thzxx
1d185db6b3
- 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 导入导致黑屏
81 lines
2.2 KiB
Markdown
81 lines
2.2 KiB
Markdown
# 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
|