# Claude Code Haha v0.4.0

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

相比 `v0.3.2`，本次把桌面端整体运行时从 Tauri 2（系统 WebView）切换到 Electron（Chromium）：内置浏览器、Workbench、终端、文件选择、系统通知、托盘、菜单、窗口状态和 sidecar 进程管理都迁移到新的 Electron 桌面运行时。因为 Electron 自带 Chromium runtime，安装包体积会比过去的 Tauri 版本更大，这是迁移后的正常变化。

## Highlights

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

## Fixes

- 修复 Windows PowerShell 终端选择异常。
- 修复退出时 sidecar 进程残留。
- 修复 macOS 外接屏场景下菜单栏异常。
- 修复窗口拖拽区域与 sidebar / titlebar 的交互问题。

## 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 未签名，**直接双击会报"已损坏，无法打开"**（系统只给"移到废纸篓"按钮）。这不是文件损坏，按下面任一方式即可正常安装，不要点"移到废纸篓"。

推荐用脚本：把 `install-macos-unsigned.sh` 和对应架构的 DMG 下载到同一目录（如 `~/Downloads`），然后运行：

```bash
bash ~/Downloads/install-macos-unsigned.sh
```

脚本会自动解除 DMG 和应用的隔离标记、挂载并装进「应用程序」后打开——全程不需要双击 DMG。

手动安装：先解除 DMG 的隔离标记（把文件名换成你下载的版本），再双击它：

```bash
xattr -dr com.apple.quarantine ~/Downloads/Claude-Code-Haha-0.4.0-mac-arm64.dmg
```

然后把 **Claude Code Haha** 拖入「应用程序」，再解除应用的隔离标记（提示 `Permission denied` 时加 `sudo`）：

```bash
xattr -dr com.apple.quarantine "/Applications/Claude Code Haha.app"
```

> macOS Sequoia (15) 起已移除「右键 → 打开」的绕过方式，`xattr` 是当前最可靠的放行方式。在拿到 Apple 签名 + 公证之前，双击 DMG 的报错无法从构建侧消除。

### Windows

双击 `Claude-Code-Haha-0.4.0-win-x64.exe` 安装。SmartScreen 弹出「Windows 已保护你的电脑」时，点「更多信息」→「仍要运行」。

### 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`。