docs(release): rewrite v0.4.0 notes and refresh unsigned install docs

- Rewrite release-notes/v0.4.0.md to match the historical style (no emoji,
  Highlights/Fixes/Notes), keep it user-facing only (drop release-process
  notes), and correct Linux (supported since the Tauri builds, not new).
- README.md / README.en.md: replace Tauri references with Electron, list
  macOS / Windows / Linux, and point first-launch approval to the guide.
- Rewrite docs/desktop/04-installation.md for Electron: Electron asset
  names, Linux section, and the unsigned-macOS flow (clear the DMG quarantine
  before double-clicking; drop the WebView2/right-click-open leftovers).
- install-macos-unsigned.sh: keep the same-folder DMG flow, no online download.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: NanmiCoder

README.en.md

@@ -17,7 +17,7 @@
 
 </div>
 
-A Claude Code build repaired from the source leaked from Anthropic's npm registry on 2026-03-31. Claude Code Haha is now primarily a **desktop Claude Code workspace** for macOS and Windows: sessions, projects, branch / Worktree launch, right-side file changes, code diffs, permission review, provider setup, Computer Use, H5 remote access, IM integration, and scheduled tasks in one app.
+A Claude Code build repaired from the source leaked from Anthropic's npm registry on 2026-03-31. Claude Code Haha is now primarily a **desktop Claude Code workspace** for macOS, Windows, and Linux: sessions, projects, branch / Worktree launch, right-side file changes, code diffs, permission review, provider setup, Computer Use, H5 remote access, IM integration, and scheduled tasks in one app.
 
 <p align="center">
   <a href="#desktop-preview">Desktop Preview</a> · <a href="#install-the-desktop-app">Install</a> · <a href="#desktop-highlights">Highlights</a> · <a href="#sponsorship--partnership">Sponsorship</a> · <a href="#more-documentation">More Docs</a>
@@ -30,7 +30,7 @@ A Claude Code build repaired from the source leaked from Anthropic's npm registr
 The Claude Code Haha desktop app brings sessions, multi-project navigation, branch / Worktree controls, right-side file changes, code diffs, permission review, provider setup, and remote access into one graphical workspace for daily development flows beyond the terminal.
 
 <p align="center">
-  <a href="https://github.com/NanmiCoder/cc-haha/releases"><img src="https://img.shields.io/badge/⬇_Download_Desktop-macOS_%7C_Windows-FF7A00?style=for-the-badge" alt="Download Desktop"></a>
+  <a href="https://github.com/NanmiCoder/cc-haha/releases"><img src="https://img.shields.io/badge/⬇_Download_Desktop-macOS_%7C_Windows_%7C_Linux-FF7A00?style=for-the-badge" alt="Download Desktop"></a>
   &nbsp;
   <a href="docs/desktop/04-installation.md"><img src="https://img.shields.io/badge/📖_Install_Guide-Guide-gray?style=for-the-badge" alt="Install Guide"></a>
 </p>
@@ -54,9 +54,9 @@ The Claude Code Haha desktop app brings sessions, multi-project navigation, bran
 
 ## Install the Desktop App
 
-1. Download the macOS or Windows desktop installer from [Releases](https://github.com/NanmiCoder/cc-haha/releases).
+1. Download the macOS / Windows / Linux desktop installer from [Releases](https://github.com/NanmiCoder/cc-haha/releases).
 2. On first launch, configure your model provider, API key, and default model in Settings.
-3. If macOS blocks the app on first open, follow the [desktop installation guide](docs/desktop/04-installation.md) for Gatekeeper steps.
+3. This build is currently unsigned, so the first launch needs a one-time manual approval (clear quarantine on macOS, click "Run anyway" on Windows). See the [desktop installation guide](docs/desktop/04-installation.md).
 
 ## Run the CLI from Source
 
@@ -99,7 +99,7 @@ See [environment variables](docs/en/guide/env-vars.md) and [global usage](docs/e
 | [Skills System](docs/skills/01-usage-guide.md) | Extensible capability plugins, custom workflows and conditional activation |
 | [IM Integration](docs/im/) | Remote chat, project switching, and permission approval via Telegram / Feishu / WeChat / DingTalk |
 | [Computer Use](docs/en/features/computer-use.md) | Desktop control (screenshots, mouse, keyboard) — [Architecture](docs/en/features/computer-use-architecture.md) |
-| [Desktop App](docs/desktop/) | Tauri 2 + React GUI client — [Quick Start](docs/desktop/01-quick-start.md) \| [Architecture](docs/desktop/02-architecture.md) \| [Installation](docs/desktop/04-installation.md) |
+| [Desktop App](docs/desktop/) | Electron + React GUI client — [Quick Start](docs/desktop/01-quick-start.md) \| [Architecture](docs/desktop/02-architecture.md) \| [Installation](docs/desktop/04-installation.md) |
 | [Global Usage](docs/en/guide/global-usage.md) | Run claude-haha from any directory |
 | [FAQ](docs/en/guide/faq.md) | Common error troubleshooting |
 | [Source Fixes](docs/en/reference/fixes.md) | Fixes compared with the original leaked source |
@@ -177,7 +177,7 @@ If this project helps you, consider buying me a coffee — every bit of support
 | Category | Technology |
 |------|------|
 | Language | TypeScript |
-| Desktop app | Tauri 2 |
+| Desktop app | Electron |
 | Desktop UI | React + Vite |
 | Local runtime | [Bun](https://bun.sh) |
 | Terminal UI | React + [Ink](https://github.com/vadimdemedes/ink) |
@@ -190,7 +190,7 @@ If this project helps you, consider buying me a coffee — every bit of support
 Thanks to the following open-source projects and community practices for reference and inspiration:
 
 - [React](https://github.com/facebook/react): frontend engineering and component-based UI ecosystem.
-- [Tauri](https://github.com/tauri-apps/tauri): cross-platform desktop app capabilities and engineering practices.
+- [Electron](https://github.com/electron/electron): cross-platform desktop app capabilities and engineering practices.
 - [cc-switch](https://github.com/farion1231/cc-switch): reference for model provider configuration.
 
 ---

README.md

@@ -17,7 +17,7 @@
 
 </div>
 
-Claude Code Haha 基于 2026-03-31 从 Anthropic npm registry 泄露的 Claude Code 源码修复而来，现在主要是一个**桌面端 Claude Code 工作台**：把会话、多项目、分支 / Worktree、右侧代码改动、代码 Diff、权限审批、模型提供商、Computer Use、H5 远程访问、IM 接入和定时任务集中到一个 macOS / Windows APP 里。
+Claude Code Haha 基于 2026-03-31 从 Anthropic npm registry 泄露的 Claude Code 源码修复而来，现在主要是一个**桌面端 Claude Code 工作台**：把会话、多项目、分支 / Worktree、右侧代码改动、代码 Diff、权限审批、模型提供商、Computer Use、H5 远程访问、IM 接入和定时任务集中到一个 macOS / Windows / Linux APP 里。
 
 <p align="center">
   <a href="#桌面端预览">桌面端预览</a> · <a href="#安装桌面端">安装桌面端</a> · <a href="#桌面端亮点">桌面端亮点</a> · <a href="#赞助与合作">赞助与合作</a> · <a href="#更多文档">更多文档</a>
@@ -30,7 +30,7 @@ Claude Code Haha 基于 2026-03-31 从 Anthropic npm registry 泄露的 Claude C
 Claude Code Haha 的桌面端把会话、多项目、分支 / Worktree、右侧代码改动、代码 Diff、权限确认、提供商配置和远程入口集中到一个图形化工作台里，适合不想长期停留在终端里的日常开发工作流。
 
 <p align="center">
-  <a href="https://github.com/NanmiCoder/cc-haha/releases"><img src="https://img.shields.io/badge/⬇_下载桌面端-macOS_%7C_Windows-FF7A00?style=for-the-badge" alt="下载桌面端"></a>
+  <a href="https://github.com/NanmiCoder/cc-haha/releases"><img src="https://img.shields.io/badge/⬇_下载桌面端-macOS_%7C_Windows_%7C_Linux-FF7A00?style=for-the-badge" alt="下载桌面端"></a>
   &nbsp;
   <a href="docs/desktop/04-installation.md"><img src="https://img.shields.io/badge/📖_安装指南-Guide-gray?style=for-the-badge" alt="安装指南"></a>
 </p>
@@ -54,9 +54,9 @@ Claude Code Haha 的桌面端把会话、多项目、分支 / Worktree、右侧
 
 ## 安装桌面端
 
-1. 前往 [Releases](https://github.com/NanmiCoder/cc-haha/releases) 下载 macOS 或 Windows 桌面端安装包。
+1. 前往 [Releases](https://github.com/NanmiCoder/cc-haha/releases) 下载 macOS / Windows / Linux 桌面端安装包。
 2. 首次启动后，在桌面端设置里配置模型提供商、API Key 和默认模型。
-3. 如果 macOS 提示应用无法打开，请按 [桌面端安装指南](docs/desktop/04-installation.md) 处理 Gatekeeper 权限。
+3. 当前版本暂未签名，首次安装需要手动放行一次（macOS 解除隔离、Windows 点"仍要运行"）。详见 [桌面端安装指南](docs/desktop/04-installation.md)。
 
 ## 从源码启动 CLI
 
@@ -99,7 +99,7 @@ cp .env.example .env
 | [Skills 系统](docs/skills/01-usage-guide.md) | 可扩展能力插件、自定义工作流与条件激活 |
 | [IM 接入](docs/im/) | 通过 Telegram / 飞书 / 微信 / 钉钉远程对话、切换项目和审批权限 |
 | [Computer Use](docs/features/computer-use.md) | 桌面控制功能（截屏、鼠标、键盘）— [架构解析](docs/features/computer-use-architecture.md) |
-| [桌面端](docs/desktop/) | Tauri 2 + React 图形化客户端 — [快速上手](docs/desktop/01-quick-start.md) \| [架构设计](docs/desktop/02-architecture.md) \| [安装指南](docs/desktop/04-installation.md) |
+| [桌面端](docs/desktop/) | Electron + React 图形化客户端 — [快速上手](docs/desktop/01-quick-start.md) \| [架构设计](docs/desktop/02-architecture.md) \| [安装指南](docs/desktop/04-installation.md) |
 | [全局使用](docs/guide/global-usage.md) | 在任意目录启动 claude-haha |
 | [常见问题](docs/guide/faq.md) | 常见错误排查 |
 | [源码修复记录](docs/reference/fixes.md) | 相对于原始泄露源码的修复内容 |
@@ -177,7 +177,7 @@ cp .env.example .env
 | 类别 | 技术 |
 |------|------|
 | 语言 | TypeScript |
-| 桌面 APP | Tauri 2 |
+| 桌面 APP | Electron |
 | 桌面 UI | React + Vite |
 | 本地运行时 | [Bun](https://bun.sh) |
 | 终端 UI | React + [Ink](https://github.com/vadimdemedes/ink) |
@@ -190,7 +190,7 @@ cp .env.example .env
 感谢以下开源项目和社区实践为本项目提供参考与启发：
 
 - [React](https://github.com/facebook/react)：前端工程与组件化 UI 生态。
-- [Tauri](https://github.com/tauri-apps/tauri)：跨端桌面应用能力与工程实践。
+- [Electron](https://github.com/electron/electron)：跨端桌面应用能力与工程实践。
 - [cc-switch](https://github.com/farion1231/cc-switch)：模型供应商配置能力参考。
 
 ---

desktop/scripts/install-macos-unsigned.sh

@@ -1,6 +1,21 @@
 #!/usr/bin/env bash
 set -euo pipefail
 
+# install-macos-unsigned.sh
+#
+# Installs the unsigned macOS build of Claude Code Haha from a DMG that sits
+# next to this script (download both from the same GitHub Release into one
+# folder, e.g. ~/Downloads, then run this script).
+#
+# Because this release ships without an Apple Developer ID signature, macOS
+# quarantines the download and Gatekeeper refuses to launch it ("damaged" /
+# "cannot verify developer"). This script installs the app to /Applications
+# and removes the com.apple.quarantine attribute so it opens normally.
+#
+# Usage:
+#   bash install-macos-unsigned.sh                       # auto-pick the DMG next to this script
+#   bash install-macos-unsigned.sh /path/to/Claude-Code-Haha-0.4.0-mac-arm64.dmg
+
 APP_NAME="Claude Code Haha.app"
 APP_PATH="/Applications/${APP_NAME}"
 
@@ -51,6 +66,7 @@ main() {
   if [ -z "$dmg" ]; then
     if ! dmg="$(find_dmg "$base_dir")"; then
       echo "No Claude Code Haha macOS DMG found next to this script."
+      echo "Download the DMG into the same folder as this script, then run it again."
       echo "Usage: bash install-macos-unsigned.sh /path/to/Claude-Code-Haha-0.4.0-mac-arm64.dmg"
       exit 1
     fi

docs/desktop/04-installation.md

@@ -1,34 +1,80 @@
 # 安装指南
 
+桌面端基于 **Electron**，提供 macOS / Windows / Linux 安装包。当前版本暂未进行 Apple / Windows 代码签名，首次安装需要手动放行一次（不是文件损坏，按下方步骤操作即可）。
+
 ## 下载
 
 前往 [GitHub Releases](https://github.com/NanmiCoder/cc-haha/releases) 下载对应平台的安装包：
 
 | 平台 | 文件 |
 |------|------|
-| macOS (Apple Silicon) | `Claude.Code.Haha_x.x.x_aarch64.dmg` |
-| macOS (Intel) | `Claude.Code.Haha_x.x.x_x64.dmg` |
-| Windows (x64) | `Claude.Code.Haha_x.x.x_x64-setup.exe` |
+| macOS (Apple Silicon / M 系列) | `Claude-Code-Haha-<版本>-mac-arm64.dmg` |
+| macOS (Intel) | `Claude-Code-Haha-<版本>-mac-x64.dmg` |
+| Windows (x64) | `Claude-Code-Haha-<版本>-win-x64.exe` |
+| Linux (x64) | `Claude-Code-Haha-<版本>-linux-x86_64.AppImage` 或 `...-linux-amd64.deb` |
+| Linux (ARM64) | `Claude-Code-Haha-<版本>-linux-arm64.AppImage` 或 `...-linux-arm64.deb` |
 
-> 不确定 Mac 架构？点击左上角  → 关于本机，芯片为 Apple M 开头选 aarch64，Intel 选 x64。
+> 不确定 Mac 架构？点击左上角  → 关于本机，芯片为「Apple M…」选 arm64，「Intel」选 x64。
 
 ## macOS 安装
 
-1. 双击 `.dmg` 文件，将应用拖入 `Applications` 文件夹
-2. 首次打开如果提示**"已损坏，无法打开"**，在终端执行：
+> 重要：当前 DMG 未签名，**直接双击会报"已损坏，无法打开"**（系统只给"移到废纸篓"按钮）。这不是文件损坏，按下面任一方式安装即可，不要点"移到废纸篓"。
+
+### 方式一：脚本安装（推荐）
+
+把 Release 资产里的 `install-macos-unsigned.sh` 和对应架构的 DMG 下载到同一目录（如 `~/Downloads`），然后运行：
+
+```bash
+bash ~/Downloads/install-macos-unsigned.sh
+```
+
+脚本会自动解除 DMG 和应用的隔离标记、挂载并装进「应用程序」后打开——全程不需要双击 DMG。
+
+### 方式二：手动安装
+
+1. 先解除 DMG 的隔离标记（把文件名换成你下载的版本），再双击它：
 
 ```bash
-xattr -cr /Applications/Claude\ Code\ Haha.app
+xattr -dr com.apple.quarantine ~/Downloads/Claude-Code-Haha-<版本>-mac-arm64.dmg
 ```
 
-> 由于应用暂未进行 Apple 开发者签名，macOS 会阻止首次运行，执行上述命令移除隔离属性后即可正常使用。
+2. 把 **Claude Code Haha** 拖入 `Applications`，再解除应用的隔离标记：
+
+```bash
+xattr -dr com.apple.quarantine "/Applications/Claude Code Haha.app"
+```
+
+> - 若提示 `Permission denied`，在命令前加 `sudo`。
+> - **macOS Sequoia (15) 起**，Apple 已移除「右键 → 打开」的绕过方式；对完全未签名的应用，系统设置里的"仍要打开"也可能不出现。因此 `xattr` 命令是当前最可靠的放行方式。
+> - 该命令只移除"从网络下载"的隔离标记，请确认是从官方 GitHub Release 下载后再执行。在拿到 Apple 签名 + 公证之前，双击 DMG 的报错无法从构建侧消除。
 
 ## Windows 安装
 
-1. 双击 `.exe` 安装程序，按向导完成安装
-2. 首次运行如果 SmartScreen 弹出警告，点击 **「更多信息」** → **「仍要运行」**
+1. 双击 `.exe` 安装程序，按向导完成安装。
+2. 首次运行如果 SmartScreen 弹出 **"Windows 已保护你的电脑"**：点击 **「更多信息」** → **「仍要运行」**。
+
+> 可选：若系统反复拦截，可在 PowerShell 中去掉文件的"网络来源"标记：
+> ```powershell
+> Unblock-File -Path "$env:USERPROFILE\Downloads\Claude-Code-Haha-<版本>-win-x64.exe"
+> ```
+
+## Linux 安装
 
-> 应用暂未进行 Windows 代码签名，仅首次运行需要此操作。
+### AppImage（免安装）
+
+```bash
+chmod +x Claude-Code-Haha-<版本>-linux-x86_64.AppImage
+./Claude-Code-Haha-<版本>-linux-x86_64.AppImage
+```
+
+> - 提示缺少 FUSE：Ubuntu 22.04 及更早 `sudo apt install libfuse2`，Ubuntu 24.04+ `sudo apt install libfuse2t64`。
+> - 提示 `SUID sandbox helper ... not configured correctly`：临时用 `--no-sandbox` 运行，或改用下面的 deb 安装。
+
+### deb（推荐，自动解决依赖与沙箱权限）
+
+```bash
+sudo apt install ./Claude-Code-Haha-<版本>-linux-amd64.deb
+```
 
 ## Web UI 模式
 
@@ -47,10 +93,10 @@ bun run dev --host 127.0.0.1 --port 2024
 
 ## 常见问题
 
-**Q: macOS 提示"来自身份不明的开发者"？**
+**Q: macOS 反复提示"已损坏"或"无法验证开发者"？**
 
-右键点击应用 → 选择「打开」→ 在弹窗中点击「打开」，仅需操作一次。
+执行 `xattr -dr com.apple.quarantine "/Applications/Claude Code Haha.app"`（必要时加 `sudo`），或使用上面的一键安装脚本。这是未签名应用被 Gatekeeper 拦截的正常现象，去掉隔离标记后即可正常使用。
 
-**Q: Windows 提示缺少 WebView2？**
+**Q: 这个版本会自动更新吗？**
 
-从 [Microsoft 官方](https://developer.microsoft.com/en-us/microsoft-edge/webview2/) 下载安装 WebView2 运行时。
+暂时不会。在拿到苹果签名前，请每次到 [GitHub Releases](https://github.com/NanmiCoder/cc-haha/releases) 手动下载新版本覆盖安装。覆盖安装不会删除本地配置和会话数据（`~/.claude`）。