From 8e7f1a84841b7b82aa24910405d5982444e32d0d Mon Sep 17 00:00:00 2001
From: Metona Dev <dev@metona.local>
Date: Mon, 6 Apr 2026 20:48:46 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20=E6=9B=B4=E6=96=B0=20README.md=20?=
 =?UTF-8?q?=E5=92=8C=20CHANGELOG.md=EF=BC=8C=E8=AE=B0=E5=BD=95=20v3.0.0-pa?=
 =?UTF-8?q?tch2=20=E4=BF=AE=E5=A4=8D?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md         |  7 +++++++
 docs/CHANGELOG.md | 22 ++++++++++++++++++++++
 2 files changed, 29 insertions(+)

diff --git a/README.md b/README.md
index eeb1f76..0003698 100644
--- a/README.md
+++ b/README.md
@@ -335,6 +335,13 @@ metona-ollama/
 
 ### 最新版本
 
+**v3.0.0-patch2** — 稳定性修复
+- 🔧 Tool Calling IPC 卡死修复（25 秒硬超时 + 多层保护）
+- 🔧 Electron contextIsolation 兼容（自定义 prompt/confirm 弹窗）
+- 🔧 日志面板默认常驻显示，启动日志不再丢失
+- 🔧 新建会话时强制中断生成并恢复发送按钮
+- 📝 对齐 Ollama 官方 Tool Calling 文档
+
 **v3.0.0** — Tool Calling & Agent 记忆系统
 - 🔧 7 个本地工具 + Agent Loop 引擎 + 安全模型
 - 🧠 自动记忆提取 + 跨会话持久化 + 可视化管理
diff --git a/docs/CHANGELOG.md b/docs/CHANGELOG.md
index 80d2aff..e207380 100644
--- a/docs/CHANGELOG.md
+++ b/docs/CHANGELOG.md
@@ -16,6 +16,28 @@
 ## 桌面版（Desktop）
 
 ### Desktop v3.0.0 — Tool Calling & Agent 记忆
+
+#### v3.0.0-patch2 — 稳定性修复
+- 🔧 **Tool Calling IPC 卡死修复**
+  - `executeTool()` 新增 25 秒 IPC 硬超时，防止主进程无响应时无限挂起
+  - `agent-engine.ts` 内 `.catch` 捕获异常，防止 reject 逃逸
+  - 主进程 `tool:execute` 外层 try-catch，确保始终返回响应
+  - 全链路 console.log 便于 DevTools 排查
+- 🔧 **Electron contextIsolation 兼容**
+  - 新增 `prompt-modal.ts` 自定义弹窗组件（替代原生 `window.prompt()` / `window.confirm()`）
+  - 替换 memory-panel / kb-modal / settings-modal / history-modal 中全部 7 处原生调用
+- 🔧 **日志面板改造**
+  - 默认常驻显示，移除关闭/清空/切换按钮
+  - 新增 earlyBuffer 缓冲机制，initLogPanel 前的日志不再丢失
+  - initLogPanel() 移至 init() 最先执行
+  - 确认为纯运行时日志，不持久化
+- 🔧 **启动稳定性**
+  - init() 中防御性重置 IS_STREAMING / IS_HISTORY_VIEW / toolCallingEnabled 等状态
+  - catch 路径也重置关键状态并初始化日志面板
+- 🔧 **新建会话修复** — 新建会话时强制中断正在进行的生成，恢复发送按钮
+- 📝 对齐 Ollama 官方 Tool Calling JavaScript 文档
+
+#### v3.0.0 — Tool Calling & Agent 记忆
 - 🔧 **Tool Calling — AI 本地文件操作系统**
   - 7 个工具：`read_file` / `write_file` / `list_directory` / `search_files` / `create_directory` / `delete_file` / `run_command`
   - Agent Loop 引擎：流式多轮工具调用循环，支持并行调用（最大 10 轮）