b5d9bbfcd3
Remove maintainer-facing release workflow notes from the public release markdown and keep the macOS unsigned install guidance concise. Tested: git diff --check Tested: bun run check:docs Confidence: high Scope-risk: narrow
3.8 KiB
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：
chmod +x Claude-Code-Haha-0.4.0-linux-x86_64.AppImage
./Claude-Code-Haha-0.4.0-linux-x86_64.AppImage
deb：
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