用途
该技能用于把应用从 Sendbird 迁移到 CometChat,覆盖本技能包支持的平台:React、Angular、React Native/Expo、iOS、Android、Flutter。触发场景包括用户要求“把应用从 Sendbird 迁移到 CometChat”“替换 Sendbird”“切换到 CometChat”等。若检测到 migrate_from 的 vendor 为 sendbird,则使用本技能;若为 Stream/GetStream,则使用 cometchat-migrate-from-getstream。若应用同时使用两个厂商,则依次运行两个技能并合并到一份报告。
如果用户只要求迁移数据(“只迁移数据”“导入 Sendbird 用户和消息”“不要改代码”,或应用已运行在 CometChat 上),则改为遵循 references/data-only.md,只编写并运行数据脚本,不改动其他内容。
主要能力
- 检测:通过 npx @cometchat/skills detect --json 获取框架、android_variant、existing_cometchat、migrate_from,并解析目标 family。
- 盘点:按 references/inventory.md 搜索 Sendbird 的使用点,记录为 file:line → 用途,并分类为 UIKit 模式、SDK 模式或混合模式。
- 功能映射:对每个 Sendbird 功能查 references/feature-map.md,再在目标 family 的 features.json 中确认对应 CometChat 功能是否存在;不存在时同时检查 UI Kit 与 Chat SDK/REST 两层,只有两者都没有才标记为 UNSUPPORTED。
- 安装与接线:按 cometchat-<family>-core 安装 CometChat 并接入初始化、登录门、渲染顺序与环境文件。
- 身份映射:使用统一的 toCometChatId() 将 Sendbird 用户 ID 转为 CometChat UID,客户端登录、服务端令牌端点与数据脚本共用同一函数。
- 逐文件替换:初始化/连接、频道列表、群组/单聊、处理器、消息收发编辑删除与线程、UIKit 界面、主题与字符串、Calls、推送等,均按 references/concept-map.md 替换。
- 移除不支持功能:删除代码路径、UI 入口、状态、类型、Hook、资源、测试、环境变量、服务端端点与依赖,并记录用户损失与最接近的替代方案。
- 服务端迁移:用 CometChat 认证令牌端点替换 Sendbird 会话/访问令牌铸造,映射 Webhook,替换或移除其他 Platform API 调用。
- 数据迁移脚本:生成 scripts/cometchat-migration/,从 Sendbird Platform API 导出用户、频道、成员与消息,经同一 toCometChatId() 转换后通过 CometChat Data Import API 导入;先 --dry-run 再正式导入。
- 卸载 Sendbird:移除依赖、CSS、字体图标、环境变量、原生配置与 CI 密钥引用,更新应用自身文档,重命名 Sendbird 相关标识符。
- 验证与报告:修复构建错误,运行应用并检查日志,最后在仓库根目录生成 COMETCHAT_MIGRATION.md,并在回复末尾列出 Removed 与 Your action items。
使用方式
该技能遵循“单提示契约”:迁移请求本身即为批准,一次运行完成所有步骤,不中途询问、不设审批门。在 git 仓库中先执行 git switch -c cometchat-migration,不提交、不推送、不改写历史。凭据不询问、不预置:复用 .cometchat/config.json 或现有 CometChat 环境值,否则写入带占位符的环境/设置文件,并将“添加 CometChat 凭据”列为第一项行动项。真实密钥只写入未跟踪文件或托管环境。
仅三种情况会停止:未发现 Sendbird 使用;应用平台不在本技能包内(如 Vue、Unity、.NET);构建在开始前已失败。
迁移工作流按顺序执行:检测 → 盘点 → 功能映射 → 安装并接线核心 → 逐文件替换 → 完整移除不支持功能 → 服务端迁移 → 数据迁移脚本 → 卸载 Sendbird → 验证 → 报告。每一步都适用于所有应用,只有主题确实不存在的步骤可跳过,并需在报告中记录跳过原因。
数据导入脚本完成后,告知用户脚本已就绪并请求所需凭据(SENDBIRD_APP_ID、SENDBIRD_API_TOKEN 以及 CometChat App ID、Region 和 full-access REST API key)。用户提供后,从环境变量运行导入,先 --dry-run 显示用户/群组/成员/消息数量,再正式导入并报告结果。仅 CometChat 6 个月保留窗口内的消息可导入,更早消息需联系 CometChat。
适用场景
适用于使用 Sendbird 且目标平台在本技能包内的应用迁移,包括 UIKit 模式、SDK 模式与混合模式;也适用于无 UI Kit 的 headless/vanilla-JS 应用(安装对应平台 Chat SDK 并迁移数据层)。原生平台(Android、iOS、Flutter)迁移必须遵循 references/native-build.md,完成工具链升级、依赖添加、initFromSettings 接线、toCometChatId 移植、构建图编辑并实际运行平台构建,否则迁移不算完成。
限制
- 仅支持本技能包列出的平台;其他平台只交付盘点与功能映射报告,不改代码。
- 不支持的 CometChat 功能必须完整移除,不能保留死按钮、注释块或开启的功能开关。
- 可访问性(跳转链接、焦点管理、实时区域、键盘快捷键)不属于“缺失功能”,需在新布局中重建,不得列为 Removed。
- CometChat UID/GUID 仅允许小写字母、数字、连字符与下划线,最长 100 字符;Sendbird ID 可能含 @、.、空格或大写,需统一清洗。
- 单聊不是群组:恰好两人的 distinct Sendbird 群组频道应转为 CometChat 用户会话(receiverType: user)。
- 大频道:CometChat 仅在最多 300 名成员的群组中发送回执与输入指示(无回执时上限 100,000);超过 300 的超级群组仍可聊天但失去回执,需列为行为变化。
- 每个 Sendbird 处理器都需要对应的 CometChat 监听器,并在卸载/销毁时移除,否则会出现重复消息。
- 集合/本地缓存(GroupChannelCollection/MessageCollection)需移植为 CometChat 请求构建器与监听器,并说明行为变化,不要重新发明缓存。
- 不得删除仅与 Sendbird 代码共享文件的非 Sendbird 代码,应重新接线。
- 不运行实时测试,除非用户要求。
- 数据导入仅限 CometChat 6 个月保留窗口内的消息。
- 本技能不提供收费、价格或平台支持范围之外的信息;资料未提供的内容暂未提供。