@godspeedai/cognate-capabilities

中文文档
0.10.0发布于 2026/11/16Apache-2.0ES Module构建来源已验证近 30 天下载 4392

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

中文使用文档
文档目录7 节
  1. 安装
  2. 快开始
  3. 如何选择
  4. 示范供应商合同
  5. 限制
  6. 相关软件包
  7. 许可证

@ godspideai/ 编码能力

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

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

安装

bun add @godspeedai/cognate-capabilities

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

快开始

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 (决定因素,离线)和 @godspeedai/cognate-provider-openai-compatible (任何OpenAI相容的HTTP端点).

限制

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

许可证

阿帕奇 - 2.0

版本与发布记录

@godspeedai/cognate-capabilities 共发布 20 个版本,首次发布于 2026/10/09;过去 12 个月发布了 20 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.10.0latest2026/11/16今天
0.9.22026/11/152 天前
0.9.12026/11/143 天前
0.9.02026/11/0610 天前
0.8.02026/10/2720 天前
0.7.12026/10/2423 天前

关于 @godspeedai/cognate-capabilities 的常见问题

@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 和提交记录判断。