# TapTap CLI Skill: 包体管理与自测

查询游戏「包体管理」页状态，支持 APK、Windows、小游戏、H5、TapTap 制造包体诊断与自测流程，包含线上 / 待处理包、使用场景标签、可见页面标签与二维码自测目标。

- 网页版: /v3/cli/#skill-taptap-package-management
- Markdown: /v3/cli/skills/taptap-package-management.md

## 摘要

| Skill ID | 分组 | 类型 | 作用域 | 主要命令数 | 确认要求 |
| --- | --- | --- | --- | --- | --- |
| taptap-package-management | Application lifecycle | 命令调用 | 应用 | 3 | 有（小游戏能力开通需确认） |

## 行为与边界

查询当前应用「包体管理」页的包体概览，覆盖 APK、Windows、小游戏、H5、TapTap 制造五类包体。既可以按你指定的包体类型查询，也可以在你泛问“当前包体 / 版本号”时自动识别页面上真实可见的包体类型：只有一类时直接给结果，有多类时列出选项让你确认。

各类包体会呈现对应的核心信息：APK 展示主包及云玩 / TapPlay / 云微端 / 模拟器的使用场景，Windows 展示处理与审核状态、当前使用包，小游戏展示线上 / 审核 / 开发三类版本，H5 展示当前线上 / 最新 / 最低运行版本，TapTap 制造展示绑定的 Spark 项目版本。

自测方面，APK 与 Windows 提供页面引导，小游戏开发版本、H5、TapTap 制造先获取自测二维码目标，再用顶层 `test-qr-code` 生成 PNG。当小游戏包体库需要初始化 Tap 小游戏能力时，也可以在你确认后完成开通。

> 不要用包体概览替代资料草稿的 `app list-packages` / `select-package` / `clear-package`。Tap 小游戏上传不调用 CLI 上传命令；只使用本次概览实际返回的非空 `page_path`，没有值时不生成或拼接链接。

## 能力摘要

- APK 主包列表 + 云玩 / TapPlay / 云微端 / 模拟器使用场景状态。

- Windows 包处理 / 审核状态与当前使用包。

- 小游戏线上 / 审核 / 开发三分段版本。

- H5 当前线上 / 最新 / 最低运行版本。

- TapTap 制造绑定空态与版本识别（不编造版本）。

- 按真实可见页面标签处理自测意图；小游戏开发版本 / H5 / TapTap 制造可获取二维码目标，再生成并展示二维码 PNG。

## 你可以这样问

- 这个游戏现在有哪些包体，哪个版本在线上？

- 我想试玩一下当前版本，可以帮我找到可用的测试入口吗？

- 我有一个 APK、Windows 或 H5 包，可以帮我上传吗？上传后还需要做什么？

## 示例

```bash
taptap-cli skills read taptap-package-management
taptap-cli schema package-management get-package-overview
taptap-cli package-management get-package-overview --dev-id <developerId> --app-id <appId>
taptap-cli package-management get-package-overview --dev-id <developerId> --app-id <appId> --data '{"package_type":"mini_app"}'
taptap-cli test-qr-code --dev-id <developerId> --app-id <appId> --data '{"kind":"h5_version","package_type":"h5","package_id":"<packageId>"}' --output test-qr.png --json
```

## 用户可见输出边界

可以说：各包体列表、线上 / 待处理状态、Windows 当前使用包、小游戏三分段、H5 当前线上版本、TapTap 制造绑定空态、可见包体类型、自测需要选择哪个页面标签、二维码 PNG 已生成并展示、云玩 / TapPlay / 模拟器当前使用主包或分支包、云微端可选下载包状态。默认**不转述**原始接口、频道数值、状态数值、结构字段名、包体 ID、版本号或二维码链接；原始 ID 只在用户明确要排查 ID 或接口数据时展示。

## 主要命令

| 命令 | 类型 | 说明 | 输入 | 输出 | 注意事项 |
| --- | --- | --- | --- | --- | --- |
| package-management get-package-overview | 只读 | 查包体管理概览，支持 APK / Windows / 小游戏 / H5 / TapTap 制造状态、自测模式和页面路径 | 包体类型（可选；不传时按真实可见页面标签解析）、页码、每页数量、是否包含使用场景 | 包体列表、当前线上 / 待处理包、APK 使用场景状态、非 APK 生命周期标签、可见页面标签、自测模式、自测目标、页面路径、风险提示 | 只读；只查 APK 主包时可关闭使用场景查询以减少请求；分页按用户页码传，不自行拉全 |
| package-management enable-mini-app | 写入 | 确认式开通 Tap 小游戏能力，仅用于小游戏包体库前置初始化 | 包体类型（仅小游戏；确认由卡片完成，不传确认参数） | 开通结果或失败原因 | 只有概览明确提示需要开通且用户确认后才能调用；页面标签不可见时不要调用 |
| package-management get-test-qr-code | 只读 | 获取小游戏开发版本、H5 或 TapTap 制造包体自测二维码 | 自测目标（优先使用概览返回值）；兼容包体类型 + 包体 ID / 版本号 | 二维码目标数据 | 目标必须来自包体库概览；成功后再用顶层 test-qr-code --output <file>.png --json 生成并展示 PNG，不要只输出二维码链接 |

## 相关能力

- taptap-app-edit — 资料草稿里的包体槽位选择 / 清空（app list-packages / select-package / clear-package）。

- taptap-publish-game — 创建阶段的包体类型识别与上传。