HWLAB Agent Index

HWLAB 是硬件实验室运行面和控制面项目。本文是 agent、指挥官和 runner 进入本仓库时的顶级索引。

Git 和 Workspace

指挥官在主机侧固定使用 /workspace/hwlab，分支固定为 main。开始任何开发、文档或调度审阅前执行 git status 和 git pull --ff-only origin main。
D601 上的部署/构建副本固定为 /home/ubuntu/workspace/hwlab。通过 UniDesk 执行：bun scripts/cli.ts ssh D601 'cd /home/ubuntu/workspace/hwlab && git pull --ff-only origin main'。
D601 上 /home/ubuntu/hwlab 可能是 Code Queue runner 或并行任务工作区，不能当作发布真相，也不能由指挥官清理、reset 或临时复用。
PR 冲突由指挥官审查和合并；runner 不应承担复杂冲突合并。无法干净合并的 PR 应由指挥官判断手动合并、关闭重做或拆分。

项目 README 与冻结服务 ID：README.md
操作与验收总 runbook：docs/operator-runbook.md
Cloud Workbench 用户界面契约：docs/cloud-web-workbench.md
DEV 构建与发布镜像：docs/dev-artifact-publish.md
DEV apply / k3s 滚动发布：docs/dev-deploy-apply.md
M3 闭环 rollout runbook：docs/reference/m3-loop-rollout-runbook.md
runner issue 可见性与 prompt handoff：docs/reference/runner-issue-visibility-handoff.md

HWLAB 的真实 DEV runtime 在 D601 原生 k3s。所有手动诊断和发布必须显式使用：

KUBECONFIG=/etc/rancher/k3s/k3s.yaml kubectl -n hwlab-dev get deploy,svc,pod -o wide

不要使用默认 kubectl context 作为判断依据。D601 默认 context 可能是 docker-desktop，这会产生与公网入口无关的误导性状态。

已验证的手动路径记录在 docs/dev-deploy-apply.md 的 Cloud Web 发布章节。关键点：

先更新 D601 /home/ubuntu/workspace/hwlab 到 origin/main。
hwlab-cloud-web 必须先运行 node web/hwlab-cloud-web/scripts/build.mjs 刷新 dist，否则镜像 runtime 会优先服务旧 dist。
镜像发布使用 node scripts/dev-artifact-publish.mjs --publish --services hwlab-cloud-web。
滚动发布使用 D601 原生 k3s 的 kubectl set image 和 rollout status。
公网验收必须检查 16666/health/live revision、HTML 语言/标题和 CSS 外层滚动锁定。

SOURCE、LOCAL、DRY-RUN、fixture 和只读报告不能被称为 DEV-LIVE。
Cloud Workbench、Gate、诊断页、发布路径修复都是支撑任务，不等同于 M3 PASS。
真正 M3 DEV-LIVE 必须证明 res_boxsimu_1:DO1 -> hwlab-patch-panel -> res_boxsimu_2:DI1，并带有 operation、audit、evidence 链。