creditdaddy 1.2.0 → 1.3.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 CreditDaddy contributors
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 CreditDaddy contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -4,7 +4,7 @@
 
 # CreditDaddy
 
-**AI 编程工具多账号本地管理 + 每日积分自动领取（领鸡蛋）助手：Qoder · WorkBuddy · ZCode · mirasim · 妙手 · Trae，集成 10Router 额度总览与用量同步**
+**AI 编程工具多账号本地管理 + 每日积分自动领取（领鸡蛋）助手：Qoder · WorkBuddy · ZCode · mirasim · 妙手 · Trae · MiniMax，集成 10Router 额度总览与用量同步**
 
 [![Release](https://img.shields.io/github/v/release/techysy/CreditDaddy?label=%E7%89%88%E6%9C%AC&color=2563eb)](https://github.com/techysy/CreditDaddy/releases/latest)
 [![CI](https://img.shields.io/github/actions/workflow/status/techysy/CreditDaddy/ci.yml?branch=main&label=CI)](https://github.com/techysy/CreditDaddy/actions/workflows/ci.yml)
@@ -59,11 +59,11 @@
 ## 功能
 
 **多账号管理与切换**
-- **仪表盘 + 分产品标签页**：首页仪表盘汇总账号总数、今日领取进度、剩余总积分、下次自动执行时间、各产品概况、待处理异常账号（token 失效 / 即将过期、领取失败）与最近领取审计；Qoder、WorkBuddy、ZCode、mirasim、妙手、Trae 各自独立标签页，卡片式展示，支持国内 / 国际版筛选，直观查看连续天数与额度包到期，自适应亮色 / 暗色主题。右上角「组件开关」可整块收起不使用的产品 / 10Router 标签页与仪表盘卡片（偏好保存在浏览器本地）。
-- **本机导入**：一键安全读取本机已登录的客户端凭据 —— 本地解密 Qoder / Qoder CN 的 `auth.v1.dat`，读取 WorkBuddy 客户端（当前与历史会话），解密 ZCode / mirasim / 妙手 / Trae 客户端凭据。敏感 Token 绝不出机器；同一用户续期时自动覆盖。
+- **仪表盘 + 分产品标签页**：首页仪表盘汇总账号总数、今日领取进度、剩余总积分、下次自动执行时间、各产品概况、待处理异常账号（token 失效 / 即将过期、领取失败）与最近领取审计；Qoder、WorkBuddy、ZCode、mirasim、妙手、Trae、MiniMax 各自独立标签页，卡片式展示，支持国内 / 国际版筛选，直观查看连续天数与额度包到期，自适应亮色 / 暗色主题。右上角「组件开关」可整块收起不使用的产品 / 10Router 标签页与仪表盘卡片（偏好保存在浏览器本地）。
+- **本机导入**：一键安全读取本机已登录的客户端凭据 —— 本地解密 Qoder / Qoder CN 的 `auth.v1.dat`，读取 WorkBuddy 客户端（当前与历史会话），解密 ZCode / mirasim / 妙手 / Trae 客户端凭据，读取 MiniMax Code 的 `~/.minimax` 登录记录。敏感 Token 绝不出机器；同一用户续期时自动覆盖。
 - **客户端一键换号**：一键将桌面客户端切换至指定账号（WorkBuddy 自动热切换；ZCode / mirasim / 妙手 / Trae 退出客户端后写回并自动重新拉起），切号前自动保存当前在线 Token，各账号拥有独立设备指纹，杜绝风控串号。
 - **内置隐私（无痕）授权**：桌面版提供隔离的一次性会话窗口进行网页登录授权，不污染系统浏览器 Cookie，支持同平台无缝扩增多账号。
-- **全流程浏览器登录**：支持三家产品线在面板内直接完成网页 / 设备码授权并入库 —— Qoder 设备码授权（PKCE + nonce）、WorkBuddy 状态轮询、ZCode CLI 轮询（支持智谱 BigModel 与 Z.ai）。
+- **全流程浏览器登录**：支持四家产品线在面板内直接完成网页 / 设备码授权并入库 —— Qoder 设备码授权（PKCE + nonce）、WorkBuddy 状态轮询、ZCode CLI 轮询（支持智谱 BigModel 与 Z.ai）、MiniMax 官方 OAuth 设备码授权（S256 PKCE）。
 
 **自动领取与资产保障**
 - **每日智能轮询**：本地守护进程每 ~2 小时自动扫描执行；当日已领成功的账号自动记忆跳过，未开启活动的账号不落记忆，以每日 10:00 (UTC+8) 刷新周期为准自动重试。
@@ -117,6 +117,12 @@
 - **有意不做自动续期**：Trae 的 refresh 会轮转 refreshToken 并作废 IDE 自己那份，等于把用户正在用的客户端踢下线，因此不提供自动续期。
 - **客户端切号**：按账号存 15 项登录态快照到 `~/.creditdaddy/trae-slots/<uid>/`，换走前先自动快照当前登录避免丢号；客户端在跑时拒绝切换（Trae 会把内存里的旧登录写回文件），强制切换后自动重新拉起。`x-device-id` 必须为纯数字设备号（传 GUID 触发 `code 9074`），优先取 `storage.json` 里 `iCubeAuthInfo://icube-dc:<数字>` 的键名后缀以与 IDE 自身指纹一致，缺失时按 uid 确定性派生。
 
+### MiniMax（MiniMax Code）
+- **账号来源**：两种方式——① 本机导入，读取 MiniMax Code 客户端的 `~/.minimax/auth/prod/cn/mcode-public/auth.json` 当前登录记录（明文文件，token 不出机）；② **浏览器登录**，走官方 OAuth 设备码授权（RFC 8628 + S256 PKCE），桌面版在内置隐私窗口打开 `account.minimax.cn/oauth-authorize` 完成授权，无需本机客户端。
+- **额度与签到**：查询积分余额（按「免费/活动」与「购买」拆分，带套餐名与到期）；每日签到领积分并累计连续天数。
+- **刷新轮换互斥的处理**：MiniMax 的 refreshToken 是一次性轮换的，本机客户端会独立刷新。为避免 CreditDaddy 用陈旧快照刷新触发 `invalid_grant`：本机导入账号在刷新前会从 `auth.json` 重读最新 refreshToken 对齐，刷新成功后再安全回写文件（仅客户端未运行时，运行中回写会作废客户端内存里的 token 故跳过）。浏览器登录拿到的是独立 `loginEpoch` 凭据链，不与本机客户端共用，从根上消除互斥。
+- **本地网关**：内置 Anthropic 兼容端点 `POST /gateway/minimax/v1/messages`，10Router 建 anthropic-compatible 节点指向即可把 MiniMax 当普通供应商调度；多账号轮换、401 自动刷新重试、429 冷却、SSE / JSON 流式透传、局域网 IP 白名单（与 ZCode 体验包接口同机制）。
+
 ## 快速开始
 
 ### 方式一：桌面安装版 / 便携版（推荐）
@@ -147,7 +153,7 @@ creditdaddy daemon
 **CLI 常用命令**：
 
 ```bash
-creditdaddy scan                    # 扫描导入本机 Qoder / WorkBuddy / ZCode / mirasim / 妙手 / Trae 客户端登录的账号
+creditdaddy scan                    # 扫描导入本机 Qoder / WorkBuddy / ZCode / mirasim / 妙手 / Trae / MiniMax 客户端登录的账号
 creditdaddy add <token>             # 添加 Qoder 国际版账号
 creditdaddy add <token> --cn        # 添加 Qoder 国内版账号
 creditdaddy add <token> --workbuddy # 添加 WorkBuddy 国内版账号（--intl 为国际版）
@@ -194,7 +200,7 @@ creditdaddy help                    # 查看完整命令行帮助
 | `POST` | `/api/tenrouter/sync` | 立即触发本机模型用量向 10Router 同步 |
 | `POST` | `/api/tenrouter/sync-accounts` | 把本机账号推送到 10Router 连接 `{adminPassword?}`（OAuth / apikey 双通道） |
 | `GET` / `POST` | `/api/qoder/umid` | 获取 / 一键安装 Linux 平台 Qoder 设备身份组件 |
-| `GET` | `/api/logs` | 查看环形内存日志 |
+| `GET` | `/api/logs` | 查看环形内存日志（`?tag=MINIMAX-GW` / `?tag=ZCODE-GW` 可只看网关调用日志） |
 | `POST` | `/api/export` / `/api/import` | 账号数据安全加密导出与导入 |
 
 ## 状态与记录说明
@@ -235,6 +241,10 @@ CreditDaddy/
 │   ├── logger.js               # 内存环形日志缓冲
 │   ├── mirasimClient.js        # mirasim 套餐 / 额度请求
 │   ├── mirasimLocal.js         # 本机 mirasim 凭据解密与切号
+│   ├── minimaxAuth.js          # MiniMax 浏览器登录（OAuth 设备码 + S256 PKCE）
+│   ├── minimaxClient.js        # MiniMax 用户信息 / 额度 / 签到 / Token 续期请求
+│   ├── minimaxGateway.js       # MiniMax 本地 Anthropic 兼容网关（多账号轮换）
+│   ├── minimaxLocal.js         # 本机 MiniMax 凭据读取、刷新对齐与安全回写
 │   ├── panel.html              # Web 管理面板前端
 │   ├── providers.js            # 多产品线适配器注册表
 │   ├── qoderApp.js             # 本机 Qoder 客户端探测与 safeStorage 解密
@@ -279,9 +289,7 @@ npm test
 
 欢迎加入 **CreditDaddy 交流群** 交流使用体验与反馈 issue：
 
-<div align="center">
 <img src="assets/feishu-group-qr.jpg" width="280" alt="CreditDaddy 交流群二维码">
-</div>
 
 ### 贡献者致谢
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "creditdaddy",
-  "version": "1.2.0",
-  "description": "CreditDaddy — Qoder / WorkBuddy / ZCode / mirasim / 妙手 / Trae 多账号本地管理与每日积分自动签到助手",
+  "version": "1.3.0",
+  "description": "CreditDaddy — Qoder / WorkBuddy / ZCode / mirasim / 妙手 / Trae / MiniMax 多账号本地管理与每日积分自动签到助手",
   "homepage": "https://github.com/techysy/CreditDaddy",
   "repository": {
     "type": "git",

package/src/accounts.js

@@ -6,7 +6,7 @@
  * 同一 provider 下 uid 相同但 token 不同 → 视为 token 续期，原地更新而不是新增。
  */
 
-import { normalizeAccountInput, findDuplicate, loadAccounts, withAccounts, loadSettings, saveSettings } from './store.js';
+import { normalizeAccountInput, findDuplicate, loadAccounts, withAccounts, withSettings } from './store.js';
 import { productImpl, displayNameFrom } from './providers.js';
 
 export { displayNameFrom };
@@ -18,11 +18,16 @@ export { displayNameFrom };
 async function attachPendingWebSession(target) {
   if (!String(target.provider || '').startsWith('qoder') || !target.uid) return false;
   if (target.meta?.qoderWebSession) return false;
-  const pending = (await loadSettings()).pendingQoderWebSessions || {};
-  const item = pending[target.uid];
-  if (!item || item.kind !== target.provider || !item.cookie) return false;
-  const { [target.uid]: _used, ...rest } = pending;
-  await saveSettings({ pendingQoderWebSessions: rest });
+  // 与 daemon 写入暂存会话（/api/auth/qoder-web-session）共用 withSettings 队列，
+  // 否则两边同时「读 pending → 改 → 写回」会把对方的暂存项冲掉
+  const item = await withSettings((settings) => {
+    const pending = settings.pendingQoderWebSessions || {};
+    const found = pending[target.uid];
+    if (!found || found.kind !== target.provider || !found.cookie) return null;
+    delete pending[target.uid];
+    return found;
+  });
+  if (!item) return false;
   target.meta = { ...(target.meta || {}), qoderWebSession: { cookie: item.cookie, capturedAt: item.capturedAt || new Date().toISOString() } };
   return true;
 }
@@ -37,7 +42,13 @@ function refreshExisting(existing, incoming) {
   const set = (k, v) => { if (v && existing[k] !== v) { existing[k] = v; changed = true; } };
   if (existing.token !== incoming.token) {
     set('token', incoming.token);
-    set('refreshToken', incoming.refreshToken);
+    // 换了 token 就必须连 refreshToken 一起换：新会话没带 refreshToken（WorkBuddy 会轮换它）时，
+    // 用 set 的真值判断会留下服务端已作废的旧 refreshToken，之后每次刷新都失败，而「重新导入」
+    // 同样清不掉它——死循环。token 变了就以新记录为准，没有就是没有。
+    if (existing.refreshToken !== (incoming.refreshToken || null)) {
+      existing.refreshToken = incoming.refreshToken || null;
+      changed = true;
+    }
     set('expiresAt', incoming.expiresAt);
     if (incoming.verified !== undefined) existing.verified = incoming.verified;
     // 换上了新凭据：旧 token 留下的失败结果（如「登录已失效，请重新登录」）不再成立，

package/src/authDevice.js

@@ -4,6 +4,7 @@
  *   qoder / qoder-cn            Qoder 设备码登录（PKCE + nonce，与官方 qodercli 同流程，移植自 10router）
  *   workbuddy / workbuddy-intl  WorkBuddy / CodeBuddy 登录（state 轮询，见 workbuddyAuth.js）
  *   zcode-bigmodel / zcode-zai  ZCode 登录（客户端 CLI 轮询流程，见 zcodeAuth.js）
+ *   minimax                     MiniMax Code 登录（OAuth 设备码 + S256 PKCE，见 minimaxAuth.js）
  *
  * Qoder 流程：
  *   1. 本地生成 PKCE 对 (verifier/challenge-S256) + nonce + machine_id
@@ -26,6 +27,7 @@ import { addAccount } from './accounts.js';
 import { logger } from './logger.js';
 import { startWorkbuddyLogin, pollWorkbuddyLogin } from './workbuddyAuth.js';
 import { startZcodeLogin, pollZcodeLogin } from './zcodeAuth.js';
+import { startMiniMaxLogin, pollMiniMaxLogin } from './minimaxAuth.js';
 
 const FETCH_TIMEOUT_MS = 15000;
 const QODER_TTL_MS = 5 * 60 * 1000;   // Qoder 授权链接 5 分钟有效
@@ -125,6 +127,7 @@ const FLOWS = {
   'workbuddy-intl': { start: startWorkbuddyLogin, poll: pollWorkbuddyLogin },
   'zcode-bigmodel': { start: startZcodeLogin, poll: pollZcodeLogin },
   'zcode-zai': { start: startZcodeLogin, poll: pollZcodeLogin },
+  minimax: { start: startMiniMaxLogin, poll: pollMiniMaxLogin },
 };
 export const LOGIN_KINDS = Object.keys(FLOWS);
 const KIND_LABEL = { 'zcode-bigmodel': 'ZCode（BigModel）', 'zcode-zai': 'ZCode（Z.ai）' };

package/src/catpawClient.js

@@ -1,103 +1,103 @@
-/**
- * 妙手（美团 CatPaw）桌面网关 API 客户端 — 用户信息与额度/版本查询。
- *
- *   GET https://catx.nocode.cn/api/gateway/auth/current-user    用户信息（userId, name, mobile, avatarUrl）
- *   GET https://catx.nocode.cn/api/gateway/credit/balance       可用额度 + 当前套餐（体验版/专业版…）
- *
- * 鉴权：本机妙手客户端解密出的 access_token，放在 X-Auth-Token 头
- * （客户端内部 API 封装同款；网页端 credit.catpaw.meituan.com 的接口只认浏览器 Cookie，不适用）。
- * 响应统一信封 { code: 0, message, data }，code !== 0 视为业务错误。
- *
- * 凭据由妙手客户端登录管理（网页 OAuth 轮转），没有对外的 refresh 接口：
- * token 失效（401）时提示在妙手客户端重新登录后重新本机导入。
- */
-
-import { fetchJsonRace } from './zcodeClient.js';
-import { FETCH_TIMEOUT_MS } from './constants.js';
-
-export const CATPAW_GATEWAY = 'https://catx.nocode.cn';
-
-const gw = (p) => CATPAW_GATEWAY + '/api/gateway' + p;
-const authHeaders = (token) => ({ 'X-Auth-Token': token, Accept: 'application/json' });
-
-/** GET 网关接口并拆信封；401 → e.auth = true（凭据失效） */
-async function gwGet(path, token) {
-  const res = await fetchJsonRace(gw(path), { headers: authHeaders(token), timeoutMs: FETCH_TIMEOUT_MS });
-  if (res.status === 401) {
-    const e = new Error('妙手登录凭据已过期，请在妙手客户端重新登录后到「添加账号 → 本机导入」同步');
-    e.auth = true;
-    throw e;
-  }
-  if (!res.ok) throw new Error(`妙手接口 ${path} 失败: HTTP ${res.status}`);
-  const body = await res.json().catch(() => null);
-  if (!body || typeof body !== 'object') throw new Error(`妙手接口 ${path} 返回无法解析`);
-  if (body.code !== 0) {
-    const msg = String(body.message || body.errorCode || '未知错误');
-    if (body.code === 401 || /未登录|登录失效/.test(msg)) {
-      const e = new Error('妙手登录凭据已过期，请在妙手客户端重新登录后重新本机导入');
-      e.auth = true;
-      throw e;
-    }
-    throw new Error(`妙手接口 ${path} 返回错误：${msg}`);
-  }
-  return body.data;
-}
-
-/** 用户信息 → { userId, name, mobile, avatarUrl } */
-export async function fetchCatpawProfile(token) {
-  if (!token) throw new Error('账号缺少 token');
-  const d = await gwGet('/auth/current-user', token);
-  if (!d || !d.userId) throw new Error('妙手用户信息响应缺少 userId（上游结构可能变化）');
-  return { userId: String(d.userId), name: d.name || null, mobile: d.mobile || null, avatarUrl: d.avatarUrl || null };
-}
-
-const iso = (ms) => (Number.isFinite(ms) && ms > 0 ? new Date(ms).toISOString() : null);
-
-/** credit/balance → 统一配额结构（可用妙手 Credits + 当前版本；无总量口径，不计入面板「剩余积分」合计） */
-export function normalizeCatpawBalance(d) {
-  // 注意 Number(null) === 0：字段缺失 / 为 null 都要判为空额度，而不是 0
-  const raw = d?.availableCredits;
-  const credits = raw === null || raw === undefined || raw === '' ? NaN : Number(raw);
-  const plan = d?.userPlan || {};
-  const planName = plan.planName || (plan.pro ? '专业版' : '体验版');
-  const remaining = Number.isFinite(credits) ? credits : null;
-  return {
-    total: remaining ?? 0,
-    used: 0,
-    remaining: remaining ?? 0,
-    unit: 'Credits',
-    plan: planName,
-    planExpiresAt: iso(Number(plan.expireTime)),
-    nextRefreshAt: iso(Number(plan.nextRefreshTime)),
-    parts: [{
-      name: '可用额度',
-      total: remaining ?? 0,
-      used: 0,
-      remaining: remaining ?? 0,
-      unit: 'Credits',
-      expiresAt: iso(Number(plan.nextRefreshTime)),
-      recurring: true,
-    }],
-    empty: remaining === null,
-    exceeded: plan.status ? plan.status !== 'active' : false,
-    pro: plan.pro === true,
-    autoRenew: plan.autoRenew === true,
-  };
-}
-
-/** 查询额度与版本（一次 balance 请求即含 userPlan；401 抛 auth 错误） */
-export async function fetchCatpawQuota(account) {
-  if (!account.token) throw new Error('账号缺少 token');
-  return normalizeCatpawBalance(await gwGet('/credit/balance', account.token));
-}
-
-/**
- * 云端用量（按天 token 总量，无输入/输出/缓存拆分、无模型维度）：
- *   GET /api/gateway/v1/usage/token/daily?startTime=&endTime=   → { daily: [{ date: 'YYYY-MM-DD', totalTokens }] }
- * 当天的桶随用随涨，调用方应只取已结束的日期，避免同一天反复快照产生重复行。
- */
-export async function fetchCatpawTokenDaily(token, { startTime, endTime } = {}) {
-  if (!token) throw new Error('账号缺少 token');
-  const d = await gwGet(`/v1/usage/token/daily?startTime=${startTime}&endTime=${endTime}`, token);
-  return Array.isArray(d && d.daily) ? d.daily : [];
-}
+/**
+ * 妙手（美团 CatPaw）桌面网关 API 客户端 — 用户信息与额度/版本查询。
+ *
+ *   GET https://catx.nocode.cn/api/gateway/auth/current-user    用户信息（userId, name, mobile, avatarUrl）
+ *   GET https://catx.nocode.cn/api/gateway/credit/balance       可用额度 + 当前套餐（体验版/专业版…）
+ *
+ * 鉴权：本机妙手客户端解密出的 access_token，放在 X-Auth-Token 头
+ * （客户端内部 API 封装同款；网页端 credit.catpaw.meituan.com 的接口只认浏览器 Cookie，不适用）。
+ * 响应统一信封 { code: 0, message, data }，code !== 0 视为业务错误。
+ *
+ * 凭据由妙手客户端登录管理（网页 OAuth 轮转），没有对外的 refresh 接口：
+ * token 失效（401）时提示在妙手客户端重新登录后重新本机导入。
+ */
+
+import { fetchJsonRace } from './zcodeClient.js';
+import { FETCH_TIMEOUT_MS } from './constants.js';
+
+export const CATPAW_GATEWAY = 'https://catx.nocode.cn';
+
+const gw = (p) => CATPAW_GATEWAY + '/api/gateway' + p;
+const authHeaders = (token) => ({ 'X-Auth-Token': token, Accept: 'application/json' });
+
+/** GET 网关接口并拆信封；401 → e.auth = true（凭据失效） */
+async function gwGet(path, token) {
+  const res = await fetchJsonRace(gw(path), { headers: authHeaders(token), timeoutMs: FETCH_TIMEOUT_MS });
+  if (res.status === 401) {
+    const e = new Error('妙手登录凭据已过期，请在妙手客户端重新登录后到「添加账号 → 本机导入」同步');
+    e.auth = true;
+    throw e;
+  }
+  if (!res.ok) throw new Error(`妙手接口 ${path} 失败: HTTP ${res.status}`);
+  const body = await res.json().catch(() => null);
+  if (!body || typeof body !== 'object') throw new Error(`妙手接口 ${path} 返回无法解析`);
+  if (body.code !== 0) {
+    const msg = String(body.message || body.errorCode || '未知错误');
+    if (body.code === 401 || /未登录|登录失效/.test(msg)) {
+      const e = new Error('妙手登录凭据已过期，请在妙手客户端重新登录后重新本机导入');
+      e.auth = true;
+      throw e;
+    }
+    throw new Error(`妙手接口 ${path} 返回错误：${msg}`);
+  }
+  return body.data;
+}
+
+/** 用户信息 → { userId, name, mobile, avatarUrl } */
+export async function fetchCatpawProfile(token) {
+  if (!token) throw new Error('账号缺少 token');
+  const d = await gwGet('/auth/current-user', token);
+  if (!d || !d.userId) throw new Error('妙手用户信息响应缺少 userId（上游结构可能变化）');
+  return { userId: String(d.userId), name: d.name || null, mobile: d.mobile || null, avatarUrl: d.avatarUrl || null };
+}
+
+const iso = (ms) => (Number.isFinite(ms) && ms > 0 ? new Date(ms).toISOString() : null);
+
+/** credit/balance → 统一配额结构（可用妙手 Credits + 当前版本；无总量口径，不计入面板「剩余积分」合计） */
+export function normalizeCatpawBalance(d) {
+  // 注意 Number(null) === 0：字段缺失 / 为 null 都要判为空额度，而不是 0
+  const raw = d?.availableCredits;
+  const credits = raw === null || raw === undefined || raw === '' ? NaN : Number(raw);
+  const plan = d?.userPlan || {};
+  const planName = plan.planName || (plan.pro ? '专业版' : '体验版');
+  const remaining = Number.isFinite(credits) ? credits : null;
+  return {
+    total: remaining ?? 0,
+    used: 0,
+    remaining: remaining ?? 0,
+    unit: 'Credits',
+    plan: planName,
+    planExpiresAt: iso(Number(plan.expireTime)),
+    nextRefreshAt: iso(Number(plan.nextRefreshTime)),
+    parts: [{
+      name: '可用额度',
+      total: remaining ?? 0,
+      used: 0,
+      remaining: remaining ?? 0,
+      unit: 'Credits',
+      expiresAt: iso(Number(plan.nextRefreshTime)),
+      recurring: true,
+    }],
+    empty: remaining === null,
+    exceeded: plan.status ? plan.status !== 'active' : false,
+    pro: plan.pro === true,
+    autoRenew: plan.autoRenew === true,
+  };
+}
+
+/** 查询额度与版本（一次 balance 请求即含 userPlan；401 抛 auth 错误） */
+export async function fetchCatpawQuota(account) {
+  if (!account.token) throw new Error('账号缺少 token');
+  return normalizeCatpawBalance(await gwGet('/credit/balance', account.token));
+}
+
+/**
+ * 云端用量（按天 token 总量，无输入/输出/缓存拆分、无模型维度）：
+ *   GET /api/gateway/v1/usage/token/daily?startTime=&endTime=   → { daily: [{ date: 'YYYY-MM-DD', totalTokens }] }
+ * 当天的桶随用随涨，调用方应只取已结束的日期，避免同一天反复快照产生重复行。
+ */
+export async function fetchCatpawTokenDaily(token, { startTime, endTime } = {}) {
+  if (!token) throw new Error('账号缺少 token');
+  const d = await gwGet(`/v1/usage/token/daily?startTime=${startTime}&endTime=${endTime}`, token);
+  return Array.isArray(d && d.daily) ? d.daily : [];
+}