Metona Desktop
63fa7e2846
- 新增 electron/main.js: 主进程（窗口管理、系统托盘、原生菜单、IPC） - 新增 electron/preload.js: contextBridge 安全 API 暴露 - 新增 electron/desktop-bridge.js: 渲染进程桥接层 + Web 降级 - 新增 electron/desktop-integration.js: 菜单/托盘事件响应、原生文件对话框 - 更新 index.html: 集成桌面脚本 - 新增 package.json: Electron + electron-builder 配置 - 新增 DESKTOP_README.md: 桌面版开发文档 - 支持: NSIS 安装包 + 便携版、系统托盘、原生菜单、窗口记忆 - 安全: contextIsolation + IPC 白名单、单实例锁
120 lines
5.5 KiB
Markdown
120 lines
5.5 KiB
Markdown
# Metona Ollama Desktop v1.0
|
|
|
|
基于 [Metona Ollama](https://gitee.com/thzxx/metona-ollama) Web 版封装的 **Electron Windows 桌面客户端**。
|
|
|
|
## ✨ 桌面版特性
|
|
|
|
| 特性 | 说明 |
|
|
|------|------|
|
|
| 原生安装包 | NSIS 安装程序 + 绿色便携版 |
|
|
| 系统托盘 | 最小化到托盘，双击恢复，托盘右键菜单 |
|
|
| 原生菜单 | 完整的文件/编辑/视图/窗口/帮助菜单 |
|
|
| 原生文件对话框 | Windows 文件选择器替代浏览器 input |
|
|
| 系统通知 | 通过 Windows 原生通知中心推送 |
|
|
| 窗口管理 | 记忆窗口大小和位置，支持置顶 |
|
|
| 单实例锁 | 防止重复启动 |
|
|
| 无 CORS 限制 | 关闭 webSecurity，直接连接本地 Ollama |
|
|
|
|
## 🚀 开发
|
|
|
|
### 前置条件
|
|
|
|
- Node.js 18+
|
|
- npm
|
|
|
|
### 启动开发环境
|
|
|
|
```bash
|
|
# 安装依赖
|
|
npm install
|
|
|
|
# 启动开发模式
|
|
npm start
|
|
```
|
|
|
|
### 构建
|
|
|
|
```bash
|
|
# 构建目录（不打包，用于测试）
|
|
npm run pack
|
|
|
|
# 构建 Windows 安装包 (NSIS + Portable)
|
|
npm run dist
|
|
|
|
# 仅构建 NSIS 安装包
|
|
npm run dist:nsis
|
|
|
|
# 仅构建便携版
|
|
npm run dist:portable
|
|
```
|
|
|
|
构建产物在 `release/` 目录。
|
|
|
|
## 📁 Desktop 项目结构
|
|
|
|
```
|
|
metona-ollama/
|
|
├── electron/
|
|
│ ├── main.js # 主进程：窗口、菜单、托盘、IPC
|
|
│ ├── preload.js # 预加载：contextBridge 安全 API 暴露
|
|
│ ├── desktop-bridge.js # 渲染进程桥接：统一 API + 降级处理
|
|
│ └── desktop-integration.js # 桌面集成：菜单响应、原生文件选择、快捷键
|
|
├── index.html # 入口（已集成桌面脚本）
|
|
├── js/ # 原有 Web 应用代码（未修改）
|
|
├── css/ # 原有样式（未修改）
|
|
├── assets/ # 图标资源
|
|
├── package.json # Electron + electron-builder 配置
|
|
└── ...
|
|
```
|
|
|
|
## 🔌 架构设计
|
|
|
|
```
|
|
┌──────────────────────────────────────────────┐
|
|
│ Main Process │
|
|
│ ┌──────────┐ ┌──────────┐ ┌──────────────┐ │
|
|
│ │ Browser │ │ Tray │ │ Menu │ │
|
|
│ │ Window │ │ │ │ │ │
|
|
│ └────┬─────┘ └────┬─────┘ └──────┬───────┘ │
|
|
│ │ │ │ │
|
|
│ ┌────┴─────────────┴──────────────┴───────┐ │
|
|
│ │ IPC Main │ │
|
|
│ └────────────────┬────────────────────────┘ │
|
|
└───────────────────┼──────────────────────────┘
|
|
│ contextBridge
|
|
┌───────────────────┼──────────────────────────┐
|
|
│ Renderer │ │
|
|
│ ┌────────────────┴───────────────────────┐ │
|
|
│ │ window.metonaDesktop (preload.js) │ │
|
|
│ └────────────────┬───────────────────────┘ │
|
|
│ ┌────────────────┴───────────────────────┐ │
|
|
│ │ window.__metonaBridge (bridge.js) │ │
|
|
│ │ 统一接口 + 降级 (Web环境可用) │ │
|
|
│ └────────────────┬───────────────────────┘ │
|
|
│ ┌────────────────┴───────────────────────┐ │
|
|
│ │ desktop-integration.js │ │
|
|
│ │ 菜单响应 · 原生文件 · 快捷键 │ │
|
|
│ └────────────────┬───────────────────────┘ │
|
|
│ ┌────────────────┴───────────────────────┐ │
|
|
│ │ 原有 Web 应用 (app.js + components) │ │
|
|
│ │ 零修改，完全复用 │ │
|
|
│ └────────────────────────────────────────┘ │
|
|
└──────────────────────────────────────────────┘
|
|
```
|
|
|
|
## 🔒 安全策略
|
|
|
|
- `contextIsolation: true` — 渲染进程无 Node.js 访问
|
|
- `nodeIntegration: false` — 通过 preload 安全暴露 API
|
|
- `sandbox: false` — 允许文件系统访问（受 IPC 白名单控制）
|
|
- `webSecurity: false` — 仅用于连接本地 Ollama API
|
|
|
|
## 📝 与 Web 版的兼容性
|
|
|
|
桌面版完全兼容 Web 版代码，通过降级处理实现：
|
|
|
|
- `window.__metonaBridge.isDesktop` 判断当前环境
|
|
- Web 环境下所有 desktop API 自动降级为浏览器原生行为
|
|
- `index.html` 无条件加载桌面脚本，非 Electron 环境静默跳过
|
|
- 原有 JS/HTML/CSS 代码**零修改**
|