@copilotkit/web-components

中文文档
1.86.0发布于 2026/11/11MITTypeScriptESM + CJS零依赖构建来源已验证近 30 天下载 166万

CopilotKit 的框架不可识别阴影- DOM 网络组件 - 包括线程抽屉元素

中文使用文档
文档目录6 节
  1. 安装
  2. 使用量
  3. 入境财产(DOMAIN状态——消费者拥有)
  4. 外部活动(INTENT-bubling + 组成) CustomEvent (c) 财务、财务和预算
  5. 瑟明 (赞美)
  6. 移动 + a11y

@ copilotkit/ web- 组件

框架不可知、阴影-DOM 升 copilotKit 的自定义元素.

目前这包船 <copilotkit-threads-drawer> ——公众自成一体, 控制线条抽屉。 这是纯洁的 视频: 域数据以 属性和用户意图作为 DOM 流出 CustomEvents. 它不进口反应, 角质,或 @copilotkit/core 代码,并在任何主机页面中正确编译, 幸存的敌对宿主CSS(all: unset尾风预飞 !important) (中文(简体) ).

安装

npm install @copilotkit/web-components lit

lit 是一个对等/运行时间的依赖,所以主机取消了一个Lit运行时间.

使用量

import { defineCopilotKitThreadsDrawer } from "@copilotkit/web-components/threads-drawer";

defineCopilotKitThreadsDrawer(); // registers <copilotkit-threads-drawer> (idempotent)
<copilotkit-threads-drawer active-thread-id="t-123"></copilotkit-threads-drawer>
<script>
  const drawer = document.querySelector("copilotkit-threads-drawer");
  drawer.threads = [
    {
      id: "t-123",
      name: "My thread",
      archived: false,
      createdAt: "...",
      updatedAt: "...",
    },
  ];
  drawer.addEventListener("thread-selected", (e) => open(e.detail.threadId));
  drawer.addEventListener("new-thread", () => createThread());
</script>

入境财产(DOMAIN状态——消费者拥有)

属性类型说明
threadsDrawerThread[]+ 权威过滤器
loadingboolean初始加载
errorstring | null初始比对出错 → 可操作重试
activeThreadIdstring | null驱动选择突出显示
licensedbooleanfalse ——上市取代名单
fetchingMoreboolean飞行中标记
fetchMoreErrorstring | null内置“ 不能再装入了 —— 重试 ”
openboolean外部可控(机动协调)
collapsedboolean桌面倒塌到铁路

外部活动(INTENT-bubling + 组成) CustomEvent(c) 财务、财务和预算

thread-selected, (中文(简体) ), archive, (中文(简体) ), unarchive, (中文(简体) ), delete (在内容确认后), new-thread, (中文(简体) ), filter-change, (中文(简体) ), open-change, (中文(简体) ), retry (单位:千美元){ scope }, (中文(简体) ), upsell。 。 。 .

元素拥有 VIEW 状态: 打开/ 缩合, 活动/ 全部过滤器 确认删除对话框,以及每行条目/视频动画.

瑟明 (赞美)

  • CSS 变量 穿透阴影边界——设定 --cpk-drawer-* (单位:千美元)-bg, (中文(简体) ), -fg, (中文(简体) ), -surface, (中文(简体) ), -accent, (中文(简体) ), -primary, (中文(简体) ), -danger, (中文(简体) ), -border, (中文(简体) ), -ring, (中文(简体) ), -radius, (中文(简体) ), -width, (中文(简体) ), -font-family,.)来自主持人.
  • ::part() 结构节点上的钩子( t)root, (中文(简体) ), header, (中文(简体) ), list, (中文(简体) ), row, (中文(简体) ), row-name, (中文(简体) ), confirm-dialog, (中文(简体) ), backdrop(中文(简体) ).
  • 已命名槽数字 : header, (中文(简体) ), footer, (中文(简体) ), empty, (中文(简体) ), upsell, (中文(简体) ), memories外加一个 每行槽数 row:{id} 用于在 元素将选择/存档/活化铬置于其周围.

内置默认皮肤的符号值是 在构建时生成 从 反应-core的克诺克主题(packages/react-core/src/v2/styles/globals.css(中文(简体) ) 以 scripts/generate-tokens.ts,它会写进报到 src/threads-drawer/generated-tokens.ts运行 pnpm run gen:tokens 重新生化; generated-tokens.test.ts 如果检查的值从反应核心漂移,则失败.

移动 + a11y

时/下 768px 抽屉是一张有背景背景的空地, Escape 关闭, 滚动锁, 以及运行于此的焦点陷阱( 仅移动) 包含由编组/平面树组成的分档行。 在桌面上是一个 发生塌陷的流入区 没有 模式( 无焦点陷阱, 无) 滚动锁).

版本与发布记录

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

版本发布日期距今
1.86.0latest2026/11/11今天
2.0.0-rc.40next2026/11/11今天
2.0.0-rc.392026/11/10今天
2.0.0-rc.382026/11/10今天
2.0.0-rc.372026/11/091 天前
2.0.0-rc.362026/11/064 天前

其他发布通道:canary → 1.84.2-canary.openbot-intel-fixes,next → 2.0.0-rc.40。

关于 @copilotkit/web-components 的常见问题

@copilotkit/web-components 是什么?

CopilotKit 的框架不可识别阴影- DOM 网络组件 - 包括线程抽屉元素

如何安装 @copilotkit/web-components?

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

@copilotkit/web-components 支持 TypeScript 吗?

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

@copilotkit/web-components 支持 ESM 还是 CommonJS?

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

@copilotkit/web-components 需要什么版本的 Node.js?

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

@copilotkit/web-components 可以商用吗?

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

@copilotkit/web-components 的下载量有多少?

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

@copilotkit/web-components 还在维护吗?

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