thzxx
0ec6e902de
- 添加 vite.config.ts 构建配置 - 添加 tsconfig.main.json（主进程单独编译） - 修复主进程模块化（menu/tray 使用 setQuitting） - 修复渲染进程导入路径 - 删除旧版 JS/Web 文件（js/、electron/、sw.js、manifest.json） - 构建验证通过：NSIS 安装包 + 便携版
🦙 Metona Ollama
基于原生 JavaScript 的 Ollama AI 聊天客户端。Web 版零依赖开箱即用，桌面版基于 Electron 封装，支持 Windows。
✨ 功能特性
💬 对话
- 流式对话 — ReadableStream 实时打字效果，支持强制停止
- 多模型支持 — 自动加载 Ollama 已安装模型，一键切换
- Think 推理 — 展开/收起的深度思考过程（需模型支持）
- 多模态 — 图片上传，自动检测 Vision 模型能力
- 文件分析 — 支持 50+ 种文本/代码格式，单文件 ≤500KB
🧠 RAG 知识库
- 文档上传 → 自动分块 → 向量化 → IndexedDB 持久化
- 语义检索增强问答，支持多集合管理
- 需嵌入模型（如
nomic-embed-text）
🤖 Agent 预设
- 内置 6 个预设：💬 默认、🌐 翻译官、🔍 代码审查、✍️ 写作助手、📊 数据分析师、🎓 学习导师
- 一键切换系统提示词 + 温度 + 上下文长度 + Think 开关
- 支持自定义创建/编辑/删除
📦 数据
- 历史记录 IndexedDB 持久化，支持搜索、分页
- 导出格式：Markdown / HTML / TXT / JSON / .metona 加密备份
- .metona 格式支持 AES-256-GCM 加密（HTTPS）或 XOR 混淆（HTTP）
🖥️ 桌面版
基于 Electron 封装，Windows 专用，在 Web 版全部功能基础上增加原生特性。
| 特性 | 说明 |
|---|---|
| Fluent Design 主题 | Windows 11 暗色风格，Mica 毛玻璃材质 |
| 系统托盘 | 最小化到托盘，双击恢复，右键菜单 |
| 原生菜单 | 文件 / 编辑 / 视图 / 窗口 / 帮助完整菜单 |
| 原生文件对话框 | Windows 文件选择器替代浏览器 input |
| 系统通知 | Windows 原生通知中心推送 |
| 窗口管理 | 记忆窗口大小位置，支持置顶 |
| 单实例锁 | 防止重复启动 |
| 无 CORS 限制 | 直连本地 Ollama，无需配置 OLLAMA_ORIGINS |
下载
从 Releases 页面下载：
| 文件 | 类型 |
|---|---|
Metona Ollama Setup 1.1.0.exe |
NSIS 安装包（可选目录、创建快捷方式） |
MetonaOllama-Portable-1.1.0.exe |
绿色便携版（免安装，双击即用） |
⚠️ 未签名版本，首次运行 Windows 可能弹出安全警告，点击「仍要运行」即可。
从源码构建桌面版
git clone https://gitee.com/thzxx/metona-ollama.git
cd metona-ollama
git checkout metona-ollama-desktop-v1.1
npm config set registry https://registry.npmmirror.com
npm install
npm start # 开发运行
ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ npm run dist # 构建 Windows 安装包
💡 国内环境需使用 npmmirror 加速，详见 BUILD.md。
🌐 Web 版
零构建步骤，纯 HTML + ES Modules，任何 HTTP 服务器即可托管。
git clone https://gitee.com/thzxx/metona-ollama.git
cd metona-ollama
# 方式一：直接浏览器打开
open index.html
# 方式二：HTTP 服务器
python3 -m http.server 8080
# 访问 http://localhost:8080
跨域配置（Web 版需要）：
OLLAMA_ORIGINS="*" ollama serve
PWA 离线使用
Web 版内置 Service Worker，可安装到桌面离线使用（桌面版无需此功能）。
🔌 Ollama API 接口
| 接口 | 用途 | 调用位置 |
|---|---|---|
GET /api/tags |
已安装模型列表 | 模型选择栏 |
GET /api/ps |
运行中模型 | 设置面板 |
GET /api/version |
Ollama 版本 | 连接检测 |
POST /api/show |
模型详情（能力检测） | Think/Vision 检测 |
POST /api/chat |
流式聊天（核心） | 消息发送 |
POST /api/embed |
生成嵌入向量 | RAG 知识库 |
📁 项目结构
metona-ollama/
├── index.html # 入口页面
├── electron/ # 桌面版（Electron）
│ ├── main.js # 主进程：窗口、托盘、菜单、IPC
│ ├── preload.js # Preload：contextBridge 安全暴露
│ ├── desktop-bridge.js # 渲染进程桥接 + Web 降级
│ └── desktop-integration.js # 菜单响应、原生文件对话框
├── js/
│ ├── app.js # 主入口
│ ├── ollama-api.js # Ollama REST API 封装
│ ├── chat-db.js # IndexedDB 持久化
│ ├── state.js # 响应式状态管理
│ ├── rag.js # RAG 检索增强生成
│ ├── vector-store.js # 向量存储 + 相似度搜索
│ ├── document-processor.js # 文档分块
│ ├── preset-manager.js # Agent 预设管理
│ ├── crypto.js # 会话加密（AES-256-GCM / XOR）
│ └── components/ # UI 组件
│ ├── chat-area.js # 消息渲染、流式更新
│ ├── input-area.js # 输入、文件上传
│ ├── settings-modal.js # 设置面板
│ ├── history-modal.js # 历史记录
│ ├── kb-modal.js # 知识库管理
│ └── ...
├── css/style.css # 全局样式（暗色主题）
├── assets/icons/ # 图标资源
├── package.json # Electron + electron-builder 配置
├── sw.js # Service Worker（PWA）
└── manifest.json # PWA 清单
⚙️ 设置
| 设置 | 默认值 | API 参数 |
|---|---|---|
| Ollama 服务地址 | http://127.0.0.1:11434 |
— |
| 系统提示词 | 关闭 | system |
| 上下文长度 | 24576 tokens | options.num_ctx |
| 温度 | 0.7 | options.temperature |
| Think 模式 | 关闭 | think |
🛠️ 技术栈
- 纯原生 JavaScript (ES Modules) — 零构建步骤
- Electron 33 — 桌面封装（Windows）
- IndexedDB — 异步持久化
- Fetch + ReadableStream — 流式 NDJSON 解析
- CSS Variables — 暗色主题，毛玻璃效果
- electron-builder — NSIS + Portable 打包
🔒 安全
- 内置 HTML 净化器（白名单标签 + 属性过滤 + URI 协议检查）
- Markdown 链接仅允许
http:/https:/mailto:/tel: - 阻止
javascript:/vbscript:/data:协议注入 - 桌面版：contextIsolation + IPC 白名单 + 单实例锁
📋 更新日志
v1.1.0
- 🎨 UI 重构为 Windows 11 Fluent Design 暗色主题（Mica 材质、Segoe UI Variable）
- 📐 知识库/历史记录弹框加宽
- ✨ Think 按钮开启后添加蓝色光效，hover 时增强
- 🖱️ 图片上传禁用态添加 hover 标识（微红背景 + 禁止光标）
- 🚫 彻底隐藏窗口菜单栏
v1.0.0
- 🖥️ Electron Windows 桌面客户端首版
- 📦 NSIS 安装包 + 绿色便携版
- 📋 系统托盘、原生菜单、原生文件对话框
- 🔔 系统通知、窗口管理、单实例锁
📄 License
MIT