Crabbox 是面向代理技能的远程证明（remote proof）工具，用于在本地测试和 PR CI 之外补足覆盖缺口，例如其他操作系统或设备、真实 provider 与 channel、长时间 E2E、重量级基准测试。常规流程是 PR CI 作为默认的广覆盖证明，先跑聚焦的本地测试与 lint/typecheck/format，全部通过后开就绪 PR；仅在 CI 或本地覆盖有缺口时才申请 Box，且必须先准备好命令、获得即时授权。
主要能力：可移植的 provider 路由、租约（lease）管理、同步、命令执行与清理。provider 使用包括 blacksmith-testbox（可信维护者源加预置 CI，前缀 tbx_）、aws（直接代理执行、新 PR、自定义同步/环境/捕获，前缀 cbx_）、local-container（已配置的本地 Docker，非远程证明）、ssh（既有运维主机，用于 macOS/Windows/WSL2）。通常省略 --provider，仅在明确要求或证明需要后端语义时覆盖。
使用方式：从仓库根目录先选定可信的已安装二进制，例如执行 export CRABBOX="$(command -v crabbox)"、test -n "$CRABBOX"、"$CRABBOX" --version、"$CRABBOX" config show --json 与 "$CRABBOX" run --help，并读取 .crabbox.yaml 及解析后的配置。Testbox 场景还需检查 blacksmith 可用。执行命令示例："$CRABBOX" run --timing-json -- CI=1 <check-command>；多条命令可先 warmup --keep 保存 id，用 run --id 复用，最后 stop。一个租约同一时间只跑一条活动命令。
授权与隔离：常规配置使用（创建/复用/停止任务所属租约、临时状态、干净检出）无需单独批准，但必须保留用户的检出、分支和无关修改，不得在本地或已注入凭据的 Testbox 上执行不可信仓库包装器/配置；不可信 AWS 执行前需遵循完整不可信配方。实时凭据需精确 key、单条命令、安全注入，禁止打印密钥或写入仓库文件。
限制：缺失命令或配置不得编造；同步超时不等于测试结果；Testbox 原生 status 无 --json；委派 Testbox 拒绝 --fresh-pr、--full-resync、--script*、--env-helper 及捕获/下载标志；Crabbox stop 不接受 --timing-json。官方资料未提供具体定价、版本或平台支持细节，暂未提供。