SuperAPI AI 工具集

cometchat-react-v7-features

编程与开发

查看项目

更新于 10-21 20:28

技能介绍

用途

该技能面向在 React v7 应用中开启 CometChat 具体功能的场景,例如添加表情回应、启用投票、开启智能回复、添加推送通知、启用消息翻译、添加通话、添加审核等。它假定用户已完成核心设置(凭据、初始化与登录),并依赖组件目录来渲染功能界面。

主要能力

技能以 features.json(包根目录)作为功能存在性的唯一依据:用户请求的功能必须能在其中找到对应 id,若未列出则视为不存在,不得编造。启用流程按功能类别分支处理:

  • 默认/自动类:SDK 侧能力已开启,但需先检查 needs_stitching;若为 true,则需宿主接线或隐藏,不能留下无效控件。
  • 扩展 + Dashboard 扩展类:先启用扩展,再接入客户端。可通过 CLI(npx @cometchat/skills-cli@3 features enable <id>)翻转 Dashboard 开关,或手动在 CometChat Dashboard → Extensions 中启用;CLI 只翻转开关,客户端组件/属性仍需自行接线。
  • AI 类:需通过 Dashboard 开关(AI User Copilot)并设置代码属性,并非零代码。智能回复使用 CometChatMessageList 的 showSmartReplies(默认 false,渲染在列表页脚而非输入框);会话开场白使用 showConversationStarters(默认 false);会话摘要使用 CometChatMessageHeader 的 showConversationSummaryButton + onSummaryClick(默认 false)。仅 ai-assistant 渲染独立组件 CometChatAIAssistantChat。套餐限制常为未知,需核实而非断言。
  • 包安装类(通话):安装独立通话包(需从 docs_topic 获取确切坐标/版本),再接入 ui_components。
  • 无 UI Kit 组件类(SDK 支持的功能):如 AI 代理、活动、高级/AI 审核、机器人、Webhook、瞬态消息等,需直接从 JavaScript Chat SDK 接入,方法签名可查阅 SDK 文档。
  • 纯 Dashboard 类(审核):完全在 Dashboard 配置,不写任何审核 UI 代码。其 ui_components(CometChatModerationView / CometChatFlagMessageDialog)为自动渲染/内部使用,消息列表已内置“举报消息”选项,不要自行挂载或添加自定义举报选项。

使用方式

  1. 在 features.json 中查找并匹配功能 id。
  2. 根据类别与启用方式分支处理(见上)。
  3. 仅使用该功能的 ui_components 接入 UI,并从各组件的 .md 文档获取确切属性。
  4. 若功能有端到端任务指南(如群聊、搜索、话题、新聊天、私聊、屏蔽/解除屏蔽),应基于指南构建并对照检查完整性,再应用加固增量。
  5. 对标注 VERIFY 的条目(或 AI/端到端加密/审核条目),在输出步骤前必须对照实时文档确认套餐限制与确切 slug。

扩展配方

  • 自定义消息类型:v7 以插件架构取代 v6 的 CometChatMessageTemplate。自定义消息类型是实现 CometChatMessagePlugin(id、messageTypes、messageCategories、renderBubble)的对象,注册在 provider 上。plugins 属性会与默认插件合并,只需传入额外插件;用 removePlugins 覆盖内置类型。CometChatProvider 需要 children。可选插件接口钩子包括 getOptions、getLastMessagePreview、renderHeaderView/renderFooterView、getTextFormatters。
  • 文本格式化器/富文本:默认文本插件已应用 @提及、URL 和 markdown。自定义格式化需继承抽象类 CometChatTextFormatter(id + getRegex() + format()),并通过 CometChatMessageComposer 及气泡组件的 textFormatters 属性传入,而非 CometChatMessageList 的属性。消息列表忽略这些属性,其文本气泡使用文本插件的 getTextFormatters()(默认 markdown + 提及 + URL);若要在列表中也格式化,需通过 provider 覆盖该方法。富文本编辑器工具栏是独立功能,通过 CometChatMessageComposer 的 enableRichTextEditor 属性切换,与 textFormatters 正交,可同时使用。
  • 通话/推送:通话有独立技能 cometchat-react-v7-calls,包含安装(@cometchat/calls-sdk-javascript@5,非捆绑)、通话开关(uiKit:{callsSDK:{}})、根组件 CometChatIncomingCall 接线、1:1 响铃与群组加入差异及注意事项。推送通知有独立技能 cometchat-react-v7-push。

适用场景

适用于需要在 React v7 应用中开启或接入 CometChat 具体功能、扩展自定义消息类型与文本格式化、以及处理通话与推送等运营细节的开发者。

限制

  • 不得编造 features.json 中不存在的功能。
  • 不得硬编码 Dashboard 导航路径,需实时获取。
  • 不得在未启用扩展前渲染功能 UI 组件(会渲染为空或无操作)。
  • 不得手写审核 UI。
  • 不得假设 AI/端到端加密功能在所有套餐可用,需核实。
  • 默认开启但未接线的控件不能留下无效终点,需接线或隐藏。
  • 输出功能/组件时不得低于 contracts.json 的最低要求。
  • 完成构建后需以共享的三选项菜单收尾并等待用户选择:① 添加另一功能(建议若干尚未接线的)② 自定义主题 ③ 手动测试(停止,让用户检查)。