# TapTap CLI Skill: 身份与上下文定位

TapTap CLI 的身份与资源发现能力：确认登录状态、查看当前 CLI 上下文、列出可见厂商和游戏，并在用户明确要求时保存当前开发者和游戏上下文。

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

## 摘要

| Skill ID | 分组 | 类型 | 作用域 | 主要命令数 | 确认要求 |
| --- | --- | --- | --- | --- | --- |
| taptap-identity | CLI & discovery | alwaysActive context | Global / Developer / App | 7 | 无 |

## 行为与边界

`overview` 用于一次查看登录状态、厂商、游戏样例和下一步；需要完整游戏列表时，再对明确的开发者使用 `app +list --page-all --page-size 50`。只给名称时必须先查候选，多结果让用户选择。

`developer +enter` 和 `app +select` 会校验资源归属并保存当前 CLI 上下文；它们不会切换浏览器页面。未保存上下文时，后续业务命令仍应显式带 `--dev-id` / `--app-id`，显式参数始终优先。

> 不要猜 `developerId` 或 `appId`，也不要复用可能过期的历史 ID。资源查询失败不等于没有资源；先按错误分类解释登录、权限、网络或无匹配，并给可执行下一步。

## 能力摘要

- 账号总览：登录态、可见厂商、游戏样例、推荐问题和下一步。

- 查当前 CLI scope 与已保存的开发者 / 游戏上下文。

- 发现当前账号可见的厂商，并输出开发者级推荐问题。

- 按关键字或连续分页列出某厂商下的游戏。

- 校验并保存当前开发者和游戏的 CLI 上下文。

## 你可以这样问

- 我现在登录的是哪个账号？这个账号能管理哪些厂商和游戏？

- 我只记得游戏名，能帮我找出它属于哪个厂商吗？

- 我想找某个厂商名下的游戏，可以帮我列出来吗？

## 示例

```bash
taptap-cli overview
taptap-cli skills read taptap-identity
taptap-cli developer +list
taptap-cli app +list --dev-id <developerId> --kw 虚空狩猎
taptap-cli app +select --dev-id <developerId> --app-id <appId>
```

## 用户可见输出边界

默认只输出当前登录与 CLI scope、可选厂商 / 游戏名称、必要 ID、页面链接和下一步建议。默认**不转述**凭证来源细节、完整 raw JSON、分页内部结构、上游接口路径或历史 scope 解析过程；保存 CLI scope 不能说成已切换网页。

## 主要命令

| 命令 | 类型 | 说明 | 输入 | 输出 | 注意事项 |
| --- | --- | --- | --- | --- | --- |
| overview | 只读 | 汇总登录态、厂商、游戏样例和下一步 | developerId?、pageSize? | 账号范围总览 + 游戏样例 | 只返回样例；完整列表改用 app +list --page-all |
| auth status | 只读 | 检查登录、服务与当前 CLI scope | 无入参 | 登录状态 + 当前开发者 / 游戏上下文 | 只有登录或权限异常时才需要重复检查 |
| developer +list | 只读 | 列出当前账号可见的全部厂商 | 无入参 | 厂商候选列表 | 多候选时让用户选择，不自动取第一个 |
| developer +enter | 写入 | 校验并保存开发者 CLI scope | developerId | 保存后的 scope | 会保存 CLI 上下文；不会切换网页状态 |
| developer +suggest | 只读 | 只输出开发者级推荐问题 | developerId | 推荐问题和下一步 | 只读，不保存开发者 CLI scope |
| app +list | 只读 | 按关键字或分页查询厂商下的游戏 | developerId、kw?、page?、pageSize?、pageAll? | 游戏候选 + 分页信息 | 需要完整列表时使用 --page-all --page-size 50 |
| app +select | 写入 | 校验游戏归属并保存开发者 / 游戏 CLI scope | developerId、appId | 保存后的 app scope | 不会切换网页；显式参数始终优先 |

## 相关能力

- taptap-cli — 统一入口，按路由表把请求分发到本 skill 与各业务 skill。

- 开发者资料能力 — 按昵称解析厂商制作人员 / 官方号。