# Claude Code Haha v0.4.0

这是一个以**桌面端底层框架迁移**为核心的大版本。桌面端已经从 Tauri 2 迁移到 Electron，内置浏览器、Workbench、终端、文件选择、系统通知、自动更新和 sidecar 进程管理都已经切到新的 Electron 桌面运行时。

对用户来说，这次迁移的目标是让桌面端在 macOS、Windows 和 Linux 上有更一致的渲染效果和系统交互能力。因为 Electron 自带 Chromium runtime，安装包体积会比过去的 Tauri 版本更大，这是本次迁移后的正常变化。

## 重要更新

- **桌面底层切换到 Electron**：内置浏览器、Workbench 预览、终端、通知、托盘、菜单、窗口状态和自动更新都迁移到新的桌面运行时。
- **跨平台安装包更新**：macOS 提供 DMG，Windows 提供安装器，Linux 提供 AppImage 和 deb。
- **内置浏览器和 Workbench 更稳定**：预览、截图、网页选择和本地文件打开链路继续保留，并适配新的 Electron 桌面壳。
- **Agent 指令体验继续打磨**：agent slash 现在走正常聊天链路并流式展示进度，选择气泡更稳定，会话标题会按用户语言生成。
- **上下文和图片输入兼容性改进**：恢复大图和常见长截图读取，provider context window 估算更准确。
- **Provider 更新**：MiniMax preset 升级到 MiniMax-M3。
- **桌面稳定性修复**：修复 Windows PowerShell 选择、退出时 sidecar 残留、macOS 外接屏菜单栏异常、窗口拖拽区域和 sidebar/titlebar 交互问题。

## 框架迁移说明

`v0.4.0` 是第一个 Electron 桌面版本。旧版 Tauri 桌面端使用系统 WebView，新版 Electron 桌面端使用 Chromium，因此滚动、预览和内置浏览器行为会更接近统一的桌面浏览器体验。

从旧 Tauri 版本升级到第一个 Electron 版本时，推荐手动下载安装 `v0.4.0`，把它作为后续 Electron 自更新的基线。直接替换 `/Applications/Claude Code Haha.app` 不会删除 `~/.claude`、`~/.claude/cc-haha` 或用户选择的便携数据目录。

macOS Release 里会同时出现 `.dmg` 和 `.zip`。普通用户手动安装只需要 DMG；ZIP、blockmap 和 `latest-mac.yml` 是后续自动更新需要的文件。

## 下载

前往 GitHub Release 下载对应系统和架构的文件：

| 平台 | 推荐下载 |
| --- | --- |
| macOS Apple Silicon | `Claude-Code-Haha-0.4.0-mac-arm64.dmg` |
| macOS Intel | `Claude-Code-Haha-0.4.0-mac-x64.dmg` |
| Windows x64 | `Claude-Code-Haha-0.4.0-win-x64.exe` |
| Linux x64 | `Claude-Code-Haha-0.4.0-linux-x86_64.AppImage` 或 `Claude-Code-Haha-0.4.0-linux-amd64.deb` |
| Linux ARM64 | `Claude-Code-Haha-0.4.0-linux-arm64.AppImage` 或 `Claude-Code-Haha-0.4.0-linux-arm64.deb` |

## Windows

下载 `Claude-Code-Haha-0.4.0-win-x64.exe` 后双击安装。如果 Windows SmartScreen 提示未知发布者，选择"更多信息"再选择"仍要运行"。

## Linux

AppImage：

```bash
chmod +x Claude-Code-Haha-0.4.0-linux-x86_64.AppImage
./Claude-Code-Haha-0.4.0-linux-x86_64.AppImage
```

deb：

```bash
sudo apt install ./Claude-Code-Haha-0.4.0-linux-amd64.deb
```

ARM64 Linux 对应把文件名替换为 `Claude-Code-Haha-0.4.0-linux-arm64.AppImage` 或 `Claude-Code-Haha-0.4.0-linux-arm64.deb`。

## macOS

如果 DMG 已完成签名和公证，下载与你 Mac 架构匹配的 DMG，打开后把 `Claude Code Haha.app` 拖到 `Applications`，再从 `Applications` 打开。

如果本次 0.4.0 因 Apple ID 和签名还没准备好，macOS 可能提示 DMG "已损坏"或"无法验证开发者"。这种情况下请下载同一个 Release 里的 `install-macos-unsigned.sh`，和 DMG 放在同一目录后运行下面这条命令。M 系列和 Intel 都用同一个脚本；脚本会自动选择同目录里匹配当前机器架构的 DMG。

macOS 未签名构建安装命令：`bash ~/Downloads/install-macos-unsigned.sh`