From 338c9319620a4018872a2b98d14afbc49f315d75 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E7=A8=8B=E5=BA=8F=E5=91=98=E9=98=BF=E6=B1=9F=28Relakkes?= =?UTF-8?q?=29?= Date: Wed, 3 Jun 2026 23:53:13 +0800 Subject: [PATCH] docs(release): simplify macOS install back to a single xattr command Real-world testing showed the unsigned app just needs the original 0.3.2 one-liner after the "damaged" prompt (System Settings "Open Anyway" also works). Drop the Sequoia / "don't trash it" / clear-DMG-first / script walkthrough noise and match the historical release-note style. - release-notes/v0.4.0.md: macOS = drag in + `xattr -cr ...`, Windows one line, Linux kept short. - docs/desktop/04-installation.md: same trim, remove duplicated FAQ entry. Co-Authored-By: Claude Opus 4.8 (1M context) --- docs/desktop/04-installation.md | 47 +++++---------------------------- release-notes/v0.4.0.md | 26 ++++-------------- 2 files changed, 12 insertions(+), 61 deletions(-) diff --git a/docs/desktop/04-installation.md b/docs/desktop/04-installation.md index 6e1c8154..5cdecf1c 100644 --- a/docs/desktop/04-installation.md +++ b/docs/desktop/04-installation.md @@ -18,59 +18,30 @@ ## macOS 安装 -> 重要：当前 DMG 未签名，**直接双击会报"已损坏，无法打开"**（系统只给"移到废纸篓"按钮）。这不是文件损坏，按下面任一方式安装即可，不要点"移到废纸篓"。 - -### 方式一：脚本安装（推荐） - -把 Release 资产里的 `install-macos-unsigned.sh` 和对应架构的 DMG 下载到同一目录（如 `~/Downloads`），然后运行： +双击 DMG 把应用拖入 `Applications`。首次打开如果提示**"已损坏"**或**"无法验证开发者"**，在终端执行： ```bash -bash ~/Downloads/install-macos-unsigned.sh +xattr -cr /Applications/Claude\ Code\ Haha.app ``` -脚本会自动解除 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 弹出 **"Windows 已保护你的电脑"**：点击 **「更多信息」** → **「仍要运行」**。 - -> 可选：若系统反复拦截，可在 PowerShell 中去掉文件的"网络来源"标记： -> ```powershell -> Unblock-File -Path "$env:USERPROFILE\Downloads\Claude-Code-Haha-<版本>-win-x64.exe" -> ``` +双击 `.exe` 安装。首次运行如果 SmartScreen 弹出 **"Windows 已保护你的电脑"**，点击 **「更多信息」** → **「仍要运行」**。 ## Linux 安装 -### AppImage（免安装） +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 安装。 +> 提示缺少 FUSE：Ubuntu 22.04 及更早 `sudo apt install libfuse2`，24.04+ `sudo apt install libfuse2t64`。 -### deb（推荐，自动解决依赖与沙箱权限） +deb： ```bash sudo apt install ./Claude-Code-Haha-<版本>-linux-amd64.deb @@ -93,10 +64,6 @@ bun run dev --host 127.0.0.1 --port 2024 ## 常见问题 -**Q: macOS 反复提示"已损坏"或"无法验证开发者"？** - -执行 `xattr -dr com.apple.quarantine "/Applications/Claude Code Haha.app"`（必要时加 `sudo`），或使用上面的一键安装脚本。这是未签名应用被 Gatekeeper 拦截的正常现象，去掉隔离标记后即可正常使用。 - **Q: 这个版本会自动更新吗？** 暂时不会。在拿到苹果签名前，请每次到 [GitHub Releases](https://github.com/NanmiCoder/cc-haha/releases) 手动下载新版本覆盖安装。覆盖安装不会删除本地配置和会话数据（`~/.claude`）。 diff --git a/release-notes/v0.4.0.md b/release-notes/v0.4.0.md index 7633554c..7e8b9b99 100644 --- a/release-notes/v0.4.0.md +++ b/release-notes/v0.4.0.md @@ -38,33 +38,17 @@ ### macOS -> 重要：当前 DMG 未签名，**直接双击会报"已损坏，无法打开"**（系统只给"移到废纸篓"按钮）。这不是文件损坏，按下面任一方式即可正常安装，不要点"移到废纸篓"。 - -推荐用脚本：把 `install-macos-unsigned.sh` 和对应架构的 DMG 下载到同一目录（如 `~/Downloads`），然后运行： +双击 DMG 把应用拖入「应用程序」。首次打开如果提示"已损坏"或"无法验证开发者"，在终端执行： ```bash -bash ~/Downloads/install-macos-unsigned.sh +xattr -cr /Applications/Claude\ Code\ Haha.app ``` -脚本会自动解除 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 已保护你的电脑」时，点「更多信息」→「仍要运行」。 +双击 `.exe` 安装。SmartScreen 提示时点「更多信息」→「仍要运行」。 ### Linux @@ -75,7 +59,7 @@ 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