SuperAPI AI 工具集

cometchat-placement

智能体与模型

查看项目

更新于 10-15 20:14

技能介绍

用途:这是一个面向 Claude 的技能,教你在已有项目中决定 CometChat 放在哪里,而不是只讲组件怎么写。它覆盖五种放置模式:路由、模态弹窗、抽屉、嵌入面板、悬浮挂件,每种都给出步骤与完整代码示例。技能与框架无关,使用类似“在框架的路由位置创建页面”“在项目路由器中加一条路由”的通用的指令;具体文件路径、SSR 处理、环境变量前缀由框架技能与 cometchat-core 技能提供。

使用前需先阅读 cometchat-core(初始化、登录、CSS、Provider 模式)与 cometchat-components(组件名、props、组合模式)。事实基准为 @cometchat/chat-uikit-react@^6,并参考官方 React UI Kit 文档。

放置推荐:消息型应用推荐全页路由 + 多会话(会话列表 + 消息头 + 消息列表 + 输入框);市场/平台推荐商品页抽屉加 /messages 路由(抽屉单会话 + 路由多会话);SaaS/仪表盘推荐导航栏弹窗加 /messages 路由;社交/社区推荐带标签页的路由全功能信使;客服/帮助台推荐悬浮挂件(用 CLI 生成);仅探索阶段可用替换首页的演示。

经验布局:多会话为左会话列表右聊天双栏;单会话只有聊天窗口,无会话列表;全功能信使在多会话基础上加底部标签栏,可切换聊天、通话、用户、群组。窄栏或双栏面板中,React v6 官方示例使用 CometChatCompactMessageComposer 而非 CometChatMessageComposer;单栏全宽布局用后者。

高度与滚动:消息视图列必须有确定高度。整条链(html/body/#root 到该列)须用确定高度(如 #root { height: 100vh }),不要用 min-height,且 CometChatMessageList 的每个 flex 祖先都要 minHeight: 0。若列表仍不滚动或你把列表包在自定义 div 中,会遇到自动注入的 .cometchat 元素,需给列表包裹类同时设置 flex: 1 1 0; min-height: 0; height: 100%; overflow: hidden,并加子规则 .your-wrapper > .cometchat { height: 100%; overflow: hidden }(内联样式无法命中注入的子元素)。

线程回复默认隐藏:每个示例的消息列表都带 hideReplyInThreadOption。若未接入线程面板(抽屉、挂件、弹窗、单会话等场景),该选项仍可见但点击无效。默认隐藏线程;要启用需移除该属性、添加 onThreadRepliesClick 捕获线程消息,并渲染由 CometChatThreadHeader、作用域消息列表与带 parentMessageId 的输入框组成的线程面板。

限制:资料只给出上述模式、布局建议与注意事项,具体来源、版本之外的收费、价格、平台支持、效果等事实暂未提供。