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:
@@ -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
|
||||
Reference in New Issue
Block a user