docs: 更新 README 和 docs 中数据库描述为 sql.js (WASM)

This commit is contained in:
thzxx
2026-04-17 16:29:48 +08:00
parent 16266ebdde
commit 1b66ee5f19
4 changed files with 11 additions and 10 deletions
+4 -4
View File
@@ -89,7 +89,7 @@ AI 自动从对话中学习并记住关键信息,跨会话持续积累:
- 设置中一键开关 - 设置中一键开关
### 📦 数据 ### 📦 数据
- SQLite (better-sqlite3) 持久化,WAL 模式高性能 - SQLite (sql.js WASM) 持久化,WAL 模式高性能
- 6 张表:sessions、messages、tool_calls、memories、settings、traces - 6 张表:sessions、messages、tool_calls、memories、settings、traces
- 导出格式:Markdown / HTML / TXT / JSON(全量备份/恢复) - 导出格式:Markdown / HTML / TXT / JSON(全量备份/恢复)
- 所有导入/导出均使用 Electron 原生文件对话框 - 所有导入/导出均使用 Electron 原生文件对话框
@@ -163,7 +163,7 @@ v4.0 四大子系统协调运作:
│ │ main.ts menu.ts tray.ts ipc.ts preload.ts │ │ │ │ main.ts menu.ts tray.ts ipc.ts preload.ts │ │
│ │ tool-handlers.ts (25 工具) tool-security.ts workspace.ts│ │ │ │ │ tool-handlers.ts (25 工具) tool-security.ts workspace.ts│ │ │
│ │ ┌──────────────────────────────────────────────────────┐ │ │ │ │ ┌──────────────────────────────────────────────────────┐ │ │
│ │ │ db/sqlite.ts: better-sqlite3 · WAL · FTS5 │ │ │ │ │ │ db/sqlite.ts: sql.js (WASM) · WAL · FTS5 │ │ │
│ │ │ workspace.ts: spawn 进程管理 · 流式输出 · 安全检查 │ │ │ │ │ │ workspace.ts: spawn 进程管理 · 流式输出 · 安全检查 │ │ │
│ │ └──────────────────────────────────────────────────────┘ │ │ │ │ └──────────────────────────────────────────────────────┘ │ │
│ └────────────────────────────────────────────────────────────┘ │ │ └────────────────────────────────────────────────────────────┘ │
@@ -250,7 +250,7 @@ metona-ollama-desktop/
│ │ ├── tool-security.ts # 🔧 路径/命令安全检查 │ │ ├── tool-security.ts # 🔧 路径/命令安全检查
│ │ ├── workspace.ts # 🖥️ spawn 进程管理、流式输出 │ │ ├── workspace.ts # 🖥️ spawn 进程管理、流式输出
│ │ └── db/ │ │ └── db/
│ │ └── sqlite.ts # 📦 SQLite 数据库(better-sqlite3, WAL, FTS5 │ │ └── sqlite.ts # 📦 SQLite 数据库(sql.js WASM, WAL, FTS5
│ └── renderer/ # 渲染进程 │ └── renderer/ # 渲染进程
│ ├── index.html # 入口 HTML │ ├── index.html # 入口 HTML
│ ├── main.ts # 入口(全系统初始化) │ ├── main.ts # 入口(全系统初始化)
@@ -335,7 +335,7 @@ metona-ollama-desktop/
- **TypeScript 5.7** — 严格类型,完整接口定义 - **TypeScript 5.7** — 严格类型,完整接口定义
- **Electron 33** — 桌面封装(Windows x64 - **Electron 33** — 桌面封装(Windows x64
- **Vite 5** — 渲染进程构建、HMR 热更新 - **Vite 5** — 渲染进程构建、HMR 热更新
- **better-sqlite3 12.9** — SQLite 数据库(主进程,WAL 模式 - **sql.js 1.11** — SQLite WASM 实现(零原生依赖,无需编译
- **Fetch + ReadableStream** — 流式 NDJSON 解析 - **Fetch + ReadableStream** — 流式 NDJSON 解析
- **CSS Variables** — 暖色调亮色主题 - **CSS Variables** — 暖色调亮色主题
- **electron-builder** — NSIS 安装包 - **electron-builder** — NSIS 安装包
+1 -1
View File
@@ -178,7 +178,7 @@ electron-builder 会自动处理所有依赖下载(Electron、NSIS、winCodeSi
### v4.0.02026-04-17 — metona-ollama-desktop 仓库 ### v4.0.02026-04-17 — metona-ollama-desktop 仓库
- 📦 SQLite (better-sqlite3) 替代 IndexedDB6 张表 + FTS5 全文搜索 - 📦 SQLite (sql.js WASM) 替代 IndexedDB6 张表 + FTS5 全文搜索(零原生依赖)
- 🔧 Agent Loop 升级为 ReAct 模式(15 轮,10 分钟超时,执行轨迹记录) - 🔧 Agent Loop 升级为 ReAct 模式(15 轮,10 分钟超时,执行轨迹记录)
- 🧠 新增 4 个记忆/会话管理工具(memory_search, memory_add, session_list, session_read - 🧠 新增 4 个记忆/会话管理工具(memory_search, memory_add, session_list, session_read
- 🎨 UI 主题改版:暗色 Fluent → 暖色调亮色(奶白 + 珊瑚橙) - 🎨 UI 主题改版:暗色 Fluent → 暖色调亮色(奶白 + 珊瑚橙)
+3 -2
View File
@@ -13,8 +13,9 @@
### Desktop v4.0.0 — SQLite & ReAct Agent & 全新主题 ### Desktop v4.0.0 — SQLite & ReAct Agent & 全新主题
- 📦 **数据库迁移:IndexedDB → SQLite (better-sqlite3)** - 📦 **数据库迁移:IndexedDB → SQLite (sql.js WASM)**
- 新增 `src/main/db/sqlite.ts`,使用 better-sqlite3 替代 IndexedDB - 新增 `src/main/db/sqlite.ts`,使用 sql.js (WASM) 替代 IndexedDB
- 零原生依赖,无需 electron-rebuild,消除 ABI 版本不匹配问题
- 6 张表:sessions、messages、tool_calls、memoriesFTS5 全文搜索)、settings、traces - 6 张表:sessions、messages、tool_calls、memoriesFTS5 全文搜索)、settings、traces
- WAL 模式 + NORMAL 同步,性能显著提升 - WAL 模式 + NORMAL 同步,性能显著提升
- 支持全量导出/导入(JSON 格式) - 支持全量导出/导入(JSON 格式)
+3 -3
View File
@@ -6,7 +6,7 @@
## 一、项目概述 ## 一、项目概述
Metona Ollama Desktop 是基于 TypeScript + Electron 的本地 Ollama AI 桌面客户端,面向 Windows 平台。项目采用零外部依赖策略(仅 better-sqlite3 为运行时依赖),所有核心功能(Markdown 解析、SHA-256、HTML 净化器等)均内联实现。 Metona Ollama Desktop 是基于 TypeScript + Electron 的本地 Ollama AI 桌面客户端,面向 Windows 平台。项目采用零外部依赖策略(仅 sql.js 为运行时依赖),所有核心功能(Markdown 解析、SHA-256、HTML 净化器等)均内联实现。
--- ---
@@ -17,7 +17,7 @@ Metona Ollama Desktop 是基于 TypeScript + Electron 的本地 Ollama AI 桌面
| 语言 | TypeScript | ≥5.7,严格模式 (`strict: true`) | | 语言 | TypeScript | ≥5.7,严格模式 (`strict: true`) |
| 桌面框架 | Electron | ≥33 | | 桌面框架 | Electron | ≥33 |
| 构建工具 | Vite (渲染进程) + tsc (主进程) | Vite ≥5 | | 构建工具 | Vite (渲染进程) + tsc (主进程) | Vite ≥5 |
| 数据存储 | better-sqlite3 | ≥12.9WAL 模式,FTS5 全文搜索 | | 数据存储 | sql.js (WASM) | ≥1.11WAL 模式,FTS5 全文搜索,零原生依赖 |
| 打包 | electron-builder | NSIS 格式 | | 打包 | electron-builder | NSIS 格式 |
--- ---
@@ -289,7 +289,7 @@ perf: 性能优化
## 九、注意事项 ## 九、注意事项
1. **零外部依赖**:新增功能优先使用内联实现,避免引入 npm 包(better-sqlite3 除外) 1. **零外部依赖**:新增功能优先使用内联实现,避免引入 npm 包(sql.js 除外)
2. **安全优先**:所有文件/命令操作必须经过安全检查层 2. **安全优先**:所有文件/命令操作必须经过安全检查层
3. **日志完整**:关键操作必须记录到执行日志面板 3. **日志完整**:关键操作必须记录到执行日志面板
4. **无超时设计**:工作空间相关操作不设超时,由用户控制生命周期 4. **无超时设计**:工作空间相关操作不设超时,由用户控制生命周期