@godspeedai/cognate-provider-local

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

确定离线模型 用于测试,演示,倒置;按照规则脚本,从不是一个真正的模型.

中文使用文档
文档目录6 节
  1. 安装
  2. 快开始
  3. 供应商表面
  4. 限制
  5. 相关软件包
  6. 许可证

@godspideai/ cognate- professor- 本地化

一个确定性,规则性规范的Cognate应用程序模型提供商. 它从规则来回答 ——没有网络,没有模型权重,没有随机性: 同一请求总是产生 相同的反应和相同的溪流块.

何时使用此软件包 : 试验和装置 ModelProvider 没有 外部依赖、离线演示和本地开发,然后指向一个真实的应用程序 终点 它从来不是一个真正的模型——不要在真正的模型行为很重要的地方使用它. 用于真正的终点, 使用 @godspeedai/cognate-provider-openai-compatible。 。 。 .

安装

bun add @godspeedai/cognate-provider-local

要求数 阿宝 >= 1.4.0. SDK 船 Bun-native TypeScript源, 因此添加 @types/bun 财务报告和审定财务报表 @types/node 在检查您的工程时, 作为非依赖性 .

快开始

import { localProvider } from "@godspeedai/cognate-provider-local";

const provider = localProvider({
  id: "demo", // provider id becomes `local:demo`
  rules: [
    {
      when: "refund", // matches a case-insensitive substring of the last user message
      respond: () => ({
        message: { role: "assistant", content: "Your refund is approved." },
        toolCalls: [],
        finishReason: "stop",
      }),
    },
    {
      // no `when`: matches everything the earlier rules did not
      respond: () => ({
        message: { role: "assistant", content: "Say 'refund' to exercise the flow." },
        toolCalls: [],
        finishReason: "stop",
      }),
    },
  ],
});

const response = await provider.generate({
  messages: [{ role: "user", content: "Can I get a refund?" }],
});
console.log(response.message.content); // "Your refund is approved."
console.log(response.model);           // "local-rules"

// Streaming yields the same content in text deltas (default 16 chars), then `done`
// with the exact response `generate` would return.
for await (const delta of provider.stream({ messages: [{ role: "user", content: "refund please" }] })) {
  if (delta.type === "text") process.stdout.write(delta.text);
}

规则按顺序匹配: when (始终是被允许的手段) 最后用户消息的子字符串生成响应. 规则 respond 获得全部 请求并可能返回工具调用,所以脚本工具使用流也起作用。 没有匹配规则, 提供者返回一个固定的“无脚本答复”.

供应商表面

  • id数字 : local:<id ?? "default">· ; model: 常数 "local-rules"。 。 。 .
  • 宣布的地物: stream, (中文(简体) ), tool_use,以及 structured_output 为: true· ; multimodal_input 实值 false· ; context_limit 实值 8192。这些旗帜是固定的,不管 将预期设定在自己的资格规则中 问题.
  • chunkSize (默认) 16控制流式文本-delta长度.

限制

  • 匹配只是子字符串:没有嵌入,没有排名,没有早期消息的内存.
  • 它宣称工具使用和结构化输出支持,尽管由你的规则决定什么 实际上是回来的,没有任何东西能证明 脚本上的反应与这些旗帜相符.
  • 绝不在需要真正模型判断的生产道路上使用它 设计.

许可证

阿帕奇 - 2.0

版本与发布记录

@godspeedai/cognate-provider-local 共发布 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/2523 天前

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

@godspeedai/cognate-provider-local 是什么?

确定离线模型 用于测试,演示,倒置;按照规则脚本,从不是一个真正的模型.

如何安装 @godspeedai/cognate-provider-local?

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

@godspeedai/cognate-provider-local 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/godspeedai__cognate-provider-local 是否存在。

@godspeedai/cognate-provider-local 支持 ESM 还是 CommonJS?

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

@godspeedai/cognate-provider-local 可以商用吗?

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

@godspeedai/cognate-provider-local 的下载量有多少?

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

@godspeedai/cognate-provider-local 还在维护吗?

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