一、概述
安装后，直接在 AI IDE 或 Coding IDE 的 AI 插件里用自然语言描述需求，例如“帮我集成 TIMPush”，Agent 会自动识别项目平台，并调用配套能力逐步完成集成或排障。
二、能力清单
当你提到 TIMPush、离线推送、厂商通道或 APNs 等关键词时，Skill 会自动触发，无需斜杠命令。
| 场景 | | 能力说明 | 示例 |
| 接入 | Android | 内置接入向导：自动识别工程，按步骤完成 SDK 依赖、华为/小米/OPPO/vivo/荣耀/魅族/FCM 厂商通道、签名 SHA256、包名一致性校验与 registerPush 代码接入 | “帮我集成 Android TIMPush” |
| | iOS | 内置接入向导：自动识别工程，按步骤完成 Pod 依赖、APNs 证书/P8、aps-environment、businessID 校验与 registerPush 代码接入 | “iOS 项目接入离线推送” |
| | Flutter | 内置接入向导：按跨平台向导完成 Flutter 插件接入，以及 Android 厂商通道与 iOS APNs 原生侧配置 | “Flutter 项目接入 TIMPush” |
| | uni-app | 内置接入向导：按跨平台向导完成原生插件、nativeResources 厂商配置、自定义基座与 JS 注册代码接入 | “uni-app 离线推送怎么接” |
| | HarmonyOS / React Native / 微信小程序多端框架 / Unity / Unreal Engine | 按产品文档引导：自动检索腾讯云对应平台的 SDK 接入文档，指导完成依赖配置、证书与注册代码接入 | “鸿蒙怎么接入 TIMPush”“React Native 怎么接离线推送” |
| 排障 | Android | 内置排障向导 + 知识库：逐步排查注册报错（如 800006）、在线/前台不弹通知、离线收不到、厂商已送达不展示、强杀不达、点击不跳转/拿不到 ext、消息分类限额等 | “Android 离线推送收不到”“registerPush 报 800006” |
| | iOS | 内置排障向导 + 知识库：逐步排查 errCode 3000、403 InvalidProviderToken、bad devicetoken、证书与 Token 不匹配、点击拿不到 ext、角标异常等 | “iOS registerPush 成功但收不到推送” |
| | HarmonyOS | 内置排障向导 + 知识库：逐步排查 80300002、1000900010、离线收不到、点击通知崩溃（useNormalizedOHMUrl）等 | “鸿蒙收不到推送”“鸿蒙点击通知崩溃” |
| | Flutter | 内置排障向导 + 知识库：逐步排查 FCM 未初始化、调用 registerPush 后账号被踢、点击通知不触发 onNotificationClicked 及双端原生通道问题 | “Flutter 点击通知不触发回调” |
| | uni-app | 内置排障向导 + 知识库：逐步排查标准基座无厂商通道、原生配置路径错误、离线收不到与点击回调问题 | “uni-app 收不到离线推送” |
| | React Native / 微信小程序多端框架 / Unity / Unreal Engine | 按产品文档引导：结合腾讯云排查流程、常见问题与错误码文档，定位各平台推送与回调异常 | “React Native 推送收不到怎么查”“Unity 离线推送收不到” |
| IM SDK 日志分析 | | 指导采集客户端 xlog 日志，本地解码并提取 registerPush、Token 上报与离线推送证据链 | “帮我分析这段 IM 日志”“xlog 里有没有 registerPush” |
| 自动发测试推送与检查控制台配置 | | 在 MCP 环境变量中配置管理员凭据后，Agent 可自动检查控制台证书是否与工程一致、代发前后台/杀进程三态测试推送、查询设备绑定状态并追踪送达轨迹（凭据仅在本机读取，不写入工程或聊天；未配置时自动改走控制台手动步骤） | “开启控制台自动核对”“帮我检查控制台证书配置”“给当前用户发一条测试推送” |
三、安装到 AI IDE
如果你使用 Cursor、Claude Code、CodeBuddy、Codex 等 AI IDE，在项目目录中执行：
# cd 到项目根目录cd root-directory-of-your-app-project# 自动检测本机已安装的 IDE 并安装到全部 IDEnpx -y @tencent-rtc/trtc-push-skill@latest add# 只安装到指定 AI IDEnpx -y @tencent-rtc/trtc-push-skill@latest add –ide cursornpx -y @tencent-rtc/trtc-push-skill@latest add –ide claudenpx -y @tencent-rtc/trtc-push-skill@latest add –ide codebuddynpx -y @tencent-rtc/trtc-push-skill@latest add –ide codex
四、安装到 Coding IDE 的 AI 插件
如果你使用的是传统 Coding IDE 中的 AI 插件，也可以使用同一个安装器。常见形态包括：
·Android Studio / IntelliJ IDEA / JetBrains 系 IDE 中的 CodeBuddy 插件。
·Visual Studio Code / Cursor 系 IDE 中的 Cursor 插件或兼容 Cursor 项目配置的插件。
·Visual Studio Code / JetBrains 系 IDE 中支持 MCP 或 Agent Skill 项目配置的 AI 编程插件。
·其他能读取项目级 .cursor/、.codebuddy/、.claude/、.codex/ 配置目录的 AI 插件。
当前安装器直接支持的 –ide 参数为 cursor、claude、codebuddy、codex。如果插件兼容其中一种项目配置目录，可以选择对应参数安装。
示例1：Android Studio + CodeBuddy 插件
在 Android Studio 中使用 CodeBuddy 插件时，在 Android 工程内执行：
npx -y @tencent-rtc/trtc-push-skill@latest add –ide codebuddy
安装后会在当前项目下生成 .codebuddy/skills/ 和项目根 .mcp.json，重启 Android Studio 或重新加载 CodeBuddy 插件后即可使用。
示例2：VSCode / Cursor 插件
在 Visual Studio Code 中使用 Cursor 相关插件或兼容 Cursor 配置的插件时，在项目内执行：
npx -y @tencent-rtc/trtc-push-skill@latest add –ide cursor
安装后会在当前项目下生成 .cursor/skills/ 和 .cursor/mcp.json。
五、安装后自查：确认 MCP 已开启
Skill 通过 trtc-push-mcp MCP server 驱动向导式流程。无论用哪种方式安装，只有 MCP 已启用并加载后流程才能工作。按下表自查。
安装到 AI IDE：
| IDE | 启用动作 |
| Cursor | 项目级 MCP 默认禁用（新版 Cursor 不再有弹窗提示）。打开 Cursor Settings > Customize > MCPs，打开 trtc-push-mcp 开关，然后重载窗口。 |
| Claude Code | 无需操作。安装器已在 .claude/settings.local.json 中预批准。重启 claude 会话即可；若仍提示审批，用 /mcp 批准。 |
| CodeBuddy | 无需操作。MCP 从项目根 .mcp.json 自动启用。重载 CodeBuddy 即可。 |
| Codex | 在项目中运行 codex 并接受 trust 提示，项目 .codex/config.toml（含 MCP）才会加载。 |
安装到 Coding IDE 的 AI 插件：
| 插件形态 | MCP 配置位置 | 启用动作 |
| Android Studio /JetBrains + CodeBuddy 插件 | 项目根 .mcp.json | 重启 IDE 或重新加载 CodeBuddy 插件。 |
| VS Code / Cursor 系插件 | .cursor/mcp.json | 在插件 MCP 面板启用 trtc-push-mcp，然后 重启 IDE。 |
| 其他兼容插件 | 取决于插件读取的配置目录（.cursor/ / .codebuddy/ / .claude/ / .codex/） | 确认配置已生成，在插件内启用后重启 IDE。 |
六、使用方式
安装完成并重启 IDE / 插件后，在 Agent 对话中直接输入：
帮我集成 TIMPush
或者：
我的 Android 离线推送收不到，帮我排查
iOS registerPush 成功了，但杀进程后收不到离线推送
七、诊断与隐私说明
首次在项目中使用时，助手会询问当前项目的诊断数据共享方式，未选择前不会收集或上报任何数据：
·开启完整诊断与体验优化（推荐）：允许收集经脱敏处理的 TIMPush 相关提示词及基础运行诊断信息。
·仅开启基础运行诊断（不收集对话提示词）：不收集任何对话提示词原文，仅上报工具调用状态与 SDKAppID（腾讯云后台已有的应用公开编号，非隐私密钥，仅用于优化接入体验与快速定位异常）。
·全部关闭：不收集且不上报任何数据（不影响正常使用所有功能）。
即使开启诊断，工具也只会做本地脱敏，绝不收集或上传 SecretKey、UserSig、证书私钥等敏感凭据及项目源码。后续你可随时在对话中说“修改/关闭 TIMPush 诊断上报”来更改当前项目的设置。