pikasTech-HWLAB/AGENTS.md

HWLAB Agent 顶级索引

HWLAB 是硬件实验室运行面和控制面项目。本文是 agent、指挥官和 runner 进入本仓库时的顶级索引，只放入口、一句话规则和长期参考链接；细则统一维护在 docs/reference/。

工作区

• Runner 和指挥常用工作区是 /workspace/hwlab；进入仓库先检查分支与工作树状态，详见 docs/reference/commander-collaboration.md。
• D601 发布/构建工作区是 /home/ubuntu/workspace/hwlab；不要把 runner 临时目录当作发布真相，详见 docs/reference/deployment-publish.md。
• 当前一律走 PR 工作流；不要直推 main、不要合并自己的 PR、不要改 PROD、不要重启服务。
• DC-DCSN-P0-2026-003 / pikasTech/HWLAB#78 是当前 M3 虚拟硬件可信闭环的上位约束；其他任务不得把 SOURCE、LOCAL、DRY-RUN、fixture 或前端状态误报为 M3 DEV-LIVE。

固定入口

• 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/chinese-first-documentation.md
• 用户反馈分流规则：docs/reference/user-feedback-triage.md
• 文档治理与 docs-spec 本地权威：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
• Code Agent 对话就绪与真实回复判定：docs/reference/code-agent-chat-readiness.md
• MVP E2E 验收测试与带编号测试报告 issue 规则：docs/reference/MVP-e2e-acceptance.md
• 指挥官协作、PR 和 runner 交接：docs/reference/commander-collaboration.md
• M3 闭环发布运行手册：docs/reference/m3-loop-rollout-runbook.md
• runner issue 可见性与 prompt 交接：docs/reference/runner-issue-visibility-handoff.md

工作优先级

• 中文优先：issue、PR 正文、长期参考文档和用户可见说明默认用中文；英文术语只在命令、协议、接口、ID、路径和标准名需要保真时保留，详见 docs/reference/chinese-first-documentation.md。
• 用户反馈优先：用户和参谋提出的问题默认按高优先级用户反馈处理，blocker 状态不能替代反馈分流，必须挂到 pikasTech/HWLAB#7 醒目位置，详见 docs/reference/user-feedback-triage.md。
• docs-spec 本地权威优先：涉及 AGENTS.md、docs/reference/*.md 或过程文档蒸馏时，先按 docs/reference/documentation-governance.md 执行，不另建同级规则副本。
• PR 工作流优先：从最新 origin/main 创建短分支，提交 PR 到 pikasTech/HWLAB:main，runner 不直推 main、不合并 PR、不改 PROD、不重启服务，详见 docs/reference/commander-collaboration.md。

常用轻量命令

• 静态合同校验：npm run validate
• Cloud Web 静态检查：npm run web:check
• Cloud Web 构建：npm run web:build
• Cloud Web M3 只读护栏：npm run web:m3-readonly
• Cloud Workbench 布局/遮挡 smoke：npm run web:layout；local-build 用 npm run web:layout:build；DEV deploy 后用 npm run web:layout:live。
• DEV artifact 发布预检：npm run dev-artifact:preflight
• DEV CD 单事务发布/应用/验证：npm run dev-cd:apply
• runner GitHub 可见性预检：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。