@godspeedai/cognate-ui-astryx

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

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

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

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

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

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

安装

bun add @godspeedai/cognate-ui-astryx

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

快开始

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 子路径解决主机页面必须链接或服务的两个样式表的绝对路径 :

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,和下载-链接的文物渲染.

许可证

阿帕奇 - 2.0

版本与发布记录

@godspeedai/cognate-ui-astryx 共发布 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-ui-astryx 的常见问题

@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 和提交记录判断。