thzxx
0fc589e73b
## 主要变更 ### 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（内存操作）
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