SuperAPI AI 工具集

rch

通用与其它

查看项目

更新于 10-16 08:35

技能介绍

用途:rch 把本地编译命令透明卸载到远程 worker:守护进程挑选健康 worker、rsync 同步工作区、执行构建、回传产物,并以 worker 的退出码结束。它通过 Claude Code 的 PreToolUse 钩子拦截,其他 agent/shell 则经托管的 cargo shim。

主要能力:提供 rch check 检查就绪状态(0 就绪/1 降级/2 未就绪)、rch status、rch workers probe、rch hook status、rch shim status、rch admit 只读预检、rch diagnose --dry-run、rch self-test、rch doctor、rch --robot-triage --json 等命令;支持证据化远程执行:RCH_REQUIRE_REMOTE=1 rch exec -- cargo check --workspace --all-targets;支持任务模式、base 快照、结果目录、机器可读 NDJSON 输出。提供错误码与恢复剧本(references/ERROR_CODES.md、RECOVERY_PLAYBOOKS.md 等)。

使用方式:单条命令可用 RCH_VISIBILITY=verbose <命令> 2>&1 | grep -E '^[RCH]' 查看卸载结果;按 Fast Triage Order 依次排查可用性、配置与 socket、拦截、分类准入、远程编译验证。常用修复:rch hook install、rch shim install、rch daemon start、rch workers discover --add --yes && rch workers setup --all。

适用场景:本地编译慢、需在多台机器间分发构建、需要可证明的远程执行或非编译远程任务(分片、fuzz、bench)。

限制与须知:缺省可见性为 none,需自行设置 summary;带 os 声明的 worker 才能处理对应目标平台;本地故意构建需在 .rch/config.toml 设 [general] force_local = true 并配合 RCH_CARGO_WRAPPER_BYPASS=1;shell 包裹的 cargo 链会被拒绝(RCH-E301)。优先级与槽位应基于持久化的 SpeedScore 测量而非猜测。RABS 侧车在资料所述版本中为可选且仅影子模式。资料未提供许可、价格或平台支持范围等信息。

(依据 remote_compilation_helper main @ b5c0566、工作区 v1.0.58 资料整理,其他细节暂未提供。)