# @godspeedai/cognate-capabilities 中文文档

规范地址：https://npmcn.com/package/%40godspeedai/cognate-capabilities/

版本：0\.10\.0
npm 元数据更新时间：2026-11-16T03:38:07.792Z
中文译文更新时间：2026-11-16T18:04:16.818Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40godspeedai/cognate-capabilities
原文对照：https://npmcn.com/package/%40godspeedai/cognate-capabilities/?lang=original
项目主页：https://github.com/GodSpeedAI/Cognate#readme
源码仓库：https://github.com/GodSpeedAI/Cognate

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：39.8 kB，9 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：3 个
- 首次发布：2026-10-09T02:26:59.362Z
- 最新版本发布：2026-11-16T03:38:07.443Z
- 近 30 天下载量：4392（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 20 个）

## 中文简介

双阶段能力选择:确定资格,然后包含适应性排名,并有持久的解释(第8.2段、第17段、第30段).

## 安装

```sh
npm install @godspeedai/cognate-capabilities
```

也可以使用：`pnpm add @godspeedai/cognate-capabilities`、`yarn add @godspeedai/cognate-capabilities`、`bun add @godspeedai/cognate-capabilities`

## README

# @ godspideai/ 编码能力

决定第一个能力选择和Cognate模式供应商合同 应用。 鉴于一项要求和一系列候选供应商,它决定——可以解释 并持久地——哪个提供者使用,它定义了平版文字 `ModelProvider` 用于执行模型集成的接口.

**何时使用此软件包 :** 在多个提供者中选择相同能力 (例如几个模型)并且需要始终适用的资格规则,排序可以 永远不要凌驾于政策之上,对每项决定都有记录的解释。 模式的实施者 供货商也需要它 `ModelProvider`, (中文(简体) ), `ModelRequest`编号 :`ModelResponse`,以及 `ModelProviderError` 类型.

## 安装

```sh
bun add @godspeedai/cognate-capabilities
```

要求数 [阿宝](https://bun.sh/) 1.4.0. 记录选择需要任何 [`@godspeedai/cognate-events`](https://www.npmjs.com/package/@godspeedai/cognate-events) 存储。 SDK号飞船 Bun-native TypeScript源, 所以添加 `@types/bun` 财务报告和审定财务报表 `@types/node` 作为 输入检查您的工程时的依赖性 .

## 快开始

```ts
import { createMemoryStore } from "@godspeedai/cognate-store-memory";
import {
  compatibilityRule,
  createSelector,
  recordSelection,
} from "@godspeedai/cognate-capabilities";

const store = createMemoryStore();

const selector = createSelector({
  rules: [
    compatibilityRule, // contract id, major version, and attributes must satisfy the requirement
    {
      id: "policy.no-cloud",
      evaluate: (candidate) =>
        candidate.contract.attributes?.hosting === "cloud"
          ? { eligible: false, reason: "tenant forbids cloud models" }
          : { eligible: true, reason: "hosting allowed" },
    },
  ],
  // ranker: optional; without one, eligible providers are picked in provider-id order
});

const decision = await selector.select({
  requirement: { capability: "model.generate", version: "1.0", attributes: { structured_output: true } },
  candidates: [
    { providerId: "cloud-a", contract: { id: "model.generate", version: "1.2.0", attributes: { structured_output: true, hosting: "cloud" } } },
    { providerId: "local-b", contract: { id: "model.generate", version: "1.0.0", attributes: { structured_output: true } } },
  ],
  principal: { id: "alice", kind: "user" },
  tenant: "tenant-a",
});

decision.eligible;  // ["local-b"] — cloud-a failed the policy rule
decision.selected;  // "local-b"
decision.filters;   // every (provider, rule) result with its reason

// Make the decision a durable fact with its full explanation:
await recordSelection(store, decision, { tenant: "tenant-a", scopeId: "root", correlationId: "corr-1", runId: "run-1" });
```

## 如何选择

1.  **资格第一.** 每个 `EligibilityRule` 评估每个候选人。 规则必须是 纯粹和具有决定力;候选人只有在所有规则都通过的情况下才有资格.
2.  **排名第二——并有所遏制.** 可选 `Ranker` 只查看符合条件的套装 可以缩小范围,永远不要扩大范围。 未知、不合格、重复或 空出无穷. 丢掉或丢掉的军衔归根结底 提供方- id 命令, 记录在 `decision.fallback`由于没有合格的候选人, `selected` 实值 `null` 军衔是不会被调用的.
3.  **持久的反馈.** `recordSelection` 附录a `capability.selected` 与 充分解释; `recordOutcome` 附录a `capability.outcome` 用于录制选择. 运行 `outcomeProjection()` 在您的投影跑道中获得个人能力成功 计数,然后通过 `createOutcomeRanker(store)` 作为选择者的分数 : 通过对记录结果的上层信心约束规则,提供商尝试未经试验 首先提供商,而且具有决定性——重播同样的结果产生同样的结果 排行榜. 反馈仅影响承诺和预测之后的排名.

## 示范供应商合同

该套件还定义了模型集成合同,每个供应商都执行:

-   `ModelProvider` —— 说 `id`, (中文(简体) ), `model`,已声明 `features` (流程、工具使用、结构化) 产出、多式联运输入、上下文限制), `generate(request)` 财务报告和审定财务报表 `stream(request)`。 。 。 .
-   `ModelRequest` 编号 : `ModelResponse` 编号 : `ModelDelta` ——信息,工具, `responseFormat`,以及 流出三角洲形状(`text`, (中文(简体) ), `tool_call_start`, (中文(简体) ), `tool_call_args`, (中文(简体) ), `tool_call_end`, (中文(简体) ), `tool_call`, (中文(简体) ), `done`) (中文(简体) ).
-   `ModelProviderError` - 已打出故障类型: `unauthorized`, (中文(简体) ), `rate_limited`, (中文(简体) ), `invalid_request`, (中文(简体) ), `unavailable`, (中文(简体) ), `cancelled`, (中文(简体) ), `malformed_response`。 。 。 .
-   `modelContract(provider)` - 那个 `CapabilityContract` 提供者出版物(能力 id `model.generate`,特征作为属性,从不认证).

现成供应商: [`@godspeedai/cognate-provider-local`](https://www.npmjs.com/package/@godspeedai/cognate-provider-local) (决定因素,离线)和 [`@godspeedai/cognate-provider-openai-compatible`](https://www.npmjs.com/package/@godspeedai/cognate-provider-openai-compatible) (任何OpenAI相容的HTTP端点).

## 限制

-   规则和军衔由你来写,这个包保证 遏制和诚实 记账,不排名质量.
-   内置结果排行榜是一个决定性的强盗 高压的你自己的记录 成果——不是训练有素的模式——和分数只在一种能力内是可比的.
-   `recordSelection`编号 :`recordOutcome` 写给商店,没有耐用 存储,重新启动时将丢失反馈.

## 相关软件包

-   [`@godspeedai/cognate-kernel-api`](https://www.npmjs.com/package/@godspeedai/cognate-kernel-api) —— 说 `Requirement`, (中文(简体) ), `CapabilityContract`,以及所使用的兼容性检查 `compatibilityRule`。 。 。 .
-   [`@godspeedai/cognate-events`](https://www.npmjs.com/package/@godspeedai/cognate-events) —— 说 记录选择和结果的商店合同.
-   [`@godspeedai/cognate-projections`](https://www.npmjs.com/package/@godspeedai/cognate-projections) —— 说 应用的投影跑道 `outcomeProjection()`。 。 。 .
-   [`@godspeedai/cognate-runtime-bun`](https://www.npmjs.com/package/@godspeedai/cognate-runtime-bun) —— 说 参考运行时间,用于连接选择和提供者.
-   [`@godspeedai/cognate`](https://www.npmjs.com/package/@godspeedai/cognate) SDK伞.

## 许可证

阿帕奇 - 2.0

## 常见问题

### @godspeedai/cognate-capabilities 是什么？

双阶段能力选择:确定资格,然后包含适应性排名,并有持久的解释\(第8\.2段、第17段、第30段\)\.

### 如何安装 @godspeedai/cognate-capabilities？

在项目目录运行 npm install @godspeedai/cognate-capabilities，或使用 pnpm add / yarn add / bun add。

### @godspeedai/cognate-capabilities 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/godspeedai\_\_cognate-capabilities 是否存在。

### @godspeedai/cognate-capabilities 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @godspeedai/cognate-capabilities 可以商用吗？

@godspeedai/cognate-capabilities 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @godspeedai/cognate-capabilities 的下载量有多少？

根据 npm 官方下载统计，@godspeedai/cognate-capabilities 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,392 次，日均约 146 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @godspeedai/cognate-capabilities 还在维护吗？

最新版本 0\.10\.0 发布于 2026/11/16（今天）；至今共发布 20 个版本，其中过去 12 个月发布了 20 个；首次发布于 2026/10/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

