# 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

## 快速开始

```bash
# 安装依赖
npm install

# 开发模式
npm run dev

# 构建
npm run build
```

## 配置

复制 `.env.example` 为 `.env`，填入 API Key：

```bash
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