程序员阿江(Relakkes) 145af8f18f docs(release): add migration rationale and the full 0.3.2..0.4.0 fix list
- Intro now explains why we migrated: users reported macOS performance
  issues and Windows behaviour diverging from the macOS dev environment;
  Electron's bundled Chromium unifies the rendering layer at the cost of a
  larger installer.
- Fixes section rebuilt from the real v0.3.2..HEAD commits, keeping the
  upstream issue numbers (#665 #653 #351 #672 #678 #671 #681 #658 #651 #620)
  so they can be closed against this release.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
2026-06-03 23:58:57 +08:00

80 lines
4.4 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Claude Code Haha v0.4.0
这是一个以**桌面端底层框架从 Tauri 2 迁移到 Electron**为核心的大版本。
迁移的起因是多位用户反馈:桌面端在 macOS 上有明显的性能问题,在 Windows 上又有不少行为和开发时的 macOS 不一致。根因是 Tauri 在不同平台各自使用系统 WebViewmacOS 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 SiliconM 系列) | `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`