38 Commits

This Branch

This Branch

All Branches

Author	SHA1	Message	Date
thzxx	99d0c54129	feat: v0.7.4 时序语义修正 · 防线实效补漏 · 全量测试翻倍 — 2406 用例 + jsdom 组件测试全量回归 ... P1 修复面收口: - 超时三态区分（aborted→USER_INTERRUPT / ETIMEDOUT→TIMEOUT / 其余→ERROR）， 根治"真实网络超时被误报为用户中断" - 流空闲超时统一（SSE/Ollama/Anthropic 读循环 60s 无数据抛 504 进重试通道） - 同会话并发 sendMessage 防重入（isRunning 守卫）+ 会话存在性预检 + 前置调用移入 try（ERROR+DONE 双事件保证，根治 isStreaming 假死） - 清空审计后 resetChainCache（根治 verifyChain 误报 TAMPERED） - DONE 不再提前清理 TRACE（TERMINATED 统一收尾，补全最终迭代录制） - IME 合成回车不发送（普通 Enter + Cmd/Ctrl+Enter 双分支）+ handleSend 闭包修复 P2 安全纵深: - preload 移除原始 electronAPI 暴露（渲染层零使用，关掉 XSS invoke 任意通道单点风险） - CORS 同源回显根治（仅当前浏览页面 Origin，did-navigate 同步） - MEMORY.md 命令保护正则扩展（括号/$/反引号/< 重定向边界 + 前导路径） - write_file append TOCTOU 统一（open 后 realpath 校验，新文件分支补漏） - 敏感键归一化（authKey 驼峰/连字符命中）+ MCP headers 鉴权值加密落库 - ReDoS 检测共享化（search_files/file_editor 统一拦截） - run_tests/lint_code 升风险 + 需确认 + npx --no-install（执行边界对齐 run_command） - MCP/SearXNG/llm.baseURL/updateFeedUrl 配置类 URL 高危目标校验（IPv6 去括号 + 十六进制映射解析 + 尾点剥离） P3 架构还债: - temperature/maxTokens 热生效（引擎/编排器/SubAgent 三处接线）+ setBatch 单事务落盘 - SessionRecorder flush 竞态根治（flushPromise 等待 + 超限内联落盘 + stopRecording async） - 内存收口（lastConsolidationBySession LRU / subTraces 清理 / 会话删除 disposeEngine） - i18n 全量收口（28 组件 + 353 key 双字典，状态标签改渲染时函数） - 死代码清理（updateTraceStep/HEADER_HEIGHT/void preA/失实注释） - 斜杠菜单 MUI 化 + 删除逻辑收敛 resetSessionState + Blob URL 统一释放 + 用户消息"仅保存"落库（saveMessage 透传前端 id 修复 id 错位） P4 能力演进: - 死循环检测拆分（驻留前置 + 乒乓后置带进度信号，合法交替不误报） - run-lock 30s 超时强制 abort（旧 run 卡死不无限排队） - RETRY 双通道 stream_reset（前端按 run 归属精确清空，根治重试文本重复） - FTS5 trigram 中文子串搜索（迁移 9 版本化 SCHEMA_VERSION=2，≤2 字符 LIKE 回退） - getContextWindow 兜底 1M→128K（未知模型防 413） 测试: - 855 → 2406 用例（+1551，2.8 倍）：服务层 +325（含 MemoryManager 51 新用例）、 工具实体 +483、IPC/适配器 +390（含 OpenAI/Anthropic/Ollama 独立套件）、 纯函数表格化 +330；引入 jsdom + @testing-library（14 组件测试文件 249 用例） - 修复 R1（saveMessage id 透传）/ R2（stream_reset 精确归属）两个回归缺陷 - 遗留低危项清零：git-tools 顺序耦合 / web-fetch 真实时间退避 / slo 内存断言 / mcp-security 多余 skipIf / deepseek-balance 命名误导 / 组件 mock 注入脆弱性 版本: 0.7.4; README 同步（工具风险表/版本徽章）; 依赖: 移除 @electron-toolkit/preload， 新增 jsdom/@testing-library（devDependencies 不打包） 回归: typecheck 双端 0 错误; ESLint 0/0; Electron ABI 全量 2406/2406 零跳过; 系统 Node 2110 通过 296 跳过（better-sqlite3 ABI）	2026-08-30 19:19:07 +08:00
thzxx	ebe45482b0	feat: v0.7.3 成本收口 · 状态一致 · 死账清理 — Prompt Cache 根治 + SSRF DNS Pinning + 87 用例扩充全量回归 ... P1 修复面收口: Prompt Cache 根治(日期/记忆/附件三类易变内容出 system 入用户消息 前置块 user-context.ts, system 跨 run 字节级稳定; Anthropic system 块数组化 + cache_control ephemeral 断言, DeepSeek 自动缓存前缀命中 — 多轮对话输入 token 成本降数量级); 编辑重发/重新生成幽灵 Trace 双侧根治(DB truncateMessagesAfter 同步过滤 metadata.traceSteps + 前端 trimTraceStepsByAnchor 镜像, 严格小于锚点 时间戳, 同毫秒等值判废); sessions:deleteMessage 死通道全链路删除(渲染层零调用 + message_count 漂移面); Ollama vision 能力门控全链路(MetonaModelInfo .supportsVision 贯穿 adapter/IPC/store/UI, model-capabilities.ts 三道判定纯函数, 未知保守放行); 记忆固化节流(consolidation-policy 纯函数: 总开关 + 内容门控 [回答>=200字符或存在成功工具调用] + 会话级 10 分钟频率窗口, 三 memory.* 配置键) P2 安全纵深: SSRF DNS Pinning 关闭 rebinding 窗口(ssrf-guard 重构 resolvePublicAddresses 单源; ssrf-dispatcher 以 undici Agent.connect.lookup 钉死校验 IP, TLS SNI 保持原域名, 一次性 dispatcher 用后即毁; 代理激活显式 退化为仅入口校验); web_fetch 重写手动逐跳重定向循环(每跳先校验后连接, 替代 redirect:follow 内核跟跳的中间跳裸奔, 上限 5 跳); http_request 换用 pinned fetch; web_search 可达性预检加固(私有 URL 零请求 + 不跟跳, 3xx 视为 可达); Agent 浏览器 CORS 通配收紧为 Origin 回显 + Vary: Origin; ConfirmationHook.forgetSession 会话终态清理(会话删除/abort 联动/SubAgent 终结三处接线, 根治 rememberedDecisions 泄漏) P3 架构还债: agent.enableReflection 死配置全链路接线(main→shared→引擎→ Orchestrator→设置开关, REFLECTING 状态真实可达); AgentLoopConfig.timeoutMs 死字段删除; MemoryManager.cleanupExpired 挂入健康检查周期(expires_at 回收 管道真实化); buildSafeEnv 收敛 utils/safe-env.ts 单源(run_command 与 MCP stdio 共用, 终结双实现漂移); Trace 生命周期治理(metadata 只保留最近 20 个 run — keepRecentRuns 纯函数; JSONL 录制启动自动清理保留 200 个 + 设置页 手动清理); SLO/健康快照可视化(app:healthSnapshot IPC + 设置页只读卡片 + 审计链一键校验) P4 能力演进: 会话标题 LLM 自动生成(TitleGenerator — 每会话幂等/并发重入复用 同一 Promise/自定义标题不覆盖/失败静默回退, Sidebar 经 config:changed 实时 刷新); MCP 自动重连(5s/15s/60s 退避最多 3 次, reconnecting 状态机, teardownConnection 内部拆除保留簿记 — 用户断开/开关关闭即时取消, 设置页 显示第 N/3 次); 死循环检测 ABAB 乒乓模式(最近4轮 A→B→A→B 交替判定, 补齐 docs 第五章"两状态反复切换"检测契约); i18n 第三阶段(ChatInput/LLMSettings/ OnboardingWizard/MemoryViewer 主链路文案出层, zh-CN + en-US 双字典补齐) 测试: 737 → 824 用例(+87, 新增 8 个测试文件 + 扩展 3 个)。新覆盖: user-context 分组/空值收缩/拼接契约、context-builder 字节级稳定性、Anthropic cache_control 四态、consolidation-policy 九路判定矩阵、ssrf-dispatcher(pinned lookup/重定向 解析/IP 校验)、forget-session 会话隔离、trace-lifecycle run 淘汰、 trace-trim 严格小于边界、safe-env 净化矩阵、mcp-reconnect 退避状态机 (fake timers)、title-generator 并发重入、SQLite 侧 truncate×TRACE 联动 (Electron ABI)。测试驱动修复: GIT_*/ 注释终止块注释、重连计数被自身重试 前置断开重置(拆 teardownConnection 保留簿记)、TitleGenerator 幂等占位与 并发去重的检查顺序竞态(去重先于幂等) 版本: 0.7.3; README 同步(配置表新增 agent.enableReflection/memory.*/mcp.autoReconnect) 回归: typecheck 双端 0 错误; ESLint 0/0; 系统 Node 771 通过 53 跳过 (better-sqlite3 ABI); Electron ABI 全量 824/824 零跳过	2026-08-30 09:44:43 +08:00
thzxx	26169b7be4	feat: v0.7.2 安全收口 · 断链接线 · 观测补洞 — 230 用例扩充与全量回归 ... P1 修复面收口: /clear 全链路根治(前端清空联动 DB messages+摘要游标+TRACE 快照, IPC 语义改"操作完成"; 流式中拒绝); web_browser open 补 SSRF 校验(Chromium 旁路关闭, 与 web_fetch/http_request 同源 validateSSRF); MCP 工具结果纳入注入扫描(mcp_* 前缀 按网络来源同级 full 模式, 收敛 resolveScanMode 单点); Trace 落库/入 store 双重瘦身 (tool_result base64/超长字段剥离, metadata 防 MB 级膨胀); 文本附件 512KB 闸门 (file.slice 首段读取+truncated 标志随消息持久化+主进程附件提示感知截断); 单实例锁(requestSingleInstanceLock + second-instance 聚焦已有窗口) P2 安全纵深: ConfirmationHook 多窗口化(确认请求/超时提示改全窗口广播, getAllWindows 空时回退 mainWindow, fail-closed 判定升级双通道); mcp_servers.headers 全链路接线(safeParseHeaders 容错解析+SSE/StreamableHTTP requestInit 注入+IPC 逐项 校验+设置页 JSON 输入, 远程 MCP 鉴权头可用) P3 断链接线: llm:listModels IPC(六家 adapter 动态模型发现首次接线, 配置完整性 前置校验); Ollama pullModel IPC+设置页下载卡片(进度/取消/能力徽标, v0.7.0 死代码 激活); 后台会话运行指示(sessionRunStates 图+Sidebar 状态点, 多会话并发可见); IR 卫生(移除 THINKING_START/END 死枚举, constraints 标注预留) P4 质量与文档: i18n 第二阶段(确认弹框/侧栏/状态栏/AgentMonitor/终止原因出层, 外观设置 zh-CN/en-US 切换, ui.locale 持久化, 渲染时求值规避异步注册); README/D1 文档对齐(http_request 风险等级/用例数/实现状态注记); 版本号 0.7.2 测试: 507 → 737 用例(+230, 11 个新文件)。覆盖补齐: context-builder/consolidator/ orchestrator/workspace.service/session-recorder/config-layering/secure-config/ network-proxy + IPC mcp/tasks/memory/app/data 域 + 渲染层 store 与流事件管线纯函数。 测试驱动修复: workspace.appendMemory 中文分区 \b 词边界失效(JS \b 不含 CJK), 固化条目恒追加文件末尾产生重复分区头 → (?=\n|$) 前瞻断言根治 回归: typecheck 双端 0 错误; ESLint 0/0; 系统 Node 687 通过 50 跳过; Electron ABI 全量 737/737 零跳过	2026-08-30 00:09:25 +08:00
thzxx	36e4b28d93	feat: v0.7.1 工具执行超时配置取消 600 秒上限 ... - 设置 → Agent 配置 → 工具执行超时：移除 600 秒输入上限，允许任意 ≥10 秒的值 - 引擎侧（agent-loop engine）本就无钳制，配置值直接生效；工具自定义 timeoutMs 仍按 Math.max 优先 - totalTimeoutMs 仅为迭代续跑条件，不中断执行中的工具，长任务可跑满自身超时	2026-08-29 21:09:24 +08:00
thzxx	3940716dc2	feat: v0.7.0 四阶段全量迭代 — 修复面收口 · 安全纵深 · 架构还债 · 能力演进 ... P1 修复面收口: v0.6.3 截断自愈推全量(Anthropic/Ollama/非流式/引擎兜底); SSE 上游错误帧检测进重试通道; clearMessages 摘要游标根治; truncateResult 内联图片白名单统一; 前端四 bug(确认弹窗锁死/MemoryViewer/ Virtuoso Footer/abort 尾部过滤) + reasoning 缓冲跨迭代污染; 托盘通知过滤与新建会话死链接线 P2 安全纵深: MCP 审批闭环(ConfirmationHook×PolicyEngine 联动+重名拒注册); SSRF 收敛 ssrf-guard 共享模块 (web_fetch 双通道校验+重定向终态复检); Electron 加固(preload CJS 化→sandbox:true/CSP/权限白名单/will-navigate); run_command cmd.exe 白名单通道元字符守门; diff_viewer 10MB 预检; Anthropic thinking 预算下限; Agnes 思考显式关闭 P3 架构还债: OpenAICompatibleAdapter 中间基类收敛四家样板; 错误分类单轨化(删 mapError/getFetchSignal, 超时显式 ETIMEDOUT); PRAGMA user_version 迁移版本化; 死代码清理专项(cn.ts/SHORTCUTS/ContextMenu 分支/ getWindowState/modifiedArgs/sandbox 空壳); i18next 引入; a11y 第一轮; SearXNG 页批量草稿模型统一 P4 能力演进: Ollama pull 可取消/capabilities 探测/num_ctx 实测缓存; UpdateService feed 比对式自动更新 (app:updateCheck IPC + StatusBar 入口); MiMo providerOptions(web_search 服务端工具/strict JSON); web_fetch extract_mode=markdown(turndown); network.proxyUrl 全局代理(Chromium sessions+undici dispatcher) 测试: 264 → 507 用例(Electron ABI 全绿零跳过), 覆盖引擎压缩管线/重试竞速/MEMORY.md 闸门/file_editor 五操作/ filesystem 七工具实体夹具/git 真实仓库/SSE 错误帧/全线截断自愈/Provider 请求形态矩阵/SSRF 表测/钩子分级矩阵/ OutputValidator 全量/SLO 指标/MCP 安全纯函数/task_manager 链路/渲染层纯域/i18n 桥契约	2026-08-27 17:06:58 +08:00
thzxx	b6e2a8bd25	fix: v0.6.3 修复截断工具调用被静默丢弃导致空回复终止会话 — SSE 流截断转模型自愈 ... 【根因（main.log 实证）】 2026-08-22 20:31:22 / 20:32:31 两次 + 20:37:01 最终终止，完整因果链： 模型写大文件（22KB HTML，write_file）时输出 token 达上限 （finish_reason=length），流正常收尾但 tool_call 的 arguments JSON 半截 （"Unterminated string in JSON at position 21890/22686"）。 缺陷链： 1. SSE 解析器对 parse 失败的 tool call 静默丢弃（log.warn 后 continue — #25 时代为防单个坏 JSON 丢弃全部而引入） 2. 该轮模型输出全部是这一个 tool call → 丢弃后引擎看到"零工具调用 + 零文本"→ 误判为模型已完成 → COMPLETED + 空回复（OutputValidator 报 "Output is empty" 仅 warn 不阻断） 3. 用户感知：AI 干了 16 轮 10.5 分钟后会话无声停止、没有最终回复 20:31/20:32 两次截断后模型自行重试（日志可见继续 EXECUTING）， 但 20:37 最后一轮再次截断且无重试机会 → 空回复终止。 【修复（sse-stream.ts — DeepSeek/Agnes/MiMo 三家共享）】 - flushToolCallBuffer: parse 失败的 tool call 不再丢弃 — 转为携带 _truncatedArguments + _truncatedReason（明确告知模型"参数因输出长度 限制被截断，请分块重试、勿复用原参数"）的 TOOL_CALL_COMPLETE。 工具执行将因参数缺失失败，错误结果回传模型 → 模型感知截断后分块 写入（ReAct 自愈路径）。无限循环由引擎死循环检测器兜底 - 流断开兜底: read() done 但从未收到 [DONE]（连接中断）时补 flush + DONE — 原实现缓冲整体丢失且引擎收尾路径行为未定义 - finish_reason=length 显式 warn 日志（含缓冲字节数）— 归因能力 - 空 argsBuffer 的 tool call（无参工具）显式产出 args={}（原实现走 JSON.parse('') 会进 catch，行为巧合正确但语义混乱） 【测试】 +5 用例（sse-truncation.test.ts）: 截断转错误说明 / 无 [DONE] 兜底 / 完整 JSON 回归 / 空 args 回归 / finish_reason=tool_calls 提前 flush 更新 1 旧用例: "损坏 JSON 跳过" → "损坏 JSON 转截断错误 tool call" （行为变更的契约级断言） 【验证】 lint 0/0；typecheck 双工程 0 错误；test:electron 264/264（+5）； electron-vite build 成功	2026-08-22 20:44:39 +08:00
thzxx	a7090214b1	fix: v0.6.2 修复工具调用不稳定与会话停止 — 纯 tool_calls 轮丢失 assistant 消息导致 API 400 ... 【根因（main.log 实证）】 19:04 / 19:05 / 19:06 三次会话终止均为同一报错： DeepSeek 400 "Messages with role 'tool' must be a response to a preceding message with 'tool_calls'" 缺陷链：engine 主循环仅在 step.thought 存在（该轮有文本或思考内容）时才 将 assistant 消息加入请求历史。当模型发起纯工具调用（零文本零思考 — DeepSeek 高频行为）时： - assistant(tool_calls) 消息不进 messages - 但 tool 结果消息照常 push → 下一轮请求出现孤立 tool 消息 → 协议 400（不可重试）→ 会话 ERROR 终止 "不稳定" = 模型每轮是否附带文本是概率性行为：带文本正常，纯调用必崩。 DB 持久化侧同源缺陷（if (!step.thought) continue）导致这些步骤的 assistant 与 tool 结果全部不落库 — 重启后工具上下文丢失，模型重复调用。 【修复】 - engine.ts: 有 toolCalls 的轮次必 push assistant（content=null，C-6 规范） - agent.ts: 持久化条件同步修复（无 thought 但有 toolCalls 的步骤落库） - 回归测试: 纯 tool_calls 轮后第二次请求中 tool 消息前必须是带 tool_calls 的 assistant（请求契约断言，engine-toolchain.test.ts） 【纵深防御 — 孤立 tool 消息过滤】 - openai-format.ts（DeepSeek/Agnes/MiMo/OpenAI 四家共享）: 构建请求时 按 tool_call_id 配对过滤孤立 tool 消息（任何来源的历史污染不再 400 死锁） - anthropic.adapter.ts: tool_use/tool_result 同策略配对过滤 - 单测 ×6: 正常配对保留 / 孤立丢弃 / id 不匹配丢弃 / 多轮配对 / includeImages 原位转换 / 非 vision 静默丢弃 【多模态索引对齐收敛】 4 家 adapter 的 images 处理循环原按未过滤的 nonSystemMsgs[i-1] 对齐索引， 孤立 tool 过滤引入后会错位 — 统一收进 buildOpenAICompatibleMessages （includeImages 参数，基于 sanitized 序列原位转换），4 家 adapter 删除 各自的索引对齐循环（DeepSeek vision 判断 / OpenAI 推理模型拒绝保留在 adapter）。 【终止原因可见化】 MAX_ITERATIONS / TIMEOUT 终止此前无任何提示（用户感知"会话直接停止"）— 前端 DONE 事件非 completed 终止原因显示为 system 消息。 【v0.6.1 回归缓解】 web_fetch timeoutMs 120s → 240s：浏览器回退串行化后并发 3 个排队最坏 ~127.5s，旧值让排队末位抓取被工具超时杀掉（表现为抓取不稳定）。 【验证】 lint 0/0；typecheck 双工程 0 错误；test:electron 259/259（+7）； electron-vite build 成功	2026-08-22 19:34:16 +08:00
thzxx	80cf5b482c	fix: v0.6.1 修复回复/推理期间偶发崩溃 — 浏览器回退窗口竞态 + 崩溃可观测性 ... 【根因（实证归因，非猜测）】 分析 userData/logs/main.log 全部 33 次启动会话，定位 3 处异常终止点 （07-25 ×2 / 08-22 ×1，启动标记前无 Database closed）。三处 100% 共享 同一模式：web_search 并行抓取 → 多个 web_fetch 同时进入浏览器回退 → 共享单例 BrowserWindowManager 中后到 open() 销毁前一个正在加载/执行 JS 的窗口。关键统计：56 次浏览器回退中 ERR_ABORTED（并发互毁的直接 证据）仅 3 次，而这 3 次恰好全部对应 3 个崩溃点；无并发销毁的 53 次 回退从未崩溃 —— 触发条件完全收敛。 缺陷链（三层叠加）： 1. browserFetch 直接 open/evaluate 共享单例，无跨调用序列化 — 并发 回退互相销毁窗口（ERR_ABORTED / "Object has been destroyed"） 2. destroy() 对仍在使用中的 partition fire-and-forget clearStorageData/clearCache，与紧随其后的新窗口创建并发 — 原生存储层竞态（崩溃引爆点） 3. ensureReady 检查与实际 executeJavaScript/loadURL 之间存在竞态窗口； loadURLWithTimeout 的 Race 落败方 rejection 无人处理 【修复（browser-window-manager.ts + web-fetch.ts + browser.ts）】 - 新增 fetchPageText：排队版页面抓取，串行化完整 open→等待→evaluate 序列（与 open 共用单一操作链，destroy 只会在链上发生，跨链互毁彻底 消除）；web_fetch 浏览器回退改走此入口 - open() 拆分 openInternal（链内直调）；open 与 fetchPageText 共用 单一串行链，排队不分死锁 - destroy() 移除 session 存储清理（终态清理迁移至 close()，await 执行， 不再与窗口创建并发） - safeWebContents() 即时校验替代 racy 的 ensureReady；evaluate/extract/ screenshot/click/type/scroll/waitForSelector 全部加固，消除对已销毁 webContents 的调用 - loadURLWithTimeout 落败方 rejection 兜底（防 unhandledRejection） - cleanupBrowser/cleanup/close 异步化适配（main.ts 退出链路 await） 【崩溃可观测性（此前崩溃无迹可查 — 日志无声截断）】 - process.on(uncaughtException/unhandledRejection) → [FATAL] 落盘 - app.on(render-process-gone/child-process-gone) → [FATAL] 落盘 - WindowManager: 每窗口 render-process-gone 日志 + 自动 reload 自愈 （渲染进程 OOM/崩溃不再白屏卡死，可自动恢复） 【验证】 - lint 0/0；typecheck 双工程 0 错误；test:electron 252/252；build 通过	2026-08-22 19:16:41 +08:00
thzxx	6b2b587c94	feat: v0.6.0 全量审计修复 — 安全加固 + 死代码激活 + 依赖治理 ... 基于全量源码审计（electron/ 70+ 文件、src/ 45+ 文件完整读取）的 四阶段迭代，修复 1 项安全缺陷、8 项功能缺陷、依赖与文档系统性脱节。 【P0 安全与数据正确性】 - S-1 数据导出泄露明文密钥：data:export 全量导出直接透传 configService.getAll()（敏感 key 解密返回），导出文件含明文 API Key。 新增 sanitizeExportConfig（shared.ts）逐 key 脱敏 + 5 项回归测试 - F-3 session_summaries 无级联删除：删会话后摘要永久残留。建表语句补 FOREIGN KEY ON DELETE CASCADE + 迁移 8 重建存量表（幂等检测）+ 2 项测试 - F-4 macOS activate 重建窗口后确认弹框失效：窗口创建收敛为 createMainWindow 单一入口（beforeLoad 补 setMainWindow/IPC 注册），TrayManager 补 rebindWindow，app:selectFolder 改 event.sender 动态解析窗口 【P1 死代码激活与功能补全】 - F-1 会话右键菜单挂载：ContextMenu session 分支（重命名/置顶/归档/ 导出/删除）约 200 行此前无任何触发点，Sidebar SessionItem 挂载 onContextMenu；置顶/归档 label 随状态切换显示 - F-2 归档会话不可找回：Sidebar 新增「已归档」折叠面板（恢复入口）， 归档功能形成完整闭环 - F-7 Provider 白名单校验：createAdapter/buildFallbackAdapter 未知 provider 显式拒绝（此前静默落入 DeepSeekAdapter 以空配置失败） - F-8 死配置治理：接通 5 项（llm.temperature/llm.maxTokens 注入引擎、 security.promptInjectionDefense 控制 SecurityScanHook+消息检测、 logging.auditEnabled 控制 AuditLogHook、logging.traceEnabled 控制 SessionRecorder，均 fail-secure 仅显式 false 关闭）；删除 4 项 无消费者配置（requireWriteConfirmation/maxFileWriteSizeKB/fontSize/ animationMode） 【P2 依赖治理与 UX 修缮】 - D-1 移除僵尸依赖 electron-store/zod/rehype-raw（源码零引用， 共裁 24 包）；README 技术栈表同步删除虚假宣称 - metona-toast 升级 0.2.1 → 0.5.0（API 全兼容：107 种图标类型、 配置项超集，default/configure/use 接口不变） - F-5 工作空间手输路径实时落库中间态：改 pendingPath 草稿 + 显式 「校验」按钮（选择文件夹与手输共用 validatePath 流程） - F-6 确认弹框超时滞留：倒计时归零时主动 refreshPending（后端超时 已删条目，拉取后弹框自然消解） - D-3 ChatInput accept 移除 .pdf（分类器不识别，误导性入口）； Onboarding 切换 Provider 自动填充默认 URL（与 LLMSettings 一致） 【P3 文档口径收敛】 - README：工具数 30+→28、版本 0.6.0、测试数 252、配置表补 F-8 接通项 - built-in/index.ts 计数注释 30→28 - docs/网络工具 v2 存储键名统一为点号口径（searxng.enabled） - docs/完整设计指南修正 db.handlers.ts 失效路径引用为 data.ts 【验证】 - lint 0 error / 0 warning - typecheck 双工程（node+web）0 错误 - test:electron 24 文件 252 用例全通过（+7 新增：导出脱敏 ×5、 级联删除 ×2） - electron-vite build 成功（metona-toast 0.5.0 chunk 正常） - 系统 Node 模式 npm test 225 通过 + 27 ABI skip（符合预期）	2026-08-22 18:28:31 +08:00
thzxx	22028c91c3	fix: v0.5.5 全量复检修复 — 图片 token 估算缺失（压缩预算失真）+ 过时文案清理 ... 背景：v0.5.4 多模态增强（多轮图片记忆 + 总开关 + DeepSeek vision）发布后的 全量全方位复检，重点核查新增功能的跨模块边界。 复检通过项（无回归确认）: - 多轮图片记忆 × 五家 adapter：Anthropic（base64 块）/ OpenAI（image_url parts）/ Ollama（纯 base64 数组）/ Agnes / MiMo 均正确处理恢复的历史 images - 多轮图片记忆 × 引擎运行时压缩：摘要请求仅含文本（图片不进摘要调用）； toKeep 消息的 images 原样保留；孤立 tool 消息配对逻辑不受影响 - 多轮图片记忆 × 摘要服务：maybeSummarize 用截断文本 transcript，无图片干扰 - history 组装 slice(0,-1) × 图片恢复无冲突（当前消息 images 走独立通道） - 编辑重发/重新生成路径与图片恢复同源（attachments.preview），行为一致 修复项: - P1 token 估算器完全忽略 images（estimateMessagesTokens）： 带 10 张图的消息被按纯文本估算。影响：压缩 keepBudget 严重低估 → 压缩后实际 token 仍超 80% 阈值 → 反复触发压缩循环（每轮多一次 LLM 摘要调用）；上下文占用显示严重失真。修复：每张图按 1000 tokens 计入 （1024px 压缩图在主流 Provider 约 700~1500 视觉 token，取保守上界） - 文案清理：ChatInput 附件按钮 Tooltip 硬编码"DeepSeek 不支持图片"改为 按拒绝原因区分（开关未开启 vs 当前模型不支持）；openai-format.ts 共享层 注释更新（DeepSeek vision 已支持，非 vision 模型才丢弃） 测试（243 → 245 用例）: - 新增 token 估算图片用例 ×2：带 images 消息按每张 1000 tokens 计入 / 无 images 字段消息行为不变（向后兼容） 验证: lint 0 / typecheck 双工程 0 / test:electron 245 全过 / build 成功	2026-08-21 23:09:36 +08:00
thzxx	4ee5100661	feat: v0.5.4 多模态增强 — 多轮图片记忆 + 多模态总开关 + DeepSeek vision 模型支持 ... 多轮图片记忆: - 此前历史轮次的图片不回传 LLM（attachments 仅存压缩 preview，历史组装 时被丢弃）— 跨轮对话中模型对图片内容"失忆" - 修复：SessionSummaryService.buildHistoryMessages 从持久化的 attachments 恢复 images（type=image 的 preview base64），历史图片随上下文回传 - Token 控制：最多注入最近 10 张（MAX_HISTORY_IMAGES，从最新消息向前 收集）— 每张 1024px 压缩图约数百至千余 token，无上限会吃满上下文 - 摘要区间（summarizedUntilRowid 之前）的图片不恢复，符合滚动摘要语义 多模态总开关 llm.multimodalEnabled（默认关闭）: - 新配置项：CONFIG_DEFAULTS 种子 + 设置弹框 LLM 配置 Switch + 首次引导向导 LLM 步骤 Switch（含说明文案） - 上传入口双重判断：总开关 × 模型能力 — 未开启时即使模型支持多模态 也不能上传图片（ChatInput 的选择/拖拽/粘贴统一拦截，Toast 区分 "开关未开启"与"当前模型不支持"两种原因） - 保存成功后同步 Agent Store 立即生效；App 启动时随 setProvider 加载 DeepSeek vision 模型支持: - 新增 deepseek-v4-flash-vision-exp（OpenAI image_url content parts 格式， 128K 上下文 / 8K 输出） - adapter 按 isVisionModel() 判断：vision 模型将带 images 的消息转换为 [{type:'text'},{type:'image_url'}] parts；非 vision 模型保持 images 静默丢弃（防 API 400） 测试（236 → 243 用例）: - 多轮图片记忆 ×3（session-summary.test.ts）：历史 attachments 恢复 images / 上限 10 张从最新向前 / 摘要区间图片不恢复 - DeepSeek vision 请求格式 ×4（deepseek-vision.test.ts，契约级 mock fetch 断言请求体）：image_url parts 转换 / 非 vision 模型丢弃 / max_tokens 钳制 8192 / 无图不转换 - 测试顺序修正：多轮图片用例置于 describe 末尾（插入新行消耗全局自增 rowid，插在中间会破坏既有用例对 rowid 数值的断言） 文档: README 同步（DeepSeek 模型表 + vision 多模态列、llm.multimodalEnabled 配置项、多轮图片记忆特性行、243 用例数） 验证: lint 0 / typecheck 双工程 0 / test:electron 243 全过 / build 成功	2026-08-21 23:00:20 +08:00
thzxx	3a30e8f5b4	fix: v0.5.3 模型能力完整性修复 — MCP 工具动态同步 + maxTokens 模型上限钳制 ... 背景：v0.5.2 工具调用失效修复后，对模型全能力矩阵（工具/思考/多模态/流式/ 压缩/摘要/记忆/故障转移/余额）做契约级核查，发现并修复两处同类时序/边界缺陷。 P1 MCP 工具运行中增删不同步引擎: - 症状：运行中添加/启用 MCP server 后，已打开会话拿不到新工具；断开 server 后已有引擎仍持有失效工具定义（模型发起调用才报 Unknown tool） - 根因：setToolsAll 仅在启动期与工具开关时调用，MCP 连接/断开路径缺失 （与 v0.5.2 修复的懒创建陷阱同类——"变更点 × 同步路径"未全覆盖） - 修复：MCPManager 新增 setOnToolsChanged 回调，connectServer 注册完成 / disconnectServer 注销完成后触发；main.ts 注入回调同步全部已存在引擎。 懒创建引擎由 createEngine 实时拉取（v0.5.2），三条路径（启动/懒创建/ 运行中变更）全覆盖。README"无需重启动态发现"的宣称至此真实成立。 P1 maxTokens 超模型上限直接 400: - 症状：引擎默认 maxTokens=63488，OpenAI gpt-4o(16384)/gpt-4.1(32768)、 Anthropic opus/haiku(32000)、MiMo standard(32768) 每次请求 400，等于不可用 - 修复：五个 adapter（DeepSeek/Agnes/MiMo/OpenAI/Anthropic）统一按 MODEL_INFO.maxOutputTokens 钳制；MiMo 保留 thinking 兜底 32768 语义； Anthropic thinking budget 在钳制后的 max_tokens 内二分，自动跟随 测试（224 → 236 用例）: - 新增 maxTokens 钳制契约测试 ×9（max-tokens-clamp.test.ts）：mock fetch 记录真实请求体断言——超限钳制（MiMo standard/OpenAI gpt-4o/Anthropic opus）/ 未超限原样传递（DeepSeek/Agnes/MiMo pro/o3-mini/sonnet）/ 推理模型字段名 / 未配置默认值安全性 - 新增 MCP 动态同步端到端测试 ×3（mcp-tools-sync.test.ts）：mock MCP SDK + 真实 MCPManager/ToolRegistry/AgentEngineManager——先建引擎再连 server，断言同一会话请求的 tools 动态更新 / 断开后移除失效定义 / 回调异常不阻断 MCP 主流程 能力矩阵核查结论（无回归确认）: 工具调用主链路 ✓（v0.5.2）/ SubAgent 工具 ✓（delegate 实时 resolveTools）/ thinking 热更新 ✓（baseConfig 合并 路径无懒创建陷阱）/ 多模态当轮 ✓ / 压缩与孤立 tool 消息配对 ✓ / 摘要分层 ✓ / 记忆注入 ✓ / 故障转移 ✓ / 余额 ✓（v0.5.2）。已知设计限制：历史轮图片不 回传（attachments 仅存缩略图，图片只在发送当轮注入上下文）。 验证: lint 0 / typecheck 双工程 0 / test:electron 236 全过 / build 成功	2026-08-21 22:36:52 +08:00
thzxx	e4d693c1c7	fix: v0.5.2 紧急修复 — 工具调用完全失效（引擎懒创建不带工具）+ DeepSeek 余额解析错误 ... P0 工具调用失效（用户实测反馈：Agnes/DeepSeek 均无法调用工具）: - 根因：AgentEngineManager.createEngine 未调用 setTools。引擎是懒创建的 （首次 sendMessage 时 getEngine），启动期的 setToolsAll 调用时 engines Map 为空（全是 no-op）→ 新引擎 this.tools=[] → LLM 请求不带 tools → 模型无法发起 tool_call。症状与用户反馈完全吻合：模型口头说要调工具 （模仿历史消息中的工具调用模式），实际不调，凭记忆瞎编结果。 - 引入点：v0.4.0 P2-10 每会话引擎重构（v0.3.x 全局单引擎时代 setTools 直接作用于唯一引擎，无此问题）。 - 修复：createEngine 从 toolRegistry 拉取当前启用工具（registry 是启用 状态的唯一事实源，MCP 后注册/工具开关场景均一致）。 P1 DeepSeek 余额显示错误（用户实测反馈：显示的不是真实余额）: - 根因：DeepSeek 官方 /user/balance 实际返回 balance_infos 数组格式， 此前按扁平字段解析（data.total_balance）→ 恒为 undefined → 界面恒显示 0。 - 修复：优先解析 balance_infos[0]，回退扁平格式（网关兼容）；URL 规范化 （剥离尾斜杠与 /v1 前缀 — 余额端点在根路径，chat 端点两种写法都合法）。 测试（215 → 224 用例）: - 新增 AgentEngineManager 回归测试 ×4：懒创建引擎的 LLM 请求必须携带 registry 工具定义（本次事故的直接拦截测试）/ 禁用工具不出现 / setToolsAll 热更新 / 无 registry 时行为不回归 - 新增 DeepSeek 余额解析测试 ×5：官方数组格式 / 扁平回退 / URL 规范化 / 非 2xx / 网络异常 - 补强引擎链路测试：mock adapter 记录请求并断言 tools 契约 — 此前 mock 无条件吐 tool_call 事件，掩盖了"请求未携带工具定义"的缺陷（复检盲区 的直接教训：mock 必须断言请求契约，否则测试是道具） 验证: lint 0 / typecheck 双工程 0 / test:electron 224 全过 / build 成功	2026-08-21 22:11:11 +08:00
thzxx	c727ad075c	fix: v0.5.1 工具调用链路复检修复 — SubAgent 孤儿工具拦截 + 确认弹框会话隔离 ... 背景：v0.5.0 发布后对工具调用链路（adapter 流式 tool_call → 引擎 PARSING → preToolHooks 管道 → ToolRegistry → 结果回填）做全链路复检，发现并修复两处问题。 安全修复: - SubAgent 中止时 pending 确认未清理（安全回归）：SubEngine 以 taskId 为 sessionId 写入 ConfirmationHook，abortSession 的 clearPending(sessionId) 清不到它们。后果：中止会话后残留弹框若被补批，孤儿工具会真实执行副作用 （v0.4.x 的全局清空反而能拦截）。修复：abortByParent 返回被中止的 taskId 列表，abortSession 一并 clearPending(taskId)。 确认弹框会话隔离（前端对齐后端 v0.5.0 语义）: - ConfirmationRequest 新增 sessionId 字段（主会话为 sessionId，SubAgent 为 taskId），弹框在会话 INIT/TERMINATED 时只清除该会话的请求 —— 修复并发 会话下任意会话结束误清其他会话等待中确认的问题 - 选中计数按当前 requests 收敛（selectedIds 残留 id 无害化） 测试（207 → 215 用例）: - 新增引擎级工具调用链路集成测试 ×6（engine-toolchain.test.ts）：真实 PermissionCheckHook + RateLimitHook + ConfirmationHook 管道 + 真实 ToolRegistry，覆盖 SAFE 工具直通 / HIGH 工具批准执行 / 拒绝以 Blocked 错误回传 LLM / 会话隔离端到端 / 工具异常不中断循环 / 策略拦截系统路径 - 新增 FTS 触发器 × NULL content 删除安全性测试 ×2：验证 truncateAfter （编辑重发/重新生成）删除 content=NULL 的 assistant 消息（模型仅发 tool_calls 的标准场景）不抛错且索引保持一致 - agent.test.ts 的 orchestrator mock 适配 abortByParent 新返回类型 验证: lint 0 problems / typecheck 双工程 0 errors / test:electron 215 全过 / build 成功	2026-08-21 21:47:03 +08:00
thzxx	7e8b4882a0	feat: v0.5.0 审计修复版 — 类型基线重建 + 会话隔离 + SubAgent 可观测性 + 三项功能补全 ... P0 安全与工程基线（止血）: - .npmrc 移除硬编码 Gitea npm 凭据，改为 GITEA_NPM_AUTH 环境变量注入（已验证未设变量时 401） - 修复 typecheck 空操作缺陷：solution-style 根 tsconfig 改为双工程真检查（node + web）， pre-commit 与 CI 门禁恢复拦截能力 - 修复 4 处 v0.4.1 遗留类型错误：confirmation-hook.test 枚举名 FILE_SYSTEM→FILESYSTEM、 agent.ts VALIDATION 事件 severity 类型谓词收窄、ContextMenu.tsx 导出 attachments 类型 - 补装 v0.4.1 声明但未安装的 node-html-parser 依赖 P1 逻辑缺陷修复（跨模块边界）: - ConfirmationHook 会话隔离：rememberedDecisions 与 pendingConfirmations 按 sessionId 隔离， abortSession 只清本会话 pending（修复 A 会话中断误杀 B 会话确认、拒绝记忆跨会话污染） - SubAgent 可观测性：orchestrator 六个事件此前全项目零消费者，现接入 ① subagent:event 生命周期广播（AgentMonitor 新增 SubAgent 状态区） ② SubEngine 流事件独立 TRACE 录制（sessionId=taskId 的 JSONL 文件） - main.ts 启动链路异常兜底：初始化失败时记录日志 + 系统错误对话框 + 退出（原为白屏挂起） P2 工程强化: - CI：typecheck 双工程真检查；electron-test 从 experimental（continue-on-error）转正为阻塞门禁； GITEA_NPM_AUTH secret 注入说明 - 渲染 bundle 代码分割：单 2630KB chunk 拆为 main 557KB + vendor-react/mui/markdown/icons （业务代码变更不再使 vendor 缓存失效） - database 建表 mcp_servers CHECK 直接含 streamable-http（新库不再依赖迁移 6 立即重建） P3 功能补全: - DeepSeek 余额显示：新增 llm:getBalance IPC + LLMSettings 余额卡片（复用适配器原死代码 getBalance） - FTS5 会话内容搜索：messages_fts 虚表 + INSERT/UPDATE/DELETE 触发器实时同步 + 存量库 rebuild 迁移 + sessions:searchContent IPC + Sidebar 搜索框标题∪内容联合搜索 （短语转义防 FTS 运算符注入，按会话聚合展示 snippet） - 审计日志导出：audit:export IPC（JSONL / CSV RFC 4180 转义）+ LogsSettings 导出按钮 文档一致性大扫除: - README：工具数统一为 28（原 26/27/30 三口径）、handlers.ts→ipc/、录制事件名更正、 删除虚构的审计导出/归档宣称与 Schema 虚构字段、MCP 三种传输、配置 key 更正、 项目结构树对齐实际（settings 10 文件/lib 6 文件/react-virtuoso）、clone 地址改为 Gitea、 新增 GITEA_NPM_AUTH 配置说明、测试数 207 - 架构/构建指南/UI UX/IR 标准 4 份 HTML 设计文档同步修正（工具数、表数 10、 磁盘文件 2 个现状注记、ipc/*.ts 路径） - eslint.config.js 与开发规范.md 注释对齐零容忍基线与 better-sqlite3 选型 测试: 199→207 用例（新增 ConfirmationHook 跨会话隔离 5 用例 + FTS5 搜索/审计导出 8 用例） 验证: lint 0 problems / typecheck 双工程 0 errors / test:electron 207 全过 / build 成功	2026-08-21 21:07:01 +08:00
thzxx	49c9b25538	feat: v0.4.1 质量加固版 — 工程化基线 + 安全加固 + 测试补齐 + 体验升级 ... 工程化（从零到一）: - 新增 Gitea Actions CI（debian-latest）：类型检查 + Lint + 单元测试 + 产物编译验证 - 新增 husky + lint-staged 预提交钩子（lint-staged + typecheck 门禁） - 移除坏脚本 test:e2e（无 Playwright 配置必失败）；prebuild 改用内置 fs.rmSync - 依赖清理：移除死依赖 sql.js(2MB)/@playwright/test，@types/shell-quote 移至 devDependencies 安全加固: - PolicyEngine 频率限制按会话隔离（多会话并发不再互抢配额） - ConfirmationHook 拒绝记忆加 10 分钟 TTL + 恢复询问入口（新增 2 个 IPC 通道） - Windows run_command 白名单工具（git/node/npm/npx/pnpm/yarn/tsc）改走 cmd.exe /c + 参数数组执行，收窄 shell 注入面 - web_search 四引擎 HTML 解析迁移 node-html-parser（结构化主层 + 正则降级） 缺陷修复（测试驱动发现）: - mapError 大小写缺陷：网络错误码永远落入 UNKNOWN 无法触发重试 - 搜狗解析器自我过滤：相对链接补全后又被 sogou.com 过滤导致结果全丢 - 百度复合类名重复收录：class="result c-container" 被双重匹配 测试补齐（113 → 194 用例）: - 新增 5 个测试文件：sse-stream / base-adapter / confirmation-hook / ipc-agent 编排链路 / web-search 解析器 - 覆盖 sendMessage 全分支、SSE 流解析、错误映射、确认钩子竞态/超时/批量审批 体验升级: - OutputValidator 验证结果可见化（VALIDATION 流事件 → 聊天流提示卡） - SettingsModal 巨型组件拆分（1503 行 → 10 个文件，可独立维护） - MessageList 接入 react-virtuoso 真虚拟滚动（千条消息恒定开销） - MCP 新增 streamable HTTP 传输支持（SDK 内置传输 + DB 迁移 6 + UI 双模式）	2026-08-21 13:58:48 +08:00
thzxx	2230bcec3f	feat: v0.4.0 四阶段迭代 — 安全加固 + 工程基线 + 架构重构 + 双 Provider 扩展 ... P0 安全修复: - API Key 加密存储（safeStorage 密钥链，版本化前缀，历史明文平滑兼容） - 间接提示注入防护（SecurityScanHook 工具结果深扫描，网络工具脱敏/本地工具警示分级） - error:report IPC 断链修复（渲染进程错误上报落 electron-log + 审计） - abort 信号贯通工具层（run_command/dev-tools 子进程随会话中断终止） - run_command 沙箱加固（cd 系统目录/敏感文件读取拦截 + chcp 前缀剥离防解析退化） - .env 真实生效（dotenv 回退加载，应用内配置优先） P1 工程基础: - ESLint 9 flat config + 全部 34 条存量 warnings 清零（零容忍基线） - 测试基线 118 用例 11 文件（token/文件防护/权限/沙箱/注入/命令/引擎/注册表/审计链/摘要分层） - test:electron 双模式（ELECTRON_RUN_AS_NODE 跑 Electron ABI，SQLite 套件全执行） - SessionRecorder 多会话隔离 + 9 种 TRACE 事件补全（含最终轮 iteration_end） - Provider 故障转移（重试耗尽/不可重试一次性切换 fallback + 前端通知） - MCP 真就绪（等待全部连接完成再广播 tools:ready） - SLO/HealthChecker 真实接入（60s 巡检 + 托盘状态） - CONFIG_DEFAULTS 单一来源（消除 SEED 双源漂移） P2 架构升级: - handlers.ts 1940 行拆分为 13 个 IPC 域模块（防重入注册 + 多窗口广播） - AgentEngineManager 每会话独立引擎（LRU 30 + adapter 工厂隔离 abort 信号） - TaskOrchestrator EngineProvider 改造 + abortByParent 联动中断 SubAgent - 会话摘要分层上下文（session_summaries 滚动摘要 + 截断游标清理防因果污染） - 消息编辑重发/重新生成（truncateAfter IPC + store 动作 + UI） - Markdown 导出 / WebSearch 并行抓取（并发 3）/ 记忆 TF 缓存 / 版本构建期注入 P3 能力扩展: - OpenAI Adapter（o 系列推理模型 reasoning_effort/max_completion_tokens） - Anthropic Adapter（原生 Messages API：tool_use 块/角色合并/thinking budget/图片 base64/SSE 事件机） - 设置页/Onboarding 六 Provider 全链路接入	2026-08-20 23:17:02 +08:00
thzxx	b9f7ec5118	fix: 修复大数据导致应用崩溃 + 图片上传冗余工具调用 + 预存类型错误 ... ## 崩溃修复 (renderer OOM) view_image 返回的 base64 dataUrl(~6.7MB/张)经 dataUrl 白名单跳过截断后, 在 IPC/store/DOM 链路被反复放大,累积撑爆渲染进程堆导致 OOM 崩溃退出。 - 新增 src/lib/tool-result-display.ts: toDisplayResult() 在显示边界剥离 dataUrl - ToolResultBlock/TraceStep 渲染前套用,store 原始 result 不变(LLM 看图链路完整) - data:export 剥离 dataUrl/preview + 每会话 2000 条消息上限 + truncated 标记 ## 图片上传修复 用户上传图片并告知 AI 后,AI 仍调 view_image 去磁盘读取。 根因: 附件提示 "do NOT search in workspace" 与 view_image "Read an image file" 语义冲突,AI 认为"读取"≠"搜索"。强化提示明确禁止调用 view_image/read_file 读取已上传图片。 ## 预存类型修复 - ConfirmationDialog: MUI v9 移除 disableEscapeKeyDown 顶层 prop,迁移到 onClose reason 拦截 - ContextMenu/Sidebar: TokenUsage 对象字面量补齐 lastInputTokens/lastCompressedSaved ## 依赖升级 - @metona-team/metona-toast 0.1.2 → 0.2.1 (TypeScript 重构,修复 0.1.2 版本号打包 bug) ## 其他 - 删除仓库根目录误生成的 nul 垃圾文件 - bump version to 0.3.22	2026-07-25 19:35:33 +08:00
thzxx	4e52b24817	chore: bump version to 0.3.21 + metona-toast 升级至 0.1.2	2026-07-24 15:25:47 +08:00
thzxx	983c52b0e4	chore: bump version to 0.3.20 + metona-toast 迁移至 @metona-team 私有源	2026-07-23 21:42:14 +08:00
thzxx	56bd3a46d7	chore: sync package-lock.json version to 0.3.19	2026-07-22 20:55:00 +08:00
thzxx	2f495775ea	chore: bump version to 0.3.19	2026-07-22 20:53:43 +08:00
thzxx	e161fe059f	fix: MiMo 上下文窗口 1M + Agnes 多模态支持 Base64	2026-07-22 20:51:53 +08:00
thzxx	96b6f0b63d	docs: 重写 README.md，精致美观完整覆盖项目架构	2026-07-22 20:29:49 +08:00
thzxx	f3a0e751ba	feat: v0.3.18 上下文压缩机制修复 + MCP 工具就绪竞态修复 + 记忆系统加固 ... 【上下文压缩机制修复】 - engine.ts 新增 lastRealInputTokens 记录 LLM 返回的真实输入 token，压缩判断取 max(估算值, 真实值)，避免估算偏低导致不压缩但 API 413 - 修复 effectiveContextWindow 缺少默认值导致 compressionThreshold 变 NaN、压缩永不触发的 bug（添加 ?? 128_000 兜底） - compressMessages 保留区从固定 10 条改为按 token 预算动态截断（50% 上下文窗口） - 二次截断 charsPerToken 从 2 调整为 1.0，与 CJK_TOKEN_RATIO 一致 - 压缩后重置 lastRealInputTokens，避免跨迭代污染 - 每个 run 开始时重置 lastRealInputTokens 【前端 Token 显示修复】 - 区分"累计消耗"和"上下文占用"语义——之前 totalTokens(累计) / contextWindow(单次窗口) 得出无意义百分比 - TokenUsage.tsx 上下文占用改用 lastInputTokens，新增压缩节省行（绿色，仅当 > 0 时显示） - agent-store.ts TokenUsage 接口新增 lastInputTokens 和 lastCompressedSaved 字段，4 处初始值统一更新 - useAgentStream.ts usage 事件 lastInputTokens 替换不累加，compressed 事件通过 streamEvent 接收 savedTokens - handlers.ts onCompressed 同时发 toast + streamEvent，解决"压缩触发但前端 token 显示不降"缺陷 - 旧数据兼容使用 ?? 0，保证历史会话加载不崩溃 【MCP 工具就绪竞态修复】 - 修复输入框永久显示"工具加载中"的竞态条件：MCP initialize 几乎立即 resolve（connectServer 不 await），tools:ready 事件在前端监听器注册前已发出 - main.ts 维护 toolsReady 标志 + 注册 tools:isReady IPC handler 查询当前状态 - preload.ts 暴露 tools.isReady() 方法 - App.tsx 注册 onReady 监听器后立即查询 isReady()，无论事件是否错过都能恢复正确状态 【记忆系统加固】 - consolidator.ts 新增 runningPromise + waitForCompletion(35s)，before-quit 等待固化完成，防止退出时异步 consolidate 数据丢失 - 固化到 MEMORY.md 的同时写入 semantic_memories 表，解决双轨存储无交叉验证问题 - manager.ts tokenize 按中英文标点切分子句后再做 bigram，优化中文分词 - 清理正则冗余括号 【SOUL.md 降级处理】 - context-builder.ts SOUL.md 为空或不存在时降级到默认身份，向前端发 toast 提示用户 - 新增 fallbackRoleNotified 去重标志，仅首次降级通知，避免每次发消息都弹 toast - SOUL.md 恢复内容时重置标志 【Token 估算调整】 - token-estimator.ts CJK_TOKEN_RATIO 从 1.5 调整为 1.0 【MCP 异步初始化】 - main.ts MCP 完成后广播 tools:ready 事件，前端 UI 据以控制输入框可用性 - preload.ts + global.d.ts 暴露 tools.onReady() 监听器 - App.tsx + ChatInput.tsx toolsReady 状态控制输入框 【版本号】 - package.json + package-lock.json 从 0.3.16 升级到 0.3.18	2026-07-22 15:17:58 +08:00
thzxx	3e5ddea72d	feat: v0.3.17 修复多项问题（sandbox/全局配置层/继承选项/配置刷新/附件提示/content_filter 错误处理） ... - fix: sandbox: true → false（ESM preload 不兼容 sandbox 导致 window.metona 不可用，选择文件夹按钮无反应） - feat: 全局配置层（GlobalConfigService）— LLM/Agent 等配置跨工作空间共享，切换工作空间后不再丢失 - 读取时工作空间 DB 空值或默认值回退到全局 JSON - 写入时双写（DB + 全局 JSON） - 首次启动迁移旧配置到全局层 - fix: 工作空间继承选项显示条件放宽 + push 前校验避免覆盖目标已有文件（SOUL.md/agent.db） - fix: config:changed IPC 广播 + 前端监听，修改 Agent 配置后详情栏 maxIterations 实时刷新 - feat: 上传图片/文件时在 System Prompt 注入附件提示，避免 AI 在工作空间查找用户上传的文件 - feat: content_filter 错误识别（ContentFilterError）+ 友好提示，替代原始 JSON 错误体透传 - fix: JSDoc 注释中 llm.* / agent.* / onboarding.completed 中的 */ 被解析为注释结束符	2026-07-22 13:12:15 +08:00
thzxx	9af9984418	fix: JSDoc 注释中 GIT_*/ 被解析为注释结束符导致构建失败	2026-07-22 10:40:04 +08:00
thzxx	2c2ca4a692	feat: 升级至 v0.3.16 — 工单修复 51 项 + 审查修复 30 项（安全加固/适配器/工具系统/数据层/前端）	2026-07-22 10:31:13 +08:00
thzxx	516d8a728f	feat: 升级至 v0.3.15 — MiMo 多模态 + 工作空间数据库继承 + 引导窗口上下文配置 + TS 错误修复 ... - feat(mimo): 适配器支持图片输入，将 images 转为 OpenAI 兼容 content parts 数组 - feat(workspace): 切换工作空间时支持继承数据库 agent.db（SQLite backup API 原子导出，自动 checkpoint WAL） - feat(onboarding): 引导弹窗 LLM 配置加上下文长度字段（DeepSeek/Agnes=1000000、MiMo=131072、Ollama=null） - fix(types): 修复 16 个 TypeScript 编译错误（setConfigLoaded 接口声明、10 个 IPC 返回类型加 error 字段、MUI TextField readOnly slot 迁移） - chore(workspace): 移除死代码 traces 目录（trace 数据实际存储于数据库 sessions.metadata 字段，traces 目录从未被任何代码读写） - docs(mimo): API 文档补充多模态输入章节和 curl/Python 代码示例 - chore: 版本号 0.3.14 → 0.3.15	2026-07-21 21:05:50 +08:00
thzxx	c0a26ce053	feat: 升级至 v0.3.14 — 移除 AGENTS.md/USERS.md + 内置提示词统一管理 + 时间感知 + 工具管理滚动	2026-07-21 17:50:39 +08:00
thzxx	f640c9b48a	feat: 升级至 v0.3.13 — 任务管理系统重构（删除 todo_write + IPC 越权防护 + UI 自动刷新）	2026-07-21 17:01:15 +08:00
thzxx	058ee2de36	feat: 升级至 v0.3.12 — 文件与代码类工具全面优化（16 项） ... 【阶段一 · 紧急修复 F1】 - F1-1 file_editor regex 计数 bug：强制 g 标志 + 同一 RegExp 实例做 match+replace - F1-2 code_search 统一 safeResolvePath（含路径遍历 + MEMORY.md 拦截） - F1-3 git_commit amend 模式：message 可选 + --no-edit 防止编辑器 hang - F1-4 write_file append 模式原子化：显式 open(O_APPEND)+write+fsync+close 【阶段二 · 增强现有工具 F2】 - F2-1 read_file 智能编码检测：BOM(UTF-8/UTF-16 LE/BE) + GBK 降级 - F2-2 read_file 支持 tail 模式（读取末尾 N 行，适用日志） - F2-3 search_files 二进制过滤 + 智能编码检测 - F2-4 search_files 多 glob 匹配（逗号分隔，如 *.ts,*.js） - F2-5 file_editor 新增 find_replace 操作（字面量替换，规避正则歧义） - F2-6 file_editor regex 支持跨行匹配（multiline 参数） - F2-7 file_editor 新增 backup 参数（编辑前 .bak 备份） 【阶段三 · 新增工具 F3】 - F3-1 file_move：双路径校验 + overwrite + 自动建父目录 + rename 原子 - F3-2 file_info：大小/时间/类型/编码/二进制/权限位 【阶段四 · 优化 F4】 - F4-1 diff_viewer Uint32Array→Uint16Array（省一半内存）+ safeResolvePath + 智能编码 - F4-2 错误处理统一：diff-viewer/file-editor/code-search catch 块改用 extractErrorMessage 【阶段五 · 验证 F5】 - tsc --noEmit 类型检查通过 - 人工审查通过：路径校验/错误处理/原子性/资源释放/权限策略/导出注册 工具数量：13 → 15（新增 file_move / file_info）	2026-07-21 16:08:39 +08:00
thzxx	8973ea6d47	feat: 升级至 v0.3.11 — 流式输出性能优化 12 项，解决长内容卡死 ... 针对 AI 流式输出长内容时应用卡死问题，实施 12 项性能优化： 渲染层优化（F1/F3/F7）： - F1: React.memo 包裹 MessageItem/AssistantMessage，跳过历史消息重渲染 - F3: 流式时用纯文本渲染，避免 ReactMarkdown 全量重解析 O(n²) - F7: useMemo 缓存 ReactMarkdown 元素，非流式时复用实例 滚动与布局（F2/F4/F10/F12）： - F2: 滚动节流 rAF + 100ms throttle + trailing 兜底，避免高频布局 - F4: CSS content-visibility 准虚拟滚动，跳过不可见区域布局 - F10: CSS contain 隔离 markdown 布局计算 - F12: 滚动容器 transform: translateZ(0) GPU 加速 状态与 IPC 批处理（F5/F8/F9）： - F5: 渲染进程 text_delta rAF 批处理，合并多次 store 写入 - F8: 主进程 text_delta 32ms 节流合并，降低 IPC 频率 - F9: reasoning_delta traceSteps thought 走 rAF 批处理 代码清理（F11）： - F11: 移除 rehypeRaw，节省 raw HTML 解析开销 + 防 AI 输出注入 验证：tsc --noEmit 通过，flush 逻辑在 done/error/cleanup 三处正确执行。	2026-07-21 14:38:27 +08:00
thzxx	cd681b949a	feat: 升级至 v0.3.10 — LLM 配置批量保存 + workspace.path 失败感知 + provider 切换防御性修复 ... - 新增 config:setBatch IPC：批量写入 8 个 LLM 字段后统一 reloadAdapter， 解决设置页串行 config:set 在中间态触发"LLM 配置不完整"错误的问题 - SettingsModal.handleSave 和 OnboardingWizard.handleNext 改用 setBatch - workspace.path 写入独立文件失败时返回 success:false（config:set 和 setBatch 一致）， 避免用户误以为保存成功但下次启动仍使用旧路径 - setBatch 将 provider 切换清空 apiKey 的逻辑移到循环前执行， 消除对 entries 中 llm.provider 必须出现在 llm.apiKey 之前的隐含顺序依赖	2026-07-21 13:14:42 +08:00
thzxx	64af91bde9	feat: 升级至 v0.3.9 — 工具批量审批 + run_command 频率限制优化 + Toast 规范 ... 1. 工具批量审批：解决并行工具审批弹框覆盖问题，新增批量 IPC 通道和列表 UI，支持同工具多次调用分组展示；2. 审批弹框健壮性：超时 toast 防风暴、agent 状态同步清空、ErrorBoundary 防白屏；3. run_command maxFrequency 从 3 调整为 10；4. 开发规范新增 Toast 通知铁律（必须使用 MeToast）	2026-07-21 11:43:41 +08:00
thzxx	76bd72b702	fix(trace): TraceViewer 出现滚动条时自动滚到底部 ... 新增 scrollContainerRef + useEffect，监听 traceSteps / agentStatus / groups.length 变化时自动滚到底部，与 MessageList 同款 throttle 80ms 模式， 避免流式事件高频触发导致滚动卡顿。	2026-07-20 22:08:14 +08:00
thzxx	5ec32f33da	fix(trace): Trace Viewer 改为按 runId 分组渲染，显示所有轮次 ... 修复 v0.3.8 引入的"覆盖"问题：sendMessage 清空 traceSteps 导致 前一条消息的 trace 被永久丢失。 方案 A+ — 既不叠加也不覆盖，按 runId 分组展示所有轮次： - agent-store.ts: 回退 sendMessage 的 traceSteps: [] 清空（保留历史） 保留 tokenUsage 重置（当前 run 统计应该重置） - TraceViewer.tsx: 重写渲染逻辑 - 新增 groupByRun 工具函数，按 runId 分组 + 计算轮次序号 - 每个 run 独立 section，带"第 N 轮"标题 + 状态徽标（进行中/已完成）+ 步数 - 当前 run 高亮（primary 边框 + 浅色背景 + MessageSquare 图标） - 历史 run 弱化（divider 边框 + 透明背景 + 0.85 透明度） - 顶部统计"共 N 轮" - isCurrent 判定改为"当前 run 的最后一个 step"（之前是"全局最后一个"） useAgentStream 的 runId 隔离逻辑（v0.3.8 已加）无需改动， 正好支撑多 run 共存设计：isSameIteration 校验 runId，跨 run 孤立 TERMINATED 跳过不创建 step。 冒烟测试场景: - 多轮对话 → 每轮独立显示，不再叠加 - 历史 trace 不丢失 → 切换会话回来仍可见所有轮次 - 当前 run 高亮 → 视觉聚焦"正在进行的活动"	2026-07-20 21:57:03 +08:00
thzxx	dde21f0b3f	feat: 升级至 v0.3.8 — Trace Viewer 叠加修复 + LLM 配置校验改造 + toast 反馈统一 ... - Trace Viewer 叠加渲染修复 - sendMessage 补 traceSteps/tokenUsage 重置（止血） - TraceStep 加 runId 字段，useAgentStream 按 runId 判定同迭代（稳健改造） - LLM 配置校验中等改造（SettingsModal LLMSettings） - 取消 onChange 实时落库，改为本地 state + Save 按钮统一提交 - 字段级 inline error：Base URL http(s):// 正则、Model 空格校验、contextWindow ≥ 4096 - Provider 切换清空 Model（之前只清 apiKey） - 保存结果改用 metona-toast（不再用 Alert） - toast 反馈机制全面统一（15 处问题修复） - ContextMenu: 原生 confirm/prompt 改 MUI Dialog（新增 useDialogStore + ContextMenuDialogHost） - ContextMenu: 抽 copyWithToast helper 替代散落 7 处静默失败 - OnboardingWizard: 配置保存失败静默改 toast.error - useKeyboardShortcuts: Ctrl+N / Ctrl+Shift+C 失败补 toast - SettingsModal: inheritFiles 失败 toast.warning、handleApply 失败 toast.error - LogsSettings: resultAlert Alert 改 toast（保留 Dialog 确认） - MemoryViewer: 删除失败改 toast（加载/搜索保留 Alert） - TaskList: create/update/delete/无会话改 toast - agent-store: sendMessage/session 失败补 toast（保留 system message） - 删除当前会话同步清空 ChatPanel/DetailPanel - Sidebar confirmDelete + ContextMenu delete 均补 agent-store 重置 - 修复 useSessionStore.removeSession 不触发 agent-store 同步的遗漏	2026-07-20 21:22:20 +08:00