Merge branch 'feat/hwpod-web-workspace-ops'

.agents/skills/unidesk-hwpod-ops/SKILL.md

@@ -44,7 +44,9 @@ description: >-
   - 受控 CLI 缺失时先实现 CLI，不把手工部署当临时完成态。
 - 调查可只读访问现场；发生以下变更时加载对应 skill：
   - 安装、注册、更新、停止旧运行器或修改 MDTODO 来源：`$unidesk-daddev`；
-  - 部署/发布：同时加载 `$unidesk-cicd`；
+  - L2/L3 部署或发布：同时加载 `$unidesk-cicd`；
+  - L1 native API、worker、Web 和 Windows desktop node 的启动、恢复与回归不加载、
+    不依赖 `$unidesk-cicd` 或 Kubernetes；
   - YAML 变更：同时加载 `$unidesk-ymalops`。
 - 远端操作走 `$unidesk-trans`。普通 `trans` 保持短连接；图形进程不得作为透传子进程长挂。
 - Python 节点可用性：
@@ -118,6 +120,12 @@ POWERSHELL
   - 解析目标交互用户的 Windows `python.exe`；
   - 安装文件并应用 YAML 声明的登录自启动策略；
   - nodeId、地址、工作区和重连/更新设置不得硬编码进生成的辅助代码。
+- Windows UART backend 由 HWPOD spec 的 YAML 字段选择：
+  - `serial-monitor` 是默认 backend；
+  - 目标机已有 `pyserial` 且 serial-monitor server 不可用时，可对该 spec 显式声明
+    `backend: pyserial`，不得改成全局隐式回退；
+  - compiler 必须把同一 backend 对称传入 `open`、`read`、`write`、`close` 四类 plan；
+  - `pyserial` 节点在四步操作之间持有同一串口连接，回归结束必须执行 `close`。
 - 证明节点状态：
   - 单一执行权威；
   - 预期版本/nodeId 和注册；

docs/reference/hwlab.md

@@ -135,6 +135,11 @@ HWLAB v0.2/v0.3 仓库内 `docs/reference/spec-*`，以及已收编的 `cloud-wo
   - 真实 Windows workspace、Keil build 和硬件操作必须通过 API host 上的 L1
     native API 路由到目标 HWPOD-NODE；
   - L0 workspace 和 bounded build 使用当前 host 的 disposable fixture 验证。
+- HWPOD Windows UART backend：
+  - backend 由 owning HWPOD spec 的 YAML 字段选择，默认使用 `serial-monitor`；
+  - 单个目标节点可显式选择 `pyserial`，禁止在代码中增加全局自动回退；
+  - compiler 必须将 backend 对称写入 `open`、`read`、`write`、`close` 四类 node plan；
+  - `pyserial` 节点在操作序列间持有同一连接，回归无论成功或失败都以 `close` 收尾。
 - HWPOD runtime spec 的持久化边界：
   - L0、L1 和 L2 development 共用 owning YAML 声明的 development host PostgreSQL；
   - L3 production 使用 production owning YAML 声明的 host PostgreSQL；