Code Queue Review
3.2 KiB
3.2 KiB
HWLAB Agent Index
HWLAB 是硬件实验室运行面和控制面项目。本文是 agent、指挥官和 runner 进入本仓库时的顶级索引。
Workspace
- Runner 和指挥常用工作区是
/workspace/hwlab；进入仓库先检查分支与工作树状态，详见 docs/reference/commander-collaboration.md。 - D601 发布/构建工作区是
/home/ubuntu/workspace/hwlab；不要把 runner 临时目录当作发布真相，详见 docs/reference/deployment-publish.md。 - 当前一律走 PR 工作流；不要直推
main、不要合并自己的 PR、不要改 PROD。
固定入口
- DEV Cloud Web：
http://74.48.78.17:16666/，规则见 docs/reference/dev-runtime-boundary.md。 - DEV API/edge/live：
http://74.48.78.17:16667/health/live，规则见 docs/reference/dev-runtime-boundary.md。 - Cloud Workbench 默认首页与 UX 约束见 docs/reference/cloud-workbench.md。
长期参考
- 长期参考入口：docs/reference/README.md
- 文档治理规范：docs/reference/documentation-governance.md
- 架构和 M3 主线：docs/reference/architecture.md
- DEV 运行态、端口、k3s 和 DB DNS 边界：docs/reference/dev-runtime-boundary.md
- 部署正规化、镜像发布、回滚和 Cloud Web 路径：docs/reference/deployment-publish.md
- 指挥官协作、PR 和 runner handoff：docs/reference/commander-collaboration.md
- M3 闭环 rollout runbook：docs/reference/m3-loop-rollout-runbook.md
- runner issue 可见性与 prompt handoff：docs/reference/runner-issue-visibility-handoff.md
常用轻量命令
- 静态合同校验：
npm run validate - Cloud Web 静态检查：
npm run web:check - Cloud Web 构建：
npm run web:build - Cloud Web 只读 M3 guard：
npm run web:m3-readonly - DEV artifact preflight：
npm run dev-artifact:preflight - runner GitHub 可见性 preflight：
npm run runner:issue-visibility:preflight - D601 k3s 只读观测：
npm run d601:k3s:readonly
D601 k3s 只读观测
HWLAB DEV runtime 在 D601 原生 k3s；只读诊断或手动发布必须显式使用 /etc/rancher/k3s/k3s.yaml，详见 docs/reference/dev-runtime-boundary.md。
禁止误判
SOURCE、LOCAL、DRY-RUN、fixture 和只读报告不能被称为DEV-LIVE；证据分级见 docs/reference/architecture.md。- Cloud Workbench、Gate、诊断页、发布路径修复都是支撑任务，不等同于 M3 PASS；M3 判定见 docs/reference/m3-loop-rollout-runbook.md。
- UniDesk 只作为调度、CI 或 CD 基础设施，不能替代 HWLAB runtime；运行态边界见 docs/reference/dev-runtime-boundary.md。