# HWLAB Agent Index

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

## Workspace

- Runner 和指挥常用工作区是 `/workspace/hwlab`；进入仓库先检查分支与工作树状态，详见 [docs/reference/commander-collaboration.md](docs/reference/commander-collaboration.md)。
- D601 发布/构建工作区是 `/home/ubuntu/workspace/hwlab`；不要把 runner 临时目录当作发布真相，详见 [docs/reference/deployment-publish.md](docs/reference/deployment-publish.md)。
- 当前一律走 PR 工作流；不要直推 `main`、不要合并自己的 PR、不要改 PROD。

## 固定入口

- DEV Cloud Web：`http://74.48.78.17:16666/`，规则见 [docs/reference/dev-runtime-boundary.md](docs/reference/dev-runtime-boundary.md)。
- DEV API/edge/live：`http://74.48.78.17:16667/health/live`，规则见 [docs/reference/dev-runtime-boundary.md](docs/reference/dev-runtime-boundary.md)。
- Cloud Workbench 默认首页与 UX 约束见 [docs/reference/cloud-workbench.md](docs/reference/cloud-workbench.md)。

## 长期参考

- 长期参考入口：[docs/reference/README.md](docs/reference/README.md)
- 文档治理规范：[docs/reference/documentation-governance.md](docs/reference/documentation-governance.md)
- 架构和 M3 主线：[docs/reference/architecture.md](docs/reference/architecture.md)
- DEV 运行态、端口和 k3s 边界：[docs/reference/dev-runtime-boundary.md](docs/reference/dev-runtime-boundary.md)
- 部署正规化、镜像发布、回滚和 Cloud Web 路径：[docs/reference/deployment-publish.md](docs/reference/deployment-publish.md)
- 指挥官协作、PR 和 runner handoff：[docs/reference/commander-collaboration.md](docs/reference/commander-collaboration.md)
- M3 闭环 rollout runbook：[docs/reference/m3-loop-rollout-runbook.md](docs/reference/m3-loop-rollout-runbook.md)
- runner issue 可见性与 prompt handoff：[docs/reference/runner-issue-visibility-handoff.md](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](docs/reference/dev-runtime-boundary.md)。

## 禁止误判

- `SOURCE`、`LOCAL`、`DRY-RUN`、fixture 和只读报告不能被称为 `DEV-LIVE`；证据分级见 [docs/reference/architecture.md](docs/reference/architecture.md)。
- Cloud Workbench、Gate、诊断页、发布路径修复都是支撑任务，不等同于 M3 PASS；M3 判定见 [docs/reference/m3-loop-rollout-runbook.md](docs/reference/m3-loop-rollout-runbook.md)。
- UniDesk 只作为调度、CI 或 CD 基础设施，不能替代 HWLAB runtime；运行态边界见 [docs/reference/dev-runtime-boundary.md](docs/reference/dev-runtime-boundary.md)。