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

程序员阿江(Relakkes) c2cd615824 docs: rebuild the documentation site around two readers

The site had drifted from the product. Every screenshot predated the
v0.5.0 UI redesign, the reading experience shipped no search and no
syntax highlighting, and a third of the pages were internal process
artefacts — migration task lists addressed to agentic workers, a
release runbook, a proposal marked "historical".

Reorganise around the only two people who read this: someone getting
the desktop app running for the first time, and someone reading the
source. Five sections replace nine — start / desktop / im / cli /
internals — and the pages that served neither reader are gone.

Site rewrite:

- Palette lifted from the desktop app's 「纸·墨·印」 themes, so the
  site and the product read as one thing. Light mirrors 纯白, dark
  mirrors 墨夜, and dark mode exists at all now.
- Fonts are self-hosted. The old @import from Google Fonts is
  unreachable from mainland China, which left every heading in a
  fallback serif; it also only requested weight 600 while the CSS
  asked for 900, so Latin and CJK in the same heading disagreed.
- Docs were shipped as one 968KB manifest downloaded on every page
  view. Split into a 32KB index plus one lazily imported chunk per
  page; the entry bundle is now 101KB gzipped.
- Add search, syntax highlighting, per-route meta with canonical and
  hreflang, a sitemap, and an error boundary. Replace the 44vh
  mobile sidebar with a drawer.
- Image dimensions are read at build time and written into the tag,
  so lazy images reserve their space instead of collapsing.

Screenshots are recaptured from a real v0.5.0 build against a clean
demo project, with tokens, QR codes and paired accounts redacted.
The previous set is deleted rather than kept alongside.

Routes follow file paths, so the restructure would have broken every
inbound link; 37 old paths redirect, in both languages. The PR policy
gate and CODEOWNERS also hardcoded docs/guide/contributing.md.

Verified: check:docs 78 pages / 323 links / 0 problems, check:policy
127 pass. Walked every route at 1440 and 390 in both themes for
overflow, contrast, keyboard reachability and focus management.

2026-07-27 17:32:41 +08:00

5.1 KiB

Raw Blame History

title	nav_title	description	order
下载与安装	下载与安装	macOS、Windows、Linux 三个平台的安装包，以及系统拦截时的处理办法。	1

下载与安装

装完就能用，不需要另外安装 Node.js、Python 或 Claude Code——CLI 内核和文件搜索用的 ripgrep 都已经打进安装包里了。

挑对安装包

所有安装包都在 GitHub Releases，按系统和 CPU 架构选一个：

你的系统	下载
macOS，M 系列芯片	`Claude-Code-Haha-<版本>-mac-arm64.dmg`
macOS，Intel 芯片	`Claude-Code-Haha-<版本>-mac-x64.dmg`
Windows x64	`Claude-Code-Haha-<版本>-win-x64.exe`
Windows ARM64	`Claude-Code-Haha-<版本>-win-arm64.exe`
Linux x64	`Claude-Code-Haha-<版本>-linux-x86_64.AppImage` 或 `-linux-amd64.deb`
Linux ARM64	`Claude-Code-Haha-<版本>-linux-arm64.AppImage` 或 `-linux-arm64.deb`

不确定自己是哪种架构：macOS 看「关于本机」里的芯片型号，Windows 看「设置 → 系统 → 系统信息」里的系统类型。别只凭机器牌子猜。

.blockmap 和 latest*.yml 是应用自动更新用的，不用手动下载。

macOS

双击 DMG。
把 Claude Code Haha 拖进「应用程序」。
从「应用程序」打开。

如果提示「已损坏，无法打开」

这不是文件坏了。macOS 会给从网上下载的安装包打一个隔离标记（quarantine），遇到没有 Apple 签名的应用就直接拒绝启动，报错文案偏偏写成「已损坏」。经过签名和公证的正式版本不会有这一步；如果你拿到的是未签名构建，用下面两种办法之一放行。

办法一：用官方脚本（推荐）

从同一个 Release 里把 install-macos-unsigned.sh 下载到和 DMG 同一个文件夹（比如「下载」），然后在终端里跑：

cd ~/Downloads
bash install-macos-unsigned.sh

脚本会自动挑对架构的 DMG、挂载、把应用装进 /Applications、清掉隔离标记再打开。已有的旧版本会先移到废纸篓，不会直接覆盖。

办法二：手动清隔离标记

已经把应用拖进「应用程序」了，就直接执行：

xattr -dr com.apple.quarantine "/Applications/Claude Code Haha.app"

只对你确认来自本仓库 Release 的安装包这么做。来路不明的应用不要绕过 Gatekeeper。

Windows

先把正在运行的旧版本完全退出，包括系统托盘里的图标。
双击 .exe 安装。
不要右键选「以管理员身份运行」——安装器是给当前用户装的，用管理员身份反而会让数据目录对不上。

未签名的安装包会触发 SmartScreen 蓝屏提示。确认文件确实来自本仓库 Release 后，点「更多信息」→「仍要运行」。

覆盖升级时安装器会检查旧安装目录里的用户数据。如果它提示「程序仍在运行」，退出主窗口和托盘图标，等几秒让后台的 sidecar、终端和 IM adapter 退干净，再重新运行安装器。别先手动删掉旧安装目录。

Linux

AppImage（免安装，下载即用）：

chmod +x Claude-Code-Haha-<版本>-linux-x86_64.AppImage
./Claude-Code-Haha-<版本>-linux-x86_64.AppImage

启动失败并提示 FUSE 相关错误时，装一下运行库：Ubuntu 22.04 及更早用 sudo apt install libfuse2，24.04 及以后用 libfuse2t64。

deb（装进系统菜单）：

sudo apt install ./Claude-Code-Haha-<版本>-linux-amd64.deb

ARM64 机器换成对应的 linux-arm64 文件。

从源码跑

想改代码、调试内核，或者只想在终端里用 CLI，可以从源码起：

git clone https://github.com/NanmiCoder/cc-haha.git
cd cc-haha
bun install
cp .env.example .env
./bin/claude-haha

需要 Bun 和 Git。这条路只跑 CLI，桌面端的构建方式和本地服务参数见命令行。

升级

应用内更新（推荐）。 打开「设置 → 关于 → 应用更新」，点「检查更新」。它会比对当前版本和 GitHub Releases 上的最新版本，有新版就下载，下载完提示「安装并重启」。

更新前先把正在跑的会话停掉，未提交的代码存好。

下载卡住不动，多半是网络到不了 GitHub。同一个面板里有「高级更新代理」，可以切成系统代理或填一个本地 HTTP 代理地址（例如 http://127.0.0.1:7890）。这个代理只管应用自己的更新下载，不影响模型请求。

手动换包。 从 Releases 下新版安装包，按上面各平台的步骤重装一遍即可。会话、服务商配置、技能、Agent、记忆都存在 ~/.claude 下，不在应用目录里，覆盖安装不会动它们。

:::warning 安装器的数据保护不等于备份。真正重要的东西请自己另存一份。 :::

装完之后

去连接模型服务。没接模型之前，应用能打开，但发不出任何一条消息。

装不上或者打不开，看装不上 / 打不开 / 连不上。

5.1 KiB Raw Blame History Unescape Escape