From f77367c5260fbbb1b1c5f52ed9d9cacf8da36a82 Mon Sep 17 00:00:00 2001
From: pikastech <liang6516@outlook.com>
Date: Tue, 21 Jul 2026 13:57:30 +0200
Subject: [PATCH] =?UTF-8?q?fix:=20=E4=BF=AE=E6=AD=A3=20HWPOD=20L1=20?=
 =?UTF-8?q?=E9=A1=B5=E9=9D=A2=E9=AA=8C=E6=94=B6=E9=85=8D=E7=BD=AE?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 config/hwlab-node-lanes.yaml | 38 ++++++++++++++++++++++++++++++++++--
 docs/reference/hwlab.md      |  4 ++++
 2 files changed, 40 insertions(+), 2 deletions(-)

diff --git a/config/hwlab-node-lanes.yaml b/config/hwlab-node-lanes.yaml
index d79b0ae0..e2f293f0 100644
--- a/config/hwlab-node-lanes.yaml
+++ b/config/hwlab-node-lanes.yaml
@@ -1007,10 +1007,44 @@ templates:
           screenshotName: native-hwpod-ready.png
           layout:
             requireNoDocumentOverflow: true
-            requireNoMainContentOverflow: false
+            requireNoMainContentOverflow: true
             mainContentSelector: .platform-content
             internalScrollSelectors:
-              - .platform-content
+              - .bounded-workspace-main
+          outputLimits:
+            errors: 20
+            failedResponses: 20
+            textPreviewChars: 160
+        hwpod-onboarding:
+          application: hwpod
+          authentication: none
+          path: /hwpods/onboarding
+          navigationTimeoutMs: 30000
+          settleMs: 700
+          commandTimeoutSeconds: 120
+          viewport:
+            width: 1920
+            height: 1080
+          readySelectors:
+            - "[data-testid='hwpod-console']"
+            - .platform-sidebar
+          minBodyTextLength: 40
+          interaction:
+            selector: .desktop-sidebar-toggle
+            observedSelector: .platform-sidebar
+            observedAttribute: data-collapsed
+          failedResponseStatus: 400
+          criticalPathPrefixes:
+            - /v1/hwpod
+            - /v1/hwlab-node
+            - /health/ready
+          screenshotName: native-hwpod-onboarding-ready.png
+          layout:
+            requireNoDocumentOverflow: true
+            requireNoMainContentOverflow: true
+            mainContentSelector: .platform-content
+            internalScrollSelectors:
+              - .bounded-workspace-main
           outputLimits:
             errors: 20
             failedResponses: 20
diff --git a/docs/reference/hwlab.md b/docs/reference/hwlab.md
index e6cced72..5e56d9e0 100644
--- a/docs/reference/hwlab.md
+++ b/docs/reference/hwlab.md
@@ -125,6 +125,10 @@ HWLAB v0.2/v0.3 仓库内 `docs/reference/spec-*`，以及已收编的 `cloud-wo
     - 不得成为 L1 启动、执行或完成条件；
   - 浏览器验收统一使用
     `bun scripts/cli.ts web-probe native-readiness --node <node> --lane <lane> --profile hwpod`；
+  - 节点接入页专项验收使用同一受控入口的 `hwpod-onboarding` profile：
+    - 固定访问 `/hwpods/onboarding`；
+    - 把 `/v1/hwlab-node` 纳入关键失败响应；
+    - 要求 AppShell 主内容不滚动，只允许 `.bounded-workspace-main` 内部滚动；
   - HWPOD Web 无业务登录页时，由 owning YAML profile 声明 `authentication: none`，不得改用临时 Playwright 脚本或弱化浏览器错误断言。
   - native API 已接受操作且 Temporal workflow 已创建时，后续公共
     `/v1/hwpod-node-ops` 失败必须分类为外部 Cloud API 或 node 运行面故障，