TapTapDeveloper Docs
开发者中心

开始使用

TapTap CLI

在命令行中完成 TapTap 游戏创建、素材上传、资料发布和运营管理。

taptap-cli 是连接本地环境与 TapTap 开发者中心的命令行工具。你可以直接在终端运行命令，也可以把本页内容提供给 AI 助手，让它帮你选择命令和填写参数。遇到创建游戏、上传素材、提交审核或发布等操作时，AI 会先说明准备执行的内容，等你确认后再继续。

安装

npm i -g @taptap/cli --registry=https://registry.npmjs.org/

安装完成后，你可以直接在终端运行 CLI 命令；如果不熟悉命令，也可以继续配置 AI 协助使用。

验证安装情况：

taptap-cli version

认证

登录以将 CLI 连接到你的 TapTap 开发者账号：

taptap-cli auth login

运行命令后打开 CLI 返回的 TapTap 登录链接完成授权。登录后，CLI 会在本地安全保存凭据，供后续创建游戏、上传素材和发布运营流程使用。

安装 AI Skills

AI 能力说明（Skill）随 CLI 一起提供，与当前 CLI 版本严格对应；CLI 更新时会一并同步。

查看已同步的 Skill：

taptap-cli skills list

更新 CLI

将全局安装的 TapTap CLI 更新到当前默认版本：

taptap-cli update

更新通过官方 npm registry 完成，需要能够访问 npm registry，并具备全局 npm 包写入权限。

更新会一并同步与 CLI 版本匹配的 AI 能力说明（Skill）；需要强制重新同步时用 taptap-cli update --force。

常见起手任务

从身份定位、创建游戏、补齐资料与资质、管理包体和素材、分析数据开始；点击卡片查看对应能力。

你可以这么问

这些问题直接来自各 CLI 能力说明中的用户意图，可用于定位厂商、查看数据、创建游戏和检查资质。

常用命令路径

这几条路径覆盖第一次定位对象、读取能力地图、上传文件并继续执行工具。

当用户只说「这个游戏」「某个厂商」或给出一个名字时，先用这组命令找到真实厂商和游戏。进入上下文后，后续命令才能围绕正确对象查询资料、包体、测试、权限等业务状态。

taptap-cli developer +listtaptap-cli app +list --dev-id <developerId> --kw <keyword>

开始业务调用前，先查看顶层帮助和目标业务域；再用 schema <service> <method> 核对参数、风险等级与返回结构。

taptap-cli --helptaptap-cli app --helptaptap-cli schema app create-app

先用完全相同的请求数据和幂等键预览；用户明确确认后追加 --yes 创建游戏草稿。创建成功后仍需补齐资料、包体、资质并单独确认提审。

taptap-cli app create-app --dev-id <developerId> --data '{"title":"<gameName>","category":"adventure","developer_role":"developer","package_type":"apk"}' --idempotency-key <create-key> --dry-runtaptap-cli app create-app --dev-id <developerId> --data @create-app.json --idempotency-key <create-key> --yes

本地文件上传属于写操作。先用 --dry-run 预览，确认后再用 --yes 上传；图片成功后会自动收录到素材库，后续工具才能引用这些素材继续补资料。

taptap-cli upload ./icon.png --app-id <appId> --dev-id <developerId> --dry-runtaptap-cli upload ./icon.png --app-id <appId> --dev-id <developerId> --yes

读取当前游戏资料和草稿状态，检查图标、截图、包体、资质和提审前缺口，决定下一步要补哪些内容。

taptap-cli app analyze-app-status --dev-id <developerId> --app-id <appId>

只有用户明确要求提审后才生成复核快照。保存返回的 review_fingerprint，后续预检和正式提交必须原样携带该指纹与相同的 release_schedule。

taptap-cli app prepare-review-snapshot --dev-id <developerId> --app-id <appId> --data '{"release_schedule":{"kind":"immediate"}}'

预检不正式提交审核，请求中复用上一步的指纹与上线方式。

taptap-cli app precheck-app-review --dev-id <developerId> --app-id <appId> --data @review-precheck.json

预检完成后展示阻塞项、风险和协议要求，并再次取得最终确认。正式提交是 high-risk-write；写入结果未知时先读取服务端状态，不更换幂等键盲目重试。

taptap-cli app submit-app-review --dev-id <developerId> --app-id <appId> --data @review-submit.json --idempotency-key <submit-key> --yes

下一步