用途:RCH Setup 用于配置远程编译环境,将 cargo build、bun test、gcc 等构建与测试命令卸载到远程 worker 执行,对用户透明——命令保持不变,构建更快。适用于搭建远程编译、添加构建机器、排查 rch doctor 问题等场景。
主要能力:提供 rch doctor 诊断与自动修复;通过 workers.toml 配置 worker(id、host、user、identity_file、total_slots、priority、tags);支持从 SSH config 自动发现 worker;可探测 worker 能力与工具链;安装 hook 拦截命令;运行 rchd 守护进程。
使用方式:先检查依赖 which rustup rsync zstd;安装 cargo install --path rch(或在仓库根目录用 --path .);创建 ~/.config/rch/workers.toml;执行 rch hook install;启动 rchd & 或 systemctl --user start rchd;最后用 rch doctor 验证全部检查通过。常用命令包括 rch doctor --fix、rch workers discover --from-ssh-config --dry-run、rch workers probe worker1 --verbose、rch workers list --capabilities。
限制与注意:所有 rch doctor 检查必须通过后才能使用;SSH 失败可用 eval $(ssh-agent) && ssh-add ~/.ssh/your_key 修复;守护进程异常可 rm -f /tmp/rch.sock && rchd &;hook 缺失用 rch hook install --force。可用 RCH_DRY_RUN=1 cargo check 在不远程执行的情况下测试。更多细节见 WORKERS.md、TROUBLESHOOTING.md、HOOKS.md。具体平台支持与收费信息暂未提供。