# @godspeedai/cognate-protocol-connect-bun 中文文档

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

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

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

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

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

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

## 中文简介

在 Bun.serve 上服务连接运行时,提供认证、有效载荷限制和最后期限;提供接取运输.

## 安装

```sh
npm install @godspeedai/cognate-protocol-connect-bun
```

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

## README

# @godspideai/cognate-protocol-connect-bun (英语)

服务于科格纳特 `RuntimeService` 超过连接协议 `Bun.serve` ——具有认证,有效载荷限制和已经接通的最后期限——并提供匹配的取取客户端运输.

**何时使用此软件包 :** 或者从Bun那里打一个电话 你要处理运输 它会编曲 [`@godspeedai/cognate-protocol-connect`](https://www.npmjs.com/package/@godspeedai/cognate-protocol-connect) (运输中性路径映射); 当您的服务器是 Bun 时安装此程序 。 对于不同的 HTTP 主机, 使用 `@godspeedai/cognate-protocol-connect` 直接在您的路由器上注册其路线.

## 安装

```sh
bun add @godspeedai/cognate-protocol-connect-bun
```

要求数 [阿宝](https://bun.sh/) 1.4.0(服务器是 `Bun.serve` 运输。 取决于 `@connectrpc/connect`, (中文(简体) ), `@connectrpc/connect-web`,以及 `@godspeedai/cognate-protocol-connect`。 。 。 .

## 快开始

服务运行时间 从第二个过程调用它:

```ts
import { createRuntime } from "@godspeedai/cognate-runtime-bun";
import { devTokenAuthenticator, serveRuntime } from "@godspeedai/cognate-protocol-connect-bun";

const runtime = await createRuntime({
  store: "./app.sqlite",
  agents: [/* your AgentDefinitions */],
  policy, // kernel invocation policy
  actions, // action authorization
});

const server = serveRuntime({
  service: runtime.service,
  authenticate: devTokenAuthenticator, // dev helper; bring your own for production
  port: 3000,
  limits: { maxBodyBytes: 1_048_576, maxJsonDepth: 32, defaultDeadlineMs: 30_000 },
});

console.log(server.url); // http://127.0.0.1:3000
await server.stop();
```

在客户端,建造一个运输和遥控器 `RuntimeService`数字 :

```ts
import { createRemoteRuntimeService } from "@godspeedai/cognate-protocol-connect";
import { connectTransport, devToken } from "@godspeedai/cognate-protocol-connect-bun";

const service = createRemoteRuntimeService(
  connectTransport("http://127.0.0.1:3000", { useBinaryFormat: false }),
  devToken, // (caller) => "tenant:principal" Bearer token
);

const caller = { actor: { id: "alice", kind: "user" }, tenant: "tenant-a" };
const run = await service.startRun(caller, { agent: "agent.echo", input: { text: "hi" } });
```

## 请求处理

每个请求都经过同一大门,以便:

1.  **认证** —— 说 `authenticate(headers)` 解决调用者; 无调用者表示 HTTP 401 与连接码 `unauthenticated`。 。 。 .
2.  **体积** ——申报 `content-length` 结束 `maxBodyBytes` (默认 1 MiB ) 被拒绝使用 `resource_exhausted`。 。 。 .
3.  **JSON 深度** ——数值比 `maxJsonDepth` (默认32)以下列方式被拒绝: `invalid_argument`; 同样有错误的信息.
4.  **截止日期** ——不缩短客户截止日期的无记名电话以 `defaultDeadlineMs` (默认 30 s); 超支表面为 `deadline_exceeded`。 。 。 .

错误返回为连接 JSON (`{ code, message }`),以及 `ServiceError` 密码从您的服务 往返到连接代码 并准确返回.

## 发展标志

`devTokenAuthenticator` 接受 `Authorization: Bearer <tenant>:<principalId>` 财务报告和审定财务报表 `devToken` 让一个打电话的人回到那个表格。 它们是用于发展和测试的 **这不是一个认证系统**; 自行交换 `authenticate` 在让服务器接触到任何真实的东西之前.

## 限制

-   HTTP/1.1 仅支持unary和服务器流调用;协议定义不使用客户端流或双向方法.
-   体积检查使用已申报 `content-length` 头曰.
-   `serveRuntime` 当 `port` 删除;从 `server.url`。 。 。 .

## 相关软件包

-   [`@godspeedai/cognate-protocol-connect`](https://www.npmjs.com/package/@godspeedai/cognate-protocol-connect) ——运输中性路线映射和远程客户端本套件更上一层楼.
-   [`@godspeedai/cognate-runtime-bun`](https://www.npmjs.com/package/@godspeedai/cognate-runtime-bun) 运行时间 `.service` 你服务.
-   [`@godspeedai/cognate-ag-ui`](https://www.npmjs.com/package/@godspeedai/cognate-ag-ui) ——AG-UI客户端的SSE端点,搭乘同一服务.
-   [`@godspeedai/cognate`](https://www.npmjs.com/package/@godspeedai/cognate) SDK伞.

## 许可证

阿帕奇 - 2.0

## 常见问题

### @godspeedai/cognate-protocol-connect-bun 是什么？

在 Bun\.serve 上服务连接运行时,提供认证、有效载荷限制和最后期限;提供接取运输\.

### 如何安装 @godspeedai/cognate-protocol-connect-bun？

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

### @godspeedai/cognate-protocol-connect-bun 支持 TypeScript 吗？

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

### @godspeedai/cognate-protocol-connect-bun 支持 ESM 还是 CommonJS？

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

### @godspeedai/cognate-protocol-connect-bun 可以商用吗？

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

### @godspeedai/cognate-protocol-connect-bun 的下载量有多少？

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

### @godspeedai/cognate-protocol-connect-bun 还在维护吗？

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

