概述
@tencent-rtc/trtc-push-skill 是腾讯云 TIMPush 提供的 Agent Skill。它可以帮助开发者在 Android、iOS、Flutter、uni-app、Harmony 等多台项目中完成 TIMPush 接入、厂商通道配置、APNs 配置、注册排障、角标、服务端 API 调试等工作。
安装后，直接在 AI IDE 或 Coding IDE 的 AI 插件里用自然语言描述需求，例如“帮我集成 TIMPush”，Agent 会自动识别项目平台，并调用配套能力逐步完成集成或排障。
能力清单
当您提到 TIMPush、离线推送、厂商通道或 APNs 等关键词时，Skill 会自动触发，无需斜杠命令。
场景 | 能力说明 | 示例 |
从零接入 | 自动识别 Android / iOS / Flutter / uni-app，按向导完成 SDK、凭据、配置文件、registerPush 和编译验证 | “帮我集成 TIMPush”、“接入腾讯云离线推送” |
Android 厂商通道 | 引导华为、小米、OPPO、vivo、荣耀、魅族、FCM 的控制台配置、签名指纹、包名一致性和凭据校验 | “帮我检查华为推送配置”、“Android 离线推送收不到” |
iOS APNs | 检查证书 / P8、Bundle ID、aps-environment、BusinessID、deviceToken 上报和注册流程 | “iOS registerPush 成功但离线推送不来” |
Flutter / uni-app | 按跨平台工程处理插件、原生通道和验证，避免误走纯 Android / iOS 向导 | “Flutter 项目接入 TIMPush”、“uni-app 离线推送怎么接” |
HarmonyOS 排障 | 引导纯血鸿蒙 / HarmonyOS NEXT 的注册失败、离线不达、点击崩溃（OHMUrl）等问题。当前无从零接入向导 | “鸿蒙收不到推送”、“鸿蒙点击崩溃” |
注册与回调排障 | 分析 registerPush、registrationID、错误码和回调日志 | “registerPush 报 800006”、“registrationID 获取不到” |
送达与展示排查 | 区分注册失败、服务端未下发、厂商已送达但不展示、杀进程不达、消息分类限额 | “离线推送有送达但不展示”、“强杀后收不到” |
点击跳转与回调 | 排查通知点击不跳转、指定页面、ext 为空、onNotificationClicked | “点击通知不跳转”、“点击拿不到 ext” |
IM SDK 日志分析 | 指导采集 xlog，本地解码并提取注册 / 离线推送证据链 | “帮我分析这段 IM 日志”、“xlog 里有没有 registerPush” |
安装指引
注意：
禁止使用
npm install 安装本包。npm install 只会下载 npm 包，不会安装 Skill，也不会配置 MCP Server。请使用下面的 npx 命令执行安装器。强烈推荐使用项目级安装。
安装到 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 侧边栏 > Customize > MCP，打开 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 成功了，但杀进程后收不到离线推送
