用途:在本地统一控制远程 GPU 集群,避免手写原始 ssh 命令。所有命令经守护进程 Unix socket,通过持久 SSH 转发到集群侧 agent.py,官方称约 0.1 秒/命令延迟。
主要能力:单节点执行 rca exec -n train "nvidia-smi",支持 -d 指定目录、-t 超时、--stdin heredoc 规避转义;多节点并行 rca batch;节点状态 rca nodes、--check、--health、connect/disconnect;文件传输 rca cp(经 agent 的 JSON-Lines 通道,base64 编码,单文件 50 MB 上限,约 2–3 MB/s);流式与长任务 rca exec -s;集群健康巡检用 rca batch 并行采样 nvidia-smi、df、uptime 等。
使用方式:先 which rca 检查,未安装则 cd <skill_dir> 后 make install(需 Go 1.21+),再 rca config init;在 ~/.config/rca/config.toml 的 [nodes.*] 写入各节点 ssh 命令,可选 dir 与 agent_path;随后 rca daemon start、rca daemon status、rca nodes、rca agent check(缺失时 rca agent deploy)。macOS 可用 rca daemon register 注册 launchd 自启。
适用场景:远程训练启动、GPU/节点巡检、日志与结果读取、依赖安装、进程管理。读取文件内容应优先用本地 Read 工具(若已配置 mutagen 实时同步),执行操作才用 rca exec。
限制与注意:rca 不管理隧道/VPN/跳板机,连接失败需自行恢复;大文件建议用共享文件系统或对象存储;无公网时用内部 PyPI 镜像;不要自动推送 master/main;pkill -f 需用方括号技巧避免误杀 SSH;长任务须 nohup 或 tmux 后台化。守护进程崩溃可 rca daemon start 重启。其余细节暂未提供。