magicrew-auth 0.3.25 → 0.3.26

package/AGENTS.md

@@ -68,6 +68,7 @@ curl -s "https://usemagpie.ai/api/latest?channel=stable" | grep -o '"version":"[
 | 15 | 接 ZCode / Claude Code 系客户端，带工具的请求回 `400 {"error":{"message":"模型响应失败","code":4017}}` | **上游的 `additionalProperties` 只认布尔值，任何对象形态都拒** —— 不只是 `{}`，`{type:"string"}` 这种有约束的 schema 一样 400（两个模型逐行一致）。判据：同一请求只把该字段换成 `true` → 200。改写已在 `rewriteRequestBody` 里做（非布尔一律换 true；**这是降级放宽、会丢约束**，取舍见 internals 十七） | internals 十七 · `tests/body-rewrite.mjs` |
 | 16 | 网关路径（agent 从 magpie 的 `/v1` 进来）报 `502 did not stream: token无效`，而 provider 显示已登录 | auth 里没带 org → `accountOf()` 落 `"default"` → 读不到真实账号的 key 槽 → 只能用 `auth.access`，它过了 2 小时就 403。`accountFor()` 已在**恰好一个真实账号**时兜到它；**多账号不猜**（猜错就是拿别人的 key 扣别人的积分） | internals 十四 · 十五 · `tests/account-fallback.mjs` |
 | 17 | 单轮回 `400 ... tools.N.function.parameters/properties/functions/items: invalid JSON Schema` | 上游不接受**空 schema 对象**当 `items`：`items:{}` 必 400，`items:{description:"x"}` 却 200。判据：同一请求只删 `items:{}` → 200。改写已做（删 `items:{}` / `true`，**严格等价**；`false` 不动） | internals 十七 · `tests/body-rewrite.mjs` |
+| 18 | 某个账号积分耗尽后整轮回 400「可用积分已不足」，其它有余额的账号一次没被问 | **上游用 HTTP 400 报额度耗尽，magpie 的 `retryable()` 400 分支只认 `quotaWords`（不含「积分」「充值」）** ⇒ `hw.failed()=false`，既不走 `!last && hw.failed()` 的换号分支，也不 rest 该账号。插件 `rewriteCreditRefusal()` 把这种 400/422 改写成 402 Payment Required（`tests/credit-refusal.mjs` 锁死）；magpie 侧修复方案见 issue（`retryable()` 的 400 分支补 `creditWords`） | CHANGELOG 0.3.26 |
 
 **坑 14 的两个附带判据**（都实测过）：
 

package/CHANGELOG.md

@@ -1,5 +1,55 @@
 # 更新记录
 
+## 0.3.26 — 2026-10-28
+
+**积分耗尽的 400 不再让整轮对话失败：改写成 402，让 magpie 换下一个账号**
+
+### 症状
+
+三个「超级麦吉」账号（余额 6,467 / 82 / 0 积分）接在同一个路由组里。余额 82 的账号
+被会话亲和（affinity）留在回复链上，一轮对话把它烧到负数，上游回：
+
+```
+HTTP 400
+超级麦吉: 非常抱歉，当前对话需要调用大模型 / 付费工具，您的可用积分已不足。
+您可以点击右上角「用户头像」，通过「充值」通道补充积分，完成后即可继续对话。
+```
+
+DSH 界面显示「本轮运行失败」，magpie 的 trace 里只有两次 try —— 都在
+`magicrew@181****710`，余额 6,467 的 `magicrew`（189****051）**一次都没被问**。
+
+### 根因
+
+magpie 的 `failure()` 已经能认出这条错误（`creditWords` 命中「充值」）并把
+`try.Fail` 记成 `credit`；但 `retryable()` 的 `status == 400, 422` 分支只查
+`quotaWords`，而 `quotaWords` 不含「积分」「充值」。于是：
+
+```
+hw.failed() == false
+  ⇒ 走不到 `!last && hw.failed()` 的换账号分支
+  ⇒ 不 rest、不换号、直接把 400 交给客户端
+```
+
+账号于是永远留在轮换里，下一次请求继续撞同一个错误。
+
+### 修法（插件层）
+
+`src/hooks/loader.mjs` 增加 `rewriteCreditRefusal()`：只在
+**400/422 + 文案确认是「积分/余额不足」** 时把状态码改成 `402 Payment Required`，
+body 原样保留。402 在 magpie 的 `retryable()` 里无条件可重试、`failure(402)` 也是
+`failCredit`，因此会 rest 该账号 30 分钟并继续问同 provider 的下一个账号 / 组的下一个成员。
+
+边界钉死：schema 错误的 400、参数错误的 400、200/402 响应一律原样透传，不读成功流。
+
+### 验证
+
+- `tests/credit-refusal.mjs`：18 个断言 —— 中文真实文案 / 英文 insufficient credits /
+  余额不足 / schema 400 不命中 / 参数 400 不命中 / 402 与 200 不碰 / content-length 与
+  content-encoding 被丢掉 / **端到端**：拦全局 fetch，`makeLoader().fetch` 收到 400 积分
+  不足时交给 magpie 的是 402，收到 schema 400 时仍是 400。
+- `tests/body-rewrite.mjs` 36 通过、`tests/account-fallback.mjs` 10 通过。
+- 两站共用同一 Go 服务与同一错误文案（AGENTS 坑 1），逻辑按站点无关实现。
+
 ## 0.3.25 — 2026-10-28
 
 **0.3.24 的 schema 扫描范围收窄：只走 schema 位置**

package/README.md

@@ -27,6 +27,7 @@
 - **本机浏览器登过就直接认** —— 你平时那个 Edge / Chrome / Brave 里登过 magicrew，点登录时插件读它的 localStorage 接上：不开窗口、不用重登
 - **模型跟着账号走** —— 每次登录后按 `/api/v1/flows/models` 实时拉，账户当前能选什么就展示什么，生图和 embedding 不会混进来
 - **积分算得准** —— 余额读的是 `/api/v1/quota/points/total`；空号就显示空，不会被优先派活
+- **积分耗尽自动换号** —— 上游用 HTTP 400 报「可用积分已不足」时，插件把它改写为语义正确的 **402 Payment Required**，magpie 会 rest 这个账号并继续问同 provider 的下一个账号 / 路由组的下一个成员，不再让整轮对话直接失败
 - **登录一次管 30 天** —— 网页 JWT 顶 30 天，`mgw_` api_key 每 2 小时自续，refresh_token 每次续期时自滚
 - **点一下，全自动** —— 插件自己拉起浏览器停在官方登录页，你在里面登（手机号 / 密码 / Google / 邮箱验证码 / 飞书 / 钉钉都行），登录完成那一刻它自己把凭据读走，不用回来点任何东西
 - **登录方式还有两条备选** —— 手机号+密码走 API；或者直接粘 JWT + 组织码
@@ -197,6 +198,8 @@ magpie plugin list
 
 **npm 上叫 `magicrew-auth`，为什么卡片显示 `Magicrew`？** 卡片标题取包内 `package.json` 的 `name`（`Magicrew`），而 npm 拒绝含大写字母的新包名。发布时用 `publish-npm.mjs` 临时换成 `magicrew-auth`、发完还原 —— 所以 npm 页面是小写包名，git 源装出来是 `Magicrew`。功能完全一样。
 
+**一个账号积分用完了，会换到另一个还有积分的账号吗？** 会。0.3.26 起插件把上游的 400「可用积分已不足」改写成 402 Payment Required —— magpie 对 402 一律视为可重试：先 rest 这个账号 30 分钟，再问同 provider 的下一个账号；如果整个组都没有额度，才会把错误交给客户端。
+
 **为什么模型列表会变？** 因为清单是从 `/api/v1/flows/models` 实时拉的。订阅档位变了、平台方上下架变了，清单就跟着变 —— 插件里没有需要维护的模型表。
 
 **国际站 `/v1/chat/completions` 报 500，22 字节的纯文本？** 那是缺 `organization-code` 请求头。国内站不需要，国际站强制。插件按站点自动带。

package/docs/internals.md

@@ -1185,3 +1185,60 @@ HTTP 400
 2. **插件宿主是运行时从 `~/.cache/magpie/bun/install-cache/` 加载的**，
    不在 `plugin-host/host-*.js` 里；magpie 更新插件后会换目录（目录名带 commit hash），
    要改当前实际加载的那个。
+
+---
+
+## 十八、上游 400「可用积分已不足」：插件改写成 402
+
+### 症状
+
+多账号（同 provider 三号，余额 6,467 / 82 / 0 积分）时，一个账号被会话亲和留在
+回复链上，一轮把余额烧穿，上游回 HTTP **400**：
+
+```
+超级麦吉: 非常抱歉，当前对话需要调用大模型 / 付费工具，您的可用积分已不足。
+您可以点击右上角「用户头像」，通过「充值」通道补充积分，完成后即可继续对话。
+```
+
+DSH 显示「本轮运行失败」；trace 里只有两次 try（都在那个账号），余额 6,467 的账号一次没问。
+
+### 根因（magpie 0.1.1899 / origin main `69626580`）
+
+`internal/gateway/routing.go` 的 `failure()` 能认出（`creditWords` 命中「充值」）：
+
+```go
+creditWords = ...|余额|欠费|充值|账户.*(不足|停)
+case status == 402, creditWords.Match(body) && ...:
+    return failCredit
+```
+
+但 `internal/gateway/fallback.go` 的 `retryable()` 400/422 分支只查 `quotaWords`：
+
+```go
+case status == 400, status == 422:
+    return quotaWords.Match(body) || unservedWords.Match(body) || ...
+```
+
+`quotaWords` 不含「积分」「充值」。⇒ `retryable(400, body) == false` ⇒
+`hw.failed() == false` ⇒ 走不到 `!last && hw.failed()` 的换号分支，也不记 `Rest`。
+
+### 插件修法（0.3.26）
+
+`src/hooks/loader.mjs` 的 `rewriteCreditRefusal()`：只在 **400/422 + 文案命中
+「积分/余额不足」** 时改写成 **402 Payment Required**，body 原样。402 在 magpie
+的 `retryable()` 里无条件 true、`failure(402)` 也是 `failCredit`，于是会 rest 该账号
+30 分钟并继续问同 provider 的下一个账号 / 组的下一个成员。
+
+边界：`schema` 400、参数 400、200、402 一律原样透传；不读成功流（只克隆错误响应）。
+`tests/credit-refusal.mjs` 18 个断言锁死，含 `makeLoader().fetch` 的端到端用例。
+
+> 这是**绕过**，不是 magpie 根修。根修建议 `retryable()` 的 400/422 分支补
+> `creditWords.Match(body)`（或直接 `failure(status, body) == failCredit`）；
+> 已报 yetone/magpie#4095。
+
+### 为什么这是插件能做的边界
+
+插件能改上游响应（loader 的 `fetch` 返回 Response），改不了 magpie 的 `retryable()`。
+把「支付问题」伪装成语义正确的 402，比让每个用户手动避开耗尽账号现实；等 magpie 修好后，
+这段转换仍然无害（402 本来就是正确的语义）。
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "magicrew-auth",
-  "version": "0.3.25",
+  "version": "0.3.26",
   "description": "超级麦吉 / MagiCrew for magpie and OpenCode — one package, two providers: letsmagic.cn (国内) and magicrew.ai (international). Password or web-JWT sign-in, the account's own live model list, points balance, newcomer rewards, invite codes.",
   "type": "module",
   "main": "./index.mjs",

package/src/hooks/loader.mjs

@@ -1,14 +1,18 @@
 // ④ auth.loader(getAuth) —— 请求接管
 //
 // 返回 baseURL / apiKey / headers / fetch(a,b)，magpie 拿它发真实请求。
-// 这是唯一能改请求体的地方。本项目用它干两件事：
+// 这是唯一能改请求体和上游错误状态的地方。本项目用它干三件事：
 //
 //   · 国际站网关强制要 organization-code（国内站不要），不带就是
 //     HTTP 500 "Internal Server Error."（22 字节纯文本，不是 JSON）
 //   · 推理模型低于 512 的 max_tokens 会被 reasoning 吃光，content 返回空串
+//   · 上游用 HTTP 400 报「可用积分已不足」：这个 400 在 magpie 的
+//     retryable() 里不被识别为可重试（400 分支只查 quotaWords，而这条文案
+//     命中的是 creditWords 的「充值」），于是整轮直接失败、账号也不 rest。
+//     插件把它改写为语义正确的 402 Payment Required，让 magpie 换下一个账号。
 //
-// ⚠ 不要在这里读流、不要重试换号、不要手拼 x-api-key ——
-//   前两件 magpie 做了，第三件看 SDK 包自动加。见 README「最小交付面」。
+// ⚠ 不要在这里读流、不要手拼 x-api-key ——
+//   流由 magpie 处理，头由 SDK 包自动加。见 README「最小交付面」。
 
 import { ensureKey, accountOf } from "../keys.mjs"
 
@@ -223,6 +227,62 @@ export function rewriteRequestBody(raw) {
   return changed ? JSON.stringify(j) : raw
 }
 
+// ═══ 上游「积分/余额不足」的 400 → 402 ═══════════════════════════════════
+//
+// 实测（2026-10-28 23:38，magpie 0.1.1899，DSH 走 group）：
+//
+//   try #1  magicrew@181****710  200  fail=loop   （模型自己绕圈，不是账号）
+//   try #2  magicrew@181****710  400  fail=credit
+//           body: 超级麦吉: 非常抱歉，当前对话需要调用大模型 / 付费工具，
+//                 您的可用积分已不足。…通过「充值」通道补充积分…
+//   route   done=true status=400   ← 第三个账号（余额 6,467）一次都没被问
+//
+// magpie 的 failure() 已经把这条归成 failCredit（creditWords 命中「充值」），
+// 但 retryable() 的 400/422 分支只查 quotaWords（quota|余额|额度|欠费|…），
+// 不含「积分」「充值」⇒ hw.failed() 为 false ⇒ 走不到 `!last && hw.failed()`
+// 的换账号分支，连 rest 都不记。账号于是永远留在轮换里，下一轮继续撞。
+//
+// 修法只改插件这一层：400/422 + 这条文案 → 402 Payment Required。
+// 402 在 magpie 的 retryable() 里无条件 true，failure(402) 也是 failCredit，
+// 会 rest 该账号 30 分钟并继续问同 provider 的下一个账号（或组的下一个成员）。
+// body 原样保留，最终错误文案不变。
+//
+// 注意：只转换「上游拒绝」这一个语义；400 的 schema 错误、参数错误绝不碰。
+const CREDIT_EXHAUSTED = /(?:积分|余额)(?:已|额度)?不足|可用积分不足|insufficient\s+(?:credit|credits|balance|fund|funds|point|points)|(?:credit|credits|point|points|balance)\s+(?:is\s+|are\s+)?(?:insufficient|exhausted)|out\s+of\s+(?:credit|credits|points?|balance)/i
+
+/** 这条错误文案是不是「账户没钱了」（而不是请求本身有问题） */
+export function isCreditExhausted(text) {
+  return CREDIT_EXHAUSTED.test(String(text ?? ""))
+}
+
+/**
+ * 把上游的「积分/余额不足」400/422 改写成 402，让 magpie 的 `retryable()`
+ * 愿意换下一个账号；其余响应原样返回（同一个 Response 对象）。
+ *
+ * @param {Response} res
+ * @returns {Promise<Response>}
+ */
+export async function rewriteCreditRefusal(res) {
+  if (!res || (res.status !== 400 && res.status !== 422)) return res
+  let text
+  try {
+    // 只克隆错误响应：成功响应（尤其是 SSE）不能在这里读，否则会破坏流
+    text = await res.clone().text()
+  } catch {
+    return res
+  }
+  if (!isCreditExhausted(text)) return res
+  const headers = new Headers(res.headers)
+  // body 已由 undici 解压，原 content-encoding/length 不再成立
+  headers.delete("content-length")
+  headers.delete("content-encoding")
+  return new Response(text, {
+    status: 402,
+    statusText: "Payment Required",
+    headers,
+  })
+}
+
 export function makeLoader(c) {
   return async (getAuth) => {
     const auth = await getAuth()
@@ -266,12 +326,12 @@ export function makeLoader(c) {
         // 四处请求体改写，全在 rewriteRequestBody 里（那里有实测出处）
         body = rewriteRequestBody(body)
 
-        return fetch(url, {
+        return rewriteCreditRefusal(await fetch(url, {
           method: init?.method ?? "POST",
           headers,
           body,
           signal: init?.signal ?? req?.signal ?? AbortSignal.timeout(300_000),
-        })
+        }))
       },
     }
   }