thzxx
9b6bdaea32
1. StreamingIndicator: 最后一条是 assistant 消息时不显示'正在连接', 避免与 AssistantMessage 的'正在思考'重叠 2. useAgentStream: 跳过 INIT(iteration=0) 的 trace step, 引擎初始化无实际内容不应展示 3. useAgentStream: 状态转换追加到 states 数组而非覆盖 state 字段, 保留完整 THINKING->EXECUTING->OBSERVING 进度 4. TraceStep: header 显示状态进度链(如'思考 -> 执行 -> 观察')而非仅最终状态 5. agent-store: 旧数据兼容, 加载时为缺少 states 的 trace step 补全
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