本资料介绍 OpenRig 跨主机（cross-host）rig 命令的使用方式。核心是：使用已注册的主机地址，并采用该条目声明的传输方式。SSH 条目通过单跳 shell 运行远程 CLI；HTTP 条目使用远程守护进程。两条路径的前置条件和命令覆盖范围不同，执行重要操作前应先查看具体命令的帮助和目标安装状态。
选择与检查目标：rig host list 列出已注册主机；rig host add --help 说明注册表写入；rig host doctor --help 说明可达性检查。应检查实际配置的 OpenRig home，而不是假定默认为 ~/.openrig/hosts.yaml。注册表要求 hosts 数组、唯一且非空的 id、受支持的 transport。SSH 需要非空 target，user 与 notes 可选；HTTP 需要 URL，且 bearer_env 与 bearer_file 至多其一，两者都省略对无令牌目标是合法的。已配置但不可用的 bearer 属于权限失败，不会匿名回退。id 还有保留名校验。
寻址操作：协调类命令如 rig send … --host、rig capture、rig ps --host … --nodes --json、rig whoami --host，会依据注册表条目选择 SSH 或 HTTP，失败时不会静默改用另一传输。队列写入使用显式 --host 或受支持的主机限定目标，不跟随持久化的主机选择；不同队列子命令标志不同，应查帮助。本地成功消息不等于远程持久化或已被取用。
按失败层级排查：registry-load-failed/unknown-host 查注册表路径与条目；ssh-unreachable 查 SSH 连接与目标；permission-gate 查凭据与目标策略；remote-daemon-unreachable 查监听与守护进程身份；remote-outcome-unknown 表示请求可能已到达，重试前先核对其实际效果；remote-command-not-found 查远程 CLI 安装；remote-command-failed 看远程操作自身状态。不要仅因诊断提示就启动或替换远程守护进程。超时的写入可能已到达目的地，重试前应先核对持久效果。
验证与归属：传输成功不等于投递验证或代理消费。SSH 转发 --verify 并返回远程 CLI 结果；HTTP 保留远程传输判定，并明确报告本地 pane 效果检查未跨主机运行。跨主机输出会标明 host/target，JSON 信封携带 cross_host 元数据。目标的主机后缀选择目的地，发送方来源标识回复归属；当前 send 从执行席位上下文推导发送方，而非调用方 --from 声明。本资料描述已实现的命令路径，不证明你的安装上存在真实远程旅程。