前言¶
接腾讯营销 DataNexus 数据采集 SDK，常见卡点不在「能不能搜到文档」，而在流程长、端型多：要先选对小程序 / 小游戏 / APP（iOS、Android、鸿蒙）或 JS SDK，再完成初始化、事件埋点、必报事件与 action_type 合规，最后还要联调、对账、看质量看板，报错时还要对着 code 51000、data not valid 等码排查。团队里若缺少统一 checklist，很容易在 user_action_set_id、secret_key、数据源 ID 等配置上反复试错。
下面介绍 SkillHub 上的企业级 Skill「腾讯营销 datanexus sdk 接入助手」，由腾讯营销 DataNexus 团队发布，把上述环节收敛为可在 AI IDE 里按步骤推进的助手能力；其中面向 AI IDE 的自动化接入标注为 Beta，已接入项目还可做接入体检。
这是什么¶
一句话定位：DataNexus 数据采集 SDK 的接入与治理助手，覆盖从选型到问题排查的完整链路，并支持在对话中触发「自动接入」「接入审计 / 体检」类诉求。
- 坐标：
@tencent-adm/datanexus-sdk-skills - 当前版本：1.0.2（SkillHub 页面展示为 v1.0.2）
- 来源：enterprise
- 分类：business-ops
- 发布者：腾讯营销 DataNexus 团队
- SkillHub：https://www.skillhub.cn/skills/tencent-adm/datanexus-sdk-skills
- 技能包地址：https://api.skillhub.cn/tencent-adm/datanexus-sdk-skills
- 标签：
requires_api_key=false（按 SkillHub 元数据，安装本 Skill 本身不要求配置 API Key）
核心功能¶
资料中明确列出的能力如下，分六块主线与两项扩展：
- SDK 选型：在小程序 SDK、小游戏 SDK、APP SDK（含 iOS、Android、鸿蒙）、JS SDK 等场景下协助判断该用哪类 SDK。
- 接入开发：围绕 SDK 初始化、接入流程、生成或整理接入代码等开发步骤给出可执行指引。
- 事件埋点：与事件上报、埋点、
action_type、行为清单，以及START_APP、PURCHASE、REGISTER等事件语义相关的实现与核对。 - 联调对账：对接 SDK 接入流程中的联调、数据对账，以及与 SDK 质量看板相关的核对思路。
- 质量评估：涉及必报事件、事件覆盖率、SDK 合规、埋点质量检查等评估维度。
- 问题排查：针对 SDK 报错、上报异常等场景协助定位（资料中举例包括
code 51000、data not valid等表述）。
扩展能力：
- 面向 AI IDE 的自动化接入（Beta）：在用户提出「接入 SDK」「自动接入」「帮我接入」「生成接入代码」等意图时，由助手按 Skill 内规范推进。
- 已接入项目接入体检：对应「检查接入」「审计接入」「audit」「体检」等诉求，对已接入工程做接入侧检查与审计向的协助。
Skill 的触发词在官方简介中写得很全：除上述能力外，当对话中出现「小程序SDK」「数据源ID」「SDK质量看板」「事件覆盖率」等关键词，或明确要选择 SDK 类型、排查上报问题、检查埋点质量时，Agent 应优先启用该 Skill。
安装与启用¶
安装方式以 SkillHub 官方说明为准：先按 SkillHub 安装与优先源配置 准备 skillhub CLI，再把技能装到当前 Agent 实际读取的 skills 目录（装错目录会导致 Agent 识别不到，文档要求使用 --dir）。
1、检查或安装 SkillHub CLI¶
command -v skillhub && skillhub --version
若未安装，可使用官方安装脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装本 Skill¶
skillhub install @tencent-adm/datanexus-sdk-skills --dir <当前 Agent 的 skills 目录>
SkillHub 页面也给出了面向 AI 的提示词式安装说明：让 Agent 根据 https://skillhub.cn/install/skillhub.md 安装 @tencent-adm/datanexus-sdk-skills。
3、各客户端 skills 目录（节选）¶
以下路径来自 SkillHub 安装文档，安装时请替换为你的环境实际目录：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或项目下的 .windsurf/skills/ |
安装后按你所用 Agent 的惯例重启或刷新技能索引，使新 Skill 生效。
典型用法¶
本 Skill 以对话与项目上下文驱动，没有单独列出与业务无关的「Hello World」命令；典型用法是在已打开工程的前提下，用自然语言对齐 DataNexus 接入任务，让助手按 Skill 内流程展开。
选型与接入开发
在对话中说明端型与目标，例如：「要在微信小程序里接入 DataNexus，帮我选择 SDK 类型并梳理 SDK 初始化步骤。」或：「生成 iOS SDK 接入代码骨架，需要配置 user_action_set_id 和 secret_key。」
埋点与必报事件
例如：「按行为清单补全 PURCHASE 和 REGISTER 的 action_type 埋点，并核对必报事件是否齐全。」
联调、对账与质量
例如：「走一遍 SDK 接入流程里的联调和对账，并对照 SDK 质量看板看事件覆盖率。」
排错
例如：「事件上报失败，报错里有 code 51000 / data not valid，帮我排查 SDK 上报问题。」
自动化接入（Beta）与体检
例如：「帮我自动接入 DataNexus JS SDK。」或：「对当前仓库做一次 SDK 接入体检 / audit。」
以上句式与官方简介中的 Use when 列表一致；实际输出仍依赖你仓库里的代码结构与 DataNexus 控制台侧配置，助手负责按 Skill 规范引导步骤而非替代官方控制台操作。
适用场景与注意¶
适合谁
- 正在或计划接入 DataNexus 数据采集 SDK 的前端、客户端、小游戏 / 小程序开发者。
- 需要在多端（iOS、Android、鸿蒙、JS、小程序、小游戏）之间统一接入话术与检查项的团队。
- 已接入但要做埋点质量、合规、覆盖率复盘，或要对老项目做接入审计 / 体检的工程。
使用上需注意
- 自动化接入为 Beta：生成或改动代码前应在版本管理中自行 review，并在测试环境完成联调与对账。
- 敏感配置：
secret_key、user_action_set_id、数据源 ID 等只应来自你的 DataNexus / 营销侧控制台，勿写入公开仓库；Skill 元数据标明requires_api_key=false指的是本 Skill 安装项本身，不表示业务上报不需要密钥。 - 数据以官方为准：SkillHub 上该 Skill 评分与下载量会随时间变化（页面统计与商店列表可能不完全一致），接入行为与事件定义仍以腾讯营销 DataNexus 官方文档与控制台为准。
- 安装路径：务必
skillhub install ... --dir指向当前 IDE Agent 的 skills 目录，避免装到默认./skills/导致不生效。
结尾¶
「腾讯营销 datanexus sdk 接入助手」把 DataNexus SDK 选型、接入开发、事件埋点、联调对账、质量评估、问题排查串成一条可在 AI IDE 里执行的助手链路，并补充 Beta 级自动接入与接入体检能力。若你正在处理 SDK 初始化、埋点、action_type 或上报报错，可在安装 @tencent-adm/datanexus-sdk-skills 后直接用语义明确的接入 / 审计诉求唤起该 Skill。
- SkillHub 页面：https://www.skillhub.cn/skills/tencent-adm/datanexus-sdk-skills
- 技能包地址：https://api.skillhub.cn/tencent-adm/datanexus-sdk-skills
- 安装说明：https://skillhub.cn/install/skillhub.md
