Lyon
eb710860dd
Merge PR #149 after Code Queue rebase and validation. This lands long-term documentation governance only: Chinese-first documentation, user-feedback triage, docs-spec entry rules, #131 first-source handling, and #78 commander constraints. No PROD/deploy/service changes.
HWLAB 长期参考入口
docs/reference/ 是 HWLAB agent、指挥官和 runner 的长期参考目录，只记录长期稳定、可复用的规则、边界、入口、命令和验收标准。issue、日报、简报、一次性报告和执行流水账只能作为来源，不混入长期参考文档。
参考索引
| 主题 | 参考文档 |
|---|---|
| 中文优先规则 | chinese-first-documentation.md |
| 用户反馈分流规则 | user-feedback-triage.md |
| 文档治理与 docs-spec 入库规则 | documentation-governance.md |
| 架构和 M3 上位约束 | architecture.md |
| DEV 运行态、端口、k3s、DB DNS 和环境边界 | dev-runtime-boundary.md |
| 部署正规化、artifact 发布、回滚和 Cloud Web rollout | deployment-publish.md |
| Cloud Workbench 默认界面和 UX 边界 | cloud-workbench.md |
| 指挥官/runner 协作、PR 和 prompt handoff | commander-collaboration.md |
| M3 闭环 rollout runbook | m3-loop-rollout-runbook.md |
| runner GitHub 可见性与 prompt handoff | runner-issue-visibility-handoff.md |
当前稳定来源
- pikasTech/HWLAB#7：指挥官看板、优先级顺序和当前 issue 状态；用户反馈必须挂到这里的醒目位置。
- pikasTech/HWLAB#78：
DC-DCSN-P0-2026-003，M3 虚拟硬件可信闭环方向和上位约束。 - pikasTech/HWLAB#121：issue 和长期文档中文化要求。
- pikasTech/HWLAB#122：用户和参谋反馈默认按高优先级用户反馈处理，并挂到
#7。 - pikasTech/HWLAB#123：docs-spec 规则必须固化进 HWLAB 长期参考文档。
- pikasTech/HWLAB#99：Cloud Workbench 默认前端方向。
- pikasTech/HWLAB#108：禁止外层页面纵向滚动、中文 UI 和内部 Markdown 帮助页。
- pikasTech/HWLAB#61：DEV 手动 rollout 复盘，以及走向 CLI 加
deploy/deploy.json自动化的路径。 - pikasTech/HWLAB#109：文档治理和长期参考体系。
- pikasTech/HWLAB#116：服务部署正规化三阶段：长期参考、受控 CLI/脚本入口、UniDesk CI/CD 加镜像化交付。
当 issue、报告或旧文档与本目录 reference 文档冲突时，先更新 reference 文档，再让 AGENTS.md 保持短索引。过程记录不得被改写；只能把稳定结论蒸馏进这里。