错误规则匹配到后在决策链记录具体规则

[ding113]

感觉错误规则那个页面还是比较迷糊，能不能匹配到规则之后特别标注一下那个请求

[github-actions]

感谢这个功能建议。

分析：

经过对代码库的调查，我理解您希望在错误规则匹配时，能够在决策链中记录具体匹配到的规则信息，以便更清晰地追踪和排查问题。

当前实现：

1. 错误规则检测器 (src/lib/error-rule-detector.ts lines 22-31) 已经返回了匹配的规则详情：

   • category: 错误分类
   • pattern: 匹配的规则模式
   • matchType: 匹配类型（regex/contains/exact）

2. 决策链结构 (src/types/message.ts lines 64-100) 已支持记录错误详情 (errorDetails)，包括：

   • 供应商错误 (provider)
   • 系统错误 (system)
   • 客户端错误 (clientError)

3. 错误规则数据库表 (src/drizzle/schema.ts lines 352-379) 包含：

   • id: 规则 ID
   • pattern: 匹配模式
   • category: 错误分类
   • description: 规则描述

实现考虑：

要实现此功能，需要：

1. 在 ProviderChainItem["errorDetails"] 中添加错误规则匹配信息字段，例如：

   errorRuleMatched?: {
     ruleId?: number;      // 规则 ID（便于关联查看）
     category: string;     // 错误分类
     pattern: string;      // 匹配的模式
     matchType: string;    // 匹配类型
     description?: string; // 规则描述
   };

2. 在 src/app/v1/_lib/proxy/errors.ts 中修改 detectErrorRuleOnceAsync 函数，使其返回的结果包含更多规则信息（如规则 ID 和描述）。

3. 更新决策链格式化器 (src/lib/utils/provider-chain-formatter.ts) 以在时间线中显示匹配的规则信息。

相关实现：

• 错误规则检测入口：src/app/v1/_lib/proxy/errors.ts (lines 493-505)
• 决策链记录：src/app/v1/_lib/proxy/session.ts (lines 356-419 addProviderToChain)
• 错误详情格式化：src/lib/utils/provider-chain-formatter.ts

注意事项：

此功能与已关闭的 #350 相关（命中错误规则时记录错误详情到决策链），可作为其增强功能来实现。

---

Automated response from Claude AI

[github-actions]

感谢反馈。

现状（基于代码）

• 错误规则在表 error_rules 中定义：包含 id/pattern/match_type/category 以及可选 override_response/override_status_code（src/drizzle/schema.ts 第 353-379 行）。
• 运行时匹配由 errorRuleDetector.detectAsync() 完成，返回 ErrorDetectionResult：matched/category/pattern/matchType/override*，没有 rule id/description 字段（src/lib/error-rule-detector.ts 第 22-31 行、第 287-363 行）。其中 contains/exact 会把 pattern 先转小写再匹配并返回小写值（第 197-217 行、第 321-346 行）。
• 命中规则后目前会走两条逻辑：
  • 任何 matched=true 都会被归类为 NON_RETRYABLE_CLIENT_ERROR（src/app/v1/_lib/proxy/errors.ts 第 768-778 行）。
  • ProxyErrorHandler 会调用 getErrorOverrideAsync() 应用响应体/状态码覆写（src/app/v1/_lib/proxy/error-handler.ts 第 97-127 行；src/app/v1/_lib/proxy/errors.ts 第 573-588 行）。
• 请求日志的“决策链/供应商链”实际写入的是 message_request.provider_chain，由 ProxyErrorHandler.logErrorToDatabase() 保存 session.getProviderChain()（src/app/v1/_lib/proxy/error-handler.ts 第 308-335 行）。
  • 在不可重试客户端错误分支，会追加一个 reason: "client_error_non_retryable" 的链路项，但目前只记录 errorMessage / errorDetails，不包含“命中的哪条 error rule”（src/app/v1/_lib/proxy/forwarder.ts 第 447-488 行）。

因此
目前后台只能看到“命中过某条规则导致 non-retryable”（reason），但看不到具体是哪条规则（id/pattern/description）。

实现这个需求的落点（供讨论）

• 如果想在决策链里精确定位到规则：需要把规则标识（至少 id，或 category+pattern+matchType）持久化到 provider_chain（或新增 message_request 字段）。现有 ErrorDetectionResult 没有 id，所以要么扩展 detector 返回 ruleId，要么用返回的 pattern/matchType 去做映射（注意 contains/exact 会 lowercase）。
• 前端展示侧目前也没有针对 client_error_non_retryable 的专门格式化分支，会走默认显示（src/lib/utils/provider-chain-formatter.ts 第 626-628 行），所以如果要“特别标注”，也需要 UI 侧读取并渲染上述元数据。

想确认一下你期望“标注”的位置：是在日志列表里加一个 badge（例如显示规则 category/description），还是在日志详情弹窗的决策链时间线里展示可点击的规则链接（id）？

---

Automated response from Codex AI