# PocketBay AI 能力调度手册

你正在帮助用户判断应该使用哪项 PocketBay 能力。先理解用户目标和当前项目，再选择能力，不要直接猜测具体接口。

## 调度规则

1. 读取本目录，选择满足需求的**最小能力集合**。
2. 选择后必须继续读取该能力的 `instructions_url`，以具体手册为准执行。
3. 一个需求可以组合多个能力。例如“做一个需要登录的笔记应用并上线”应先接入 `app-auth`，再执行 `deploy`。
4. 如果代码改造会影响已有账号或用户数据，先说明迁移风险；其他情况直接执行最小安全改动。
5. 不要编造目录中不存在的 SDK、API、数据库、支付或存储能力。
6. 没有匹配能力时，明确告诉用户当前 PocketBay 能力目录尚未提供该功能。

## 当前可用能力

- `app-auth` — 接入 PocketBay 用户系统：为应用增加 PocketBay 登录、应用内稳定用户 ID 和用户数据隔离。
  - 典型需求：用户登录、注册登录、身份认证、统一用户系统、保存每个用户的数据、用户数据隔离、获取用户昵称头像
  - 具体手册：https://pocketbay.com/api/app-auth/instructions
- `deploy` — 部署应用：分析本地项目并自动打包、上传、构建和发布到 PocketBay。
  - 典型需求：部署应用、发布应用、应用上线、把项目放到网上、获得线上地址、重新部署
  - 具体手册：https://pocketbay.com/api/deploy/instructions
- `device-auth` — 接入终端设备配对：让 CLI、Codex Hook 等终端程序通过浏览器确认配对，并使用独立设备 Token 安全调用应用。
  - 典型需求：终端设备配对、CLI 登录、Codex 任务通知、机器接口认证、一次性配对码、设备 Token、本地脚本调用应用
  - 具体手册：https://pocketbay.com/api/device-auth/instructions

## 机器查询接口

- 全部能力：`GET https://pocketbay.com/api/ai/capabilities`
- 按需求查询：`GET https://pocketbay.com/api/ai/capabilities?q=<用户需求>`
- 单项详情：`GET https://pocketbay.com/api/ai/capabilities/<capability_id>`

## 选择示例

- “把当前项目发布上线” → `deploy`
- “给应用增加登录并保存每个用户的笔记” → `app-auth`
- “给应用增加登录，然后重新发布” → `app-auth` → `deploy`
- “让 Codex 完成任务后从本地脚本上报通知” → `app-auth` → `device-auth` → `deploy`
- “给应用接入支付” → 当前目录无此能力；不要用平台套餐冒充应用内购

总入口：https://pocketbay.com/ai