# @godspeedai/cognate-react 中文文档

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

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

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

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

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

- 包体积（解压后）：37.1 kB，5 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：3 个
- peer 依赖：react 19\.3\.0
- 首次发布：2026-10-09T02:30:42.096Z
- 最新版本发布：2026-11-16T03:49:38.131Z
- 近 30 天下载量：3532（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：20（近 12 个月 20 个）

## 中文简介

反应19对无头客户端的绑定:运行,预测,前端能力,续作,文物(spec §25.2). 没有 Astryx.

## 安装

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

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

## README

# @ godspideai/ cognate- react

对Cognate进行19个装订:将运行,活预测,前端能力,续作,以及文物放入您组件的无头客户端上薄钩. 设计-系统免费——带出自己的渲染器.

**何时使用此软件包 :** 您为 Cognate 运行时间构建一个 React 前端, 并想要处理状态管道( 订阅、 重放、 注册生命周期) 而不采用组件库 。 现成聊天/核准/艺术表面,层 [`@godspeedai/cognate-ui-astryx`](https://www.npmjs.com/package/@godspeedai/cognate-ui-astryx) 在顶上.

## 安装

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

要求数 [阿宝](https://bun.sh/) ++ 1.4.0和++++ **反应 19.3.0** (被宣布为同伴依赖, `"react": "19.3.0"`) (中文(简体) ). 取决于 [`@godspeedai/cognate-client`](https://www.npmjs.com/package/@godspeedai/cognate-client) 每个钩子都读取 `CognateClient`,这仍然是真相的唯一来源。 包件船 Bun-native TypeScript 源; 如果您在 Bun 外键入, 请添加 `@types/bun` 财务报告和审定财务报表 `@types/node`。 。 。 .

## 快开始

```tsx
import { createClient } from "@godspeedai/cognate-client";
import { CognateProvider, useAgent, useContinuations } from "@godspeedai/cognate-react";
import { createRuntime } from "@godspeedai/cognate-runtime-bun";

const runtime = await createRuntime({
  store: ":memory:",
  agents: [myAgent],
  policy, // your kernel invocation policy
  actions, // your action authorization
});
const caller = { actor: { id: "alice", kind: "user" }, tenant: "tenant-a" };
const client = createClient({ service: runtime.service, caller });

function App() {
  const { start, runId, state } = useAgent("agent.support");
  const { open, resolve } = useContinuations(runId);

  return (
    <main>
      <button onClick={() => void start({ message: "I was double charged" })}>Ask</button>
      <p>{state?.text}</p>
      {open
        .filter((c) => (c.condition as { kind?: string } | null)?.kind === "human_approval")
        .map((c) => (
          <button key={c.id} onClick={() => void resolve(c.id, "resume", { approved: true })}>
            Approve {c.id}
          </button>
        ))}
    </main>
  );
}

// Wrap once, near the root:
<CognateProvider client={client}><App /></CognateProvider>;
```

## 钩子

| 钩子 | 目的 |
| --- | --- |
| `useCognate()` | 从最近的客户端 `CognateProvider` |
| `useRun(runId)` | 现场直播 `RunState` 状态,流式 `text`,错误,打开的续作,文物,衍生状态 |
| `useAgent(agent)` | `start(input)`,最新数据 `runId`及其状态 |
| `useSharedState(runId)` | 运行的活共享状态加 `update(patchOrSnapshot)`; 写解决一旦持久并被被中止代理通过 `RunContext.state` |
| `useThreadSharedState(threadId)` | 相同的, 由所有运行在线程中共享 |
| `useProjection(name)` | 公开投影的条目 |
| `useCapability(capability, handler)` | 在组件挂起时服务前端能力; 未注册在卸载上, 留下任何打开的继续等待 |
| `useRemoteCapability(offer, handler, options?)` | (一) 发布装机寿命的描述式辅助远程能力; `options.render` 记录每个持久呼叫的用户界面;返回 `{ status, error }` |
| `useRemoteCapabilityHistory(runId)` | 运行中远程能力呼叫(仅同一次) |
| `useContinuations(runId)` | 打开续作+ `resolve(id, "resume" | "cancel", input?)` |
| `useArtifact(artifactId)` | 获取文物 : `{ status, name, mediaType, text? }` (文本解码为: `text/*` 媒体类型) |
| `useConnectionStatus()` | 客户端的连接状态 |

所有订阅钩是 `useSyncExternalStore` 适配器凌驾于客户端的被动存储器之上,因此它们也在服务器渲染下工作:客户端将缓冲历史重放入第一次订阅.

## 限制

-   软件包没有做任何事情,也没有风格;它是钩子和提供者。 Astryx 类型和组件按设计不开放.
-   远程能力使出处活在挂载提供者的内存中——在整页重新装入之后,耐用电话仍然可以检查,但原始的渲染器组件已经消失.
-   `useCapability` 财务报告和审定财务报表 `useRemoteCapability` 后续组件寿命:卸载会撤回能力或提议; 代理等待中位停留,而不是倒下.

## 相关软件包

-   [`@godspeedai/cognate-client`](https://www.npmjs.com/package/@godspeedai/cognate-client) 无头客户 这些钩子绑住.
-   [`@godspeedai/cognate-ui-astryx`](https://www.npmjs.com/package/@godspeedai/cognate-ui-astryx) ——参考基于此套件的Astryx组件.
-   [`@godspeedai/cognate-runtime-bun`](https://www.npmjs.com/package/@godspeedai/cognate-runtime-bun) 跑步时间.
-   [`@godspeedai/cognate-profile-copilot`](https://www.npmjs.com/package/@godspeedai/cognate-profile-copilot) ——使用这些绑定的由编组组成的交互聊天应用程序.
-   [`@godspeedai/cognate`](https://www.npmjs.com/package/@godspeedai/cognate) SDK伞.

## 许可证

阿帕奇 - 2.0

## 常见问题

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

反应19对无头客户端的绑定:运行,预测,前端能力,续作,文物\(spec §25\.2\)\. 没有 Astryx\.

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

在项目目录运行 npm install @godspeedai/cognate-react，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（19\.3\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

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

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

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

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

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

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

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

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

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

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

