Rainytoken/docs/实测-凭据提取.md

实测凭据提取指南（仅用于功能验证，绝不写入代码/提交）

目标：为 RainyToken 三家新供应商做「实测优先」验证。 凭据只在本机实测时临时使用，用完即弃；不会进入 Git 历史或仓库文件。

✅ 实测进度（2026-09，goal round 5）

• Sub2API：已用真实 sk- Key 实测通（GET /v1/usage），字段校准完成。
• Trae：已实测通（authorized 登录态调 api.trae.cn ide_user_ent_usage，HTTP 200）， 权威口径 usage_summary.total_amount - consumed_amount，无需 X-Device-Id/X-User-Region 头。
• WorkBuddy：已实测通（authorized 登录态调 workbuddy.cn billing/meter/get-user-resource-summary， HTTP 200），data.Packages[].Cycle{Total,Remain,Used,Frozen}Capacity + CapacityUnit。
• 以下步骤保留作「他人/日后自助提取」参考。

---

1. Trae —— 提取 Cloud-IDE-JWT（点击级步骤，5 分钟）

RainyToken 用 Authorization: Cloud-IDE-JWT <jwt> 认证（官方 IDE 同款）。 推荐在浏览器 Web IDE 上抓（Chrome / Edge 都行）：

步骤

1. 打开 Chrome 或 Edge，访问 https://www.trae.cn 并登录你的 Trae 账号；
2. 按 F12 打开开发者工具 → 切到 Network（网络） 标签；
   • 建议勾选日志左上角的 Preserve log（保留日志），避免跳转丢记录；
3. 保持 DevTools 开着，访问 https://ide.trae.cn（或点右上角「进入 IDE / Web IDE」）。页面加载时会自动发一堆请求；
4. 在 Network 顶部的 Filter（过滤） 输入框里输入 ent_usage；
5. 找到名为 ide_user_ent_usage 的请求（方法 POST，域名 api.trae.cn 或 grow-normal.trae.ai）：
   • 点击它 → 右侧切到 Headers → 往下到 Request Headers；
   • 找到 Authorization 一行，值是 Cloud-IDE-JWT eyJ…；
   • 复制 Cloud-IDE-JWT 后面的整段 eyJ…（JWT 三段、以点分隔，很长）；
6. 告诉我：
   • 这个 JWT；
   • 你的区域：域名/请求是 api.trae.cn → CN；是 grow-normal.trae.ai → INTL（对应请求头 X-User-Region）。

校验（防止复制错）

• 复制的内容应以 eyJ 开头，形如 eyJhbGciOiJIUzI1NiJ9.eyJ…。….（三个点分片）；
• 如果抓到的是 Cloud-IDE-V2 / Cookie / Bearer 开头的值，则不是这个 JWT，换一个请求再看；
• 若 ent_usage 过滤为空：到 账户/配额页（trae.cn 头像 → 用量/套餐）点一下刷新，同时清空 Filter 输入 pay 或 ide_user 再找。

备选（浏览器方案无效时）

• 桌面 Trae IDE 里查看「额度/套餐」面板并打开系统代理抓包（Charles/Fiddler 需装根证书，较麻烦）；
• 或告诉我，我改成其它抓取路径（如 CLI 登录态文件）。

JWT 约 14 天有效；只用于实测，用完即弃，绝不写入仓库/提交。

---

2. WorkBuddy / CodeBuddy —— 需要 accessToken + refreshToken（OAuth Bearer）

腾讯 WorkBuddy 与 CodeBuddy 共用积分体系，实测走官方 CLI 插件协议：

1. 安装 CodeBuddy CLI（npm i -g @codebuddy/cli 或官方安装包）并登录；
2. 或直接抓浏览器：登录 https://www.codebuddy.cn / copilot.tencent.com 后在开发者工具 Network 里找 get-user-resource 请求的 Authorization: Bearer ；
3. refreshToken 一般可从浏览器的本地存储 / CLI 的 ~/.codebuddy/auth 之类配置里读到 （名为 refresh_token / X-Refresh-Token 对应字段）。

若你不想装 CLI，告诉我你平时怎么用 WorkBuddy/CodeBuddy，我改写成对应抓法。

---

3. Sub2API —— ✅ 已实测确认（xxcsn.site，2026-09）：普通用户用自己的 sk- API Key 即可，无需管理员

• 接口：GET {实例基址}/v1/usage，请求头 Authorization: Bearer <你的 sk-… API Key>
• 返回：remaining / balance（剩余余额）、unit（如 USD）、usage.total.cost（累计花费）、 model_stats[]（分模型）、daily_usage[]（按日）。
• RainyToken 填：实例地址 + 你账号的 sk-… Key（推荐）；无 Key 可用面板账号邮箱+密码登录（/api/v1/auth/login → Bearer token）。
• 兜底：/v1/usage 404 时自动尝试 /api/v1/usage。

---

留下什么

• 你在下一条消息里按上面任一项贴出凭据（可先只给一个供应商）；我会：
  1. 直接用 curl 验证官方接口的真实响应结构；
  2. 对照校准我方仓库的字段解析（TraeRepository / WorkBuddyRepository / Sub2ApiRepository）；
  3. 在你提供后当场删除，不落入任何文件。