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