TapTap 数据技能安装器

把 TapTap 数据团队维护的 skill(数据查询、分析、报告等)和它们依赖的知识库 / MCP 服务,一键装到本机检测到的所有 AI 编辑器(Claude Code / Cursor / Codex / OpenClaw),并保持版本同步。

装一个 skill

export DVIEW_MCP_TOKEN=<你的 service token>
npx @zhoufeng7z7/data-skills-test add <skill-name>

第一次运行会自动:

• 把 skill 文件装到检测到的每个 AI 编辑器
• 从服务端拉对应知识库(KB)缓存到本机
• 给需要 MCP 服务的 skill 写好编辑器配置

后续运行只做增量同步,跳过没变的部分。

看本机装了什么

npx @zhoufeng7z7/data-skills-test list                 # 已装的
npx @zhoufeng7z7/data-skills-test list --available     # 可装的
npx @zhoufeng7z7/data-skills-test info <name>          # 某个 skill 的版本/路径详情

升级 / 同步 / 卸载

npx @zhoufeng7z7/data-skills-test update [<name>]      # 升到 catalog 最新版本(不传名字 = 全部)
npx @zhoufeng7z7/data-skills-test sync-kb <name>       # 只刷新知识库,不动 skill 文件/MCP
npx @zhoufeng7z7/data-skills-test remove <name>        # 卸载,KB 缓存默认保留(下次 add 命中)

只想装到部分编辑器

默认装到本机所有检测到的 host(Claude Code / Cursor / Codex / OpenClaw)。可以显式选:

npx @zhoufeng7z7/data-skills-test add <name> --agent claude-code cursor

鉴权

下载知识库需要服务端 service token,通过 DVIEW_MCP_TOKEN 环境变量传入。容器 / CI / 无浏览器环境必须用 token。普通桌面环境配过持久化 SSO 凭据时,token 缺失会回退到 SSO 凭据。

# 推荐:静默读入,token 不进 shell history
read -rs "?DVIEW_MCP_TOKEN: " DVIEW_MCP_TOKEN
export DVIEW_MCP_TOKEN

Token 申请请联系 TapTap 数据团队。

排障

npx @zhoufeng7z7/data-skills-test doctor               # 一键自检
npx @zhoufeng7z7/data-skills-test doctor --report > /tmp/report.md

doctor --report 生成可发给维护者的报告,自动剥离敏感信息(token、SSO 凭据、绝对路径中的 $HOME 段)。报告里不会包含你的 token / 主机名 / 私有路径。

从旧版迁移

如果机器上有 @taptap-internal/data-analysis-skill 的残留:

npx @zhoufeng7z7/data-skills-test migrate

会安全把老 setup 搬到新 wrapper 下,不丢配置。

如果遇到问题

1. 先跑 doctor
2. 再跑 doctor --report 把生成的 markdown 报告发给数据团队 maintainer
3. 报告里包含 wrapper 版本 / 安装清单 / 各 host 路径状态(已脱敏),够 maintainer 定位大部分问题