2 Commits

Author	SHA1	Message	Date
JianFeeeee	a02feaaff7	refactor(agent): 子 agent 类型抽象 + rt 输出异步 + 工具钩子统一 ... 三件事，都是同一个根因的症状：子 agent 的类型逻辑复制成多份， 于是标准路径上的能力没跟着传过来。 ## 1. 抽出 child 包（类型抽象 + 单一登记表） 新增 internal/agent/core/child/： child.go Kind / Child（嵌入用）/ State / 残余与通道处置 registry.go 单一 Registry + Entry 接口 + Cleanup 骨架 kind.go ChildKind —— 按两条主轴（上下文 / 工具与输出异步） kinds.go 四种子 agent 的清单与迁移状态 此前 Agent 上有两张互不知情的表（residents / rtChildren），各带一把锁。 实测新增一种子 agent 要改 18 个生产文件，并已因复制而漂移过一次 （StopRTChildren 漏注销入站登记，见 engineering-lessons.md §2.3）。 现在单数与复数停止**共用** Cleanup，那个形态在结构上不可能复现。 ## 2. rt 的输出改为异步（用户的原始诉求） rtEmit 曾直接 dev.Execute(...)，插件侧延迟（TTS/网络编码/字幕渲染） 直接节流模型的 token 消费 —— 「不攒整段」的收益全被吃掉。 新增 outputpump.go（输出通道的异步壳）： · Push 立即返回，交付由独立消费 goroutine 完成 · 有界队列（64），满则**丢最旧**（符合 rt 的"最新者胜"） · 丢弃与设备缺失都留痕，否则"用户听不到"没有任何线索 · Close 排空后退出，不吞最后半句 · 设备每片重新解析（插件崩溃会 Unregister，缓存指针会指向死设备） ## 3. 工具钩子统一（本轮最大发现） 实测：StageBeforeToolcall / StageAfterToolcall 全仓只在 task.go:1022/1079/1194，三处都在 runOneTool / stepToolAfter 里； 而 executeToolCallOutcome 内部**没有任何 runStage**。 ⇒ rtchild 与工作式子两条路径**完全跳过插件钩子**：不能审计、 不能拒绝、不能改参、不能脱敏。README 承诺的 before_toolcall 在这两条路径上不成立。 新增 toolbatch.go（唯一批执行实现：批并发 + 双钩子 + 顺序落结果）， 两种类型切过去。工作式子的"禁输出工具"与"保持串行"用 batchOpts 注入， 不各写一遍执行逻辑。 ## 判据（均经变异验证） TestRTChild_OutputIsAsync 改回同步 ⇒ 红（实测确认） TestOutputPump_DropsOldestOnFull 改阻塞/无界 ⇒ 红 TestOutputPump_CloseDrains 丢弃队列 ⇒ 红 TestOutputPump_ResolvesDeviceEachTime 缓存指针 ⇒ 红 TestRTChild_ToolsGoThroughPluginStages 绕开钩子 ⇒ 红 TestRTChild_StageCanDenyTool 同上 TestWorkerToolsGoThroughPluginStages 同上（变异实测确认） TestWorkerToolsStaySerial 改成并发 ⇒ 红 TestNoChildTypeTablesInCore 源码扫描，禁类型专属表回潮 TestRTChild_HasGraphMemory 等 5 条 rt 接入图记忆 ## 顺带修复 · rt 接入图记忆（参照驻留子的轻量内核形态）：此前 graphMem() == nil， memory_recall / memory_commit 在 rt 里全部不可达，每通电话从零开始。 默认只读（通话高频写入会灌满图谱噪声），4 个失败点合并成一个 rollback 闭包（逐点挂必然漏一处 ⇒ 泄 SQLite 句柄）。 · rt 的 PreferredProvider 走候选链（此前裸调 a.provider，优先源无效且零回退）。 ## 保留的语义（逐项确认仍在） 驻留子三层压缩：checkContextFull / handleChildContextFull / CompressResident 三种通道处置：ChannelRelease / Suspend / Takeover 残余 keep/drop + harvestResidentMemory child.Start() 的 7 个 goroutine 验证：build / vet / gofmt / go test -race 全绿； 且在干净检出（git worktree）上单独 build + test 通过。	2026-11-04 08:21:15 +08:00
JianFeeeee	fbccfe17ed	fix(rtchild): 同名复用串线 + 批量停止漏注销 ... 三处缺陷，全部在「回收/复用」这条线上 —— 单实例 e2e 天然测不到： 1. RTTranscript 读序（主线） 原实现先查留档、命中即返回。留档以 id 为键而 id 由模型给，于是 回收后同名重建，rt_transcript 返回的永远是上一通电话的原文， 且完全不报错。改为「在跑实例优先，无活实例才落回留档」。 2. StopRTChildren 漏注销入站登记 单数路径会 Unregister(child/rt-<id>)，复数路径没有。登记表共享、 按 name 全局唯一，残留随 create/destroy 单调累积，而外部没有任何 工具能单独注销一条 inputch。 3. 撤回一个错误的修法 一度在 SpawnRTChild 里 delete 留档。变异测试证明删掉它判据仍绿 （治不了串线），且有害：留档的意义正是「回收后父按需取原文」， 提前删掉会造成「推了信号却拉不到正文」。现仅在 CloseRTChild 写 同名键时自然覆写。 判据（均通过变异验证，去掉修复必红）： - internal/agent/core/rtchild_reuse_test.go（进程内，5 条） - internal/plugins/rtchild_reuse_e2e_test.go（跨进程真插件，3 条） ★ 写判据时踩到两个坑，一并记在注释里： - 前两版判据假绿（先塞留档被 Spawn 清理掉 / 新实例不 push 导致 「读到旧内容」与「读到空」都是 len==0），靠变异才发现没测到真东西 - 等 Rounds 不等于历史已入账（rtRunOnce 先 round++ 后 rtAppendHistory）， 与 dff745c 同一个坑；已改为等 history 条数	2026-10-30 21:54:40 +08:00