请求体超过网关上限时，错误被显示为「API 密钥无效」；AUTH 归类掩盖了真实原因

[zhaocjiang]

Summary

当上游网关因请求体超过体积上限而拒绝请求时，DSH 会把这次失败显示成 「API 密钥无效」。用户看到的是认证错误，实际问题却是请求体积；而网关返回的真实错误信息在 UI 里无法取得。

Reproduction

1. 使用 api: openai-completions（由 dsh-llm-pi-ai 服务）的 provider，指向一个对请求体有体积上限的 OpenAI 兼容网关。
2. 在一个会话里累积较多图片（本次为 75 张唯一附件、原始约 39 MB）。历史图片会被重新编码并内联进每一个请求体，因此请求体随会话增长。
3. 继续对话，直到请求体超过网关上限。此后该会话的每一轮都会以同样方式失败。

体积阈值可用同一把 key、同一模型直接复现（只有体积在变）：

请求体	结果
7 MB	HTTP 200
8 MB	HTTP 403 {"message":"Insufficient account balance","type":"bad_response_status_code"}
9 MB	HTTP 403（同上）

7 MB 用同一把 key 成功，说明该 403 是体积触发的产物，与凭据或余额无关。

Current behavior

UI 渲染为 本轮运行失败 API 密钥无效，错误码 AUTH。而网关实际返回：

403: {"message":"Insufficient account balance","type":"bad_response_status_code"}

网关自身日志显示真实原因与故障转移链：

channel error (status 413): request body exceeds limit of 8388608 bytes; please reduce conversation context
channel error (status 413): request body exceeds limit of 8388608 bytes; please reduce conversation context
channel error (status 403): Insufficient account balance
relay error: Insufficient account balance
POST /v1/chat/completions | 403

即：主渠道以 413（体积超 8 MiB）拒绝，网关转移到备用渠道，备用渠道因无关原因返回 403。DSH 只看到最后的 403。

三处成因（按影响排序）：

1. failureMessage 在 AUTH 时丢弃真实错误（对用户最误导）
dsh-client-ui-chat/lib/client.js：

function failureMessage(message, code, t) {
    return code === "AUTH" ? t("message.failure.auth") : message;
}

code === "AUTH" 时真实 message 被丢弃、替换成固定文案，用户既看不到 Insufficient account balance，也看不到任何细节，只会被告知去检查 API key。

2. 401|403 在 413 分支之前就被归类为 AUTH
dsh-llm-pi-ai/lib/index.js 的 classifyPiAiError：

if (/\b(?:401|403)\b/.test(message)) return "AUTH";
if (isQuotaExceededError(message)) return QUOTA_EXCEEDED_CODE;
if (/\b429\b|rate.?limit/i.test(message)) return "RATE_LIMIT";
if (/\b413\b|failed to buffer the request body:\s*length limit exceeded|payload too large|request body too large/i.test(message)) return "INVALID_REQUEST";

413 分支已存在，但含 403 的消息会先返回 AUTH。（dsh-llm-deepseek/lib/index.js:1527 有同样的 401||403 → AUTH 映射。）该顺序还与故障转移相互作用：413 与 403 可能出现在同一次逻辑失败里，只有最后一个能活到归类阶段。

3. 默认图片预算（20 MiB）可能高于网关上限
dsh-llm-pi-ai/lib/index.js：

const DEFAULT_MAX_REQUEST_IMAGE_BYTES = 20 * 1024 * 1024;

其文档注释已准确描述了这个意图：

Every image in history is re-encoded into every request body, so an unbounded conversation eventually exceeds a provider or gateway request-size cap and the session can never complete another request. … Deployments behind stricter gateways lower it per route.

本次正是如此：网关上限为 8 MiB，而默认 20 MiB 高于它，卸载策略在网关拒绝之前根本不会触发。

Expected behavior

1. AUTH 时不替换真实错误，展示（或附加）底层 message。
2. 调整 classifyPiAiError 顺序/判据，使体积信号不被 403 掩盖；可考虑区分「体积被拒后经故障转移产生的 403」。
3. 显著说明与网关上限的相互作用，和/或在收到 request-too-large 时自动收紧图片预算并重试一次，而不是直接让本轮失败。

Environment

• @deepseek-ai/dsh 0.1.5-rc.2
• provider api: openai-completions（dsh-llm-pi-ai），OpenAI 兼容网关，请求体上限 8 MiB（8388608 B）
• 触发会话：75 张唯一图片附件、原始约 39 MB（数张 1–2 MB 截图）

备注：/compact 不能缓解

实测压缩完成后（文本 0.04 MB、0 张图片），下一轮仍然 403。压缩只减少文本，图片载荷会从历史里被重新内联。可行规避是按 provider 下调图片预算：

llm-pi-ai:
  providers:
    <provider>:
      maxRequestImageBytes: 6291456   # 6 MiB，留在网关 8 MiB 之下

已验证可解决。

[PerryLink]

这个误报我能指出确切的机制：403 被分类器直接归成了 AUTH

1. 为什么会显示"API 密钥无效"

packages/llm/llm-pi-ai/src/stream.ts 里的错误分类器（当前最新版仍在）：

if (/\b(?:401|403)\b/.test(message)) return 'AUTH'      // :43

⇒ 它只看状态码数字：网关返回 403（你的场景里实际是 Insufficient account balance，即体积触发的拒绝），分类器就落到 AUTH，UI 于是渲染成"API 密钥无效"。你观察到的"真实原因被 AUTH 归类掩盖"完全成立，而且这是一条正则的结果，不是某处逻辑判断。

2. 你那份 7MB / 8MB 对照是这条报告最有力的部分

同一把 key、同一模型，只改体积：7 MB → 200，8 MB → 403 ⇒ 这就把"凭据/余额"这一层排除掉了。建议把它放在正文最前面——否则维护者会先怀疑是不是真的余额不足。

3. 两点值得补进报告

1. 403 的语义本身就不可靠：它既可能表示"无权"（真正的 AUTH），也可能被网关用来表示"拒绝处理/超额/超体积"。所以光靠数字分类必然误判。可提的具体改法：403 时保留并展示上游的 message/body（你那条 Insufficient account balance 就是答案），而不是只归成一个码；
2. "该会话的每一轮都会同样失败" 这一点请明确保留：它不是偶发失败，而是会话级砖化（历史图片被重新内联进每一个请求体，所以体积只增不减）。这决定了严重度。

4. 一个可直接对照的旁证

DSH 里另有一处同类误报刚刚被独立报告（#7691）：纯文本 5xx 因"没有状态数字"而落到兜底的 PI_AI_ERROR，于是该重试的没重试。两条合起来说明：这套分类器过度依赖错误文本里的数字，既有"漏"也有"误"。你的报告可以引用它来论证"应当优先使用结构化信息（状态码 + 上游 body），而不是正则"。⚠️ 我没有核对你们两条是否同一段代码路径（你这条走 llm-pi-ai，那条也是），引用时请写成"同类问题"而不是"同一处"。

5. 版本提醒

⚠️ 当前最新是 0.1.7-rc.2；别装 latest（npm 上它仍停在 0.1.5-rc.3，更旧）：

npm i -g @deepseek-ai/dsh@next      # 当前 = 0.1.7-rc.2

一条边界

我确认的是分类器那一行的存在与行为（这足以解释"为什么显示成 API 密钥无效"）。你那条 403 Insufficient account balance 的性质（是网关的体积策略还是账户策略）以你自己的实测为准——我没有该网关的资料。