41 Commits

Include renames

Author	SHA1	Message	Date
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	2f495775ea	chore: bump version to 0.3.19	2026-07-22 20:53:43 +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	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	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
thzxx	ceb8ee644d	feat: 升级至 v0.3.7 — 前后端状态同步与错误处理全量修复 ... 核心引擎修复: - CE-1: 上下文压缩摘要 role 从 system 改为 user，避免被 adapter 过滤 - CE-2: 工具失败时优先使用 error 字段（engine/openai-format/ollama 三处） - P0-1: DeadLoopError 终止时正确传 error 参数，前端可见 ERROR 事件 - MT-1: 新增 waitForAbort 方法，abortSession 等待 run 结束再返回 - MT-2: TERMINATED 状态到达时标记步骤完成，避免 Trace Viewer 转圈 - MT-3: 压缩边界检测孤立 tool 消息，避免 API 400 错误 - isRetryableError 与 catch 分支统一 toLowerCase IPC 与主进程修复: - P0-2: createAdapter 配置缺失返回 null，FALLBACK_ADAPTER 兜底 - P0-3: reloadAdapter 失败返回 success:false 通知前端 - P1-5: 校验失败发 ERROR+DONE 流事件，防止 isStreaming 卡死 - P1-6: configLoaded 标志，配置加载前禁用发送按钮 - P1-7: MCP initialize 移到 agentLoop 后，完成后同步工具 - P2-11: beforeLoad 在 loadURL 前注册 IPC handler - P2-12: provider 切换竞态保护 前端状态同步修复: - clearSessions 后同步清空前端会话与消息状态 - clearMemories 通过 memoryVersion 触发 MemoryViewer 重新加载 - ContextMenu 4 个 session 操作补全 IPC 调用与 try/catch - useConfig 配置保存失败回滚 UI 并提示 - handleToggle 工具切换失败回滚单个工具状态 错误处理全量补全: - 所有 await window.metona 调用补全 try/catch 与 toast 反馈 - MCP addServer/toggleServer/removeServer 检查返回值 - showItemInFolder 检查返回值（handleOpen/handleOpenInFolder） - sse-stream/ollama NDJSON 解析失败改为 log.warn - adapter throwHttpError 带 status 属性供 isRetryableError 判断	2026-07-16 22:40:32 +08:00
thzxx	656c6b7af1	feat: 升级至 v0.3.4 — 接入 Xiaomi MiMo Provider + 文档全量校准 ... 新增 MiMo (小米) LLM Provider 适配器，支持 mimo-v2.5-pro 和 mimo-v2.5 两个文本模型，复用 OpenAI 兼容 SSE 流式解析，支持 Thinking 模式和 Function Calling。同步校准全量 docs 文档与 README 使其与实际代码一致。 主要变更： - 新增 mimo.adapter.ts 适配器（SSE + thinking.type + max_completion_tokens） - 修复 thinking 逻辑 bug：禁用思考时未传 temperature/top_p - 补全 sse-stream.ts 的 MiMo 缓存字段映射（prompt_tokens_details.cached_tokens） - 补全 sse-stream.ts 的 finish_reason 映射（repetition_truncation） - 注册 MiMo 适配器到 adapters/index.ts、main.ts 工厂 - handlers.ts 添加 mimo.contextWindow 热重载触发 - database.service.ts seed 添加 mimo 默认配置 - SettingsModal/OnboardingWizard/Header 添加 MiMo Provider UI - constants.ts PROVIDER_LABELS 添加 mimo - .env.example 添加 MIMO_API_KEY/MIMO_BASE_URL - 反向修改 4 个 docs HTML 设计文档（工具数量/版本日期/适配器列表/数据库表） - 反向修改 Agent网络工具通用设计-v2.md 附录 B 文件索引 - 完全重写 README.md（v0.3.4、27 工具、4 适配器、9 表）	2026-07-15 22:28:09 +08:00
thzxx	4554177db0	feat: 升级至 v0.3.3 — 新增 delete_file 工具 + 文件工具全面优化 ... ## 主要变更 ### 1. 新增 delete_file 工具（26 → 27 个） - 支持：删除文件/空目录（默认）/递归删除非空目录（recursive: true） - 5 层安全防护： * isPathWithinWorkspace — 路径遍历防护 * isProtectedWorkspaceFile — MEMORY.md 拦截 * 工作空间根目录保护 — 禁止删除 workspace 本身 * 递归删除需显式开启 — 默认仅删空目录 * riskLevel: HIGH + requiresPermission — 破坏性操作必须确认 - 友好错误处理：ENOTEMPTY 时提示设置 recursive: true ### 2. 文件工具全面优化（6 个工具） - 抽取共享代码到 file-guard.ts： * safeResolvePath — 合并路径遍历 + MEMORY.md 校验 * matchGlob — 简易通配符匹配 * extractErrorMessage — 统一错误提取 * MAX_FILE_SIZE_BYTES (10MB) / FILE_TOOL_TIMEOUT_MS (15s) / MAX_LINE_LENGTH (10000) - read_file：stat 预检 + 超长行截断 + 二进制检测 + 大小上限 - write_file：原子写入（临时文件+rename）+ 内容大小上限 + append 返回 new_file_size - list_directory：1000 结果上限 + modified time + include_hidden 参数 + 提前终止优化 - search_files：regex lastIndex 修复 + context_lines + include_hidden + 大文件跳过 - file_editor：dry_run 预览模式 + 文件大小上限 ### 3. 审计修复（1 FAIL + 3 WARN） - FAIL: isBinaryFile 用 bytesRead 限制循环，修复 < 8KB 文本误判为二进制 - WARN-1: file-editor dry_run preview 分模式计算，修复 insert 范围过大 - WARN-2: write_file 允许空字符串创建空文件 - WARN-3: list_directory listDir 提前终止，避免大目录全量遍历	2026-07-14 21:42:46 +08:00
thzxx	0fc589e73b	feat: 升级至 v0.3.2 — 工具体系扩展至 26 个 + Context Window 可配置化 ... ## 主要变更 ### 1. Context Window 可配置化（v0.3.1 延续） - DeepSeek/Agnes contextWindow 不再写死 1M，可在设置中配置（min 4096） - 修复 Engine 128K vs Adapter 1M 不一致 bug，Engine 从 adapter.getContextWindow() 读取 - 热重载 configSig 加入 contextWindow，配置变化即时生效 ### 2. 新增 11 个工具（15 → 26 个） - Git 工具集（4）：git_status, git_diff, git_log, git_commit - 开发工具集（3）：lint_code, run_tests, project_info - HTTP 请求（1）：http_request（Node 18+ fetch + AbortController） - TODO 管理（1）：todo_write（会话级内存 + LRU 淘汰） - 结构化思考（1）：think（无副作用思考空间） - 图片查看（1）：view_image（base64 data URL，多模态 LLM 支持） ### 3. 审计修复（2 FAIL + 14 WARN） - FAIL-1: registry.ts truncateResult 添加 dataUrl 白名单（图片不被截断） - FAIL-2: todo.ts 添加 LRU 策略 + clearSession 静态方法 - WARN-1: run_tests filter 字符白名单校验，防 cmd 元字符注入 - WARN-2: dataUrl 检测前置到 stringify 之前，避免大图片无意义序列化 - WARN-3: todo.ts 实现真正 LRU（访问刷新位置，非 FIFO） - WARN-4: git_diff maxBuffer 提升至 5MB，支持超大变更集 - WARN-5: log.info 移至 DelegateTaskTool 注册后，输出正确的 26 - WARN-6: riskColors 添加 critical: 'error' 键 - WARN-7: 所有 execFileAsync 显式设置 encoding: 'utf-8' - WARN-8: git_log --author 拆分为独立参数 - WARN-9: todo_write 权限从 WRITE 改为 READ - WARN-10: description 区分与 task_manager 的不同用途 ### 4. PolicyEngine 策略 - 新增 11 条策略，26 个工具 + mcp_* 全覆盖 - git_commit: WRITE + requireConfirmation - todo_write: READ（内存操作）	2026-07-14 21:15:54 +08:00
thzxx	e4d81d8247	feat: 升级至 v0.3.1 — 全量代码审计修复 + 安全增强 ... 本次升级基于完整代码审查，修复 Critical/High/Medium/Low 四级共 96 项问题， 并通过返工审计修复 10 项遗留问题，tsc 双端类型检查零错误。 Critical (10/10 完成): - C-4: command.ts 接入 shell-quote 进行 token-level 注入检测，替代原有正则匹配 可防御 r"m" -rf /、$'rm'、$(echo rm) 等字符串拼接绕过 High (11/11 完成): - 竞态保护、Promise.allSettled、AbortController 资源泄漏、IPC 参数校验等 Medium (55/55 完成): - 事务保护、敏感数据脱敏、枚举校验、MUI v9 Stack prop 迁移、 React 组件 cancelled 标志、类型收窄等 Low (20/20 完成): - 辅助方法提取（flushToolCallBuffer/scoreAndPushMemory/tryAddColumn 等） - nanoid 统一替代 Date.now()+Math.random() - confirm() 替换为 MUI Dialog、useMemo 缓存、魔法数字命名化等 返工审计修复 (10/10 完成): - L-11: LogsSettings 残留的原生 confirm()/alert() 全部替换为 MUI Dialog/Alert - M-53: MemoryViewer handleSearch 独立 ref，修复 searching 状态卡死 - M-42: 脱敏短值（length <= 4）泄露修复 - M-47: tasks:update 补全 title/description 类型校验 - L-9: ollama.adapter 非流式路径 nanoid 统一 - M-45: audit:query limit 策略与 memory:listAll 一致化 - SettingsModal handleConfirmRemove 补全 try/catch + loadServers cleanup - L-15: CommandPalette useMemo 补全 sessions 响应式依赖 - useAgentStream 事件类型补全 seq/timestamp 字段 新增依赖: shell-quote + @types/shell-quote 版本号: 0.3.0 -> 0.3.1	2026-07-13 22:36:58 +08:00
thzxx	025f00171b	feat: 升级至 v0.3.0 — 安全增强、死循环检测、六轮全面审计修复 ... 大版本迭代，新增安全增强、Agent Loop 增强、UI/UX 增强，经六轮全面审计修复所有问题。 新增功能： - OutputValidator 事实一致性检查 + 幻觉检测 - PromptInjectionDefender 语义级检测（指令性动词密度、角色边界、分隔符嵌套） - DeadLoopError 死循环检测（连续3轮相同工具调用自动终止） - PolicyEngine maxFrequency 滑动窗口频率限制 - MemoryManager TF-IDF 语义检索 + IDF 缓存原子替换 - 斜杠命令（/tool /memory /clear /export）+ 快捷键（Ctrl+B/J/Shift+F/N/[/]） - 专注模式（Ctrl+Shift+F）带面板状态快照保存/恢复 六轮审计修复（共修复 3 CRITICAL + 8 HIGH + 13 MEDIUM + 11 LOW）： CRITICAL: - main.ts 传入 createAdapter 而非 reloadAdapter，导致 Provider 切换完全失效 - Ctrl+N/Ctrl+[/Ctrl+] 不同步 agent-store，导致消息发到错误会话 - engine.ts emit('error') 无监听器导致 DONE 事件丢失、前端卡死 HIGH: - 死循环检测在工具执行之后（移入 PARSING 后 EXECUTING 前） - deadLoop 事件前端未处理 - ConfirmationHook.clearPending 从未调用导致定时器泄漏 - engine.ts retry abort listener 未移除导致监听器堆积 - MCPManager JSON.parse 无 try-catch 导致初始化崩溃 - sendMessage 自动创建会话不同步 session-store - setCurrentSession 竞态导致旧请求覆盖新会话数据 MEDIUM: - toggleFocusMode 覆盖用户原有面板状态 - 正则检测可被常见词绕过 - 频率限制内存泄漏 + customPolicies 覆盖 - LIKE 回退转义未包含反斜杠 - OutputValidator 新功能未传入 toolResults/context - MemoryConsolidator LLM 调用无超时保护 - AuditService 每次 log 都查询数据库 - browser-window-manager 超时后未停止页面加载 - output-validator URL 比较大小写敏感 - FileReader 无 onerror 导致 Promise 永久挂起 - /clear /export 不关闭斜杠菜单 - 专注模式下 toggleSidebar/toggleDetail 未恢复另一面板快照 LOW: - abortPromise 事件监听器堆积 - RateLimitHook Map 内存泄漏 - memory.ts await 同步方法 - PolicyEngine 死代码清理 - Orchestrator sessionDepth 会话结束不清理 - workspace.service.ts 元数据插入边界问题	2026-07-12 19:46:47 +08:00
thzxx	1eabed9b70	feat: 升级至 v0.2.3 — Token 估算优化、工具确认超时改进、工作空间标签页 ... 1. Token 估算优化（核心改进）：新增 token-estimator.ts 智能字符估算（中文 1.5 token/字、ASCII 0.25 token/字），替换三处旧的 length/2 粗略估算，中文场景准确度从 ~50% 提升到 ~90% 2. 工具确认超时改进：超时时间可配置（30s~600s）、超时 toast 通知、ConfirmationDialog 倒计时 UI（进度条 + 最后 10 秒红色脉冲动画）、SettingsModal 新增配置入口 3. 详情栏新增 Workspace 标签页：workspace:getInfo IPC + WorkspaceViewer 组件（文件预览、目录状态、在文件管理器打开）	2026-07-12 14:20:05 +08:00
thzxx	aa13a98f63	feat: 升级至 v0.2.2 — 工作空间路径注入、Provider 切换修复、编码与样式优化 ... 功能增强： - System Prompt 注入当前工作空间路径到动态区（LLM 可使用绝对路径调用工具） - ContextBuilder.buildSystemPrompt 新增 workspacePath 参数 Provider 切换修复： - reloadAdapter 返回 boolean，失败时 sendMessage 中止发送 - 切换 Provider 时自动清空 apiKey（不同 Provider key 不通用） - apiKey 为空时显示警告提示 - Provider 切换事件加 sessionId 字段 编码修复： - run_command 使用 encoding: 'buffer' 获取原始字节 - 新增 decodeBuffer 智能解码：UTF-8 严格 → GBK → UTF-8 宽松 - 修复不响应 chcp 的 Windows 命令中文乱码问题 样式优化： - 代码块底色改用主题变量（灰底主题色文字，双主题适配） - 表格标题 th/td 底色和文字色改用主题变量 - CodeBlock 组件 pre 背景从 secondary.main 改为 background.default - 设置面板已自动执行工具行 opacity 0.8→0.15（淡绿底，文字清晰） 版本号 0.2.1 → 0.2.2	2026-07-12 13:46:09 +08:00
thzxx	3c5aea8fb7	feat: 升级至 v0.2.1 — 流式渲染修复、安全增强、工具自动执行 ... 流式渲染修复： - runId 机制防止 abort 后旧流事件污染新 run - run lock 防止并发 run 污染引擎状态 - abort race 提前退出工具执行等待 - TERMINATED 状态通过 stateChange 发射 - tool_call_delta 流式参数拼接 + pending 占位替换 - 首轮卡片创建路径统一，traceStep 按 ID 精确匹配 - compressed 事件转发为 toast 通知 安全增强： - ConfirmationHook 支持持久化自动执行（跨会话） - 设置面板新增自动执行工具管理 UI - SandboxManager 双重安全校验 fail-closed - 审计日志链式哈希防篡改 - PromptInjectionDefender 中文注入标记清理 - scanCode 28 模式 + base64/$() 检测 - validatePath realpathSync 防符号链接逃逸 - code-search 使用 execFile 防命令注入 新增工具： - file_editor、code_search、task_manager、diff_viewer 其他： - Agent Loop 加 PARSING/REFLECTING 状态 + 指数退避重试 - MemoryManager TF-IDF 语义检索 - run_command Windows 中文编码修复（chcp 65001） - 版本号 0.2.0 → 0.2.1	2026-07-12 12:54:52 +08:00
thzxx	469f53b623	chore: bump version to 0.1.4	2026-07-09 20:41:22 +08:00
thzxx	725f40ca6c	chore: bump version to 0.1.3	2026-07-07 21:25:47 +08:00
thzxx	6f08759f63	v0.1.2: 全项目代码审查修复 + 子代理编排器 + 上下文压缩 + 并行工具执行 ... 后端修复: Ollama adapter 移除死代码/修复超时硬编码/iteration硬编码/pullModel无超时/流异常断开补发DONE; SSE解析器支持非字符串arguments; Sandbox fail-closed安全加固; IPC移除未使用变量 新增功能: TaskOrchestrator子任务编排器; DelegateTaskTool委派工具; Agent Loop并行工具执行; 上下文自动压缩; 记忆检索注入System Prompt 前端修复: useAgentStream text_delta thought累积bug; 工具调用状态正确流转; 修复重复stateChange事件; TraceStep.thought正确填充	2026-07-06 22:48:33 +08:00
thzxx	8cdb93f8bf	feat: MEMORY.md 访问保护、格式简化及预存问题修复 ... MEMORY.md 保护: 新建 file-guard.ts 共享守卫模块; read_file/write_file/search_files/run_command 禁止访问根目录 MEMORY.md; permissions.ts 增加 deniedPatterns 深度防御。格式简化: 元数据从 # 注释改为 > 引用语法; 校验规则从 6 条简化为 3 条; context-builder extractContent 适配。预存问题: 修复路径遍历前缀碰撞漏洞; 移除 browser_extract 内容截断; SearXNG 配置实时读取; web_search/web_fetch 移除截断; 侧边栏动态获取工具列表; 版本号 0.1.1	2026-07-05 21:24:22 +08:00
thzxx	f4532a2bb2	refactor: 移除多余依赖，统一 MUI 为唯一 UI 库 ... - 移除 radix-ui、clsx、tailwind-merge、class-variance-authority、react-router-dom - 前后端全面适配 MUI 组件，清理残留 Tailwind 工具类引用 - 优化 Agent Loop 引擎、IPC 处理器、Provider Adapter 等后端模块 - 新增 Agent 网络工具通用设计文档 v2	2026-07-05 19:15:48 +08:00
thzxx	1d185db6b3	feat: MetonaAI Desktop 初始项目 ... - Electron + React + TypeScript 架构 - 三栏布局: Sidebar | ChatPanel | DetailPanel - 9 个内置工具 (文件系统/网络/记忆/命令) - SQLite 持久化 (better-sqlite3) - MUI 暗色/亮色主题系统 - Agent Loop ReAct 状态机引擎 - DeepSeek / Agnes AI / Ollama Provider 适配器 - MCP 协议集成 - 系统托盘 + 全局快捷键 - Tailwind CSS v4 + Tailwind Merge - 修复: Sidebar 缺失 TextField 导入导致黑屏	2026-06-27 21:33:27 +08:00