2 Commits

Author	SHA1	Message	Date
JianFeeeee	e70d2171ee	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
HomeAgent Agent	642e1c39b1	refactor(webui): handler.go 2993 行按资源拆成 11 个同包文件 ... 拆法：按「资源面」搬家，每个顶层声明（func/type/var/const）整体搬到目标文件， 声明体一字未改，各文件按实际用到的包重新生成 import。文件头加一行说明本文件负责哪一面。 handler.go 骨架：嵌入前端资源、Handler/构造、路由表、鉴权会话日志中间件、静态页 handler_chat.go 对话面：消息模型与内存历史、SSE 事件订阅、对话/历史接口 handler_upload.go 上传面：handleChatFile / handleUploads / 中断对话 handler_memory.go 记忆面：图/文档/文本记忆、知识库、LLM 源、变更追踪 handler_agents.go 内核与代理面：状态、kernel、人格、代理/快照/回滚 handler_settings.go 设置与插件面：配置读写、插件列表详情（含 pluginmgr 反代） handler_terminal.go 终端面：终端会话、终端接口、命令历史 handler_sse.go SSE 环形缓冲（断线重连补发） handler_openai.go OpenAI 兼容面：/v1/chat/completions handler_device.go 设备网关反代（HTTP + WS 升级透传） handler_files.go /files/ 与 /uploads/ 下载 零漂移校验：拿重构前的 handler.go 与新 11 个文件逐行比对（忽略空行、package/import 头）， **丢失行 0**；新增行恰好是 11 个文件头注释（14 行）。 顺带修掉 import 里两处假使用：handler_openai 的 sdk 只作为 Handler 字段名出现（h.sdk.）， handler_settings 的 fmt 只出现在注释里 —— 都从 import 里去掉。 验证：go build ./... / go vet / webui+config+sdk 测试全绿； 起真实实例（沿用已有 data 目录）后 /status /settings /chat/history /plugins /terminals /kernel /memory /config /login 全部 200，设置在注入 5MB 历史的情况下仍是 33,921 字节。 最大文件从 2993 → 706 行（handler_chat.go）。	2026-09-14 07:03:47 +08:00