error rule 新增：Invalid `signature` in `thinking` block

[ding113]

error rule 新增：Invalid signature in thinking block
现有规则均无法匹配。
常见于非 Anthropic 渠道与 Anthropic 渠道互相切换。
示例错误内容：

{
  "type": "error",
  "error": {
    "type": "request_fail",
    "upstream_error": {
      "type": "error",
      "error": {
        "type": "invalid_request_error",
        "message": "messages.1.content.0: Invalid `signature` in `thinking` block"
      },
      "request_id": "req_011CWkB65DcNzK2MiofhXx8b"
    }
  },
  "request_id": "req_011CWkB65DcNzK2MiofhXx8b"
}

[coderabbitai]

🔗 Similar Issues

Possible Duplicates

• 关于CC部分模型开启 Thinking 模式后，多轮对话中包含 Tool Use 时报 400 错误（历史记录缺少 thinking 块） #489

Related Issues

• error rule 新增错误规则 all messages must have non-empty content except for the optional final assistant message #432

👤 Suggested Assignees

• lvyandev
• ding113

---

Enable issue planning

_{To enable issue planning, add the following to your .coderabbit.yaml:}

issue_enrichment:
  planning:
    enabled: true

_{You can then request a plan by commenting @coderabbitai plan on any issue.}

🧪 Issue enrichment is currently in open beta.

You can configure auto-planning by selecting labels in the issue_enrichment configuration.

To disable automatic issue enrichment, add the following to your .coderabbit.yaml:

issue_enrichment:
  auto_enrich:
    enabled: false

💬 Have feedback or questions? Drop into our discord!

[ding113]

@claude fix it

[github-actions]

感谢您提出这个增强建议。

基于我对代码库的分析：

Error Rule 系统概述

Claude Code Hub 的错误规则系统支持三种匹配类型：

• contains: 包含匹配（最快，O(n*m)）
• exact: 精确匹配（使用 Map，O(1)）
• regex: 正则匹配（最灵活但最慢）

相关代码位置

• 规则检测引擎: src/lib/error-rule-detector.ts (lines 1-442)
• 数据库 Schema: src/drizzle/schema.ts (lines 351-377) - errorRules 表定义
• Server Actions: src/actions/error-rules.ts (lines 61-201) - createErrorRuleAction 函数
• 默认规则定义: src/repository/error-rules.ts (lines 292-689) - DEFAULT_ERROR_RULES 数组

关于 "Invalid `signature` in `thinking` block" 错误

根据您的描述，这个错误常见于非 Anthropic 渠道与 Anthropic 渠道互相切换时。基于错误消息的结构：

{
  "type": "invalid_request_error",
  "message": "messages.1.content.0: Invalid \`signature\` in \`thinking\` block"
}

建议的规则配置

对于这个错误，推荐使用 contains 匹配类型：

• Pattern: Invalid \signature` in `thinking` block`
• Match Type: contains
• Category: thinking_error (已存在于 src/actions/error-rules.ts:67)
• Priority: 建议设为 75-80（位于现有 thinking_error 规则附近）
• Override Response:

  {
    "type": "error",
    "error": {
      "type": "thinking_error",
      "message": "thinking 块签名无效，通常发生在不同渠道切换时。请尝试重新发送请求或切换供应商"
    }
  }

实现方式

管理员可以通过以下两种方式添加此规则：

1. Web UI (推荐): 访问 /settings/error-rules 页面，使用可视化界面添加
2. 数据库直接插入: 手动插入到 error_rules 表中

添加规则后，系统会：

• 自动触发缓存刷新（通过 Redis pub/sub 同步到所有 worker）
• 在运行时匹配该错误并返回友好的中文提示
• 避免不必要的重试（因为这是非临时性错误）

与 Issue #489 的关系

虽然 #489 也涉及 thinking 相关错误，但两者场景不同：

• 关于CC部分模型开启 Thinking 模式后，多轮对话中包含 Tool Use 时报 400 错误（历史记录缺少 thinking 块） #489: AWS Bedrock 要求 thinking 块必须在 tool_use 之前（协议转换问题）
• error rule 新增：Invalid signature in thinking block #518: thinking 块的签名验证失败（渠道切换兼容性问题）

这两个问题需要分别处理。

---

Automated response from Claude AI

[github-actions]

感谢反馈。

可行性/现状（基于代码）

• 错误规则匹配的输入优先是上游原始响应体 upstreamError.body（这样可以匹配嵌套 JSON 里的任何字段）；没有响应体时才回退到 error.message（src/app/v1/_lib/proxy/errors.ts lines 469-475）。
• 规则一旦命中，会被归类为 NON_RETRYABLE_CLIENT_ERROR，在转发器里会“立即停止，不重试/不切换供应商”（src/app/v1/_lib/proxy/forwarder.ts lines 413-471；分类入口在 src/app/v1/_lib/proxy/errors.ts lines 784-788）。
• 当前默认 thinking_error 规则只覆盖 thinking format invalid / Expected ... thinking ... but found ... / clear_thinking ... 等分支，并不包含你示例里的 “Invalid `signature` in `thinking` block”（src/repository/error-rules.ts lines 608-623）。

建议（新增默认规则）

• 在 src/repository/error-rules.ts 的 DEFAULT_ERROR_RULES 里增加一条 category: "thinking_error" 的规则；就这个报错文案而言，用 matchType: "contains" + pattern 包含该固定短语会更稳妥（能覆盖前缀如 messages.1.content.0:，也避免正则转义/安全校验带来的复杂度）。例如：

{ 
  pattern: "Invalid `signature` in `thinking` block",
  category: "thinking_error",
  matchType: "contains",
  // 需要的话可复用现有 thinking_error 的 overrideResponse
}

• 如果希望返回更友好的提示，可以同时配置 overrideResponse；覆写响应会在错误处理阶段应用（src/app/v1/_lib/proxy/error-handler.ts lines 97-193）。

如果该错误在不同中继/渠道里还有其他变体（比如没有反引号、字段路径不同），欢迎补充更多样本，方便把 pattern 做得更通用但不误伤。

---

Automated response from Codex AI

[ding113]

I've created a fix for this issue.

Pull Request: #519

Changes made:

• Added new error rule to match "Invalid `signature` in `thinking` block" error
• Used contains match type for precise pattern matching
• Priority 71 (higher than generic thinking error at 70) ensures this specific error is caught first
• Provides clear Chinese error message explaining the cross-channel incompatibility

How it works:
When the error "Invalid `signature` in `thinking` block" occurs, the system will now:

1. Match it against the new error rule
2. Return a user-friendly message: "thinking 块签名无效，通常发生在 Anthropic 渠道与非 Anthropic 渠道切换时，请检查请求格式"
3. Categorize it as a thinking_error type

The new rule will be automatically synced to the database on application startup or when the error rules cache is refreshed.

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

---

Response from Claude AI