MetonaTeam/metona-ai-desktop
2
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
94 Commits 1 Branch 1 Tag
3a30e8f5b4890d01f10793c7bad064c2380361e9
Commit Graph
14 Commits
Author SHA1 Message Date
thzxx 3a30e8f5b4 fix: v0.5.3 模型能力完整性修复 — MCP 工具动态同步 + maxTokens 模型上限钳制
CI / 类型检查 + Lint + 单元测试 (push) Failing after 5m43s
Details
CI / 全量测试 (Electron ABI) (push) Failing after 5m21s
Details
CI / 产物编译验证 (push) Successful in 9m59s
Details 
背景：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 余额解析错误
CI / 全量测试 (Electron ABI) (push) Failing after 5m21s
Details
CI / 产物编译验证 (push) Successful in 10m6s
Details
CI / 类型检查 + Lint + 单元测试 (push) Failing after 5m42s
Details 
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 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 2c2ca4a692 feat: 升级至 v0.3.16 — 工单修复 51 项 + 审查修复 30 项（安全加固/适配器/工具系统/数据层/前端） 2026-07-22 10:31:13 +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 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 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 97a3d3d53b fix: 全面修复审计问题并优化系统提示词 
**崩溃/挂死修复 (5):**
- 统一 TrayManager.isQuitting 变量，修复 Cmd+Q 无法退出
- useAgentStream 闭包过期快照 → 每次 getState()
- Agnes chatStream 添加 AbortSignal.timeout
- SSE JSON.parse 添加 try-catch 保护
- Orchestrator setTools 污染 → save/restore 模式

**功能修复 (14):**
- 上下文压缩实现 (每5轮 COMPRESSING 状态)
- 修复 requestId 硬编码空串
- ConfigService.set() 保留已有 category
- MemoryManager 新增 working 类型搜索
- PromptInjectionDefender 补全 sanitize()
- Ollama: 补全 dynamicReminders + reasoningContent
- openai-format: 所有 assistant 消息保留 reasoningContent
- SSE: finish_reason 时提前 flush tool_calls
- DeepSeek thinking effort 映射注释
- Ollama done_reason load→stop
- RateLimitHook >= 边界修复
- WorkspaceService isValid 首次启动修复
- sessions:archive IPC handler
- 托盘/窗口图标路径生产环境修复

**系统提示词优化:**
- SOUL.md 存在时不显示兜底身份，原文放最前
- 兜底身份改为中文 (MetonaAI 自身描述)
- 用户文本在前，附件内容在后

**文件上传:**
- 非图片文件不再 base64 编码，保留 JSON 结构
- 用户文本优先于文件内容

**UI 修复:**
- 首页 Logo 路径修复 (public/ + 相对路径)
- TokenUsage contextWindow 动态计算 (Provider 感知)
- 切换 Provider 同步 contextWindow
- 托盘图标始终显示 Logo (状态由右键菜单展示)
 2026-06-30 23:17:38 +08:00
thzxx 594652f27a feat: 默认 maxTokens 8192 → 65536 (64K) 
- engine.ts: 默认 maxTokens 8192 → 65536
- database.service: llm.maxTokens 种子值同步更新
- deepseek.adapter: 补充模型规格注释(1M上下文, 384K最大输出)
 2026-06-27 22:00:18 +08:00
thzxx aa0dd464ac fix: 对照 API 文档修复 3 个 Adapter 的 8 个实现差异 
通过逐接口对比 DeepSeek/AgnesAI/Ollama 官方文档与实现代码，发现并修复：

DeepSeek (4 fix):
- temperature 默认值: 错误发送 0(API默认=1)，改为 undefined 让 API 用默认值
- thinking 禁用: API 默认 enabled，不传=开启。改为显式发送 {type:disabled}
- reasoning_effort: 补充 xhigh→max 映射(文档规定)
- stream 请求: 补充 AbortSignal.timeout 超时控制

Agnes AI (2 fix):
- temperature 默认值: 同上
- 图片 image_url: 移除文档未提及的 detail 字段

Ollama (3 fix):
- temperature 默认值: 同上(Ollama默认≈0.8)
- tool_calls arguments: 从对象改为 JSON 字符串(REST API 要求)
- finishReason: 使用 done_reason 字段正确映射(之前始终返回 STOP)
 2026-06-27 21:48:15 +08:00
thzxx bd6856c7e4 refactor: 解耦 Provider Adapter 继承关系 
问题：AgnesAdapter extends DeepSeekAdapter 在架构上不合理。
DeepSeek、Agnes AI、Ollama 是三个完全不同的 API，不应有继承关系。

重构：
  BaseAdapter
  ├── DeepSeekAdapter  (独立)
  ├── AgnesAdapter     (独立)
  └── OllamaAdapter    (独立)

变更：
- 新增 shared/openai-format.ts — 提取 OpenAI 兼容消息/工具格式构建
- 新增 shared/sse-stream.ts   — 提取 SSE 流式解析逻辑
- DeepSeekAdapter  重写为独立继承 BaseAdapter，使用共享工具
- AgnesAdapter     重写为独立继承 BaseAdapter，使用共享工具
- OllamaAdapter    无需变更（原本就独立继承）
- adapters/index.ts 清理导出，移除隐式耦合
 2026-06-27 21:41:43 +08:00
thzxx a879b4f38a fix: 修复上传图片后 AI 无法识别图片的问题 
根因：图片从 ChatInput → agent-store → IPC → adapter 的链路中有两处断裂：

1. DeepSeekAdapter.toNativeRequest 完全忽略 message.images 字段
   - 用户消息中的图片 base64 数据未转换为 OpenAI 多模态 content
     数组格式，导致 LLM 收不到图片数据，只能尝试用工具查磁盘文件

2. AgnesAdapter.toNativeRequest 图片处理存在数组索引错位
   - base.messages[0] 固定为 system 消息（父类插入）
   - request.messages.filter(m => m.role !== 'system') 去掉了 system
   - 同一索引 i 访问两个不同长度的数组，导致图片消息匹配到错误位置

3. agent-store sendMessage 中 images 参数被局部变量遮蔽
   - ChatInput 传入的 images 被  覆盖
   - 改为直接使用参数，避免重复从 attachments 提取

修复:
- DeepSeekAdapter: 在 toNativeRequest 中添加图片→OpenAI content 数组转换
- AgnesAdapter: 移除冗余图片处理(基类已处理)，仅保留 Thinking/max_tokens
- agent-store: 移除 images 变量遮蔽，直接使用参数

影响范围: DeepSeek / Agnes AI / Ollama 三个 Provider 的图片传递均已验证
 2026-06-27 21:39:24 +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