用途:面向 Capsem 新开发者的快速入门指引,回答“如何开始”“首次安装配置”之类问题;若用于环境故障排查,应改用 dev-setup 技能。
主要能力:给出最快上手路径:先执行 git clone <repo> && cd capsem,再运行 ./bootstrap.sh(交互式,每次安装前提示 [Y/n])或 ./bootstrap.sh --yes(非交互,适合 CI/无人值守),最后用 just exec "echo hello" 验证虚拟机能否启动。bootstrap.sh 是仓库根目录的公开引导入口,分三个阶段:先检查硬性前置 bash、git、curl,自动安装 rustup 与 just(置于 ~/.local/bin);再安装依赖,Linux 侧包括发行版原生构建/Tauri 包、cpio、校验过的 Node 24、pnpm 10、Docker + Buildx、Bubblewrap 及当前会话的 Docker/KVM 访问权限,macOS 侧通过 Homebrew 安装 flock、colima + docker + docker-buildx、Tart 与 sshpass;两平台均安装 uv、锁定版本的 Python/前端依赖并验证运行时。随后 doctor --fix 安装 Rust 目标与配置指定的 Cargo 工具(cargo-nextest、cargo-llvm-cov、cargo-audit、b3sum、cargo-tauri、cargo-sbom),构建 VM 资产并打包 initrd。
使用方式:所有提示默认回答为 Yes,回车即安装,输入 n 跳过;--yes 与非 TTY 输入均自动接受全部提示。引导完成后,所有 just 配方会检查 .dev-setup,缺失时自动运行 doctor,因此不会跳过初始化。
适用场景:首次搭建 Capsem 开发环境、新成员环境准备、CI 无人值守初始化。
限制:容器运行时建议 12GB 以上内存(推荐 16GB,Tauri 安装测试构建在 12GB 以下会 OOM)。VM 资产轨道会在自身架构匹配的 helper 内生成 digest 固定的 OBOM 工具,不要另行安装全局 cdxgen。详细配置与故障排查见 Development Guide 或 /dev-setup 技能,just 配方参考 /dev-just,测试流程见 /dev-testing。