feat: MetonaAI Desktop 初始项目

- Electron + React + TypeScript 架构
- 三栏布局: Sidebar | ChatPanel | DetailPanel
- 9 个内置工具 (文件系统/网络/记忆/命令)
- SQLite 持久化 (better-sqlite3)
- MUI 暗色/亮色主题系统
- Agent Loop ReAct 状态机引擎
- DeepSeek / Agnes AI / Ollama Provider 适配器
- MCP 协议集成
- 系统托盘 + 全局快捷键
- Tailwind CSS v4 + Tailwind Merge
- 修复: Sidebar 缺失 TextField 导入导致黑屏
This commit is contained in:
thzxx
2026-06-27 21:33:27 +08:00
commit 1d185db6b3
109 changed files with 39155 additions and 0 deletions
+80
View File
@@ -0,0 +1,80 @@
# 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