# TapTap CLI

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

- 网页版: /v3/cli/
- Markdown: /v3/cli/get-started/overview.md

## 文档页面

- [命令参考](/v3/cli/command-reference.md)

- [AI 能力参考](/v3/cli/skill-reference.md)

- [CLI 入口与路由](/v3/cli/skills/taptap-cli.md)

- [身份与上下文定位](/v3/cli/skills/taptap-identity.md)

- [创建游戏](/v3/cli/skills/taptap-publish-game.md)

- [资料编辑与版本发布](/v3/cli/skills/taptap-app-edit.md)

- [上架资质](/v3/cli/skills/taptap-qualification.md)

- [包体管理与自测](/v3/cli/skills/taptap-package-management.md)

- [测试计划](/v3/cli/skills/taptap-test-plan.md)

- [数据表现](/v3/cli/skills/taptap-dashboard-stats.md)

- [图片素材库](/v3/cli/skills/taptap-asset-library.md)

- [玩家评价](/v3/cli/skills/taptap-player-feedback.md)

## 安装

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

验证安装：

```bash
taptap-cli version
```

## 认证

运行认证命令后打开 CLI 返回的 TapTap 登录链接完成授权：

```bash
taptap-cli auth login
```

## 安装 AI Skills

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

```bash
taptap-cli skills list
```

## 更新 CLI

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

```bash
taptap-cli update
```

## 常见起手任务

- [创建游戏](/v3/cli/skills/taptap-publish-game.md): 创建草稿，并继续准备资料、包体和提审。

- [补齐资料与包体](/v3/cli/skills/taptap-app-edit.md): 补齐基础资料、宣传素材和安装包。

- [包体管理](/v3/cli/skills/taptap-package-management.md): 查看线上包、待处理包和平台包状态。

- [测试计划](/v3/cli/skills/taptap-test-plan.md): 管理测试计划、招募、资格和激活码。

- [上架资质](/v3/cli/skills/taptap-qualification.md): 分析资质缺口，维护非敏感材料和增量审核。

- [图片素材库](/v3/cli/skills/taptap-asset-library.md): 按使用场景检索、批量筛选和收录图片素材。

- [数据表现](/v3/cli/skills/taptap-dashboard-stats.md): 查询下载、曝光、转化、订单、评分等趋势。

- [玩家评价](/v3/cli/skills/taptap-player-feedback.md): 按评分、关键字和时间检索评价正文与回复。

## 你可以这么问

- 我只记得游戏名，能帮我找出它属于哪个厂商吗？: 先找到正确的厂商和游戏，再继续处理。

- 这个游戏现在还缺哪些内容，什么时候可以提交审核？: 查看游戏当前还缺什么，以及是否具备提交审核的条件。

- 我想新增一个游戏，需要准备哪些信息？: 了解新增游戏需要准备的基本信息。

- 这个游戏最近的数据表现怎么样？: 用合适的数据说明游戏最近的表现。

## 常用命令路径

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

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

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

```bash
taptap-cli --help
taptap-cli app --help
taptap-cli schema app create-app
```

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

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

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

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

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

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

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

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

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

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

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

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

## 下一步

- [命令参考](/v3/cli/command-reference.md): 查看全局参数、认证、AI 能力说明、命令树、错误说明和上传命令。

- [AI 能力参考](/v3/cli/skill-reference.md): 按业务模块浏览当前开放的 AI 能力。

- [命令行工具（CLI）入口与路由](/v3/cli/skills/taptap-cli.md): 了解上下文发现、路由和 CLI 使用顺序。

- [创建游戏](/v3/cli/skills/taptap-publish-game.md): 查看创建草稿、确认字段和后续发布准备。