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

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

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

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

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

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

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

## 中文简介

将运行时服务映射到生成的连接服务(服务器路由和远程客户端). 交通-不可知论.

## 安装

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

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

## README

# @ godspideai/ cognate- protocol- 连接

映射凝结 `RuntimeService` 输入生成的连接服务( E)`cognate.v1.RuntimeService`),独立于任何HTTP服务器。 它提供服务器侧路由注册,以及一个行为类似进程内服务的远程客户端.

**何时使用此软件包 :** 当您自己托管 Connect 路由器( 任何基于获取的服务器都可以驱动) 或需要输入时安装它 `RuntimeService` 由远程端点支持。 如果你从本服务, [`@godspeedai/cognate-protocol-connect-bun`](https://www.npmjs.com/package/@godspeedai/cognate-protocol-connect-bun) 用现成的包包 `Bun.serve` 运输,有效载荷的限制, 和最后期限—— 安装它,你自动得到这个.

## 安装

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

要求数 [阿宝](https://bun.sh/) 1.4.0. 取决于 `@connectrpc/connect`, (中文(简体) ), `@bufbuild/protobuf`, (中文(简体) ), [`@godspeedai/cognate-proto`](https://www.npmjs.com/package/@godspeedai/cognate-proto),则 `RuntimeService`编号 :`ServiceError` 类型来源 [`@godspeedai/cognate-runtime-api`](https://www.npmjs.com/package/@godspeedai/cognate-runtime-api)。 。 。 .

## 快开始

将连接传输转换成全远程 `RuntimeService` ——返回对象满足与进程运行时间服务相同的接口:

```ts
import { createConnectTransport } from "@connectrpc/connect-web";
import { createRemoteRuntimeService } from "@godspeedai/cognate-protocol-connect";

const service = createRemoteRuntimeService(
  createConnectTransport({ baseUrl: "http://127.0.0.1:3000" }),
  (caller) => issueToken(caller), // Bearer credential for this caller
);

const caller = { actor: { id: "alice", kind: "user" }, tenant: "tenant-a" };
const run = await service.startRun(caller, { agent: "agent.echo", input: { text: "hi" } });
for await (const event of service.events(caller, { runId: run.runId, follow: true })) {
  console.log(event.eventType);
}
```

普通JSON为 `input` 和其他数值类型字段——适配器转换为原生出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出入出出出出出出出出出出出出出出出出出出出出出出出入出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出入出出出出出出出出出出出出出出出出出出出出出出出出入出出出出出出出出出出出出出出出出出入出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出出 `Value` 给你的... 还有.. `ServiceError` 由服务器生成的代码相同,所以 `service` 用于进程内服务.

在服务器一侧,注册连接路由器上的路由 :

```ts
import { registerRuntimeService } from "@godspeedai/cognate-protocol-connect";

registerRuntimeService(router, runtime.service, {
  // Caller identity comes from request headers, never from message bodies.
  authenticate: (headers) => myBearerAuth(headers.get("authorization")),
  maxJsonDepth: 32, // reject over-deep JSON values from clients
});
```

缺少或无效的证书失败每条路由 `unauthenticated`如果你是从邦服务, [`serveRuntime`](https://www.npmjs.com/package/@godspeedai/cognate-protocol-connect-bun) 请为您办理登记,并增加体积和期限.

## API 表面

-   `registerRuntimeService(router, service, { authenticate, maxJsonDepth })` – 每架服务器路由 `RuntimeService` 方法.
-   `createRemoteRuntimeService(transport, tokenFor)` - 客户端 `RuntimeService` 超越任何连接运输; `tokenFor` 为每个呼叫者提供持证人证书.
-   `errorCodes` - 那个 `ServiceError` 代码到连接代码表(例如) `not_found` → `NotFound`因此,其他运输工具可以重新使用精确的绘图.

## 限制

-   服务只定义了unary和服务器流方法;电线上没有客户端流或双向方法.
-   观察摄取是一种在过程机制:远程客户端的 `observe` 总是失败 `failed_precondition` 而不是把它暴露在电线上.
-   请求以您的 `authenticate` 执行进展情况 `maxJsonDepth` 仅;车体大小限制和呼叫截止日期是运输问题(Bun包增加了两者).

## 相关软件包

-   [`@godspeedai/cognate-protocol-connect-bun`](https://www.npmjs.com/package/@godspeedai/cognate-protocol-connect-bun) —— 说 `Bun.serve` 运输、限制、期限和取货运输厂.
-   [`@godspeedai/cognate-proto`](https://www.npmjs.com/package/@godspeedai/cognate-proto) ——生成的信息和服务描述此软件包地图到.
-   [`@godspeedai/cognate-runtime-api`](https://www.npmjs.com/package/@godspeedai/cognate-runtime-api) - 那个 `RuntimeService` 合同和 `ServiceError` 类型.
-   [`@godspeedai/cognate`](https://www.npmjs.com/package/@godspeedai/cognate) SDK伞.

## 许可证

阿帕奇 - 2.0

## 常见问题

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

将运行时服务映射到生成的连接服务\(服务器路由和远程客户端\)\. 交通-不可知论\.

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

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

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

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

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

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

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

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

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

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

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

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

