97a3d3d53b729e6bcc7c5f4154851df16a317ca8
**崩溃/挂死修复 (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 (状态由右键菜单展示)
MetonaAI Desktop
生产级通用 AI Agent 智能体桌面应用。
技术栈
- 运行时: Electron 35 + React 19 + TypeScript 5.8
- 状态管理: Zustand 5
- 数据库: better-sqlite3
- LLM: DeepSeek / Agnes AI / Ollama
- 协议: MCP (Model Context Protocol)
- 构建: electron-vite + Vite 6
快速开始
# 安装依赖
npm install
# 开发模式
npm run dev
# 构建
npm run build
配置
复制 .env.example 为 .env,填入 API Key:
cp .env.example .env
或在应用设置界面中配置 LLM Provider。
项目结构
MetonaAI-Desktop/
├── electron/ # Electron 主进程
│ ├── main.ts # 应用入口
│ ├── preload.ts # 安全桥接脚本
│ ├── ipc/ # IPC 通道处理
│ ├── services/ # 业务服务(数据库、会话、记忆等)
│ └── harness/ # Agent 核心引擎
│ ├── agent-loop/ # ReAct 状态机
│ ├── adapters/ # LLM Provider 适配器
│ ├── tools/ # 工具注册与内置工具
│ ├── memory/ # 记忆系统
│ ├── prompts/ # System Prompt 构建
│ └── types/ # Metona IR 类型定义
├── src/ # React 渲染进程
│ ├── components/ # UI 组件
│ ├── hooks/ # React Hooks
│ ├── stores/ # Zustand 状态管理
│ ├── styles/ # 全局样式
│ └── types/ # 类型声明
├── docs/ # 设计文档
├── standard/ # 开发规范
└── apis/ # API 文档
功能
- ✅ 三栏布局(Sidebar + Chat + DetailPanel)
- ✅ 流式对话(DeepSeek / Agnes / Ollama)
- ✅ 9 个内置工具(文件系统、网络、记忆、命令行)
- ✅ MCP 协议支持
- ✅ 会话持久化(SQLite)
- ✅ 三层记忆系统(情节/语义/工作)
- ✅ 全链路追踪(Trace Viewer)
- ✅ 审计日志(防篡改)
- ✅ 系统托盘 + 全局快捷键
- ✅ 暗色/亮色主题
- ✅ 14 个键盘快捷键
许可证
MIT