首次 npx ruflo init 很慢、npx 缓存约 2GB（磁盘敏感环境）

你会遇到什么

第一次 npx ruflo init 要等约 5 分钟，而且磁盘占用突然变大——一查 ~/.npm/_npx 涨到 1.2GB+，加上全局缓存合计约 2GB 级。这不是 ruflo 本体大，而是 npx -y 的缓存机制 + 原生 prebuild 下载叠出来的体积。

本文路径：快速修复（30 秒一段命令）→ 一步步排查（可跳读）→ 原理与变体（症状/原因/证据）。赶时间直接跳到「快速修复」。

为什么会这样

先给结论：慢在「首次下载」，大在「npx 缓存双份」。

链路：npx -y ruflo ... → 从 registry 拉包 → 包内原生 prebuild 下载 → 全部落进 ~/.npm/_npx 缓存。断点/放大点：npx -y 每次运行都把包解到缓存（隔离 HOME 与全局各一份：2026-08-29 实测 1.2GB + 775MB），原生预构建下载占大头（2026-08-27 基线约 5 分钟、约 1.6GB）。

实测（2026-08-29，）：npmmirror init 成功（v3.38.20），全程秒级下载完成——慢的确定性部分被换源消掉了；缓存体积仍在。

推论：慢 → 换 npmmirror（确定性收益）；大 → 验证完清缓存（rm -rf ~/.npm/_npx，不影响已装项目）。磁盘敏感环境（CI/容器/小盘 VPS）两招一起用。

一步步来

1. 换源安装 — 必做

npm_config_registry=https://registry.npmmirror.com 前缀重跑 init；实测从约 5 分钟降到秒级。

2. 减下载面 — 必做

--no-signup --no-skills-sh --no-codex-detect 跳过交互、注册与技能全量拉取（267 个技能按需再装）。

3. 清理缓存 — 按场景

磁盘敏感：rm -rf ~/.npm/_npx 或 npm cache clean --force；只清缓存，不动已装项目。

4. 核对写面 — 排查

init 会写工作区 .claude/、.claude-flow/、.swarm/ 等 + HOME ~/.claude/CLAUDE.md；--help 会拉起后台 daemon，测完 ruflo daemon stop。

怎么确认修好了

• init 快速完成（换源后秒级下载）；
• ruflo --version 输出版本；
• du -sh ~/.npm/_npx 在你接受的范围（清缓存后回落）。

其它环境的表现

• CI / 容器：缓存体积直接影响镜像层大小，建议装机即清或挂缓存卷；
• 小盘 VPS：2GB 级占用要预留；

症状

npx ruflo init 首次安装约 5 分钟，磁盘占用明显变大。

原因

原生 prebuild 下载 + npx 缓存双份：2026-08-29 实测隔离 HOME 下 ~/.npm/_npx 1.2GB + 全局 ~/.npm/_npx 775MB（合计约 2GB 级），npx -y 每次运行都落缓存。

解法

1. 国内加速：npm_config_registry=https://registry.npmmirror.com npx -y ruflo ...（实测 init 全程秒级下载完成）。
2. 磁盘敏感：安装验证完清理 npx 缓存（rm -rf ~/.npm/_npx 或 npm cache clean --force），不影响已装项目。
3. init 用 --no-signup --no-skills-sh --no-codex-detect 跳过交互、注册与技能全量拉取，减少下载面。