51TODO — 劳动节后开工清单

创建于 2026-04-28。计划在 5月1日劳动节假后启动。本文件聚焦跨方向工作（Bus 升级 + 整体节奏）。表格模块的解耦与三模式落地详见 TableTODO.md。

一、全景

两条并行主线：

Bus tool-call 能力升级（本文 Phase A） —— 让任何 Amily2Bus 注册的插件都能定义自己的 tool_calls 工具集，LLM 调用时自动 dispatch 回 handler，跑 agent loop。
表格模块重构 + 三模式填表 —— 解耦 manager.js 上帝模块；新增 JSON / toolcall 填表模式；保留 legacy 默认，老用户零感知。详见 TableTODO.md。

两条线可并行，仅在表格的 toolcall 模式（TableTODO Phase C）落地时需要 Bus Phase A 完成。

register(pluginName) 返回的 context 上挂 tool：
- define(name, { description, parameters }, handler)
- undefine(name)
- list()

Options.js 加 tools / toolChoice 字段
RequestBody.toPayload 在有 tools 时包进 payload
ModelCaller._normalize 在响应含 tool_calls 时返回完整 message 对象（而非只返字符串）—— 注意做后向兼容标记

context.model.callWithTools(messages, options, { maxSteps = 8, onToolError = 'feedback' })
自动拼本插件 define 的工具进 request
收 tool_calls → 串行 dispatch 到对应 handler → tool result 回喂 messages
handler 抛错时 catch，把 error string 作为 tool_result 喂回 LLM 让其自纠
maxSteps 兜底，防死循环

Phase A 验收：

预估：1.5 天人时，风险中（agent loop 边界条件多）。

假后开工前先拍：

Phase A 与 TableTODO Phase 0 谁先：
- 选项 A：先 Phase A（Bus 升级），再 Table Phase 0
- 选项 B：先 Table Phase 0（解耦），再 Phase A
- 选项 C：并行两条分支
- 倾向：B（Table Phase 0 不依赖 Bus，先把表格上帝模块拆了，后续 Phase A 也好用 ToolRegistry）
Phase A 是否必须 ship 才能开 Table Phase B：
- 不必须。Phase B（JSON formatter）独立。Phase C（toolcall）才依赖 Phase A。
是否合并发版：
- 选项 A：Phase 0 → 单独 ship → Phase A → ship → Phase B/C → ship（增量发布，回归风险低）
- 选项 B：全部攒一起一次性发（节奏简单但风险高）
- 倾向：A，每完成一段先发，老用户始终能用 legacy。

合计 ~7.5 天人时。 假期 5 天 + 假后两周缓冲，5 月底前可全量上线。