diff --git a/docs/BUILD.md b/docs/BUILD.md
index 9cf0867..383e52d 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.2
+git checkout metona-ollama-desktop-v3.3.3
 npm config set registry https://registry.npmmirror.com
 npm install
 
@@ -176,6 +176,16 @@ electron-builder 会自动处理所有依赖下载（Electron、NSIS、winCodeSi
 
 ## 构建日志
 
+### v3.3.3（2026-04-17） — metona-ollama-desktop 仓库
+
+- 🔧 修复工具面板中除 run_command 外所有工具错误显示为"需确认"
+- 🔧 修复 run_command 执行模式下拉框未选中项白字白底不可见
+- 🎨 加宽工具面板、历史记录、设置面板、帮助面板
+- ✨ 增强联网搜索与网页抓取联动（TOOL_USAGE_GUIDE 新增规则）
+- ✨ 增强 AI 主动调用工具的 prompt 指导（新增第 7 条规则）
+- ✨ web_search 默认结果数 5 → 15
+- 📝 版本号更新至 3.3.3
+
 ### v3.3.2（2026-04-16） — metona-ollama-desktop 仓库
 
 - ✨ 新增 web_search 联网搜索工具（DuckDuckGo + Bing 双引擎，21 个工具）
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 75e22ff..4d8e16a 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-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`（当前发布分支）
 
 **Web 版历史**已独立为 [metona-ollama-web](https://gitee.com/thzxx/metona-ollama-web) 仓库（v1.1.0 ~ v4.0.3）。
 
@@ -11,6 +11,25 @@
 
 ## 桌面版（Desktop）
 
+### Desktop v3.3.3 — 工具面板修复 & 搜索增强
+
+- 🔧 **修复工具面板 badge 显示错误**
+  - 除 run_command 外所有工具的 badge 从"需确认"改为"自动"（与代码实际行为一致）
+  - 根因：CONFIRM_TOOLS 数组仅包含 run_command，但 HTML 硬编码了 10 个工具为 confirm
+- 🔧 **修复 run_command 下拉框样式**
+  - 未选中项白字白底不可见，根因：内联样式引用了未定义的 CSS 变量 --bg-tertiary
+  - 改用 --bg-card 并为 option 元素添加显式暗色背景
+- 🎨 **面板宽度优化**
+  - 工具面板：720px → 900px
+  - 历史记录：680px → 800px
+  - 设置面板：480px → 640px
+  - 帮助面板：600px → 760px
+- ✨ **增强联网搜索与网页抓取联动**
+  - TOOL_USAGE_GUIDE 新增第 6 条：要求 AI 在 web_search 后必须用 web_fetch 抓取详情
+  - 新增第 7 条：明确 AI 在不确定、信息过时、需实时数据时应主动调用工具
+  - 典型场景→工具映射：查版本→web_search+web_fetch、查文件→read_file、查项目→git status
+- ✨ **web_search 默认结果数提升**：5 → 15，给 AI 更多线索定位目标页面
+
 ### Desktop v3.3.2 — 联网搜索 & 工具权限优化
 
 - ✨ **新增 web_search 联网搜索工具**（第 21 个工具）
diff --git a/docs/DEVELOPMENT.md b/docs/DEVELOPMENT.md
index 5a9d7ac..b40197f 100644
--- a/docs/DEVELOPMENT.md
+++ b/docs/DEVELOPMENT.md
@@ -1,6 +1,6 @@
 # Metona Ollama Desktop — 开发规范
 
-> 版本: 3.3.2 | 更新: 2026-04-16 | 维护: 项目团队
+> 版本: 3.3.3 | 更新: 2026-04-17 | 维护: 项目团队
 
 ---