mirror of https://github.com/NanmiCoder/cc-haha synced 2026-07-16 13:03:31 +08:00

程序员阿江(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

4.4 KiB

Raw Blame History

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 手动下载新版本覆盖安装。覆盖安装不会删除本地数据（~/.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 把应用拖入「应用程序」。首次打开如果提示"已损坏"或"无法验证开发者"，在终端执行：

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

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

Windows

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

4.4 KiB Raw Blame History Unescape Escape