腾讯云 RUM SDK 接入助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @tencent-adm/rum-sdk-setup。
技能介绍
解决的问题
前端项目接入腾讯云 RUM 时,常见问题不是“会不会写 new Aegis()”,而是容易把 web、小程序、react-native、node 的 SDK 混用,或在已有初始化后重复插入导致双重上报。RUM SDK-Setup 面向这类接入场景,先确认项目类型、上报地域、SDK 包和入口文件,再生成最小侵入的初始化代码,帮助工程师把 SDK 安装到正确位置并留下可验证、可回滚的结果。
工作方式
技能按“检测 → 选择 → 安装 → 生成 → 校验”的流程推进:
- 项目检测:通过脚本识别
projectType、framework、packageManager、entryFiles,并输出hasExistingAegis、installedAegisPackages、detectedPlatforms等字段。复合项目会要求先确认接入端。 - 包与地域匹配:按
web-*、miniprogram-*、react-native、node等平台选择对应aegis-*-sdk,并核对rumt-zh.com、rumt-sg.com、rumt-us.com等上报域名。 - 代码生成:优先创建独立文件,
import放在入口顶部,保持 TS/JS、ESM/CJS 语法一致;Web SPA 可配置spa: true,Vue 项目提醒配置errorHandler。 - 校验与交付:生成后会检查初始化位置、占位符是否替换、是否有类型错误,并给出修改清单、验证步骤和回滚说明,避免接入后无法撤销。
适用边界
适合做 RUM SDK 接入、安装、配置监控能力、自定义上报和排查接入问题。不适用于查询分析已上报数据、后端 APM 或非腾讯云监控。若用户给出的 ID 以 AKID 开头,应提醒这可能是云 API 密钥,而不是公开上报 ID。
使用场景
- 在 Vue3 Web 项目接入腾讯云 RUM,需选择 web SDK、配置 spa 与上报域名,并避免重复初始化。
- 在 Taro 混合项目里判断接入 H5 还是小程序端,再生成对应 Aegis 初始化文件和回滚说明。
- 给小程序增加 RUM 监控,需安装对应 mp SDK、提醒安全域名,并检查 app 入口是否已初始化。
- 排查已有 Aegis 接入后的重复上报,需检测依赖和源码初始化,再决定升级、改配置或重新接入。
适合人员
- 负责前端上线质量的前端工程师,需要把 RUM 安全接入 Web 或混合项目,并留下可验证的修改记录。
- 维护小程序业务的小程序工程师,需要在 app 入口配置监控,同时避免正式环境因安全域名被拦截。
- 接手旧仓库的工程师,需要先确认项目是否已有 Aegis 初始化,再避免重复接入导致双重上报。
- 需要前端监控方案的团队负责人,需要一套可校验、可回滚的 SDK 接入流程,而不是直接改入口文件。