fix(upstream): M51 复审 p2 三条 —— light.go 同形出口 / MCP SDK 日志面 / ErrorToken 口径

① light.go 的 2 处 "light judge: " + d.Reason 与 engage.go 同形(model reason →
返回值 → coalesce_prepare 的 Debug)。把上一轮的 engageReason 提成包内共用的
judgeReason(judge_reason.go,RedactTextLimited + strings.Fields,60 rune),
engage.go 7 处 + light.go 2 处 + notice.go 的 "notice review failed: "+err.Error()
统一走它。控制流零改动:只换「进去的那份文本」,判定条件与返回值拼接结构未动。

② MCP 的 Logger 面先探针后修:go-sdk v1.8.0 的 keepalive 会把对端 JSON-RPC error
原样打进日志(实测泄漏,见 sdklog_probe_test.go 的输出),tools/call 路径不打日志。
新增 sdklog.go:redactingLogger 交给 SDK,wire 错误(链上有 *jsonrpc.Error)只留
code + message_bytes(复用 upstreamError),本地错误保留原因,消息/属性压平+打码+300 rune。

③ errortoken.go 的口径注释纠正:从「包外不得调用」改为按字段类别判定(协议枚举可守、
自由文本默认不带),并把 cdp.go 这条 M51 用法作为例子写进去。
This commit is contained in:
AskaEth committed 2026-10-26 20:00:57 +08:00
1 parent 7fbb8d6232
commit 76263d42ed
11 files changed
+560 -47

No files matched your search

+28 -9
View File
@@ -2,22 +2,41 @@ package trace
import "strings"
// 本文件是「上游错误信封里的自由文本字段能不能出镜」的唯一守卫。
// 本文件是「上游错误里的某个字段能不能出镜」的守卫之一:只放行「像协议枚举」的短串。
//
// 背景:UpstreamErrorInfo 只解析 error.code / error.type 两个字段,而它们是**自由
// 文本面** —— 主流上游里它们确实是枚举(invalid_request_error、overloaded_error、
// Throttling.RateQuota …),但网关、代理与兼容层可以往里面塞任何东西,包括回显的
// 用户原文。因此这两个字段出镜前必须像令牌:短、只含标识符字符。
//
// 丢弃的代价只是少一条分类提示;保留一个不受控字段的代价是她的话进日志。这道守卫
// 原先在 runtime/model(safeErrorToken)与 runtime/multimodal/voice
// (dashscopeErrorToken)各有一份逐字同形的实现,M46 把同一份收敛到这里。
// 丢弃的代价只是少一条分类提示;保留一个不受控字段的代价是她的话进日志。
//
// 🔴 M49 收口:守卫的**应用点**同样收进本包 —— UpstreamError 构造时对 error.code /
// error.type 各调一次(构造即安全,调用点不必也不该再守),构造后的注入走
// UpstreamErrorInfo.SetCode / SetType(同一道守卫)。因此本包之外的 Go 代码里
// **不应出现 ErrorToken 调用**:出现了就意味着又回到「调用方逐点补」的漂移形态
// (M48 复审的 finding 正是这么漏的:httpclient / vision / embedding / weixin 四处)。
// 🔴 M49 收口的是**应用点**,不是调用权:UpstreamError 构造时对 error.code /
// error.type 各守一次(构造即安全),构造后的注入走 SetCode / SetType(同一道守
// 卫)—— 这样一来「新调用点默认安全」,不必也不该在 model/voice 里各抄一份。
//
// 🔴 M51 纠正口径(2026-10-26,复审 p2 裁定):本文件旧注释写的是「包外不应出现
// ErrorToken 调用」。那句话把 M48 的真实教训(**调用方逐点补守卫**会漏)错译成了
// 「只有本包能守」,于是把「按**字段类别**判定」这条正确口径一并否掉,而现实里包外
// 一直有正当调用。正确口径按字段类别分:
//
// - **协议枚举字段** —— error.code / error.type、CDP `error.message` 里的协议错误
// 名、各类状态码:值域是协议定义的短标识符 ⇒ 用 ErrorToken 守。像枚举就保留,
// 散文(带空格、标点、超长)一律丢弃;
// - **自由文本字段** —— error.message、模型/对端「说的话」、页面异常文本:**默认
// 不带**;确实要带时按「带上限地带」处理(rune 上限 + RedactText,见
// channel/adapter 的 reviewExcerpt 与 services/channelbridge 的 judgeReason),
// 绝不拿 ErrorToken 当清洗(它只会把整段话删掉,不是清洗)。
//
// 包外调用的现存例子(都是枚举口径,属正当用法):
// - `internal/capability/browser/cdp.go` 的 cdpError.Error():CDP error.message
// 只有像协议枚举才出镜,其余只留字节数(M51);
// - `internal/runtime/multimodal/voice/dashscope_error.go`:DashScope 的 code/type
// (M46 起就在包外调用)。
//
// 因此现在的约束只有一条:**调用前先确认那个字段是枚举口径**;自由文本字段不许用
// 它冒充清洗,也不许为了「新调用点安全」而在本文件之外复制一份守卫实现 —— 守卫本身
// 仍然只有这一份。
// maxErrorTokenBytes 是 error.code / error.type / request_id 允许出镜的长度上限。
// 64 字节足够容纳任何真实的枚举与 UUID 形状,又远小于「一段话」。