程序员阿江(Relakkes) 8bca6985fe docs(release): rewrite v0.4.0 notes and refresh unsigned install docs
- Rewrite release-notes/v0.4.0.md to match the historical style (no emoji,
  Highlights/Fixes/Notes), keep it user-facing only (drop release-process
  notes), and correct Linux (supported since the Tauri builds, not new).
- README.md / README.en.md: replace Tauri references with Electron, list
  macOS / Windows / Linux, and point first-launch approval to the guide.
- Rewrite docs/desktop/04-installation.md for Electron: Electron asset
  names, Linux section, and the unsigned-macOS flow (clear the DMG quarantine
  before double-clicking; drop the WebView2/right-click-open leftovers).
- install-macos-unsigned.sh: keep the same-folder DMG flow, no online download.

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

85 lines
4.1 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**为核心的大版本。
相比 `v0.3.2`,本次把桌面端整体运行时从 Tauri 2系统 WebView切换到 ElectronChromium内置浏览器、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 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 未签名,**直接双击会报"已损坏,无法打开"**(系统只给"移到废纸篓"按钮)。这不是文件损坏,按下面任一方式即可正常安装,不要点"移到废纸篓"。
推荐用脚本:把 `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`