2 Commits

Author	SHA1	Message	Date
JianFeeeee	3d31037f63	test(seq): 端到端接线判据，抓出「传参方式完全不可用」的真 bug ... P1–P4 的判据都在**包内**（假 runner / 直接调函数），覆盖的是**语义**； 本轮补的是**接线**层——参数名对不对、返回值模型读不读得懂、跨层调用断不断。 接线层的 bug 语义判据抓不到：例如工具注册了但参数名拼错，单元判据全绿 而模型永远传不进来。 ★ 抓到一个真 bug：**seq_create 走 groups 传参时完全不可用**。 根因：marshalGroups 只把 groups 包进 JSON 文档、不带 name，而 Parse 要求 name 非空 ⇒ 报「序列缺少 name」。而 seqCreate 里那句 `if seq.Name == "" { seq.Name = name }` 回落分支是**死代码**（Parse 早就失败了）。 后果：**只有 file 方式能用，传参方式一律失败**。 已修（name 一并包装）。包内判据抓不到这个——它们直接构造 *Sequence， 不经过这条路径；只有真正 dispatch 一遍才暴露。 判据（e2e_test.go，7 条）：真实 dispatch 串通 seq_create → seq_list（须展示签名，模型据此按名调用）→ seq_run （执行序按 tools 声明序、槽回填、结果里**不得**出现 Go 的 `map[` 语法） · seq_call 按名调用 group 并返回其出参 · seq_when_call 条件为假 ⇒ 跳过且**零工具被执行** · seq_when_call 条件畸形 ⇒ **报错**且零执行（不得静默跳过） · seq_create 走**文件**（长序列的主力用法） · groups 与 file 同时传 ⇒ 报错「二选一」 · seq_delete 不存在 ⇒ 报错（模型会以为删掉了） 过程中又一次臆造 helper（`writeFile`），改用 os.WriteFile； 并把三处 `_, _ = p.dispatch(...)` 补上 err 检查（正是 go-ignored-call-result 报的那类）。 回归：seq -race 全绿；go build ./... 通过；go test ./internal/... 全绿。	2026-09-27 13:18:19 +08:00
JianFeeeee	71c894c182	feat(seq): 六个 seq_* 工具、插件装配，并补内核两处缺口（插件线 P4） ... 内核缺口（都是 P3 落地时暴露的真实缺陷）： · **GetAllTools 丢 ParallelSafe**：它只带出 Name/Description/Parameters， 插件看到的设备工具一律"不可并发" ⇒ 设备工具的并发声明**对插件不可见**。 · **ToolAPI 缺按名查**：新增 ToolDefByName。插件需要在**运行前**判断目标 是否存在/是否并发安全（工具动态注册，"不存在"是常态）， 而 GetAllTools 只能拿到全量列表。查不到返回 nil，不 panic。 seq 插件： · plugin.go：插件骨架 + kernelRunner（把 sdk.ToolAPI 收窄成三个方法， 判据因此能用假实现驱动，不必构造整个内核） · tools.go：六个工具定义（独立真相源，注册/判据/文档都从它取） · handlers.go：seq_create/list/delete/run/call/when_call 的实现 · register.go + all.go：按 skillmgr 同一范式 init 注册 ★ 过程中解决一个**我自己的设计矛盾**： 判据原先要求 `seq_call` / `seq_when_call` 进黑名单，但"按名调用 group/序列"恰恰是本包的核心能力——禁掉它，序列就退化成单层脚本。 分层澄清后：黑名单只管**对外发消息 / 起子 agent / 改插件表 / 再跑整条 序列**；seq_call 系列留给序列内部组合，其递归由 maxCallDepth + 环检测 负责（设计文档 §8.3 本来就是这么定的，我把两层混了）。 `seq_run` 留在黑名单：序列内再跑整条序列语义上是递归。 **六个工具一律不声明 ParallelSafe**：seq_run/seq_call 会执行一串工具， 其中可能含写操作；标成并发安全会让内核把两条 seq_run 并发跑， 两个序列的执行顺序交错、变量表互相污染。 安全性：序列名与文件路径都做穿越防护（`..` 段、分隔符、空名）。 过程中四次自伤： 1. 臆造 `jsonMarshalIndent`（不存在）→ 改 encoding/json.MarshalIndent； 并把 execGroup 的 runner 传错成 p（应 p.runner）。 2. seq 判据里写了 `black(name)`，而 blacklisted 是**谓词**不是函数。 3. 一次 python 替换删漏，把「跨序列目标存在性检查」那段从 CheckNew 里整段摘掉又贴回原处——靠编译错误发现。 4. ★ 注册失败我写了 panic：内置插件在 main() 装配期加载，panic 会 **直接拖垮内核启动**，而"某个工具没注册上"只该让该工具不可用。 已改为 log.Printf + 继续（与 clawhubadapter / mcp 一致）。 变异验证：把 seq_run 移出黑名单 ⇒ 黑名单判据 FAIL。 判据（plugin_test.go，6 条）：六个工具全部注册且 description/参数 schema 非空；seq_create 声明 required 并说明 groups/file 二选一； seq_run 说明"按数组顺序"；六个工具均未声明 ParallelSafe； 黑名单含递归风险项且**不误伤** seq_call 与普通工具。 回归：seq -race 全绿；internal/sdk/... internal/plugins/... 12 包全绿。	2026-09-27 13:05:28 +08:00