SuperAPI AI 工具集

blacksmith-testbox

通用与其它

查看项目

更新于 10-16 03:06

技能介绍

用途:Testbox 适用于需要远程 CI 环境一致性的场景,例如需要注入密钥、托管服务、CI-only 运行器或本地无法廉价提供的操作系统/运行时镜像。不要把它当作每次本地测试/构建循环的默认选择;仓库若有文档化的本地命令,应优先使用本地命令以保留热缓存和快速反馈。Testbox 是昂贵路径,应有意识地使用。

主要能力:预热后获得远程 CI 环境,可通过 ID 复用;支持运行命令、下载产物、查看状态、列出与停止实例。ClawHub 维护者可通过设置 CLAWHUB_TESTBOX=1 启用 Testbox 优先验证(仅维护者、需 Blacksmith 访问权限)。启用后应尽早预热、对宽泛的 Bun 检查、e2e、Convex 部署一致性、包证明及昂贵验证优先使用 Testbox,并在同一任务/会话中复用同一 Testbox ID。

安装与认证:curl -fsSL https://get.blacksmith.sh | sh。canary 通道:BLACKSMITH_CHANNEL=canary sh -c 'curl -fsSL https://get.blacksmith.sh | sh'。认证:blacksmith auth login。代理触发浏览器认证需非交互模式且必须带 organization:blacksmith auth login --non-interactive --organization <org-slug>。

常用操作:预热:blacksmith testbox warmup ci-check-testbox.yml --ref main --idle-timeout 90。认领:bun run testbox:claim -- --id <ID>。运行:blacksmith testbox run --id <ID> "<command>",或 ClawHub 包装器 bun run testbox:run -- --id <ID> -- bun run lint。健全检查:bun run testbox:sanity -- --id <ID>。下载:blacksmith testbox download --id <ID> <remote-path> [local-path]。状态等待:blacksmith testbox status --id <ID> --wait --wait-timeout 5m。停止:blacksmith testbox stop --id <ID>。

限制与注意:必须始终从 git 仓库根目录调用 testbox 命令,CLI 使用 rsync --delete 同步当前工作目录,从子目录运行可能删除远程其他内容;若在子目录,先 cd "$(git rev-parse --show-toplevel)"。.gitignore 的目录不同步,依赖目录由预热流程提供;若修改 package.json 或 bun.lock,需在 box 内重新运行安装。run 命令会自动等待就绪,无需 sleep 轮询。本地认领标记不会自动删除,包装器将超过 12 小时的认领视为过期,可用 CLAWHUB_TESTBOX_CLAIM_TTL_MINUTES 覆盖。代理崩溃时依赖 Blacksmith 空闲超时回收。GitHub 仅在默认分支存在工作流文件后才暴露 workflow_dispatch,新工作流仅在特性分支时预热可能返回 404。