metona-ollama-desktop/DESKTOP_README.md

Metona Ollama Desktop v1.0

基于 Metona Ollama Web 版封装的 Electron Windows 桌面客户端。

✨ 桌面版特性

特性	说明
原生安装包	NSIS 安装程序 + 绿色便携版
系统托盘	最小化到托盘，双击恢复，托盘右键菜单
原生菜单	完整的文件/编辑/视图/窗口/帮助菜单
原生文件对话框	Windows 文件选择器替代浏览器 input
系统通知	通过 Windows 原生通知中心推送
窗口管理	记忆窗口大小和位置，支持置顶
单实例锁	防止重复启动
无 CORS 限制	关闭 webSecurity，直接连接本地 Ollama

🚀 开发

前置条件

• Node.js 18+
• npm

启动开发环境

# 安装依赖
npm install

# 启动开发模式
npm start

构建

# 构建目录（不打包，用于测试）
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 代码零修改