docs: 固化 HWLAB 概念展示原则

docs/reference/hwlab.md

@@ -40,6 +40,36 @@ HWLAB v0.2/v0.3 仓库内 `docs/reference/spec-*`，以及已收编的 `cloud-wo
 
 重大规划型 issue 必须执行 P0 SPEC-first：P0 阶段先在 UniDesk OA `project-management/PJ2026-01/specs/` 维护对应 SPEC，确认 SPEC 编号、上级/关联规格、架构图、数据流图、关键时序图和代码引用规则，再进入后续实现。该 issue 范围内新增或修改的源码文件头部必须标注遵循的 SPEC 编号、短名和实现引用版本；自动生成、vendored、纯配置、锁文件或不能承载注释头的二进制产物可例外，但对应生成器、渲染器或配置入口必须能追溯到 SPEC。issue 正文和评论只承载执行计划、讨论和证据，不替代长期 SPEC。
 
+## 概念展示与执行可见性
+
+- HWLAB 概念展示必须从 UniDesk OA 的总规格、Agent 编排、客户端和硬件池边界出发，不从既有 Web 页面布局反推产品定义。
+  - 展示页用于解释稳定产品能力和研发闭环，不承担第二份需求规格。
+  - 页面中的任务、工具动作、硬件事实、证据和裁决必须能追溯到 OA 规格中的对应能力。
+  - 一次性演示故事、截图、端口、提交和运行记录只保留在 issue 或项目过程材料中。
+- AGENT 必须是研发过程的主语，不能把固定 CI/CD 流水线或代码差异冒充 AGENT 参与过程。
+  - 每个关键阶段应展示观察事实、可审计假设、决策摘要、工具调用、输出事实和下一步。
+  - 不展示原始思维链，不用拟人化长篇解释替代可验证的行动与证据。
+  - 代码差异是 AGENT 行动的结果，只在对应修改节点或检查器中展开。
+- 执行过程优先使用可交互的空间执行图表达。
+  - AGENT 的观察、假设、计划、裁决和复诊应作为独立节点。
+  - Keil、CMSIS-DAP、UART、ioProbe 等能力应作为 AGENT 选择调用的工具或硬件节点。
+  - 节点与连线必须投影排队、运行、通过、失败、阻断和跳过状态。
+  - 通过和失败必须形成真实分支；物理验证失败后应生成新假设，并明确回环到下一轮诊断入口。
+  - 节点检查器应提供有界输入、决策摘要、工具调用、输出事实、证据引用和必要的代码差异。
+- 真实硬件和数字孪生只负责提供物理现场与测量事实，视觉权重不得压过 AGENT 主舞台。
+  - 板卡、调试器、探针、线缆和仪器应保持可辨识的真实硬件关系。
+  - 空间波形、设备线框、深度网格和测量 HUD 可以增强混合现实表达，但不能遮挡设备身份或伪造测量结果。
+  - AGENT 调用 Flash、UART 或物理测量时，执行节点应与对应设备产生同步状态响应。
+- 证据链必须把任务、Agent Trace、Patch、Build、Flash、UART、Physical 和 Verdict 关联起来。
+  - 物理测量通过前不得展示 Aggregate PASS 或允许封存回归 Case。
+  - 物理测量失败时必须拒绝封存，展示 Aggregate BLOCKED，并暴露下一诊断目标。
+  - 浏览器中的动画、标签和演示状态只能表达预先声明的故事或真实后端事实，不能把本地状态冒充运行面证据。
+- 纯前端概念展示可以使用独立静态目录和轻量 HTTP 服务，但必须保持展示资产与生产运行面解耦。
+  - 静态页面不得增加后端接口、伪造 API 响应或引入不必要的框架依赖。
+  - 公网展示必须验证 HTML、关键图片和交互资产均可从外部网络读取。
+  - 需要持续托管时应使用受监督、可重启的服务管理器；一次性 shell 子进程或普通 `nohup` 不能作为长期在线证据。
+  - 验收至少覆盖桌面、紧凑桌面和移动端，无文档级横向溢出、无关键内容重叠、无浏览器控制台错误，并支持 `prefers-reduced-motion`。
+
 ## DEV 入口
 
 - 当前入口必须从 `config/hwlab-node-lanes.yaml#lanes.v03.targets.NC01` 读取，不从长期文档硬编码推断。