mirror of
https://github.com/NanmiCoder/cc-haha
synced 2026-07-17 13:13:35 +08:00
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>
This commit is contained in:
程序员阿江(Relakkes)
parent
b5d9bbfcd3
commit
8bca6985fe
14
README.en.md
14
README.en.md
@ -17,7 +17,7 @@
|
||||
|
||||
</div>
|
||||
|
||||
A Claude Code build repaired from the source leaked from Anthropic's npm registry on 2026-03-31. Claude Code Haha is now primarily a **desktop Claude Code workspace** for macOS and Windows: sessions, projects, branch / Worktree launch, right-side file changes, code diffs, permission review, provider setup, Computer Use, H5 remote access, IM integration, and scheduled tasks in one app.
|
||||
A Claude Code build repaired from the source leaked from Anthropic's npm registry on 2026-03-31. Claude Code Haha is now primarily a **desktop Claude Code workspace** for macOS, Windows, and Linux: sessions, projects, branch / Worktree launch, right-side file changes, code diffs, permission review, provider setup, Computer Use, H5 remote access, IM integration, and scheduled tasks in one app.
|
||||
|
||||
<p align="center">
|
||||
<a href="#desktop-preview">Desktop Preview</a> · <a href="#install-the-desktop-app">Install</a> · <a href="#desktop-highlights">Highlights</a> · <a href="#sponsorship--partnership">Sponsorship</a> · <a href="#more-documentation">More Docs</a>
|
||||
@ -30,7 +30,7 @@ A Claude Code build repaired from the source leaked from Anthropic's npm registr
|
||||
The Claude Code Haha desktop app brings sessions, multi-project navigation, branch / Worktree controls, right-side file changes, code diffs, permission review, provider setup, and remote access into one graphical workspace for daily development flows beyond the terminal.
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/NanmiCoder/cc-haha/releases"><img src="https://img.shields.io/badge/⬇_Download_Desktop-macOS_%7C_Windows-FF7A00?style=for-the-badge" alt="Download Desktop"></a>
|
||||
<a href="https://github.com/NanmiCoder/cc-haha/releases"><img src="https://img.shields.io/badge/⬇_Download_Desktop-macOS_%7C_Windows_%7C_Linux-FF7A00?style=for-the-badge" alt="Download Desktop"></a>
|
||||
|
||||
<a href="docs/desktop/04-installation.md"><img src="https://img.shields.io/badge/📖_Install_Guide-Guide-gray?style=for-the-badge" alt="Install Guide"></a>
|
||||
</p>
|
||||
@ -54,9 +54,9 @@ The Claude Code Haha desktop app brings sessions, multi-project navigation, bran
|
||||
|
||||
## Install the Desktop App
|
||||
|
||||
1. Download the macOS or Windows desktop installer from [Releases](https://github.com/NanmiCoder/cc-haha/releases).
|
||||
1. Download the macOS / Windows / Linux desktop installer from [Releases](https://github.com/NanmiCoder/cc-haha/releases).
|
||||
2. On first launch, configure your model provider, API key, and default model in Settings.
|
||||
3. If macOS blocks the app on first open, follow the [desktop installation guide](docs/desktop/04-installation.md) for Gatekeeper steps.
|
||||
3. This build is currently unsigned, so the first launch needs a one-time manual approval (clear quarantine on macOS, click "Run anyway" on Windows). See the [desktop installation guide](docs/desktop/04-installation.md).
|
||||
|
||||
## Run the CLI from Source
|
||||
|
||||
@ -99,7 +99,7 @@ See [environment variables](docs/en/guide/env-vars.md) and [global usage](docs/e
|
||||
| [Skills System](docs/skills/01-usage-guide.md) | Extensible capability plugins, custom workflows and conditional activation |
|
||||
| [IM Integration](docs/im/) | Remote chat, project switching, and permission approval via Telegram / Feishu / WeChat / DingTalk |
|
||||
| [Computer Use](docs/en/features/computer-use.md) | Desktop control (screenshots, mouse, keyboard) — [Architecture](docs/en/features/computer-use-architecture.md) |
|
||||
| [Desktop App](docs/desktop/) | Tauri 2 + React GUI client — [Quick Start](docs/desktop/01-quick-start.md) \| [Architecture](docs/desktop/02-architecture.md) \| [Installation](docs/desktop/04-installation.md) |
|
||||
| [Desktop App](docs/desktop/) | Electron + React GUI client — [Quick Start](docs/desktop/01-quick-start.md) \| [Architecture](docs/desktop/02-architecture.md) \| [Installation](docs/desktop/04-installation.md) |
|
||||
| [Global Usage](docs/en/guide/global-usage.md) | Run claude-haha from any directory |
|
||||
| [FAQ](docs/en/guide/faq.md) | Common error troubleshooting |
|
||||
| [Source Fixes](docs/en/reference/fixes.md) | Fixes compared with the original leaked source |
|
||||
@ -177,7 +177,7 @@ If this project helps you, consider buying me a coffee — every bit of support
|
||||
| Category | Technology |
|
||||
|------|------|
|
||||
| Language | TypeScript |
|
||||
| Desktop app | Tauri 2 |
|
||||
| Desktop app | Electron |
|
||||
| Desktop UI | React + Vite |
|
||||
| Local runtime | [Bun](https://bun.sh) |
|
||||
| Terminal UI | React + [Ink](https://github.com/vadimdemedes/ink) |
|
||||
@ -190,7 +190,7 @@ If this project helps you, consider buying me a coffee — every bit of support
|
||||
Thanks to the following open-source projects and community practices for reference and inspiration:
|
||||
|
||||
- [React](https://github.com/facebook/react): frontend engineering and component-based UI ecosystem.
|
||||
- [Tauri](https://github.com/tauri-apps/tauri): cross-platform desktop app capabilities and engineering practices.
|
||||
- [Electron](https://github.com/electron/electron): cross-platform desktop app capabilities and engineering practices.
|
||||
- [cc-switch](https://github.com/farion1231/cc-switch): reference for model provider configuration.
|
||||
|
||||
---
|
||||
|
||||
14
README.md
14
README.md
@ -17,7 +17,7 @@
|
||||
|
||||
</div>
|
||||
|
||||
Claude Code Haha 基于 2026-03-31 从 Anthropic npm registry 泄露的 Claude Code 源码修复而来，现在主要是一个**桌面端 Claude Code 工作台**：把会话、多项目、分支 / Worktree、右侧代码改动、代码 Diff、权限审批、模型提供商、Computer Use、H5 远程访问、IM 接入和定时任务集中到一个 macOS / Windows APP 里。
|
||||
Claude Code Haha 基于 2026-03-31 从 Anthropic npm registry 泄露的 Claude Code 源码修复而来，现在主要是一个**桌面端 Claude Code 工作台**：把会话、多项目、分支 / Worktree、右侧代码改动、代码 Diff、权限审批、模型提供商、Computer Use、H5 远程访问、IM 接入和定时任务集中到一个 macOS / Windows / Linux APP 里。
|
||||
|
||||
<p align="center">
|
||||
<a href="#桌面端预览">桌面端预览</a> · <a href="#安装桌面端">安装桌面端</a> · <a href="#桌面端亮点">桌面端亮点</a> · <a href="#赞助与合作">赞助与合作</a> · <a href="#更多文档">更多文档</a>
|
||||
@ -30,7 +30,7 @@ Claude Code Haha 基于 2026-03-31 从 Anthropic npm registry 泄露的 Claude C
|
||||
Claude Code Haha 的桌面端把会话、多项目、分支 / Worktree、右侧代码改动、代码 Diff、权限确认、提供商配置和远程入口集中到一个图形化工作台里，适合不想长期停留在终端里的日常开发工作流。
|
||||
|
||||
<p align="center">
|
||||
<a href="https://github.com/NanmiCoder/cc-haha/releases"><img src="https://img.shields.io/badge/⬇_下载桌面端-macOS_%7C_Windows-FF7A00?style=for-the-badge" alt="下载桌面端"></a>
|
||||
<a href="https://github.com/NanmiCoder/cc-haha/releases"><img src="https://img.shields.io/badge/⬇_下载桌面端-macOS_%7C_Windows_%7C_Linux-FF7A00?style=for-the-badge" alt="下载桌面端"></a>
|
||||
|
||||
<a href="docs/desktop/04-installation.md"><img src="https://img.shields.io/badge/📖_安装指南-Guide-gray?style=for-the-badge" alt="安装指南"></a>
|
||||
</p>
|
||||
@ -54,9 +54,9 @@ Claude Code Haha 的桌面端把会话、多项目、分支 / Worktree、右侧
|
||||
|
||||
## 安装桌面端
|
||||
|
||||
1. 前往 [Releases](https://github.com/NanmiCoder/cc-haha/releases) 下载 macOS 或 Windows 桌面端安装包。
|
||||
1. 前往 [Releases](https://github.com/NanmiCoder/cc-haha/releases) 下载 macOS / Windows / Linux 桌面端安装包。
|
||||
2. 首次启动后，在桌面端设置里配置模型提供商、API Key 和默认模型。
|
||||
3. 如果 macOS 提示应用无法打开，请按 [桌面端安装指南](docs/desktop/04-installation.md) 处理 Gatekeeper 权限。
|
||||
3. 当前版本暂未签名，首次安装需要手动放行一次（macOS 解除隔离、Windows 点"仍要运行"）。详见 [桌面端安装指南](docs/desktop/04-installation.md)。
|
||||
|
||||
## 从源码启动 CLI
|
||||
|
||||
@ -99,7 +99,7 @@ cp .env.example .env
|
||||
| [Skills 系统](docs/skills/01-usage-guide.md) | 可扩展能力插件、自定义工作流与条件激活 |
|
||||
| [IM 接入](docs/im/) | 通过 Telegram / 飞书 / 微信 / 钉钉远程对话、切换项目和审批权限 |
|
||||
| [Computer Use](docs/features/computer-use.md) | 桌面控制功能（截屏、鼠标、键盘）— [架构解析](docs/features/computer-use-architecture.md) |
|
||||
| [桌面端](docs/desktop/) | Tauri 2 + React 图形化客户端 — [快速上手](docs/desktop/01-quick-start.md) \| [架构设计](docs/desktop/02-architecture.md) \| [安装指南](docs/desktop/04-installation.md) |
|
||||
| [桌面端](docs/desktop/) | Electron + React 图形化客户端 — [快速上手](docs/desktop/01-quick-start.md) \| [架构设计](docs/desktop/02-architecture.md) \| [安装指南](docs/desktop/04-installation.md) |
|
||||
| [全局使用](docs/guide/global-usage.md) | 在任意目录启动 claude-haha |
|
||||
| [常见问题](docs/guide/faq.md) | 常见错误排查 |
|
||||
| [源码修复记录](docs/reference/fixes.md) | 相对于原始泄露源码的修复内容 |
|
||||
@ -177,7 +177,7 @@ cp .env.example .env
|
||||
| 类别 | 技术 |
|
||||
|------|------|
|
||||
| 语言 | TypeScript |
|
||||
| 桌面 APP | Tauri 2 |
|
||||
| 桌面 APP | Electron |
|
||||
| 桌面 UI | React + Vite |
|
||||
| 本地运行时 | [Bun](https://bun.sh) |
|
||||
| 终端 UI | React + [Ink](https://github.com/vadimdemedes/ink) |
|
||||
@ -190,7 +190,7 @@ cp .env.example .env
|
||||
感谢以下开源项目和社区实践为本项目提供参考与启发：
|
||||
|
||||
- [React](https://github.com/facebook/react)：前端工程与组件化 UI 生态。
|
||||
- [Tauri](https://github.com/tauri-apps/tauri)：跨端桌面应用能力与工程实践。
|
||||
- [Electron](https://github.com/electron/electron)：跨端桌面应用能力与工程实践。
|
||||
- [cc-switch](https://github.com/farion1231/cc-switch)：模型供应商配置能力参考。
|
||||
|
||||
---
|
||||
|
||||
@ -1,6 +1,21 @@
|
||||
#!/usr/bin/env bash
|
||||
set -euo pipefail
|
||||
|
||||
# install-macos-unsigned.sh
|
||||
#
|
||||
# Installs the unsigned macOS build of Claude Code Haha from a DMG that sits
|
||||
# next to this script (download both from the same GitHub Release into one
|
||||
# folder, e.g. ~/Downloads, then run this script).
|
||||
#
|
||||
# Because this release ships without an Apple Developer ID signature, macOS
|
||||
# quarantines the download and Gatekeeper refuses to launch it ("damaged" /
|
||||
# "cannot verify developer"). This script installs the app to /Applications
|
||||
# and removes the com.apple.quarantine attribute so it opens normally.
|
||||
#
|
||||
# Usage:
|
||||
# bash install-macos-unsigned.sh # auto-pick the DMG next to this script
|
||||
# bash install-macos-unsigned.sh /path/to/Claude-Code-Haha-0.4.0-mac-arm64.dmg
|
||||
|
||||
APP_NAME="Claude Code Haha.app"
|
||||
APP_PATH="/Applications/${APP_NAME}"
|
||||
|
||||
@ -51,6 +66,7 @@ main() {
|
||||
if [ -z "$dmg" ]; then
|
||||
if ! dmg="$(find_dmg "$base_dir")"; then
|
||||
echo "No Claude Code Haha macOS DMG found next to this script."
|
||||
echo "Download the DMG into the same folder as this script, then run it again."
|
||||
echo "Usage: bash install-macos-unsigned.sh /path/to/Claude-Code-Haha-0.4.0-mac-arm64.dmg"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
@ -1,34 +1,80 @@
|
||||
# 安装指南
|
||||
|
||||
桌面端基于 **Electron**，提供 macOS / Windows / Linux 安装包。当前版本暂未进行 Apple / Windows 代码签名，首次安装需要手动放行一次（不是文件损坏，按下方步骤操作即可）。
|
||||
|
||||
## 下载
|
||||
|
||||
前往 [GitHub Releases](https://github.com/NanmiCoder/cc-haha/releases) 下载对应平台的安装包：
|
||||
|
||||
| 平台 | 文件 |
|
||||
|------|------|
|
||||
| macOS (Apple Silicon) | `Claude.Code.Haha_x.x.x_aarch64.dmg` |
|
||||
| macOS (Intel) | `Claude.Code.Haha_x.x.x_x64.dmg` |
|
||||
| Windows (x64) | `Claude.Code.Haha_x.x.x_x64-setup.exe` |
|
||||
| macOS (Apple Silicon / M 系列) | `Claude-Code-Haha-<版本>-mac-arm64.dmg` |
|
||||
| macOS (Intel) | `Claude-Code-Haha-<版本>-mac-x64.dmg` |
|
||||
| Windows (x64) | `Claude-Code-Haha-<版本>-win-x64.exe` |
|
||||
| Linux (x64) | `Claude-Code-Haha-<版本>-linux-x86_64.AppImage` 或 `...-linux-amd64.deb` |
|
||||
| Linux (ARM64) | `Claude-Code-Haha-<版本>-linux-arm64.AppImage` 或 `...-linux-arm64.deb` |
|
||||
|
||||
> 不确定 Mac 架构？点击左上角 → 关于本机，芯片为 Apple M 开头选 aarch64，Intel 选 x64。
|
||||
> 不确定 Mac 架构？点击左上角 → 关于本机，芯片为「Apple M…」选 arm64，「Intel」选 x64。
|
||||
|
||||
## macOS 安装
|
||||
|
||||
1. 双击 `.dmg` 文件，将应用拖入 `Applications` 文件夹
|
||||
2. 首次打开如果提示**"已损坏，无法打开"**，在终端执行：
|
||||
> 重要：当前 DMG 未签名，**直接双击会报"已损坏，无法打开"**（系统只给"移到废纸篓"按钮）。这不是文件损坏，按下面任一方式安装即可，不要点"移到废纸篓"。
|
||||
|
||||
### 方式一：脚本安装（推荐）
|
||||
|
||||
把 Release 资产里的 `install-macos-unsigned.sh` 和对应架构的 DMG 下载到同一目录（如 `~/Downloads`），然后运行：
|
||||
|
||||
```bash
|
||||
xattr -cr /Applications/Claude\ Code\ Haha.app
|
||||
bash ~/Downloads/install-macos-unsigned.sh
|
||||
```
|
||||
|
||||
> 由于应用暂未进行 Apple 开发者签名，macOS 会阻止首次运行，执行上述命令移除隔离属性后即可正常使用。
|
||||
脚本会自动解除 DMG 和应用的隔离标记、挂载并装进「应用程序」后打开——全程不需要双击 DMG。
|
||||
|
||||
### 方式二：手动安装
|
||||
|
||||
1. 先解除 DMG 的隔离标记（把文件名换成你下载的版本），再双击它：
|
||||
|
||||
```bash
|
||||
xattr -dr com.apple.quarantine ~/Downloads/Claude-Code-Haha-<版本>-mac-arm64.dmg
|
||||
```
|
||||
|
||||
2. 把 **Claude Code Haha** 拖入 `Applications`，再解除应用的隔离标记：
|
||||
|
||||
```bash
|
||||
xattr -dr com.apple.quarantine "/Applications/Claude Code Haha.app"
|
||||
```
|
||||
|
||||
> - 若提示 `Permission denied`，在命令前加 `sudo`。
|
||||
> - **macOS Sequoia (15) 起**，Apple 已移除「右键 → 打开」的绕过方式；对完全未签名的应用，系统设置里的"仍要打开"也可能不出现。因此 `xattr` 命令是当前最可靠的放行方式。
|
||||
> - 该命令只移除"从网络下载"的隔离标记，请确认是从官方 GitHub Release 下载后再执行。在拿到 Apple 签名 + 公证之前，双击 DMG 的报错无法从构建侧消除。
|
||||
|
||||
## Windows 安装
|
||||
|
||||
1. 双击 `.exe` 安装程序，按向导完成安装
|
||||
2. 首次运行如果 SmartScreen 弹出警告，点击 **「更多信息」** → **「仍要运行」**
|
||||
1. 双击 `.exe` 安装程序，按向导完成安装。
|
||||
2. 首次运行如果 SmartScreen 弹出 **"Windows 已保护你的电脑"**：点击 **「更多信息」** → **「仍要运行」**。
|
||||
|
||||
> 应用暂未进行 Windows 代码签名，仅首次运行需要此操作。
|
||||
> 可选：若系统反复拦截，可在 PowerShell 中去掉文件的"网络来源"标记：
|
||||
> ```powershell
|
||||
> Unblock-File -Path "$env:USERPROFILE\Downloads\Claude-Code-Haha-<版本>-win-x64.exe"
|
||||
> ```
|
||||
|
||||
## Linux 安装
|
||||
|
||||
### AppImage（免安装）
|
||||
|
||||
```bash
|
||||
chmod +x Claude-Code-Haha-<版本>-linux-x86_64.AppImage
|
||||
./Claude-Code-Haha-<版本>-linux-x86_64.AppImage
|
||||
```
|
||||
|
||||
> - 提示缺少 FUSE：Ubuntu 22.04 及更早 `sudo apt install libfuse2`，Ubuntu 24.04+ `sudo apt install libfuse2t64`。
|
||||
> - 提示 `SUID sandbox helper ... not configured correctly`：临时用 `--no-sandbox` 运行，或改用下面的 deb 安装。
|
||||
|
||||
### deb（推荐，自动解决依赖与沙箱权限）
|
||||
|
||||
```bash
|
||||
sudo apt install ./Claude-Code-Haha-<版本>-linux-amd64.deb
|
||||
```
|
||||
|
||||
## Web UI 模式
|
||||
|
||||
@ -47,10 +93,10 @@ bun run dev --host 127.0.0.1 --port 2024
|
||||
|
||||
## 常见问题
|
||||
|
||||
**Q: macOS 提示"来自身份不明的开发者"？**
|
||||
**Q: macOS 反复提示"已损坏"或"无法验证开发者"？**
|
||||
|
||||
右键点击应用 → 选择「打开」→ 在弹窗中点击「打开」，仅需操作一次。
|
||||
执行 `xattr -dr com.apple.quarantine "/Applications/Claude Code Haha.app"`（必要时加 `sudo`），或使用上面的一键安装脚本。这是未签名应用被 Gatekeeper 拦截的正常现象，去掉隔离标记后即可正常使用。
|
||||
|
||||
**Q: Windows 提示缺少 WebView2？**
|
||||
**Q: 这个版本会自动更新吗？**
|
||||
|
||||
从 [Microsoft 官方](https://developer.microsoft.com/en-us/microsoft-edge/webview2/) 下载安装 WebView2 运行时。
|
||||
暂时不会。在拿到苹果签名前，请每次到 [GitHub Releases](https://github.com/NanmiCoder/cc-haha/releases) 手动下载新版本覆盖安装。覆盖安装不会删除本地配置和会话数据（`~/.claude`）。
|
||||
|
||||
@ -1,44 +1,72 @@
|
||||
# Claude Code Haha v0.4.0
|
||||
|
||||
这是一个以**桌面端底层框架迁移**为核心的大版本。桌面端已经从 Tauri 2 迁移到 Electron，内置浏览器、Workbench、终端、文件选择、系统通知、自动更新和 sidecar 进程管理都已经切到新的 Electron 桌面运行时。
|
||||
这是一个以**桌面端底层框架从 Tauri 2 迁移到 Electron**为核心的大版本。
|
||||
|
||||
对用户来说，这次迁移的目标是让桌面端在 macOS、Windows 和 Linux 上有更一致的渲染效果和系统交互能力。因为 Electron 自带 Chromium runtime，安装包体积会比过去的 Tauri 版本更大，这是本次迁移后的正常变化。
|
||||
相比 `v0.3.2`，本次把桌面端整体运行时从 Tauri 2（系统 WebView）切换到 Electron（Chromium）：内置浏览器、Workbench、终端、文件选择、系统通知、托盘、菜单、窗口状态和 sidecar 进程管理都迁移到新的 Electron 桌面运行时。因为 Electron 自带 Chromium runtime，安装包体积会比过去的 Tauri 版本更大，这是迁移后的正常变化。
|
||||
|
||||
## 重要更新
|
||||
## Highlights
|
||||
|
||||
- **桌面底层切换到 Electron**：内置浏览器、Workbench 预览、终端、通知、托盘、菜单、窗口状态和自动更新都迁移到新的桌面运行时。
|
||||
- **跨平台安装包更新**：macOS 提供 DMG，Windows 提供安装器，Linux 提供 AppImage 和 deb。
|
||||
- **内置浏览器和 Workbench 更稳定**：预览、截图、网页选择和本地文件打开链路继续保留，并适配新的 Electron 桌面壳。
|
||||
- **Agent 指令体验继续打磨**：agent slash 现在走正常聊天链路并流式展示进度，选择气泡更稳定，会话标题会按用户语言生成。
|
||||
- **上下文和图片输入兼容性改进**：恢复大图和常见长截图读取，provider context window 估算更准确。
|
||||
- **桌面底层切换到 Electron**：macOS / Windows / Linux 三端的内置浏览器、Workbench 预览、终端、通知、托盘、菜单和窗口状态全部迁移到新桌面运行时，跨平台行为更统一。
|
||||
- **内置浏览器与 Workbench 适配新壳**：预览、截图、网页元素选择和本地文件打开链路在 Electron 壳下保持完整并更稳定。
|
||||
- **Agent 指令体验打磨**：`agent` slash 走正常聊天链路并流式展示进度，选择气泡更稳定，会话标题按用户语言生成。
|
||||
- **上下文与图片输入兼容性改进**：恢复大图和常见长截图读取，provider 上下文窗口估算更准确。
|
||||
- **Provider 更新**：MiniMax preset 升级到 MiniMax-M3。
|
||||
- **桌面稳定性修复**：修复 Windows PowerShell 选择、退出时 sidecar 残留、macOS 外接屏菜单栏异常、窗口拖拽区域和 sidebar/titlebar 交互问题。
|
||||
|
||||
## 框架迁移说明
|
||||
## Fixes
|
||||
|
||||
`v0.4.0` 是第一个 Electron 桌面版本。旧版 Tauri 桌面端使用系统 WebView，新版 Electron 桌面端使用 Chromium，因此滚动、预览和内置浏览器行为会更接近统一的桌面浏览器体验。
|
||||
- 修复 Windows PowerShell 终端选择异常。
|
||||
- 修复退出时 sidecar 进程残留。
|
||||
- 修复 macOS 外接屏场景下菜单栏异常。
|
||||
- 修复窗口拖拽区域与 sidebar / titlebar 的交互问题。
|
||||
|
||||
从旧 Tauri 版本升级到第一个 Electron 版本时，推荐手动下载安装 `v0.4.0`，把它作为后续 Electron 自更新的基线。直接替换 `/Applications/Claude Code Haha.app` 不会删除 `~/.claude`、`~/.claude/cc-haha` 或用户选择的便携数据目录。
|
||||
## Notes
|
||||
|
||||
macOS Release 里会同时出现 `.dmg` 和 `.zip`。普通用户手动安装只需要 DMG；ZIP、blockmap 和 `latest-mac.yml` 是后续自动更新需要的文件。
|
||||
- 本版本暂未进行 Apple / Windows 代码签名，首次安装需要手动放行一次（见下方安装说明），这不是文件损坏。
|
||||
- 暂不提供在线自动更新：在拿到 Apple 签名前，请每次到 [GitHub Releases](https://github.com/NanmiCoder/cc-haha/releases) 手动下载新版本覆盖安装。覆盖安装不会删除本地数据（`~/.claude`、`~/.claude/cc-haha` 及自定义便携数据目录）。
|
||||
|
||||
## 下载
|
||||
## 安装
|
||||
|
||||
前往 GitHub Release 下载对应系统和架构的文件：
|
||||
到本页面底部的 Assets 里，按系统和 CPU 架构下载对应文件：
|
||||
|
||||
| 平台 | 推荐下载 |
|
||||
| --- | --- |
|
||||
| macOS Apple Silicon | `Claude-Code-Haha-0.4.0-mac-arm64.dmg` |
|
||||
| 平台 | 文件 |
|
||||
|------|------|
|
||||
| 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` |
|
||||
|
||||
## Windows
|
||||
### macOS
|
||||
|
||||
下载 `Claude-Code-Haha-0.4.0-win-x64.exe` 后双击安装。如果 Windows SmartScreen 提示未知发布者，选择"更多信息"再选择"仍要运行"。
|
||||
> 重要：当前 DMG 未签名，**直接双击会报"已损坏，无法打开"**（系统只给"移到废纸篓"按钮）。这不是文件损坏，按下面任一方式即可正常安装，不要点"移到废纸篓"。
|
||||
|
||||
## Linux
|
||||
推荐用脚本：把 `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：
|
||||
|
||||
@ -47,18 +75,10 @@ chmod +x Claude-Code-Haha-0.4.0-linux-x86_64.AppImage
|
||||
./Claude-Code-Haha-0.4.0-linux-x86_64.AppImage
|
||||
```
|
||||
|
||||
deb：
|
||||
deb（推荐，自动解决依赖与沙箱权限）：
|
||||
|
||||
```bash
|
||||
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`
|
||||
ARM64 机器把文件名换成 `...-linux-arm64.AppImage` / `...-linux-arm64.deb`。
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user