一个用于React的聊天表面:记录,作曲,工具调用,流出标记. 该处还配备了现场助理人员(./assistant)和让聊天在页面上看到并采取行动的页面工具。 交通-不可知论:主机提供适配器,包提供聊天外观的一切.
pnpm add @djangocfg/widget-chat @djangocfg/ui-core
@import "@djangocfg/widget-chat/styles";
import { Chat } from '@djangocfg/widget-chat';
<Chat adapter={myAdapter} renderers={myRenderers} capabilities={{ tools, voice }} body={{ kind: 'packaged' }} />
聊天需要适配器和每个部分绘制的渲染器: 开始中 拥有最小的工作之一.
每种能力都是可选的,不存在意味着不存在,从不动摇. <Chat> 拥有7个道具,一个新的特征是能力,部分类型或插槽,从不使用道具(概念) (中文(简体) ). 当第二个产品需要再次写入时,文件属于这个软件包,没有改变.
文档
@docs/ 由读者提问:
| 我想这样 | 开始于 |
|---|
| 挂载聊天 | 开始中, (中文(简体) ), 概念, (中文(简体) ), 能力, (中文(简体) ), 子路径 |
| 改变它的行为方式 | 作曲家, (中文(简体) ), 附录, (中文(简体) ), 块, (中文(简体) ), 媒体, (中文(简体) ), 运行块, (中文(简体) ), 房间, (中文(简体) ), 电话 |
| 添加一个站点助理 | 助理人员 |
| 让聊天看到页面 | 页面工具 |
| 重新样式、翻译、测试 | 样式, (中文(简体) ), i18n (英语), (中文(简体) ), 测试 |
CLAUDE.md 回答另一个问题:什么是容易打破的.
校验
pnpm --filter @djangocfg/widget-chat check-types test
关于 @djangocfg/widget-chat 的常见问题
@djangocfg/widget-chat 是什么？
传送-不可知聊天表层:一个纯核心,一个商店,一个原始人,一个作曲家和组装的组件一个主机上架,加上SSE上的站点助手(线,会话,外壳,口语,17个地块)
如何安装 @djangocfg/widget-chat？
在项目目录运行 npm install @djangocfg/widget-chat，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：react（^19.0.0）、remark-gfm（^4.0.0）、streamdown（^2.7.0）、lucide-react（^1.68.0）、@djangocfg/api（^2.1.653）、@djangocfg/i18n（^2.1.653）、@djangocfg/ui-core（^2.1.653）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。
@djangocfg/widget-chat 支持 TypeScript 吗？
支持。包内自带 TypeScript 类型声明（package.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。
@djangocfg/widget-chat 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module，更早的版本需要改用动态 import()。
@djangocfg/widget-chat 可以商用吗？
@djangocfg/widget-chat 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
@djangocfg/widget-chat 的下载量有多少？
根据 npm 官方下载统计，@djangocfg/widget-chat 在 2026/10/13 – 2026/11/11 这 30 天内被下载 6,241 次，日均约 208 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
@djangocfg/widget-chat 还在维护吗？
最新版本 0.1.49 发布于 2026/11/12（今天）；至今共发布 40 个版本，其中过去 12 个月发布了 40 个；首次发布于 2026/09/09。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。