From 3ac868527c2677e716bdc1c03dc27406e93163c5 Mon Sep 17 00:00:00 2001 From: pikastech Date: Tue, 21 Jul 2026 11:14:31 +0200 Subject: [PATCH] docs: clarify HWPOD L1 UART operations --- .agents/skills/unidesk-hwpod-ops/SKILL.md | 10 +++++++++- docs/reference/hwlab.md | 5 +++++ 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/.agents/skills/unidesk-hwpod-ops/SKILL.md b/.agents/skills/unidesk-hwpod-ops/SKILL.md index 06fe2d81..2e113b2d 100644 --- a/.agents/skills/unidesk-hwpod-ops/SKILL.md +++ b/.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 和注册； diff --git a/docs/reference/hwlab.md b/docs/reference/hwlab.md index 969b6191..324e92d0 100644 --- a/docs/reference/hwlab.md +++ b/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；