refactor: rewrite README.md with accurate feature list and clean layout
This commit is contained in:
thzxx
@@ -1,173 +1,155 @@
|
||||
<div align="center">
|
||||
|
||||
# 🦙 Metona Ollama Desktop
|
||||
|
||||
基于 TypeScript + Electron 的 [Ollama](https://ollama.com) 桌面 AI Agent 客户端，专为 Windows 打造。
|
||||
**基于 TypeScript + Electron 的本地 Ollama AI 桌面客户端**
|
||||
|
||||
> 💡 全离线运行，数据本地存储，零外部依赖
|
||||
全离线运行 · 数据本地存储 · 零外部依赖
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
[](https://gitee.com/thzxx/metona-ollama-desktop/releases)
|
||||
[](https://gitee.com/thzxx/metona-ollama-desktop/releases)
|
||||
[](https://www.typescriptlang.org/)
|
||||
[](https://www.electronjs.org/)
|
||||
[](https://vitejs.dev/)
|
||||
[](LICENSE)
|
||||
|
||||
</div>
|
||||
|
||||
---
|
||||
|
||||
## ✨ 功能特性
|
||||
|
||||
### 💬 对话
|
||||
- **流式对话** — ReadableStream 实时打字效果，支持强制停止
|
||||
- **多模型支持** — 自动加载 Ollama 已安装模型，一键切换
|
||||
- **Think 推理** — 展开/收起的深度思考过程（需模型支持）
|
||||
- **多模态** — 图片上传，自动检测 Vision 模型能力
|
||||
- **文件分析** — 支持 50+ 种文本/代码格式，单文件 ≤500KB
|
||||
### 💬 智能对话
|
||||
|
||||
### 🔧 Tool Calling — 34 个内置工具 + MCP 动态工具
|
||||
|
||||
AI 在对话中主动调用本地工具完成任务，所有操作在用户可视化监督下执行：
|
||||
|
||||
| 工具 | 说明 |
|
||||
| 功能 | 说明 |
|
||||
|------|------|
|
||||
| 📄 `read_file` | 读取文件内容（≤1MB，支持行范围） |
|
||||
| ✏️ `write_file` | 写入文件（自动创建父目录） |
|
||||
| 📁 `list_directory` | 列出目录（支持递归、隐藏文件） |
|
||||
| 🔍 `search_files` | 按文件名/内容搜索（支持扩展名过滤） |
|
||||
| 📂 `create_directory` | 创建目录（递归创建） |
|
||||
| 🗑️ `delete_file` | 删除文件/目录 |
|
||||
| 💻 `run_command` | 执行 Shell 命令（无超时，自动/需确认/禁用） |
|
||||
| 📦 `move_file` | 移动/重命名文件或目录 |
|
||||
| 📋 `copy_file` | 复制文件或目录 |
|
||||
| 🌐 `web_fetch` | 抓取网页内容（HTTP/HTTPS） |
|
||||
| 🔍 `web_search` | 联网搜索（DuckDuckGo/Bing） |
|
||||
| ➕ `append_file` | 追加内容到文件末尾 |
|
||||
| ✂️ `edit_file` | 查找替换文件中的文本 |
|
||||
| ℹ️ `get_file_info` | 获取文件/目录详细信息 |
|
||||
| 🌳 `tree` | 以树形结构展示目录 |
|
||||
| ⬇️ `download_file` | 从 URL 下载文件到本地 |
|
||||
| 🔀 `diff_files` | 对比两个文件差异（unified diff） |
|
||||
| 🔄 `replace_in_files` | 按 glob 模式批量查找替换 |
|
||||
| 📚 `read_multiple_files` | 批量读取多个文件内容 |
|
||||
| 🔖 `git` | Git 操作（16 个子操作） |
|
||||
| 🗜️ `compress` | 创建/解压归档（zip/tar.gz） |
|
||||
| 🧠 `memory_search` | 搜索 Agent 记忆 |
|
||||
| 💾 `memory_add` | 添加新记忆条目 |
|
||||
| 📋 `session_list` | 列出历史会话 |
|
||||
| 📖 `session_read` | 读取历史会话内容 |
|
||||
| 🤖 `spawn_task` | 子代理委派（独立执行子任务） |
|
||||
| 🌐 `browser_open` | 打开 URL 加载网页 |
|
||||
| 📸 `browser_screenshot` | 浏览器截图 |
|
||||
| ⚡ `browser_evaluate` | 在浏览器中执行 JavaScript |
|
||||
| 📰 `browser_extract` | 提取页面文本和链接 |
|
||||
| 👆 `browser_click` | 点击页面元素 |
|
||||
| ⌨️ `browser_type` | 在输入框中输入文本 |
|
||||
| ↕️ `browser_scroll` | 滚动浏览器页面 |
|
||||
| ❌ `browser_close` | 关闭浏览器 |
|
||||
| 🔄 流式响应 | ReadableStream 实时打字效果，支持强制停止 |
|
||||
| 🧠 Think 推理 | 展开/收起深度思考过程（需模型支持） |
|
||||
| 🖼️ 多模态 | 图片上传，自动检测 Vision 模型能力 |
|
||||
| 📄 文件分析 | 50+ 种文本/代码格式，单文件 ≤500KB |
|
||||
| 🔀 多模型 | 自动加载 Ollama 已安装模型，一键切换 |
|
||||
|
||||
**MCP 工具**：通过 [Model Context Protocol](https://modelcontextprotocol.io) 连接外部工具服务，动态注册工具。在设置面板添加 MCP Server 即可。
|
||||
---
|
||||
|
||||
**Agent Loop（ReAct 模式）**：用户请求 → Thought → Action → Observation → Reflection → 循环直到 Final Answer。支持流式 + 并行调用 + 最大 15 轮保护 + 10 分钟总超时。自动检测并跳过重复工具调用。
|
||||
### 🔧 Tool Calling — 34 个内置工具
|
||||
|
||||
AI 在对话中**主动调用**本地工具完成任务，所有操作在用户可视化监督下执行。采用 **ReAct Agent Loop**（Thought → Action → Observation → Reflection），最大 15 轮，10 分钟超时。
|
||||
|
||||
> ⚠️ 需要模型支持 Tool Calling（推荐 Qwen3、Llama 3.1+、Mistral）
|
||||
|
||||
#### 📁 文件系统（12 个）
|
||||
|
||||
| 工具 | 说明 |
|
||||
|------|------|
|
||||
| `read_file` | 读取文件（≤1MB，支持行范围） |
|
||||
| `write_file` | 写入文件（自动创建父目录） |
|
||||
| `append_file` | 追加内容到文件末尾 |
|
||||
| `edit_file` | 查找替换文本 |
|
||||
| `list_directory` | 列出目录（支持递归、隐藏文件） |
|
||||
| `create_directory` | 递归创建目录 |
|
||||
| `delete_file` | 删除文件/目录 |
|
||||
| `move_file` | 移动/重命名 |
|
||||
| `copy_file` | 复制文件/目录 |
|
||||
| `search_files` | 按文件名/内容搜索 |
|
||||
| `get_file_info` | 获取文件详细信息 |
|
||||
| `tree` | 树形结构展示目录 |
|
||||
|
||||
#### 💻 系统 & 网络（9 个）
|
||||
|
||||
| 工具 | 说明 |
|
||||
|------|------|
|
||||
| `run_command` | 执行 Shell 命令（自动/需确认/禁用 三模式） |
|
||||
| `web_fetch` | 抓取网页内容（HTTP/HTTPS） |
|
||||
| `web_search` | 联网搜索（DuckDuckGo + Bing 双引擎） |
|
||||
| `download_file` | 从 URL 下载文件 |
|
||||
| `diff_files` | 对比文件差异（unified diff） |
|
||||
| `replace_in_files` | 批量查找替换（glob 模式） |
|
||||
| `read_multiple_files` | 批量读取多个文件 |
|
||||
| `git` | Git 操作（16 个子操作） |
|
||||
| `compress` | 创建/解压归档（zip/tar.gz） |
|
||||
|
||||
#### 🧠 记忆 & 会话（4 个）
|
||||
|
||||
| 工具 | 说明 |
|
||||
|------|------|
|
||||
| `memory_search` | 搜索 Agent 记忆 |
|
||||
| `memory_add` | 添加新记忆条目 |
|
||||
| `session_list` | 列出历史会话 |
|
||||
| `session_read` | 读取历史会话内容 |
|
||||
|
||||
#### 🤖 Agent & 浏览器（9 个）
|
||||
|
||||
| 工具 | 说明 |
|
||||
|------|------|
|
||||
| `spawn_task` | 子代理委派（独立执行子任务） |
|
||||
| `browser_open` | 打开 URL 加载网页 |
|
||||
| `browser_screenshot` | 浏览器截图 |
|
||||
| `browser_evaluate` | 执行 JavaScript |
|
||||
| `browser_extract` | 提取页面文本和链接 |
|
||||
| `browser_click` | 点击页面元素 |
|
||||
| `browser_type` | 在输入框输入文本 |
|
||||
| `browser_scroll` | 滚动页面 |
|
||||
| `browser_close` | 关闭浏览器 |
|
||||
|
||||
> 📌 **MCP 工具**：通过 [Model Context Protocol](https://modelcontextprotocol.io) 连接外部工具服务，动态注册。在设置面板添加 MCP Server 即可使用，工具命名格式 `mcp_{server}_{tool}`。
|
||||
|
||||
---
|
||||
|
||||
### 🔌 MCP (Model Context Protocol)
|
||||
- 通过 JSON-RPC 2.0 over stdio 与外部工具服务通信
|
||||
- 支持 `initialize` 握手、`tools/list` 工具发现、`tools/call` 工具执行
|
||||
- 30 秒超时保护，优雅清理（pending 请求 + SIGTERM）
|
||||
- 工具自动注入 Agent Loop，命名格式 `mcp_{server}_{tool}`
|
||||
|
||||
通过 JSON-RPC 2.0 over stdio 与外部工具服务通信：
|
||||
|
||||
```
|
||||
启动 MCP Server → initialize 握手 → tools/list 发现 → tools/call 执行
|
||||
```
|
||||
|
||||
- 7 个 IPC 通道：`startServer` / `stopServer` / `stopAll` / `callTool` / `getTools` / `getStatuses` / `refreshTools`
|
||||
- 30 秒超时保护，退出时优雅清理（pending 请求 + SIGTERM）
|
||||
- 设置面板管理：添加 / 启用 / 禁用 / 删除服务器
|
||||
|
||||
---
|
||||
|
||||
### 🧠 Agent 记忆系统
|
||||
|
||||
AI 自动从对话中学习并记住关键信息，跨会话持续积累：
|
||||
|
||||
| 类型 | 说明 | 检索方式 |
|
||||
| 类型 | 说明 | 注入策略 |
|
||||
|------|------|----------|
|
||||
| 📌 事实 | 关于用户的事实 | 关键词 + 向量语义 |
|
||||
| ⚙️ 偏好 | 用户的偏好习惯 | 始终注入 |
|
||||
| 📏 规则 | 应遵守的规则 | 始终注入 |
|
||||
| 📏 规则 | 应遵守的规则 | 始终注入（无条件执行） |
|
||||
| ⚙️ 偏好 | 用户偏好习惯 | 始终注入（建议遵循） |
|
||||
| 📌 事实 | 关于用户的事实 | 关键词 + 向量语义检索 |
|
||||
|
||||
**特性**：
|
||||
- 对话 ≥6 条消息后自动触发提取
|
||||
- FTS5 全文搜索 + 向量语义搜索
|
||||
- SQLite 持久化，跨会话保留
|
||||
- 可视化管理面板（搜索、筛选、编辑、删除）
|
||||
- 对话 ≥6 条消息后自动触发提取
|
||||
- SQLite 持久化，可视化管理面板
|
||||
|
||||
### 🧠 技能自动生成
|
||||
- 自动从成功工具调用链提取可复用技能
|
||||
- `skills` 表持久化，支持关键词搜索和使用统计
|
||||
- 下次同类任务自动匹配并注入技能上下文
|
||||
---
|
||||
|
||||
### 👤 用户画像
|
||||
- 从对话中自动检测用户技术栈（Python/TypeScript/Go/React 等）
|
||||
- 用户画像注入 system prompt，Agent 行为更贴合用户习惯
|
||||
### 🖥️ 工作空间
|
||||
|
||||
### 🎭 人格模式
|
||||
- 多种预设人格模板，独立 system prompt + 温度设置
|
||||
- 快速切换，适配不同任务场景
|
||||
右侧常驻面板（480px），集成**终端**和**文件浏览器**：
|
||||
|
||||
### 🖥️ 工作空间 — 终端 & 文件浏览器
|
||||
右侧常驻面板（480px），提供终端命令行和文件浏览器：
|
||||
- **终端**：实时流式输出，支持 ANSI 颜色，无超时限制
|
||||
- **文件浏览器**：目录树展示，点击文件预览内容（带行号）
|
||||
- AI 工具命令自动在工作空间终端执行，用户可随时停止
|
||||
|
||||
**终端**：
|
||||
- 实时流式显示命令输出（支持 ANSI 颜色）
|
||||
- 支持长时间运行命令，**无超时限制**
|
||||
- 单一终端进程，可随时停止
|
||||
---
|
||||
|
||||
**文件浏览器**：
|
||||
- 浏览工作空间目录，目录树展示
|
||||
- 点击文件预览内容（带行号）
|
||||
### 🎭 更多功能
|
||||
|
||||
### ⏰ 定时任务 (Cron)
|
||||
- 支持一次性/周期性定时任务
|
||||
- 任务触发时自动填入聊天输入框
|
||||
|
||||
### 📦 数据
|
||||
- SQLite (sql.js WASM) 持久化，WAL 模式高性能
|
||||
- 7 张表：sessions、messages、tool_calls、memories（FTS5）、settings、traces、skills
|
||||
- 导出格式：Markdown / HTML / TXT / JSON（全量备份/恢复）
|
||||
- 所有导入/导出均使用 Electron 原生文件对话框
|
||||
|
||||
### 🖥️ 桌面原生
|
||||
- 暖色调亮色主题（奶白背景 + 珊瑚橙主色）
|
||||
- 执行日志面板（左侧，实时显示运行日志）
|
||||
- 工作空间面板（右侧，终端 + 文件浏览器，固定 480px）
|
||||
- Token 消耗统计（Header 实时显示）
|
||||
- 系统托盘 / 原生菜单 / 原生文件对话框
|
||||
- 单实例锁 / 无 CORS 限制
|
||||
| 功能 | 说明 |
|
||||
|------|------|
|
||||
| 🧠 技能自动生成 | 从成功工具调用链提取可复用技能，自动匹配复用 |
|
||||
| 👤 用户画像 | 自动检测技术栈（14 种），注入 system prompt |
|
||||
| 🎭 人格模式 | 多种预设模板，独立 system prompt + 温度设置 |
|
||||
| 💓 Heartbeat | 后台主动检查 Ollama 连接状态、磁盘空间等 |
|
||||
| ⏰ Cron 定时任务 | 一次性 / 周期性任务调度 |
|
||||
| 📦 数据导出 | Markdown / HTML / TXT / JSON 全量备份与恢复 |
|
||||
|
||||
---
|
||||
|
||||
## 🏗️ 架构
|
||||
|
||||
v5.0 五大子系统协调运作：
|
||||
|
||||
```
|
||||
用户输入消息
|
||||
│
|
||||
├─→ ① Agent 记忆检索（关键词 + 向量语义） → 注入 system prompt
|
||||
├─→ ② ReAct Agent Loop → Thought → Action → Observation → Reflection
|
||||
│ │
|
||||
│ ├─→ 内置工具（34 个） → 主进程 tool-handlers
|
||||
│ └─→ MCP 工具 → 主进程 mcp-manager → JSON-RPC → MCP Server
|
||||
│
|
||||
▼
|
||||
Ollama API（携带组合后的 system prompt + tools）
|
||||
│
|
||||
▼
|
||||
流式响应 → 渲染到聊天区域（含工具调用卡片）
|
||||
│
|
||||
▼
|
||||
保存会话 → SQLite → 自动提取记忆 / 技能
|
||||
|
||||
③ 工作空间（独立通道）
|
||||
AI 建议命令 → 用户确认 → spawn 子进程 → IPC 流式推送 → 终端面板
|
||||
|
||||
④ MCP（独立通道）
|
||||
启动时 spawn MCP Server → initialize 握手 → tools/list → 动态注册
|
||||
|
||||
⑤ 数据层（SQLite）
|
||||
sessions · messages · tool_calls · memories(FTS5) · settings · traces · skills
|
||||
```
|
||||
|
||||
```
|
||||
┌──────────────────────────────────────────────────────────────────┐
|
||||
│ Electron 应用 │
|
||||
@@ -184,61 +166,35 @@ v5.0 五大子系统协调运作：
|
||||
│ │ 主进程 (Main) ││
|
||||
│ │ main.ts · ipc.ts · preload.ts · menu.ts · tray.ts ││
|
||||
│ │ tool-handlers.ts (25 工具) · tool-security.ts ││
|
||||
│ │ workspace.ts · browser.ts · mcp-manager.ts ││
|
||||
│ │ workspace.ts · browser.ts (8 工具) · mcp-manager.ts ││
|
||||
│ │ db/sqlite.ts (sql.js WASM · WAL · FTS5) ││
|
||||
│ └──────────────────────────────────────────────────────────────┘│
|
||||
└──────────────────────────────────────────────────────────────────┘
|
||||
```
|
||||
|
||||
---
|
||||
### Agent Loop (ReAct)
|
||||
|
||||
## 📥 下载
|
||||
|
||||
从 [Releases](https://gitee.com/thzxx/metona-ollama-desktop/releases) 页面下载：
|
||||
|
||||
| 文件 | 类型 |
|
||||
|------|------|
|
||||
| `Metona Ollama Setup 5.0.0.exe` | NSIS 安装包（可选目录、创建快捷方式） |
|
||||
|
||||
> ⚠️ 未签名版本，首次运行 Windows 可能弹出安全警告，点击「仍要运行」即可。
|
||||
|
||||
---
|
||||
|
||||
## 🔨 从源码构建
|
||||
|
||||
### 环境要求
|
||||
|
||||
- Node.js v22+
|
||||
- Windows 或 Linux（交叉编译需 Wine 9.0+）
|
||||
|
||||
### 构建步骤
|
||||
|
||||
```bash
|
||||
git clone https://gitee.com/thzxx/metona-ollama-desktop.git
|
||||
cd metona-ollama-desktop
|
||||
git checkout metona-ollama-desktop-v5.0.0
|
||||
|
||||
npm config set registry https://registry.npmmirror.com
|
||||
npm install
|
||||
|
||||
# 构建并运行
|
||||
npm start
|
||||
|
||||
# 构建 Windows 安装包
|
||||
ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm run dist
|
||||
```
|
||||
用户消息 → 注入记忆/技能上下文
|
||||
↓
|
||||
┌─ Thought → Action(tool_calls) → Observation(result) → Reflection ─┐
|
||||
│ 循环（最大 15 轮，10 分钟超时） │
|
||||
└───────────────────────────────────────────────────────────────────┘
|
||||
↓
|
||||
流式响应 → 渲染到聊天区域（含工具调用卡片）→ 保存 → 自动提取记忆/技能
|
||||
```
|
||||
|
||||
> 💡 详细构建指南见 [docs/BUILD.md](docs/BUILD.md)
|
||||
### 数据库（7 张表）
|
||||
|
||||
### 常用命令
|
||||
|
||||
```bash
|
||||
npm run build:renderer # 仅构建渲染进程（Vite）
|
||||
npm run build:main # 仅构建主进程（tsc）
|
||||
npm run build # 构建全部
|
||||
npm start # 构建并运行
|
||||
npm run dist # 构建 Windows 安装包（NSIS）
|
||||
```
|
||||
| 表 | 用途 |
|
||||
|---|---|
|
||||
| `sessions` | 会话（parent_id 父子关系） |
|
||||
| `messages` | 消息（外键级联，thinking/tool_calls） |
|
||||
| `tool_calls` | 工具调用记录 |
|
||||
| `memories` | Agent 记忆（FTS5 全文搜索） |
|
||||
| `settings` | 设置（JSON 序列化） |
|
||||
| `traces` | ReAct 执行轨迹 |
|
||||
| `skills` | 自动生成的可复用技能 |
|
||||
|
||||
---
|
||||
|
||||
@@ -254,39 +210,46 @@ src/
|
||||
│ ├── tool-security.ts # 路径/命令安全检查
|
||||
│ ├── workspace.ts # 子进程管理、流式输出
|
||||
│ ├── browser.ts # 浏览器控制（8 工具）
|
||||
│ ├── mcp-manager.ts # MCP 协议通信（JSON-RPC 2.0）
|
||||
│ ├── menu.ts / tray.ts / utils.ts # 菜单/托盘/工具函数
|
||||
│ └── db/sqlite.ts # SQLite (sql.js WASM, WAL, FTS5)
|
||||
└── renderer/ # 渲染进程
|
||||
├── main.ts # 入口、全局初始化
|
||||
├── types.d.ts # 完整类型定义
|
||||
├── api/ollama.ts # Ollama REST API 客户端
|
||||
├── components/ # 14 个 UI 组件
|
||||
│ ├── chat-area.ts # 消息渲染、工具卡片
|
||||
│ ├── input-area.ts # 消息发送、文件上传
|
||||
│ ├── workspace-panel.ts # 工作空间（终端+文件）
|
||||
│ ├── settings-modal.ts # 设置面板（含 MCP/Cron 管理）
|
||||
│ ├── memory-modal.ts # 记忆管理
|
||||
│ ├── tool-confirm-modal.ts # 工具确认
|
||||
│ ├── tools-modal.ts / history-modal.ts / header.ts / ...
|
||||
│ └── toast.ts / lightbox.ts / prompt-modal.ts
|
||||
├── services/ # 核心服务
|
||||
│ ├── agent-engine.ts # ReAct Agent Loop 引擎
|
||||
│ ├── tool-registry.ts # 工具注册调度（含 MCP 路由）
|
||||
│ ├── memory-manager.ts # 记忆管理核心
|
||||
│ ├── vector-memory.ts # 向量索引
|
||||
│ ├── vector-store.ts # 向量存储
|
||||
│ ├── context-manager.ts # 上下文窗口管理
|
||||
│ ├── skill-manager.ts # 技能自动生成
|
||||
│ ├── sub-agent.ts # 子代理委派
|
||||
│ ├── cron-manager.ts # 定时任务
|
||||
│ ├── mcp-client.ts # MCP 渲染端客户端
|
||||
│ ├── log-service.ts # 结构化执行日志
|
||||
│ └── crypto.ts # AES-256-GCM 加密
|
||||
├── utils/ # 工具函数
|
||||
│ ├── utils.ts / sanitizer.ts / marked-config.ts
|
||||
├── state/state.ts # 响应式状态管理
|
||||
└── styles/style.css # 暖色调亮色主题
|
||||
│ ├── mcp-manager.ts # MCP 协议通信
|
||||
│ ├── menu.ts · tray.ts · utils.ts # 菜单/托盘/工具函数
|
||||
│ └── db/sqlite.ts # SQLite (sql.js WASM)
|
||||
│
|
||||
├── renderer/ # 渲染进程
|
||||
│ ├── main.ts # 入口、全局初始化
|
||||
│ ├── types.d.ts # 完整类型定义
|
||||
│ ├── index.html # 入口 HTML
|
||||
│ ├── api/
|
||||
│ │ └── ollama.ts # Ollama REST API 客户端
|
||||
│ ├── components/ # 14 个 UI 组件
|
||||
│ ├── services/
|
||||
│ │ ├── agent-engine.ts # ReAct Agent Loop 引擎
|
||||
│ │ ├── tool-registry.ts # 工具注册调度（含 MCP 路由）
|
||||
│ │ ├── memory-manager.ts # 记忆管理核心
|
||||
│ │ ├── vector-memory.ts # 向量索引
|
||||
│ │ ├── vector-store.ts # 向量存储
|
||||
│ │ ├── context-manager.ts # 上下文窗口管理
|
||||
│ │ ├── skill-manager.ts # 技能自动生成
|
||||
│ │ ├── sub-agent.ts # 子代理委派
|
||||
│ │ ├── cron-manager.ts # 定时任务
|
||||
│ │ ├── mcp-client.ts # MCP 渲染端客户端
|
||||
│ │ ├── log-service.ts # 结构化执行日志
|
||||
│ │ └── crypto.ts # AES-256-GCM 加密
|
||||
│ ├── utils/
|
||||
│ │ ├── utils.ts · sanitizer.ts · marked-config.ts
|
||||
│ ├── state/
|
||||
│ │ └── state.ts # 响应式状态管理
|
||||
│ └── styles/
|
||||
│ └── style.css # 暖色调亮色主题
|
||||
│
|
||||
├── assets/icons/ # 应用图标
|
||||
├── docs/ # 文档
|
||||
│ ├── BUILD.md # 构建指南
|
||||
│ ├── CHANGELOG.md # 更新日志
|
||||
│ ├── DEVELOPMENT.md # 开发规范
|
||||
│ └── OPENCLAW-HERMES-ANALYSIS.md # 改进路线图
|
||||
├── package.json
|
||||
├── vite.config.ts
|
||||
└── tsconfig.json · tsconfig.main.json
|
||||
```
|
||||
|
||||
---
|
||||
@@ -304,22 +267,94 @@ src/
|
||||
|
||||
---
|
||||
|
||||
## 🔒 安全
|
||||
## 🔒 安全模型
|
||||
|
||||
### Tool Calling 安全
|
||||
- **路径黑名单**：自动屏蔽 `/etc`, `/sys`, `/proc`, `~/.ssh`, `~/.gnupg` 等
|
||||
- **写操作白名单**：仅允许用户目录下的写入
|
||||
- **命令黑名单**：`rm -rf /`, `mkfs`, `dd`, `shutdown`, 反弹 shell 检测等
|
||||
- **run_command 三模式**：自动执行 / 需确认 / 禁用
|
||||
- **安全提示词注入**：自动向 system prompt 追加工具使用安全规则
|
||||
|
||||
所有文件/命令操作必须经过 `tool-security.ts` 安全检查层：
|
||||
|
||||
| 维度 | 措施 |
|
||||
|------|------|
|
||||
| 路径 | 黑名单屏蔽 `/etc`, `/sys`, `/proc`, `~/.ssh`, `~/.gnupg` 等 |
|
||||
| 写入 | 仅允许用户目录下的写操作 |
|
||||
| 命令 | 黑名单拦截 `rm -rf /`, `mkfs`, `dd`, `shutdown`, 反弹 shell 等 |
|
||||
| 模式 | `run_command` 支持自动执行 / 需用户确认 / 禁用三模式 |
|
||||
|
||||
### 应用安全
|
||||
|
||||
- 内置 HTML 净化器（白名单标签 + 属性过滤 + URI 协议检查）
|
||||
- contextIsolation + IPC 白名单 + 单实例锁
|
||||
- `contextIsolation: true` + IPC 白名单 + 单实例锁
|
||||
- SQLite 本地存储，不上传任何服务器
|
||||
|
||||
---
|
||||
|
||||
## 📥 下载
|
||||
|
||||
从 [Releases](https://gitee.com/thzxx/metona-ollama-desktop/releases) 页面下载最新安装包：
|
||||
|
||||
| 文件 | 类型 |
|
||||
|------|------|
|
||||
| `Metona Ollama Setup 5.0.0.exe` | NSIS 安装包（可选目录、创建快捷方式） |
|
||||
|
||||
> ⚠️ 未签名版本，首次运行 Windows 可能弹出安全警告，点击「仍要运行」即可。
|
||||
|
||||
---
|
||||
|
||||
## 🔨 从源码构建
|
||||
|
||||
### 环境要求
|
||||
|
||||
- Node.js v22+
|
||||
- Windows 或 Linux（交叉编译需 Wine 9.0+）
|
||||
|
||||
### 快速开始
|
||||
|
||||
```bash
|
||||
git clone https://gitee.com/thzxx/metona-ollama-desktop.git
|
||||
cd metona-ollama-desktop
|
||||
git checkout develop
|
||||
|
||||
npm config set registry https://registry.npmmirror.com
|
||||
npm install
|
||||
npm start
|
||||
```
|
||||
|
||||
### 构建 Windows 安装包
|
||||
|
||||
```bash
|
||||
bash restore-build-cache.sh # 恢复构建缓存（可选）
|
||||
ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm run dist
|
||||
```
|
||||
|
||||
### 常用命令
|
||||
|
||||
```bash
|
||||
npm run build:renderer # 仅构建渲染进程（Vite）
|
||||
npm run build:main # 仅构建主进程（tsc）
|
||||
npm run build # 构建全部
|
||||
npm start # 构建并运行
|
||||
npm run dist # 构建 Windows 安装包（NSIS）
|
||||
```
|
||||
|
||||
> 💡 详细构建指南见 [docs/BUILD.md](docs/BUILD.md)（含故障排查）
|
||||
|
||||
---
|
||||
|
||||
## 🎨 设计语言
|
||||
|
||||
| 元素 | 值 |
|
||||
|------|------|
|
||||
| 背景 | 奶白 `#FAF7F2` |
|
||||
| 主色 | 珊瑚橙 `#E8734A` |
|
||||
| Think | 紫色 `#9B7ED8` |
|
||||
| Token | 金色 `#D4A03C` |
|
||||
| 终端 | 暖棕深色 `#2D2016` |
|
||||
| 正文字体 | Inter |
|
||||
| 代码字体 | JetBrains Mono |
|
||||
| 圆角 | 控件 8px · 卡片 12px · 弹框 16-20px |
|
||||
|
||||
---
|
||||
|
||||
## 📋 更新日志
|
||||
|
||||
完整更新日志请查看 [docs/CHANGELOG.md](docs/CHANGELOG.md)。
|
||||
@@ -328,4 +363,4 @@ src/
|
||||
|
||||
## 📄 License
|
||||
|
||||
MIT
|
||||
[MIT](LICENSE)
|
||||
|
||||
Reference in New Issue
Block a user