diff --git a/docs/reference/hwlab.md b/docs/reference/hwlab.md index 400c5471..ca991d05 100644 --- a/docs/reference/hwlab.md +++ b/docs/reference/hwlab.md @@ -101,6 +101,16 @@ HWLAB v0.2/v0.3 仓库内 `docs/reference/spec-*`,以及已收编的 `cloud-wo - 当前 lane 入口: - development `NC01/v03` 前端/API 入口为 `https://lab-dev.hwpod.com`; - production release lane `NC01/production` 的正式入口为 `https://lab.hwpod.com`。 +- HWPOD L1 Native 是独立于 Cloud Web 的运行面: + - API、Temporal worker、Web、固定端口和公网入口必须从 `config/hwlab-node-lanes.yaml#lanes..targets..nativeDevelopment.hwpod` 读取; + - 启停和状态统一使用 `hwlab nodes native-development hwpod api|worker|web`; + - 公网验收统一使用 `web-probe native-readiness --node --lane --profile hwpod`; + - HWPOD Web 无业务登录页时,由 owning YAML profile 声明 `authentication: none`,不得改用临时 Playwright 脚本或弱化浏览器错误断言。 +- Windows HWPOD-NODE 的连接入口和制品入口属于不同合同: + - WebSocket 注册入口来自节点 YAML 的桌面连接配置; + - 更新元数据和 Python 制品下载入口来自同一节点 YAML graph 的 artifact 配置; + - HTTP health 或制品下载成功不能证明 WebSocket Upgrade 可用; + - 恢复节点时必须以 `hwlab nodes hwpod-node status` 同时证明交互进程、配置指纹和 cloud registration。 - 两个产品入口分别声明内部 NodePort `32009` 与 `32010`,公网 hostname、upstream 和 healthPath 由同一产品 exposure 对象唯一声明。 - NC01 共享 `public-edge` 只允许通过 `configRef/path` 消费产品 exposure,不得复制 hostname、upstream 或形成第二 authority。 - HWLAB Cloud Web/Workbench 的最终 web-probe 证据必须来自 PR 合并并经 CI/CD/GitOps/Argo 部署后的公网入口;本地 fake-server、localhost dist、临时 `--url` 和源码/API preflight 只能证明开发面,不得作为关闭用户入口 issue 或声明上线成功的替代证据。所有浏览器操作只经 `web-probe`,禁止直接调用 Playwright;公网 web-probe 发现问题时继续修复 PR 或运行面,再重新部署复测。