79 lines
2.7 KiB
Markdown
79 lines
2.7 KiB
Markdown
# Metona Ollama Desktop
|
||
|
||
> 本地 Ollama AI 桌面客户端 — TypeScript + Electron
|
||
|
||
## 简介
|
||
|
||
Metona Ollama Desktop 是一个基于 Ollama 的本地 AI 桌面客户端，支持 Tool Calling、记忆系统、浏览器控制、MCP 协议等能力。数据不离开本机，零配置启动。
|
||
|
||
## 特性
|
||
|
||
- 🤖 ReAct Agent Loop（Thought → Action → Observation → Reflection）
|
||
- 🔧 38 个内置工具（文件系统/命令执行/联网搜索/浏览器/Git/记忆/技能/MCP）
|
||
- 🧠 智能记忆系统（FTS5 全文搜索 + 向量语义搜索 + 安全扫描）
|
||
- 🌐 MCP 协议支持（动态工具发现与执行）
|
||
- 🔍 三引擎联网搜索（Bing + 百度 + Google）
|
||
- 🖥️ 工作空间面板（终端 + 文件浏览器一体化）
|
||
- 🎨 暖色调 UI（长时间使用不疲劳）
|
||
|
||
## 技术栈
|
||
|
||
| 层级 | 技术 |
|
||
|------|------|
|
||
| 语言 | TypeScript (strict mode) |
|
||
| 桌面框架 | Electron 33+ |
|
||
| 构建 | Vite (渲染进程) + tsc (主进程) |
|
||
| 数据库 | sql.js (WASM) + FTS5 |
|
||
| 打包 | electron-builder (NSIS) |
|
||
|
||
## 快速开始
|
||
|
||
```bash
|
||
git clone https://gitee.com/thzxx/metona-ollama-desktop.git
|
||
cd metona-ollama-desktop
|
||
git checkout desktop-v1-stable-release
|
||
npm config set registry https://registry.npmmirror.com
|
||
npm install
|
||
npm start
|
||
```
|
||
|
||
## 构建 Windows 安装包
|
||
|
||
```bash
|
||
# 环境：Ubuntu 24.04 + Node.js v22 + Wine 9.0+
|
||
ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm run dist
|
||
```
|
||
|
||
产出：`release/Metona Ollama Setup 1.0.0.exe`
|
||
|
||
## 项目结构
|
||
|
||
```
|
||
src/
|
||
├── main/ # Electron 主进程
|
||
│ ├── main.ts # 入口、窗口管理
|
||
│ ├── preload.ts # contextBridge API
|
||
│ ├── ipc.ts # IPC 处理器
|
||
│ ├── browser.ts # 浏览器控制（8 个工具）
|
||
│ ├── mcp-manager.ts # MCP 协议管理
|
||
│ ├── tool-handlers*.ts # 工具执行（fs/system/git/shared）
|
||
│ ├── tool-security.ts # 安全检查
|
||
│ └── db/sqlite.ts # SQLite 数据库层
|
||
├── renderer/ # 渲染进程
|
||
│ ├── services/
|
||
│ │ ├── agent-engine.ts # ReAct Agent Loop 引擎
|
||
│ │ ├── tool-registry.ts # 工具注册与调度
|
||
│ │ ├── memory-manager.ts# 记忆管理
|
||
│ │ ├── vector-memory.ts # 向量记忆
|
||
│ │ ├── skill-manager.ts # 技能自动生成
|
||
│ │ └── mcp-client.ts # MCP 客户端
|
||
│ ├── components/ # UI 组件
|
||
│ ├── styles/style.css # 暖色调主题
|
||
│ └── index.html # 入口 HTML
|
||
└── vendor/ # 第三方库（marked, DOMPurify）
|
||
```
|
||
|
||
## 许可证
|
||
|
||
MIT
|