diff --git a/release-notes/v0.4.0.md b/release-notes/v0.4.0.md
index 7e8b9b99..b39869ad 100644
--- a/release-notes/v0.4.0.md
+++ b/release-notes/v0.4.0.md
@@ -2,7 +2,9 @@
 
 这是一个以**桌面端底层框架从 Tauri 2 迁移到 Electron**为核心的大版本。
 
-相比 `v0.3.2`，本次把桌面端整体运行时从 Tauri 2（系统 WebView）切换到 Electron（Chromium）：内置浏览器、Workbench、终端、文件选择、系统通知、托盘、菜单、窗口状态和 sidecar 进程管理都迁移到新的 Electron 桌面运行时。因为 Electron 自带 Chromium runtime，安装包体积会比过去的 Tauri 版本更大，这是迁移后的正常变化。
+迁移的起因是多位用户反馈：桌面端在 macOS 上有明显的性能问题，在 Windows 上又有不少行为和开发时的 macOS 不一致。根因是 Tauri 在不同平台各自使用系统 WebView（macOS WebKit、Windows WebView2），渲染和交互天然有差异。这一版索性统一改用 Electron 自带的 Chromium 作为渲染层，多加这一层来把跨平台不一致从根上抹平。代价是安装包体积会比 Tauri 版本更大（内置 Chromium runtime），这是这次取舍下没办法的事。
+
+相比 `v0.3.2`，内置浏览器、Workbench、终端、文件选择、系统通知、托盘、菜单、窗口状态和 sidecar 进程管理都迁移到新的 Electron 桌面运行时。
 
 ## Highlights
 
@@ -14,10 +16,19 @@
 
 ## Fixes
 
-- 修复 Windows PowerShell 终端选择异常。
-- 修复退出时 sidecar 进程残留。
-- 修复 macOS 外接屏场景下菜单栏异常。
-- 修复窗口拖拽区域与 sidebar / titlebar 的交互问题。
+- 修复 Windows 上自定义窗口装饰、任务栏标识（AppUserModelID）、PowerShell 终端选择转发、窗口导航等与开发端 macOS 不一致的行为 (#665)。
+- 修复退出应用时 sidecar 子进程残留为孤儿进程。
+- 修复 macOS 外接显示器下菜单栏出现残影。
+- 修复 sidebar、titlebar、tab bar 的窗口拖拽区域失效。
+- 修复 `agent` slash 指令：改走正常聊天链路、流式展示执行进度、发送前选择可编辑 (#653)。
+- 修复聊天内容圈选的引用不稳定 (#351)，以及滚动时圈选气泡不消失 (#672)。
+- 修复浏览器截图后 composer 输入状态丢失 (#678)。
+- 修复会话标题在助手回合后才生成、并保持与用户相同的语言。
+- 修复飞书（Feishu）兜底回复出现重复消息 (#671)。
+- 修复预热（prewarm）时空闲标签页被误显示为活跃 (#681)。
+- 修复桌面会话中失效的登录态和连接无法自动恢复 (#658, #651)。
+- 修复 provider 模型名归一化导致的测试不一致 (#620)。
+- 修复 Electron 迁移后的若干细节：代理与全屏处理、Activity 摘要布局、社交图标加载、thinking 详情默认折叠。
 
 ## Notes