新增错误规则：Too much media

[ding113]

错误详情:

{
  "type": "error",
  "error": {
    "type": "invalid_request_error",
    "message": "Too much media: 0 document pages + 104 images > 100"
  },
  "request_id": "req_011CWvFj7Rbw3toQatTzaUoS"
}

[github-actions]

Thank you for reporting this error pattern.

Analysis:

This error "Too much media: 0 document pages + 104 images > 100" is a rate limit from Claude's API when the total media count (PDF pages + images) exceeds 100 in a single request. Currently, there is no matching error rule in the default rule set for this specific pattern.

Existing similar rules:

Looking at the codebase, there are related media/content limit rules but none specifically for this "Too much media" error:

• src/repository/error-rules.ts (lines 628-642): PDF page limit rule matches PDF has too many pages|maximum of.*PDF pages
• src/repository/error-rules.ts (lines 728-742): Image size rule matches image exceeds.*maximum.*bytes

Suggested rule pattern:

A new rule could be added to DEFAULT_ERROR_RULES in src/repository/error-rules.ts with a pattern like:

pattern: "Too much media"
matchType: "contains"
category: "media_limit"
description: "Total media (document pages + images) exceeds API limit"

How to add custom rules:

In the meantime, you can add this rule manually through the dashboard:

1. Navigate to Settings > Error Rules
2. Click Add Rule
3. Configure:
   • Pattern: Too much media
   • Match Type: Contains
   • Category: media_limit
   • Override Response (optional): Custom error message

---

Automated response from Claude AI

[github-actions]

感谢反馈。

从你贴出的响应体看，它属于 { type: "error", error: { type, message } } 这类结构。当前代码路径里，这类上游 JSON 会被解析成 ProxyError，并用于后续的错误分类/重试决策。

当前行为（基于代码）

• ProxyError.extractErrorMessage() 会把该结构提取成字符串；当 error.type + error.message 同时存在时，会拼成 ${error.type}: ${error.message}（src/app/v1/_lib/proxy/errors.ts 第 363-380 行）。因此你这个例子会变成类似 invalid_request_error: Too much media: 0 document pages + 104 images > 100。
• 错误规则匹配时优先使用完整的上游响应体 upstreamError.body（JSON 响应会被完整 JSON.stringify 保存），因此规则可以直接匹配响应体里的任意字段（src/app/v1/_lib/proxy/errors.ts 第 401-405 行、第 469-475 行）。
• 如果没有任何错误规则命中，categorizeErrorAsync() 会把除 404 以外的 ProxyError 归类为 PROVIDER_ERROR（src/app/v1/_lib/proxy/errors.ts 第 778-797 行），转发器将走“供应商错误”路径：重试/切换供应商，并在重试耗尽后可能计入熔断器（src/app/v1/_lib/proxy/forwarder.ts 第 603-733 行）。

为什么需要新增规则

• 默认错误规则在 src/repository/error-rules.ts 的 DEFAULT_ERROR_RULES（第 292 行起）中维护；目前已有例如 PDF 页数限制（第 627-642 行）和图片大小限制（第 727-742 行），但未包含 Too much media 这类“媒体数量上限”报错的 pattern。
• 一旦新增规则命中，该错误会在分类阶段被视为 NON_RETRYABLE_CLIENT_ERROR（src/app/v1/_lib/proxy/errors.ts 第 784-788 行），并在 forwarder 中“立即停止、不重试、不切换供应商”（src/app/v1/_lib/proxy/forwarder.ts 第 414-472 行）。同时也可以通过规则的 overrideResponse/overrideStatusCode 覆写对外返回的错误体/状态码（src/app/v1/_lib/proxy/error-handler.ts 第 97-194 行）。

规则写法的关键点（示例思路）

• matchType: "contains" 会进行大小写不敏感的包含匹配（src/lib/error-rule-detector.ts 第 213-224 行、第 341-357 行）。用 pattern: "Too much media" 即可覆盖你示例里的报错文本。

为方便把规则做得更稳，请补充

• 该错误对应的 HTTP 状态码（上游 response.status）
• 是否存在其他变体文本（例如字段/语言不同，但同样表达“媒体数量超限”）

---

Automated response from Codex AI

[ding113]

@claude fix it

[ding113]

I've created a fix for this issue.

Pull Request: #572

Changes made:

• Added new error rule for "Too much media" pattern to src/repository/error-rules.ts
• Pattern: Too much media (contains match, case-insensitive)
• Category: media_limit
• Priority: 79 (placed after PDF limit rules)
• Override message: "媒体数量超过限制（文档页数 + 图片数量 > 100），请减少图片或文档页数后重试"

Once merged, this rule will:

1. Correctly categorize the error as a non-retryable client error
2. Prevent unnecessary retries and provider switching
3. Return a clear error message to the client explaining the media limit

Please review and let me know if you need any adjustments.

---

Response from Claude AI