SuperAPI AI 工具集

cometchat-theming

前端与建站

查看项目

更新于 10-15 20:14

技能介绍

用途:教代理如何在已集成 CometChat 的项目中做主题定制,使聊天 UI 匹配应用设计系统。CometChat 外观由 @cometchat/chat-uikit-react/css-variables.css 中 200+ CSS 自定义属性驱动,没有组件级颜色样式 API,主题即 CSS 变量覆盖。

主要能力:提供预设主题(slack、whatsapp、imessage、discord、notion,含各自主色、文字色、背景色、字体与圆角)、品牌色覆盖、设计系统令牌提取(从 tailwind.config 或根 CSS 提取)、暗色模式(OS 驱动的 @media (prefers-color-scheme: dark) 或应用切换器控制的 .dark/[data-theme="dark"] 作用域)以及组件级变量覆盖。

使用方式:先确认项目已有集成(检查 .cometchat/config.json 与 UI Kit 依赖),否则提示先运行 /cometchat。覆盖规则需写在 css-variables.css 导入之后,作用域用 .cometchat 而非 :root,优先级为内联 setProperty > 组件作用域 > 全局 > 默认。目标文件按框架而定:reactjs 用 src/index.css,nextjs 用 globals.css,react-router 用 app/app.css,Astro 必须写在 React island 的 .tsx 内联 style 或组件内导入。完成后执行 npx @cometchat/skills-cli config set theme "<preset-or-custom>",并重启开发服务器、刷新聊天页。

限制:不要使用 cometchat apply-theme CLI(v2 工具,v3 会报 No integration found)。组件级选择器需查询 CometChat docs MCP 或源码,不得凭记忆编造类名。未提供的信息(如具体价格、平台差异细节)暂未提供。