# @godspeedai/cognate-ui-astryx 中文文档

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

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

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

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

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

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

## 中文简介

参考 Astryx 在@godspideai/cognate-resact:外壳,聊天,批准,文物,运行和状态检查,主题(spec §25.3). 造物师 不是本体.

## 安装

```sh
npm install @godspeedai/cognate-ui-astryx
```

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

## README

# @godspideai/cognate-ui-astryx (英语)

用于 Cognate 的参考聊天应用表面,使用 [Astryx 图像](https://www.npmjs.com/package/@astryxdesign/core) 设计系统:一个应用外壳、聊天面板、批准卡、文物取景器和运行/状态检查员,其中包含轻型/暗色主题.

**何时使用此软件包 :** 您想要一个工作,可访问的Cognate UI从盒子中取出,或者在组合自己时提供具体的参考. 它是一个渲染器,而不是本体学——这里的所有东西都作曲 [`@godspeedai/cognate-react`](https://www.npmjs.com/package/@godspeedai/cognate-react) 钩子和可格纳特型号仅此而已,因此互换设计系统意味着替换这个包而别无他法. 对于没有组件的装订,使用 `@godspeedai/cognate-react` 直接说.

## 安装

```sh
bun add @godspeedai/cognate-ui-astryx
```

要求数 [阿宝](https://bun.sh/) ++ 1.4.0和++++ **反应 19.3.0** 与 **反应-比分 19.3.0** (均被宣布为同级依赖). Astryx 本身 (`@astryxdesign/core`, (中文(简体) ), `@astryxdesign/theme-neutral`)是一种经常性的依赖。 包件船 Bun-native TypeScript 源; 如果您在 Bun 外键入, 请添加 `@types/bun` 财务报告和审定财务报表 `@types/node`。 。 。 .

## 快开始

```tsx
import { useState } from "react";
import { createClient } from "@godspeedai/cognate-client";
import { CognateProvider } from "@godspeedai/cognate-react";
import { Approvals, ChatPanel, CognateShell, RunInspector } from "@godspeedai/cognate-ui-astryx";

const client = createClient({ service: runtime.service, caller }); // runtime from @godspeedai/cognate-runtime-bun

function App() {
  const [runId, setRunId] = useState<string>();
  return (
    <CognateProvider client={client}>
      <CognateShell title="Support copilot">
        <ChatPanel agent="agent.support" placeholder="Ask about a refund" onRunStarted={setRunId} />
        <Approvals runId={runId} />
        <RunInspector runId={runId} />
      </CognateShell>
    </CognateProvider>
  );
}
```

输入信件后, 面板会启动代理运行; 流出时会显示助手文本; 批准式的续作为通过客户端解决的核准/拒绝卡; 检查员跟踪状态、 打开续作和文物。 外壳在服务器侧渲染下工作( S)`renderToString` 生成光和暗模式下的可获取标记)和水合物与活运行时间相对.

## 表面

| 构成部分 | 目的 |
| --- | --- |
| `CognateShell({ title, mode?, onModeChange?, children })` | Astryx 有标题( 标题、 浅/ 暗切) 和主区域的主题包装; 邮票 `data-cognate-theme` 在其根上 |
| `ChatPanel({ agent, placeholder?, onRunStarted? })` | 启动于 `useAgent`; 显示流式回复 |
| `ApprovalCard({ continuation, onResolve })` | 一种续用类型和有效载荷 |
| `Approvals({ runId })` | 所有公开的核准式继续作为卡片运行,通过 `useContinuations` |
| `ArtifactViewer({ artifactId })` | `text/*` 作为文本, JSON 作为可访问的密钥/ 值表对象, 其他任何东西作为下载链接 |
| `RunInspector({ runId })` | 状态、错误、开放持续和文物清点 |
| `StateInspector({ runId })` | 该运行的衍生共享状态为格式化的 JSON |

## 服务样式表

Astryx ships 预编 CSS (没有风格构建步骤). `stylesheetPaths()` 从 `./styles` 子路径解决主机页面必须链接或服务的两个样式表的绝对路径 :

```ts
import { stylesheetPaths } from "@godspeedai/cognate-ui-astryx/styles";

for (const path of stylesheetPaths()) registerStylesheet(path); // host-app specific
```

没有这些样式表 组件渲染和功能, 但不是与 Astryx 的预定外观.

## 限制

-   这些是参考面,而不是一个组件框架:除了Astryx自己的外,没有公共主题API `Theme`编号 :`mode` 由 `CognateShell`。 。 。 .
-   聊天面板包含一个代理和最新运行的文本;多运行的对话视图由您编写 `@godspeedai/cognate-react` 钩子.
-   仅提供文本,JSON-object,和下载-链接的文物渲染.

## 相关软件包

-   [`@godspeedai/cognate-react`](https://www.npmjs.com/package/@godspeedai/cognate-react) ——这里的每个地表都由钩子来建造.
-   [`@godspeedai/cognate-client`](https://www.npmjs.com/package/@godspeedai/cognate-client) 下方的无头客户端.
-   [`@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-ui-astryx 是什么？

参考 Astryx 在@godspideai/cognate-resact:外壳,聊天,批准,文物,运行和状态检查,主题\(spec §25\.3\)\. 造物师 不是本体\.

### 如何安装 @godspeedai/cognate-ui-astryx？

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

### @godspeedai/cognate-ui-astryx 支持 TypeScript 吗？

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

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

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

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

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

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

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

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

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

