用途:在 Astro 项目中集成 CometChat React UI Kit v6,采用 React islands 方式挂载聊天界面。不适用于 Next.js、普通 React.js 或 React Router 项目,那些应使用对应框架技能。
主要能力与流程:先确保已配置 @astrojs/react(未配置则运行 npx astro add react);用 npx @cometchat/skills-cli@latest detect --json 检测框架,若结果不是 astro 则停止;让用户选择体验类型(多会话、单会话、完整信使),再用 view、apply(--placement dedicated-route)、verify 命令写入并校验代码;随后用 npx @cometchat/skills-cli@latest install 安装依赖。CLI 会创建 .env(含 APP_ID、REGION、AUTH_KEY 占位符)并加入 .gitignore,生成 src/pages/chat.astro 与 src/cometchat/ChatApp.tsx。
限制与规则:SDK 相关事实须优先查询 CometChat 文档 MCP(未安装时需先安装后再继续),不得凭记忆编造 SDK 签名;初始集成阶段只由 CLI 写文件;自定义组件时应先查 Phase B 组件查找表,搜索等能力须使用内置组件而非自建;css-variables.css 必须导入到 React island 的 .tsx 文件内,不能放在全局样式表。
适用场景:为 Astro 站点加入聊天功能,并按需扩展主题、功能、组件定制、浮动小组件、生产鉴权与服务端用户管理。