diff --git a/.gitignore b/.gitignore
index a0f07676..18eaf123 100644
--- a/.gitignore
+++ b/.gitignore
@@ -23,9 +23,8 @@ extracted-natives/
 # E2E screenshots
 e2e-*.png
 
-# Quality gate reports
-artifacts/quality-runs/
-artifacts/coverage/
+# Local/generated artifacts
+artifacts/
 
 # Desktop build output
 desktop/dist/
@@ -78,4 +77,6 @@ runtime/__pycache__
 
 # Local AI assistant artifacts (graph, notes)
 CLAUDE.md
+.mavis/
+.opencode/
 graphify-out/
diff --git a/desktop/package.json b/desktop/package.json
index d7c0df34..64caa2a2 100644
--- a/desktop/package.json
+++ b/desktop/package.json
@@ -1,7 +1,7 @@
 {
   "name": "claude-code-desktop",
   "private": true,
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Desktop coding agent workbench for Claude Code Haha.",
   "homepage": "https://github.com/NanmiCoder/cc-haha",
   "author": {
diff --git a/release-notes/v0.4.1.md b/release-notes/v0.4.1.md
new file mode 100644
index 00000000..631f1df9
--- /dev/null
+++ b/release-notes/v0.4.1.md
@@ -0,0 +1,81 @@
+# Claude Code Haha v0.4.1
+
+这是 `v0.4.0` Electron 迁移后的第一个补丁版本，重点是补齐桌面端可观测性、IM 适配器能力、多语言界面，以及修复迁移后暴露出来的会话稳定性和发布打包细节。
+
+相比 `v0.4.0`，本版本新增 session trace monitoring，可在桌面端查看模型请求、工具调用、消息流和关键事件；同时补强 WhatsApp / Telegram 适配器、设置页体验、图片/截图链路和 provider/runtime 边界行为。
+
+## Highlights
+
+- **Session Trace Monitoring**：新增会话 Trace 记录和查看能力，支持按 session 查看 LLM 请求、工具调用、消息详情、耗时与错误信息；Trace 界面升级为更接近 LangSmith 的双栏树状布局，并把入口收敛到 Settings。
+- **IM 适配器增强**：新增 WhatsApp linked-device 支持，完善配对、媒体处理和桌面设置入口；Telegram 新增命令菜单，常用操作不再依赖手写命令。
+- **桌面多语言补齐**：新增日语、韩语、繁体中文界面，并补齐后续新增设置项、Trace、Adapter 等页面文案。
+- **桌面设置和工作流更顺手**：新增桌面端 Output Style 配置，插件列表支持批量开关，Memory 页面改为 preview-first 并让 Markdown 编辑器填满面板。
+- **截图与预览链路更可靠**：预览截图改为 Electron 原生采集，renderer reload 时会关闭预览窗口，减少旧窗口和截图状态残留。
+
+## Fixes
+
+- 修复 active turn 进行中切换权限或运行时配置时，server 可能过早重启 session 的问题；现在会延后到当前 turn 完成后处理 (#626)。
+- 修复 prewarm / resume / shutdown 交错时可能触发异常状态或退出路径不完整的问题 (#611)。
+- 修复并发 worktree 配置写入可能互相覆盖的问题 (#572)。
+- 修复 OpenAI-compatible provider 流式响应长时间无输出时缺少 stall timeout 的问题 (#548)。
+- 修复 OpenAI chat completion 测试请求误走 stream 形态的问题 (#638)。
+- 修复桌面端输出风格设置无法正确写入和用于会话启动的问题 (#652)。
+- 修复持久化聊天图片在恢复历史会话后丢失的问题 (#721)。
+- 修复聊天选中文本生成的历史引用卡片样式丢失，以及 plan mode 退出后权限模式恢复异常的问题 (#623)。
+- 修复工具调用失败时错误详情展示不完整的问题 (#625)。
+- 修复 Memory 文件默认进入编辑态、Markdown 编辑器高度不足的问题 (#533)。
+- 修复 scheduled task 通知轮询早于 server ready 状态启动的问题。
+- 修复 diagnostics 把预期状态记录成 error 的噪音，并隔离相关测试状态。
+- 修复 WhatsApp 配对完成后重启 login socket 导致连接丢失的问题。
+- 修复 IM adapter 设置页的安装和配置引导文案过时。
+- 修复 release workflow 在未配置签名 secrets 时把空签名环境变量传给 electron-builder。
+
+## Notes
+
+- GitHub Release 正文继续以 `release-notes/v0.4.1.md` 作为来源。
+- 本版本包含 Trace capture、provider proxy、WebSocket session lifecycle、IM adapter sidecar 和 Electron 预览截图链路变化；发布前建议至少跑 `bun run verify`，并对桌面 Trace、WhatsApp/Telegram、预览截图和 provider 请求做一次真实 smoke。
+- 桌面端发布版本号来源是 `desktop/package.json`；root `package.json` 仍保留本地开发用的 `999.0.0-local`。
+- 如果本版本仍未完成 Apple / Windows 代码签名，首次安装时系统可能需要手动放行一次（见下方安装说明）。覆盖安装不会删除本地数据（`~/.claude`、`~/.claude/cc-haha` 及自定义便携数据目录）。
+
+## 安装
+
+到本页面底部的 Assets 里，按系统和 CPU 架构下载对应文件：
+
+| 平台 | 文件 |
+|------|------|
+| macOS Apple Silicon（M 系列） | `Claude-Code-Haha-0.4.1-mac-arm64.dmg` |
+| macOS Intel | `Claude-Code-Haha-0.4.1-mac-x64.dmg` |
+| Windows x64 | `Claude-Code-Haha-0.4.1-win-x64.exe` |
+| Linux x64 | `Claude-Code-Haha-0.4.1-linux-x86_64.AppImage` 或 `Claude-Code-Haha-0.4.1-linux-amd64.deb` |
+| Linux ARM64 | `Claude-Code-Haha-0.4.1-linux-arm64.AppImage` 或 `Claude-Code-Haha-0.4.1-linux-arm64.deb` |
+
+### macOS
+
+双击 DMG 把应用拖入「应用程序」。首次打开如果提示"已损坏"或"无法验证开发者"，在终端执行：
+
+```bash
+xattr -cr /Applications/Claude\ Code\ Haha.app
+```
+
+也可以在「系统设置 → 隐私与安全性」里点"仍要打开"。
+
+### Windows
+
+双击 `.exe` 安装。SmartScreen 提示时点「更多信息」→「仍要运行」。
+
+### Linux
+
+AppImage：
+
+```bash
+chmod +x Claude-Code-Haha-0.4.1-linux-x86_64.AppImage
+./Claude-Code-Haha-0.4.1-linux-x86_64.AppImage
+```
+
+deb：
+
+```bash
+sudo apt install ./Claude-Code-Haha-0.4.1-linux-amd64.deb
+```
+
+ARM64 机器把文件名换成 `...-linux-arm64.AppImage` / `...-linux-arm64.deb`。