|
|
835688c94a
|
refactor(plugins): 按「内置插件判定标准」收敛内置清单 16 → 11
## 判定标准（写进 all.go 与 ARCHITECTURE）
**只有必须使用内部 SDK 能力（公开 SDK 没有的接口面）的插件，才留在
编译期内置清单**；其余一律外置为 .hmap 插件，独立编译、独立发版。
依据是 internal/plugin/proc/capability.go 的 withheldCapabilities：
内部 SDK 的 TerminalAPI/TrackerAPI/StatusAPI/SupervisorAPI/AdapterAPI/
SelftestAPI/ToolAPI/Publish 等能力面，外部插件在类型层就不存在。
需要它们的插件外置后功能会**静默消失**（不报错），必须内置；
只要公开能力的插件，留在内核里是白付重编成本。
## 内置 11 个（all.go 单一权威清单）
cli webui TerminalAPI/Tracker/Status/Supervisor/Adapter
agentcli EventPublish（终端输出走 Publish，公开 SDK 无此方法）
healthcheck SelftestAPI
pluginmgr failback 恢复链必需
seq ToolAPI
remotedevice RegisterChannel
clawhubadapter InjectInputSync
cfgmgr skillmgr seemedia（保留）
## 外置 8 个（源码保留，.hmap 由 SDK 仓 example/ 提供）
timer（此前）ai_image files cmd kbtree localuse mcp multimodal
## 同步修正
- kbtree 归位：它一直是编译期内置插件，却长期被 main.go 单独导入，
游离在 all.go 清单之外（文档盘点因此数错）。现移入 all.go，
main.go 不再单独导入任何插件，并加注释禁止该做法。
- integration_test：外置插件的 7 个用例（cmd_run/terminal_*）加
requireExternalTool 跳过保护——用例保留（行为判据仍有价值），
在纯内置装配下 Skip，不造假失败。
- 全部文档同步 11 个的清单与判定标准（中英四份 + 两份 README）。
## 已核实不做的事
- 保留的 11 个内置插件无一在代码里硬依赖被外置的插件：
cli 对 terminal_* 是 ExecuteTool 按名动态调用（运行时依赖）；
healthcheck/seq 只在白名单与示例文本里出现；webui 只订阅事件。
- kernelmod/（内核模块）与 plugins/（插件）严格区分：
kernelmod/multimodal 是内核装配模块，与外置的 multimodal 插件无关。
验证：go build ./... 全绿；go test ./internal/plugins/... 全绿；
webui 新增 5 条命令历史渲染回归判据（TestCmdHistory*）全绿。
|
2026-10-19 21:13:23 +08:00 |
|
