fix(seq): 类型不匹配的错误改成模型可执行的话(真机实跑发现)

真机实跑(独立实例)发现:模型把 group 的 `in` 传成字符串 "{}",
拿到的是 encoding/json 的原始报错:

  json: cannot unmarshal string into Go struct field rawSeq.groups.0.in
        of type map[string]string

这句说的是**事实**(string 解不成 map)而不是**该怎么做**
(in 应该写成对象 {"键":"类型"});残留的 `rawSeq` / `Go struct field`
更是 Go 内部实现细节,对模型无意义且会误导它去猜一个叫 rawSeq 的东西。
模型为此**重试了 3 次**才改对。

这与本仓反复吃亏的那类问题同源:`20s` 少引号 → 静默降级 →
cmd_run 失败率 34%。**报事实不报改法,模型只能猜。**

改动(parse.go):新增 friendlyJSONError,把原始报错翻译成可执行文案
· in / out 类型不符 ⇒ 说明"应写成对象 {键:类型};无入参请写 {}"
· tools 类型不符 ⇒ 说明"应写成字符串(内容是 ; 分隔的 JSON 对象)"
· groups / name / when / missing / timeout / on_error ⇒ 逐个说明期望
· 未知字段 ⇒ 列出 group 允许的全部字段名(拼写错误最常见)
· shortFieldName 剥掉 `rawSeq` 这类包内类型名前缀
· jsonKind / goTypeName 把 Go 类型翻译成模型看得懂的说法

判据(parse_test.go,2 条):
· in 传字符串 ⇒ 错误须指名字段、须说明该传对象、**且不得残留 Go 内部类型名**
· tools 传数组 ⇒ 错误须指明 tools 且说明它是字符串

★ 变异验证时踩了一次坑:第一次变异让 friendlyJSONError 不被调用,
结果**编译失败**(函数变成未使用),判据压根没跑,我却看到 "ok"。
改用可编译的变异(函数保留、开头直接 return err)后判据正确 FAIL。
★ 教训:**"变异后判据通过"要先确认变异真的生效**——编译失败 ≠ 判据通过。

真机复验:模型读一次即懂,并明确说"提示里的意思很明确";
修复前它为此重试 3 次。

回归:internal/plugins/... internal/agent/core internal/sdk 全绿。
This commit is contained in:
JianFeeeee
2026-09-27 13:43:39 +08:00
parent 7e1169bcda
commit 0b96d6d78c
2 changed files with 153 additions and 1 deletions

View File

@ -272,3 +272,55 @@ func TestBracesInsideStringDoNotAffectDepth(t *testing.T) {
t.Errorf("command 被破坏: %q(期望 %q)", got, command)
}
}
// ①' ★ 字段类型不匹配的错误必须**可执行**(真机实跑发现的缺口)。
//
// 实测:模型把 `in` 传成字符串 "{}",拿到的是 encoding/json 的原始报错:
//
// j 序列 JSON 解析失败: json: cannot unmarshal string into Go struct
// field rawSeq.groups.0.in of type map[string]string
//
// 这条文案对模型**不可执行**:它说"string 不能解到 map",却没说
// "`in` 应该是对象 {键:类型}"。模型为此重试了 **3 次**才改对。
//
// 这正是本仓反复吃亏的那类问题(`20s` 少引号 → 静默降级 → 34% 失败率):
// 报"事实"而不报"该怎么做",模型只能猜。
func TestParseTypeErrorIsActionable(t *testing.T) {
// in 传字符串(模型最常犯:以为能写 "{}")
bad := `{"name":"t","groups":[{"name":"g","in":"{}","out":{"x":"string"},` +
`"tools":"{\"tool\":\"cmd_run\",\"args\":{},\"as\":\"x\"} ;"}]}`
_, err := Parse([]byte(bad))
if err == nil {
t.Fatal("in 传字符串却通过了")
}
msg := err.Error()
// 必须指出**哪个字段**
if !strings.Contains(msg, "in") {
t.Errorf("错误应指明出错的字段 in,实际: %s", msg)
}
// 必须说明**该传什么**
if !strings.Contains(msg, "对象") && !strings.Contains(msg, "{") {
t.Errorf("错误应说明该传对象(如 {\"键\":\"类型\"}),实际: %s", msg)
}
// 必须剥掉 Go 内部类型名 rawSeq(那是实现细节,对模型无意义且误导)
if strings.Contains(msg, "rawSeq") || strings.Contains(msg, "Go struct field") {
t.Errorf("错误里残留 Go 内部类型信息(模型无法据此行动): %s", msg)
}
}
// ②' 同类问题:tools 传数组而非字符串(模型可能照直觉传数组)。
func TestParseToolsTypeErrorIsActionable(t *testing.T) {
bad := `{"name":"t","groups":[{"name":"g","in":{},"out":{"x":"string"},` +
`"tools":[{"tool":"cmd_run","args":{},"as":"x"}]}]}`
_, err := Parse([]byte(bad))
if err == nil {
t.Fatal("tools 传数组却通过了")
}
msg := err.Error()
if !strings.Contains(msg, "tools") {
t.Errorf("错误应指明 tools 字段,实际: %s", msg)
}
if !strings.Contains(msg, "字符串") {
t.Errorf("错误应说明 tools 是**字符串**(内含 ; 分隔的 JSON 对象),实际: %s", msg)
}
}