diff --git a/desktop/package.json b/desktop/package.json
index 620236fb..27b0ade5 100644
--- a/desktop/package.json
+++ b/desktop/package.json
@@ -1,7 +1,7 @@
 {
   "name": "claude-code-desktop",
   "private": true,
-  "version": "0.1.6",
+  "version": "0.1.7",
   "type": "module",
   "scripts": {
     "dev": "vite",
diff --git a/desktop/src-tauri/Cargo.lock b/desktop/src-tauri/Cargo.lock
index 72545d9f..9c188625 100644
--- a/desktop/src-tauri/Cargo.lock
+++ b/desktop/src-tauri/Cargo.lock
@@ -329,7 +329,7 @@ dependencies = [
 
 [[package]]
 name = "claude-code-desktop"
-version = "0.1.6"
+version = "0.1.7"
 dependencies = [
  "anyhow",
  "portable-pty",
@@ -727,14 +727,14 @@ checksum = "d0881ea181b1df73ff77ffaaf9c7544ecc11e82fba9b5f27b262a3c73a332555"
 
 [[package]]
 name = "embed-resource"
-version = "3.0.8"
+version = "3.0.9"
 source = "registry+https://github.com/rust-lang/crates.io-index"
-checksum = "63a1d0de4f2249aa0ff5884d7080814f446bb241a559af6c170a41e878ed2d45"
+checksum = "c31a88c8d26de40ed18fe748c547845aa39de1db3afd958f8cb91579f3644bcb"
 dependencies = [
  "cc",
  "memchr",
  "rustc_version",
- "toml 0.9.12+spec-1.1.0",
+ "toml 1.1.2+spec-1.1.0",
  "vswhom",
  "winreg 0.55.0",
 ]
@@ -4285,6 +4285,21 @@ dependencies = [
  "winnow 0.7.15",
 ]
 
+[[package]]
+name = "toml"
+version = "1.1.2+spec-1.1.0"
+source = "registry+https://github.com/rust-lang/crates.io-index"
+checksum = "81f3d15e84cbcd896376e6730314d59fb5a87f31e4b038454184435cd57defee"
+dependencies = [
+ "indexmap 2.14.0",
+ "serde_core",
+ "serde_spanned 1.1.1",
+ "toml_datetime 1.1.1+spec-1.1.0",
+ "toml_parser",
+ "toml_writer",
+ "winnow 1.0.2",
+]
+
 [[package]]
 name = "toml_datetime"
 version = "0.6.3"
diff --git a/desktop/src-tauri/Cargo.toml b/desktop/src-tauri/Cargo.toml
index 142eebce..81bbe6e2 100644
--- a/desktop/src-tauri/Cargo.toml
+++ b/desktop/src-tauri/Cargo.toml
@@ -1,6 +1,6 @@
 [package]
 name = "claude-code-desktop"
-version = "0.1.6"
+version = "0.1.7"
 edition = "2021"
 
 [lib]
diff --git a/desktop/src-tauri/tauri.conf.json b/desktop/src-tauri/tauri.conf.json
index 758c4dd8..7ec0ef4d 100644
--- a/desktop/src-tauri/tauri.conf.json
+++ b/desktop/src-tauri/tauri.conf.json
@@ -1,7 +1,7 @@
 {
   "$schema": "https://raw.githubusercontent.com/nicegui/nicegui/main/nicegui/static/tauri-schema-v2.json",
   "productName": "Claude Code Haha",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "identifier": "com.claude-code-haha.desktop",
   "build": {
     "frontendDist": "../dist",
diff --git a/release-notes/v0.1.7.md b/release-notes/v0.1.7.md
new file mode 100644
index 00000000..4666c101
--- /dev/null
+++ b/release-notes/v0.1.7.md
@@ -0,0 +1,35 @@
+# Claude Code Haha v0.1.7
+
+这是一个以 Windows 桌面端在线更新稳定性和聊天展示体验修复为主的补丁版本。
+
+相比 `v0.1.6`，这次重点修复了 Windows 桌面端自动更新后本地服务启动失败的问题，并补齐了 Windows 开发环境 WebUI 启动 CLI 时的宏预加载逻辑。同时修复了 Mermaid 渲染错误提示和聊天手动滚动被打断的问题。
+
+## 主要更新
+
+- 修复 Windows 桌面端在线自动更新流程：安装新版本前会先停止本地 server sidecar 和 adapter sidecar，避免升级后重启时出现 `os error 32`、`另一个程序正在使用此文件` 或“本地服务启动失败”。
+- Windows 发布产物改为优先使用 NSIS 安装包，并在安装器 hook 中处理 sidecar 进程清理，降低从旧版本自动升级时被文件锁卡住的概率。
+- 修复 Windows 开发环境中 WebUI 启动 CLI 失败的问题，源码 fallback 启动 CLI 时会正确加载 `preload.ts`，避免 `MACRO is not defined` 导致进程启动失败。
+- 优化聊天列表手动滚动体验：用户向上查看历史消息时，流式输出不会强制把视图拉回底部；当用户仍停留在底部附近时，会继续保持自动跟随最新回复。
+
+## 问题修复
+
+- 修复 Mermaid 图表渲染失败时可能出现开发错误覆盖层的问题，让错误状态保持在聊天消息内部展示。
+- 修复聊天流式输出期间手动滚动位置被覆盖的问题，并补充相关回归测试。
+- 修复 Windows updater 安装阶段没有提前释放 sidecar 文件句柄的问题。
+- 修复 Windows dev WebUI 会话启动时 CLI 进程直接以 code 1 退出的问题。
+
+## 其他说明
+
+- 已安装 `v0.1.5` 或 `v0.1.6` 的 Windows 用户正常情况下可以直接升级到 `v0.1.7`，不需要先卸载旧版本。
+- 如果某台机器已经卡在旧版本升级后的“本地服务启动失败”页面，可以先完全退出桌面端和残留的 `claude-sidecar.exe` 进程，再安装 `v0.1.7`。
+- GitHub Release 正文继续以 `release-notes/v0.1.7.md` 作为来源，发布时无需再手动复制 Markdown。
+
+## 安装说明
+
+### macOS
+
+首次打开如果提示“已损坏”或“无法验证开发者”，请执行：
+
+```bash
+xattr -cr /Applications/Claude\ Code\ Haha.app
+```