@assistant-ui/react-o11y

中文文档
0.0.48发布于 2026/10/23MITTypeScriptES Module构建来源已验证近 30 天下载 2.9万

@ assistant- ui 的可观察性原始

中文使用文档

@assistant-ui/react-o11y

无头反应原始的渲染跨度和微量UIs(瀑布、时间表、运行的检查员) @assistant-ui/store以水龙头为基础的船舶 SpanResource 拥有数据 和一组无样式 SpanPrimitive.* 用于铺设的组件.

安装

npm install @assistant-ui/react-o11y

使用量

"use client";

import { AuiProvider, AuiConfig } from "@assistant-ui/store";
import { SpanPrimitive, SpanResource } from "@assistant-ui/react-o11y";

const spans = [
  { id: "a", parentSpanId: null, name: "request", type: "http", status: "completed", startedAt: 0, endedAt: 120, latencyMs: 120 },
  { id: "b", parentSpanId: "a", name: "db query", type: "db", status: "completed", startedAt: 10, endedAt: 80, latencyMs: 70 },
];

export function Waterfall() {
  const config = AuiConfig({ span: SpanResource({ spans }) });
  return (
    <AuiProvider extends={null} config={config}>
      <SpanPrimitive.Timeline>
        <SpanPrimitive.Children>
          {() => (
            <div className="relative h-8">
              <SpanPrimitive.TimelineBar className="top-1 h-6 rounded bg-blue-500" />
            </div>
          )}
        </SpanPrimitive.Children>
      </SpanPrimitive.Timeline>
    </AuiProvider>
  );
}

SpanPrimitive.* 内部组件 <AuiProvider> 覆盖行,缩进,名称,状态,倒塌控制,以及时间表栏. SpanPrimitive.Timeline 为其子女提供时间范围; SpanPrimitive.TimelineBar 以 CSS 等变量定位当前每个跨度 --span-timeline-left 财务报告和审定财务报表 --span-timeline-width。运行栏使用时间范围最大,除非您通过一个明确 now 从您自己的效果或动画循环的时标.

见 examples/waterfall 完全执行瀑布计划.

版本与发布记录

@assistant-ui/react-o11y 共发布 46 个版本,首次发布于 2026/02/21;过去 12 个月发布了 46 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.0.48latest2026/10/2315 天前
0.0.472026/10/0929 天前
0.0.462026/10/061 个月前
0.0.452026/09/181 个月前
0.0.442026/09/111 个月前
0.0.432026/09/032 个月前

关于 @assistant-ui/react-o11y 的常见问题

@assistant-ui/react-o11y 是什么?

@ assistant- ui 的可观察性原始

如何安装 @assistant-ui/react-o11y?

在项目目录运行 npm install @assistant-ui/react-o11y,或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖:react(^18 || ^19)。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖,Yarn 需要手动安装。

@assistant-ui/react-o11y 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

@assistant-ui/react-o11y 支持 ESM 还是 CommonJS?

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

@assistant-ui/react-o11y 可以商用吗?

@assistant-ui/react-o11y 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@assistant-ui/react-o11y 的下载量有多少?

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

@assistant-ui/react-o11y 还在维护吗?

最新版本 0.0.48 发布于 2026/10/23(15 天前);至今共发布 46 个版本,其中过去 12 个月发布了 46 个;首次发布于 2026/02/21。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。