# Claude Code Haha v0.4.0

这是一个以**桌面端底层框架从 Tauri 2 迁移到 Electron**为核心的大版本。

迁移的起因是多位用户反馈：桌面端在 macOS 上有明显的性能问题，在 Windows 上又有不少行为和开发时的 macOS 不一致。根因是 Tauri 在不同平台各自使用系统 WebView（macOS WebKit、Windows WebView2），渲染和交互天然有差异。这一版索性统一改用 Electron 自带的 Chromium 作为渲染层，多加这一层来把跨平台不一致从根上抹平。代价是安装包体积会比 Tauri 版本更大（内置 Chromium runtime），这是这次取舍下没办法的事。

相比 `v0.3.2`，内置浏览器、Workbench、终端、文件选择、系统通知、托盘、菜单、窗口状态和 sidecar 进程管理都迁移到新的 Electron 桌面运行时。

## Highlights

- **桌面底层切换到 Electron**：macOS / Windows / Linux 三端的内置浏览器、Workbench 预览、终端、通知、托盘、菜单和窗口状态全部迁移到新桌面运行时，跨平台行为更统一。
- **内置浏览器与 Workbench 适配新壳**：预览、截图、网页元素选择和本地文件打开链路在 Electron 壳下保持完整并更稳定。
- **Agent 指令体验打磨**：`agent` slash 走正常聊天链路并流式展示进度，选择气泡更稳定，会话标题按用户语言生成。
- **上下文与图片输入兼容性改进**：恢复大图和常见长截图读取，provider 上下文窗口估算更准确。
- **Provider 更新**：MiniMax preset 升级到 MiniMax-M3。

## Fixes

- 修复 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

- 本版本暂未进行 Apple / Windows 代码签名，首次安装需要手动放行一次（见下方安装说明），这不是文件损坏。
- 暂不提供在线自动更新：在拿到 Apple 签名前，请每次到 [GitHub Releases](https://github.com/NanmiCoder/cc-haha/releases) 手动下载新版本覆盖安装。覆盖安装不会删除本地数据（`~/.claude`、`~/.claude/cc-haha` 及自定义便携数据目录）。

## 安装

到本页面底部的 Assets 里，按系统和 CPU 架构下载对应文件：

| 平台 | 文件 |
|------|------|
| macOS Apple Silicon（M 系列） | `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` |

### macOS

双击 DMG 把应用拖入「应用程序」。首次打开如果提示"已损坏"或"无法验证开发者"，在终端执行：

```bash
xattr -cr /Applications/Claude\ Code\ Haha.app
```

也可以在「系统设置 → 隐私与安全性」里点"仍要打开"。

### Windows

双击 `.exe` 安装。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-arm64.AppImage` / `...-linux-arm64.deb`。