diff --git a/README.md b/README.md
index d3e0ea0..c48d744 100644
--- a/README.md
+++ b/README.md
@@ -4,7 +4,7 @@
 
 > 💻 桌面版仓库 | 🌐 [Web 版历史存档](https://gitee.com/thzxx/metona-ollama-web)
 
-![版本](https://img.shields.io/badge/version-3.3.4--desktop-brightgreen)
+![版本](https://img.shields.io/badge/version-4.0.0--desktop-brightgreen)
 ![平台](https://img.shields.io/badge/platform-Windows%20x64-blue)
 ![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178c6)
 ![Electron](https://img.shields.io/badge/Electron-33-47848f)
@@ -202,7 +202,7 @@ v3.3 四大子系统协调运作：
 
 | 文件 | 类型 |
 |------|------|
-| `Metona Ollama Setup 3.3.4.exe` | NSIS 安装包（可选目录、创建快捷方式） |
+| `Metona Ollama Setup 4.0.0.exe` | NSIS 安装包（可选目录、创建快捷方式） |
 
 > ⚠️ v3.2.0 起不再提供便携版，仅保留 NSIS 安装包。
 >
@@ -222,7 +222,7 @@ v3.3 四大子系统协调运作：
 ```bash
 git clone https://gitee.com/thzxx/metona-ollama-desktop.git
 cd metona-ollama-desktop
-git checkout metona-ollama-desktop-v3.3.4
+git checkout metona-ollama-desktop-v4.0.0
 
 # 安装依赖（国内使用 npmmirror 加速）
 npm config set registry https://registry.npmmirror.com
diff --git a/docs/BUILD.md b/docs/BUILD.md
index 2f0bfde..ad514bc 100644
--- a/docs/BUILD.md
+++ b/docs/BUILD.md
@@ -14,7 +14,7 @@
 # 1. 克隆并安装依赖
 git clone https://gitee.com/thzxx/metona-ollama-desktop.git
 cd metona-ollama-desktop
-git checkout metona-ollama-desktop-v3.3.4
+git checkout metona-ollama-desktop-v4.0.0
 npm config set registry https://registry.npmmirror.com
 npm install
 
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 6517180..9b54864 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -3,7 +3,7 @@
 ## 分支结构
 
 **桌面版主线**（`master`）：
-- `metona-ollama-desktop-v1.1` → `metona-ollama-desktop-v2` → `metona-ollama-desktop-v3.0.0` → `metona-ollama-desktop-v3.1.0` → `metona-ollama-desktop-v3.1.1` → `metona-ollama-desktop-v3.2.0` → `metona-ollama-desktop-v3.2.1` → `metona-ollama-desktop-v3.2.2` → `metona-ollama-desktop-v3.2.3` → `metona-ollama-desktop-v3.2.4` → `metona-ollama-desktop-v3.2.5` → `metona-ollama-desktop-v3.2.6` → `metona-ollama-desktop-v3.3.0` → `metona-ollama-desktop-v3.3.1` → `metona-ollama-desktop-v3.3.2` → `metona-ollama-desktop-v3.3.3` → `metona-ollama-desktop-v3.3.4`（当前发布分支）
+- `metona-ollama-desktop-v1.1` → `metona-ollama-desktop-v2` → `metona-ollama-desktop-v3.0.0` → `metona-ollama-desktop-v3.1.0` → `metona-ollama-desktop-v3.1.1` → `metona-ollama-desktop-v3.2.0` → `metona-ollama-desktop-v3.2.1` → `metona-ollama-desktop-v3.2.2` → `metona-ollama-desktop-v3.2.3` → `metona-ollama-desktop-v3.2.4` → `metona-ollama-desktop-v3.2.5` → `metona-ollama-desktop-v3.2.6` → `metona-ollama-desktop-v3.3.0` → `metona-ollama-desktop-v3.3.1` → `metona-ollama-desktop-v3.3.2` → `metona-ollama-desktop-v3.3.3` → `metona-ollama-desktop-v3.3.4` → `metona-ollama-desktop-v4.0.0`（当前发布分支）
 
 **Web 版历史**已独立为 [metona-ollama-web](https://gitee.com/thzxx/metona-ollama-web) 仓库（v1.1.0 ~ v4.0.3）。
 
@@ -11,6 +11,27 @@
 
 ## 桌面版（Desktop）
 
+### Desktop v4.0.0 — SQLite 数据库 & ReAct Agent 升级
+
+- 📦 **数据库迁移：IndexedDB → SQLite (better-sqlite3)**
+  - 新增 `src/main/db/sqlite.ts`，使用 better-sqlite3 替代 IndexedDB
+  - 6 张表：sessions、messages、tool_calls、memories（FTS5 全文搜索）、settings、traces
+  - WAL 模式 + NORMAL 同步，性能显著提升
+  - 支持全量导出/导入（JSON 格式）
+- 🔧 **Agent Loop 升级为 ReAct 模式**
+  - Thought → Action → Observation → Reflection 循环
+  - 任务复杂度评估（简单/中等/复杂）
+  - 执行轨迹记录（traces 表），Agent 可观测性
+  - 最大 15 轮循环，10 分钟总超时保护
+- 🧠 **记忆/会话管理工具**
+  - 新增 `memory_search`、`memory_add` 工具（AI 可主动管理记忆）
+  - 新增 `session_list`、`session_read` 工具（AI 可查阅历史会话）
+  - 记忆支持 FTS5 全文搜索 + 向量语义搜索
+- 🖥️ **工作空间改进**
+  - IPC 通信优化，workspace 命令通过独立进程管理
+  - AI 工具命令实时输出推送到工作空间终端
+- 📝 **版本号更新至 4.0.0**
+
 ### Desktop v3.3.4 — Agent Loop 去重 & 记忆系统修复
 
 - 🔧 **修复 Agent Loop 工具调用重复问题**
diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md
index 1e212ab..8396d5d 100644
--- a/docs/DEVELOPMENT.md
+++ b/docs/DEVELOPMENT.md
@@ -1,6 +1,6 @@
 # Metona Ollama Desktop — 开发规范
 
-> 版本: 3.3.4 | 更新: 2026-04-17 | 维护: 项目团队
+> 版本: 4.0.0 | 更新: 2026-04-17 | 维护: 项目团队
 
 ---
 
diff --git a/package-lock.json b/package-lock.json
index 7690559..41e9437 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -1,12 +1,12 @@
 {
   "name": "metona-ollama-desktop",
-  "version": "3.3.4",
+  "version": "4.0.0",
   "lockfileVersion": 3,
   "requires": true,
   "packages": {
     "": {
       "name": "metona-ollama-desktop",
-      "version": "3.3.4",
+      "version": "4.0.0",
       "license": "MIT",
       "dependencies": {
         "@types/better-sqlite3": "^7.6.13",