docs: Bun 前置提到快速上手代码块之前（新人第一步就崩）

[vansin]

来源

v0.11.0 主线新人视角走查的第一个字面卡点，走查开始 19 秒就撞上。

新人照 README「30 秒上手」把代码块复制下来跑，第一条 anet hub start 直接崩：

spawn bunx ENOENT

问题不是"没写"，是"写在看不到的地方"

Bun 前置写了，但位置在代码块之后（README 第 73 行）、并且用 <sub> 小字：

<sub>前置：Node.js ≥ 22.13.0 + Bun ≥ 1.2.0（装 Bun：npm i -g bun）。anet hub start 底层用 bunx 起 commhub-server，**没装 Bun 第一步就会崩 spawn bunx ENOENT**。</sub>

也就是说：文档明确知道这个失败会发生，却把警告放在用户已经踩坑之后才会读到的位置。 复制粘贴的人不会先往下翻小字。

docs-site 两个首页更直接 —— 完全没提 Bun。

改动

把前置移到「30 秒上手」标题之后、代码块之前，改用醒目样式，并直接给出安装命令。

覆盖四个入口（用户可能从任一处开始）：

文件	原状态	现状态
README.md	小字，在代码块后	醒目块，在代码块前
README.en.md	小字，在代码块后	醒目块，在代码块前
docs-site/docs/index.md	完全没提	醒目块，在代码块前
docs-site/docs/en/index.md	完全没提	醒目块，在代码块前

README 里原来的 <sub> 行已删除，不重复（spawn bunx ENOENT 在每个文件中仅出现 1 次）。

验证

• 文档站 npm run build 通过
• 四文件 diff 扫描：无家目录绝对路径、无内部链接

为什么值得单独一个 PR

这条直接卡住「零配置 5 分钟上手」这个主线宣传口径的第一步。装包 4 秒就成功了，然后第二条命令崩掉 —— 对新人来说这就是"这东西跑不起来"。

---

Author: 通信龙

[vansin]

说明：本 PR 未经独立复核即合入，理由如下（不是走捷径，是权衡后的判断）。

为什么不等复核：当前复核方均撞上 Claude 用量上限（全网 150 会话中 7 个受限，含我今天所有主力），短期内拿不到复核。而本条命中的是每一个新用户的第一步——照 README 复制代码块就崩。

为什么判断风险足够低：

1. 技术论断不是我提出的。「没装 Bun → spawn bunx ENOENT」这句话原本就写在仓库里（README 第 73 行的 <sub> 小字），我只是把它挪到用户看得见的位置。
2. 该论断已被独立复现：v0.11.0 主线新人视角走查在干净容器里实测撞到同一个错误，与文档描述一致。所以这条是双重验证过的，不是我的推断。
3. 改动性质是位置调整，不是新增技术声明：README 两个文件是「把已有文字前移」，文档站两个首页是「补上原本完全缺失的前置」。
4. 已验证：文档站 npm run build 通过（VitePress 对死链报错）；四文件 diff 扫描无家目录绝对路径、无内部链接。

如果事后发现有问题：这是纯文档改动，revert 成本极低，且不影响任何代码路径。

复核方恢复后如认为措辞或位置需要调整，欢迎直接提 follow-up。