tako 文档 GitHub

未提交改动审查交接(2026-09-30)

范围与结论

审查对象是当时工作区的未提交改动,包括未跟踪的 Go 文件;本文不是实现计划,也没有修改业务代码。主要改动:read_file 改为 enhanced 工具以返回图片片段,mediaoffload 将历史内联媒体落盘,msgtext 给事件和摘要提取多模态消息文字,guard 补齐 enhanced 工具钩子,WebUI 按既定计划迁移到 Gin。

组件边界整体可用:tools 负责产生工具回执,mediaoffload 负责模型输入中的媒体生命周期,guard 负责调用/输出策略,msgtext 负责文本呈现。优先改的是媒体的轮次身份、重新读取契约和缓存存储语义,而不是再拆更多包。

Gin 迁移已有独立决策与等价迁移计划(docs/superpowers/plans/2026-09-30-webui-gin-migration.md):handler 内继续用 c.Request / c.Writer 是有意控制响应差异,不作为本次重构问题。

待处理问题

1. P1:read_file 在限制大小前读完整文件

2. P2:同轮主动重读相同图片仍被抑制

3. P2:用历史消息数量推断轮次会与压缩冲突

4. P2:缓存文件未原子发布

5. P2:共享缓存缺少生命周期/总量边界

推荐顺序

  1. 先修 read_file 的有界读取,再修 Store 的原子发布,封住资源与不完整文件问题。
  2. 再统一“轮次 ID + 片段交付 ID”的状态模型,同时修复问题 2、3;不要只改 seen 的重置条件。
  3. 最后确定缓存的引用/清理契约,再实现容量策略。避免先做清理、再补偿已经失效的占位符。

验证记录

本文只记录审查与接手建议;工作区原有的未提交改动应原样保留。