# @copilotkit/web-inspector 中文文档

规范地址：https://npmcn.com/package/%40copilotkit/web-inspector/

版本：1\.86\.0
npm 元数据更新时间：2026-11-11T06:10:58.664Z
中文译文更新时间：2026-11-11T06:12:29.794Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40copilotkit/web-inspector
原文对照：https://npmcn.com/package/%40copilotkit/web-inspector/?lang=original
项目主页：https://github.com/CopilotKit/CopilotKit#readme
源码仓库：https://github.com/CopilotKit/CopilotKit

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

- 包体积（解压后）：7.3 MB，126 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20
- 运行依赖：7 个
- 首次发布：2026-03-29T00:19:14.243Z
- 最新版本发布：2026-11-11T06:10:58.256Z
- 近 30 天下载量：2051709（2026-10-11 至 2026-11-09，npm 官方下载统计）
- 已发布版本数：217（近 12 个月 217 个）

## 中文简介

为“副驾驶Kit”网络检查员提供基于lit的网页组件

## 安装

```sh
npm install @copilotkit/web-inspector
```

也可以使用：`pnpm add @copilotkit/web-inspector`、`yarn add @copilotkit/web-inspector`、`bun add @copilotkit/web-inspector`

## README

# @ copilotkit/ web- 督察

## 受托项目背景

网络检查员读取可选 `InspectorMetadataV1` 数据来源 `@copilotkit/core`。它再次在 UI 边界上解析值,使每个值 自动有效模块 :

-   `identity` 在 Home 项目卡上显示组织和项目.
-   `plan` 在“家庭”和“线索”页脚上显示计划标签.
-   `action` 可以在监察员侧边栏、线索中显示一个可信任的链接 foder,或被锁入线条视图.
-   `usage` 显示可信任的线索数和详细的使用和过期数据 在线脚.

缺少或无效的元数据只隐藏受影响的可信任模块 。 家还是 使其工程、运行时间、服务以及“新预览”安全空出 各州. 现有的调试视图和线索端点行为仍然可用. A 类 没有线索的运行时间端点提供静态的、由文件支持的 编码代理即时和链接到公共路由设置指南.

脚印坐在线条列表边栏的下方. 它不会离开 账户条、其他导航组和设置。 用法和页脚 动作自行渲染,这样两个模块都可以不另出现.

家是新安装或升级安装上的第一个面板. 稍后打开恢复 最后一个选中的窗格。 活的边栏组 导航到家和什么 新建, 工作区 (线程和内存),和检查(代理,AG-UI事件,可选的前端工具) 和能力,以及背景)。 和工程师联系的谈话会留在脚下, 接下来是情报和运行时状态 家预览 最新更新并打开专用的“新窗格”. 左侧和狭长的布局使用紧凑的图标栏;更宽的布局也可以 手动崩溃。 右上方的光/暗主题控制 在会话之间检查而不更改主机应用程序的主题 . 未读通知激活了关闭的发射装置, 显示为家预览, 并标记“新边栏”条目,直到更新打开.

元数据只显示: 它从来不授权或门串工作 。 核心开始 真实 只有对象值的线索工作 `threadEndpoints` 与 `list !== false`。 。 。 . 没有终点, 字面 `false`,或终点对象 `list: false` 生成零列表、订阅、检查、信件、事件和状态请求.

### 许可证和行动汇总表

| 有效许可证状态 | 线索页脚 | 锁定线索视图 |
| --- | --- | --- |
| `valid` | 显示 `Manage Your Plan` 低于90%的限用和紫色 `Upgrade Your Plan` 90%或以上为受信任者 `manage_plan` 动作 | 复制编码代理修复提示, 并在运行时无线索端点时链接到 Rich Threads 路由设置指南 |
| `none` | 无页脚动作 | 显示 `Enable Intelligence` 只为信任 `enable_intelligence` 动作 |
| `expired` | 无页脚动作 | 显示 `Renew` 页:1 `renew`,或 `Manage Your Plan` 页:1 `manage_plan` |
| `unknown` | 无页脚动作 | 使用没有动作的中性副本 |

有限用途显示 `used / limit Threads` 有个本土进步栏 那个酒吧是 绿色在90%以下,橙色从90%到极限,红色在极限或高于极限. 90%,一个信任的 `manage_plan` 页脚链接从 `Manage Your Plan` 改为 紫外线 `Upgrade Your Plan` 动作而不改变其 URL 或动作类型。 超龄显示 `limit+ / limit Threads` 百分百封顶 无限制使用文字 只有这个 未知的限制显示信任的用量 `Limit unavailable`· ; 它既不发明数字限制,也不发明进步。 已知的零过期数保留 可见; 缺少或格式错误的过期数据仍然隐藏.

`Expiring Soon` 说明今后24个保留政策门槛值 小时。 检查员不强制保留、锁定或删除线索或运行 线性克勒.

企业管理元数据没有管理计划行动,团队自行管理 元数据没有主机动作 。 任何提供的行动必须与有效 上表中的许可证状态和行动类型.

检查专员将元数据许可状态与 `licenseStatus` 从 运行时间信息响应 。 如果两者都已知并不同意,则使用运行时 复制和隐藏动作状态。 避免将用户发送到动作 不隐藏有效用法,则不符合运行时的当前状态.

每个动作都会打开共享解析器接受的确切URL. 检查员 不添加查询参数,不从名称或ID中获取 URL,也不提供 对锁定的线索元数据动作进行硬码后退的签名 .

### 线索选择保持不变

元数据到达、刷新、失败和删除不选择或重选 a 线程。 检查员保留现有的所选行和细节视图.

### 混合版本

| 组合 | 结果 |
| --- | --- |
| 有新共享和运行时间的老制作人 | 无 `expiringSoonCount`; 过期不发生. |
| 已过期的共享或运行时间新制作人 | 年长的消费者忽略或去除添加剂过期叶并保持了有效的基础V1使用. |
| 有新运行时间的旧 App API | 提供者 `404` 成为私人 `204`; 核心保持连接,元数据保持缺失. |
| 使用旧运行时间新建 App API | 运行时不提出元数据请求,当前检查员的行为保持不变. |
| 与旧检查员新建运行时间或核心 | 老检查员忽略了它不能提供的元数据. |
| 用旧的 Core 或运行时新建检查器 | 检查员的特征探测器支持安全缺失的元数据,使其倒置. |

这些组合不需要同步部署. 推出 情报制作人先放出每个消费者 明确 `threadEndpoints` 仍然是每种组合中的权威;元数据永远无法实现 线索和许可证冲突会抑制不兼容的动作 压制有效使用 .

### 隐私许可列表

UI可能只提供解析的组织名称,项目名称,计划标签, 许可证桶、动作类型、信任的动作 URL 和信任的线索使用字段: 使用计数,限制种类和值,以及过期计数。 元数据遥测是 粗体:其特性可能仅包括 `module`, (中文(简体) ), `action_kind`, (中文(简体) ), `license_bucket`, (中文(简体) ), `usage_bucket`, (中文(简体) ), `expiry_bucket`, (中文(简体) ), `group_key`, (中文(简体) ), `leaf_key`,以及 `action_placement`它永远不能复制准确的用途,限制, 过期计数、内容、名称、URL,或线索、代理、消息、账户、项目、, 或其他产品身份证明 它只保留匿名者 探长遥测已经使用的识别符.

使用 UI 不为遥测添加用法印象或值. 值得信赖的人 元数据页脚动作仅在线索上可见。 现有元数据 动作印象和点击事件保持粗糙的允许列表 .

## 常见问题

### @copilotkit/web-inspector 是什么？

为“副驾驶Kit”网络检查员提供基于lit的网页组件

### 如何安装 @copilotkit/web-inspector？

在项目目录运行 npm install @copilotkit/web-inspector，或使用 pnpm add / yarn add / bun add。

### @copilotkit/web-inspector 支持 TypeScript 吗？

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

### @copilotkit/web-inspector 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @copilotkit/web-inspector 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @copilotkit/web-inspector 可以商用吗？

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

### @copilotkit/web-inspector 的下载量有多少？

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

### @copilotkit/web-inspector 还在维护吗？

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