2 Commits

Author	SHA1	Message	Date
root	3119d48625	refactor(terminal): 终端逻辑回归 agentcli，内核不再编码终端语义 ... 按用户指正调整架构：终端是 agentcli 的职责，内核不该有终端逻辑；插件与 agentcli 的联动应走事件总线，而不是内核内部组件。 ## 删掉内核里的终端语义 `internal/agent/core/terminal_registry.go`（280 行）整体删除。它做了两件不该 内核做的事：定义「什么是终端会话」、从 EventToolCall 的 Go map 文本里解析 terminal id / command 并归并会话与命令历史。连带移除： - Agent 的 terminalReg 字段、构造、subscribeTerminalRegistry 订阅 - StatusAPI 上的 ListTerminals / CmdHistory - sdk.TerminalAPI + PluginSDK.Terminal() + Registry.SetTerminalAPI 及接线 - 对应测试（迁到插件侧视图包） 保留 `sdk.TerminalStatus` / `CmdExecStatus`：它们只是线上 JSON 格式，WebUI/CLI 返回给前端时口径一致。 ## 插件侧订阅事件总线自攒视图 新增 `internal/pluginview`（TerminalView）：把原先内核那份归并逻辑原样搬过来， 由插件自己持有。数据源仍是两条总线事件： EventTerminalOutput（agentcli 发）→ 会话输出 + 生命周期 EventToolCall （内核发） → cmd_run 历史、terminal_create/close 归并 WebUI 在 NewHandler 订阅、Close 退订；CLI 在 Start 订阅、Stop 退订。 两边共用同一实现，避免历史上「两份推导各踩一次 Go map 文本」的坑。 视图不是权威：真值在 agentcli，插件晚于会话启动会缺早期会话（注释写明）。 ## agentcli 保持内置 它现在仍需要 `Publish`（进程内事件总线写入）——外部插件没有上行事件通道 （`EventPublish` 在 withheldCapabilities 里，proc 只有 events.subscribe）。 按判定标准留内置；将来要外置，须先开一条受控的插件→内核上行事件通道， 本次刻意不开（用户决定：先保持内置）。 ## 文档 中英 ARCHITECTURE 新增「终端归属」小节：说明职责边界、两条事件、视图非权威、 以及 agentcli 为何仍内置；内置判定表里 cli/webui 去掉 TerminalAPI 一项。 ## 验收（本机实例实测） - 内核编译通过，删除后 `go build ./... && go vet ./...` 干净，`go test ./internal/...` 全绿 - 实例重启后：让 agent 开终端跑 `echo term-view-test` → WebUI `GET /api/v1/terminals` 返回 term_1（output 正确、running=false） CLI `/terminals`（unix socket）返回同一份； 两处都是从事件总线自攒，内核侧无终端代码参与 - cmd 历史分支由迁过来的单测覆盖（Go map 文本解析、生命周期、上限裁剪）	2026-10-20 09:33:08 +08:00
JianFeeeee	dbc493a545	refactor(terminal): 内核开终端/命令历史权威视图，WebUI 与 CLI 都改接内核 ... 按「内核开，两个插件接」重构终端与命令历史的数据归属。 背景：此前 WebUI 与 CLI 各订 EventToolCall/EventTerminalOutput 攅一份状态， 同一件事两份推导，还各自踩过同一个坑——工具 result 是 Go 的 map 文本 （map[cols:80 ... id:term_2 ...]），断言成 map[string]interface{} 永远失败， terminal_create 的 id 回填不生效，/terminals 因此恒空（WebUI 也一样）。 实测确认：WebUI 自己的 /api/v1/terminals 与 /api/v1/cmd/history 同样是空的。 内核开（权威唯一真相）： - internal/agent/core/terminal_registry.go：TerminalRegistry 归并两类事件—— EventToolCall（terminal_create/close、cmd_run，id/command 从 args 或 Go map 文本回填）与 EventTerminalOutput（agentcli 生命周期 + 输出，含 64KB 缓冲上限、 100 条命令历史、50 个终端上限）。 - internal/sdk/terminal.go：新增 TerminalAPI（ListTerminals/CmdHistory）与 TerminalStatus/CmdExecStatus DTO。**不塞进 KernelStatus**：那是全量快照， 前端每 3 秒轮询 /kernel，背上每终端最多 64KB 输出会让轮询成本爆炸； 终端输出是按需拉取的明细，另开接口。 - Agent 订阅自己的事件总线（subscribeTerminalRegistry），且**只根 agent 建** （驻留子共用同一总线，每个子都建会 N+1 份重复记账）。 - SDKConfig/Registry/bootstrap 接线：pluginReg.SetTerminalAPI(agent)。 生产者补全（agentcli）：终端无输出时 ticker 不发事件，内核就无从知道终端 存在。新增 emitTermState，在 handleCreate/handleClose/readLoop 退出（超时/ 进程结束/读取错误/stopCh）显式上报 running 状态，并给输出事件补 command 字段。 handleClose 改为接收 *sdk.PluginSDK 以便上报。 两个插件接（消费方）： - WebUI：删掉本地 termStates/cmdHistory/subscribeTerminalStream/handleToolEvent 及不再使用的 getStr；/terminals 与 /cmd/history 直接读 s.Terminal()。 - CLI：删掉上一轮刚加的 subscribeToolEvents 与 cliTermState/cliCmdExec； /terminals 与 /cmd/history 直接读 s.Terminal()。两条路（local/remote）都通。 测试：新增 terminal_registry_test.go，锁死 Go map 文本解析（旧缺陷根因）、 生命周期、CLI 直调路径（无 EventToolCall 仅凭 output 事件建条目）、历史与 终端数量上限。全量 go test ./internal/... ./cmd/... 通过。	2026-09-17 18:56:15 +08:00