2 Commits

Author	SHA1	Message	Date
JianFeeeee	667b9fdc8a	fix(webui): OpenAI 兼容面 —— 补 /v1/models + 真流式（原先是假流式） ... /v1/* 是**给外部程序用的**（IDE、脚本、agent 框架），不是给人看的聊天页。 它的行为必须真符合 OpenAI 协议，否则调用方直接坏掉。下面两条都在 **生产实测**中确认过，不是推理。 ## ① GET /v1/models → 404 几乎每个 OpenAI 客户端（curl 脚本、LangChain、OpenAI SDK、IDE 插件） 启动时都会先列模型来探测服务可用性。404 让它们直接判定「服务不可用」， 连试都不试 —— 这是集成方最容易踩空、也最难自查的缺口（表现为 「连不上」，而实际端点是通的）。 新增 handleOpenAIModels。返回什么模型**不重要**，结构合法才重要： 本端点不做模型选择（model 只是回显），所以只暴露 HomeAgent 自身。 不谎报 GPT 之类名字 —— 那会让用户以为能选模型，实际不能。 ## ② stream=true 是假流式 实测：首字节 7.79s，随后**整段**内容在一个 chunk 里到达。 根因：两条路径都走 InjectTextSyncNoMemory —— **同步等完整回复**才返回， 之后才把已拼好的全文切成 3 个 chunk 吐出去。客户端的「生成中」/取消/ 超时/进度条全部失效；300s 超时表现为「卡 5 分钟然后一次性出现」。 重写为真流式：先订阅 EventContentDelta / EventReasoningDelta **再**启动 注入（顺序反了会漏开头几个分片），边收边转成 chunk，最后用同步调用拿到的 完整回复补 usage、发 finish、[DONE]。沿用 handleSSE 的成熟结构 （批量 16ms 合并、独立 writer goroutine、done channel 而非 close）。 顺带处理内核的 reset 事件：流式失败回退非流式时内核会发 content="" + reset=true（见 internal/agent/core/process.go）。忽略它会让 客户端看到半截内容后又接上完整内容（重复且自相矛盾），故识别并丢弃累积。 ## 判据（4 条，变异验证） - TestOpenAIModelsEndpoint / RequiresAuth - TestOpenAIStreamIsActuallyStreaming - TestOpenAINonStreamUnchanged（别把非流式改坏） ★ **判据本身踩了两个坑，都已修正并记在测试注释里**： 1. `httptest.ResponseRecorder` 把整个响应**缓冲在内存里**，请求结束才交付 —— 它**根本观察不到流式**。用它写的流式判据必然是假的。故改用 `httptest.NewServer` + `bufio.Reader` 逐帧读。 2. 「要求首帧早于末帧」**抓不住**假流式：假流式确实是分多次 write 的， 帧间间隔是微秒级 > 0，任何 `> 0` 判据都绿（已实测）。 真正能区分的是：**首帧是否早于「内核产出最终答案」那一刻**。 于是假内核被构造成：发 3 个增量后**扣住**最终响应，直到消费者 表现出「已在读帧」才放行 —— 真流式首帧 0.35s，假流式首帧 3.30s。 3. 鉴权判据一度写错：未登录时门户 302 到 /login，若跟随重定向就会拿到 登录页的 200，把「被重定向」误判成「鉴权通过」。改用不跟随重定向的 客户端。 变异验证：去掉 /v1/models 路由 → 判红（还原 404）； 不转发增量 → 判红（首帧 3.30s）。 全量：35 包全绿。	2026-09-26 13:49:59 +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