对齐文件规范

docs/05-02-onenav首页面板.md

@@ -2,6 +2,14 @@
 
 > OneNav 运行在集群外（如 armv7 主机），通过 K3s Traefik 做静态转发接入。
 
+
+## TL;DR
+
+- **自动化验收**：`./scripts/verify.sh run 05-02`
+- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
+- **成功判据**：达到本文「预期」且 playbook 断言通过
+- **排障**：见本文「排障」
+
 ---
 
 ## 在 armv7 部署 OneNav
@@ -19,12 +27,12 @@ docker run -d --name onenav \
 
 ## 在 K3s 做静态转发
 
-**唯一真源**：[`ansible/files/05-02-onenav/onenav-proxy.yaml`](../ansible/files/05-02-onenav/onenav-proxy.yaml)（修改 `Endpoints` IP 与 `Ingress` host）。
+**唯一真源**：[`ansible/files/05-02/onenav-proxy.yaml`](../ansible/files/05-02/onenav-proxy.yaml)（修改 `Endpoints` IP 与 `Ingress` host）。
 
 应用方式：
 
 ```bash
-kubectl apply -f ansible/files/05-02-onenav/onenav-proxy.yaml
+kubectl apply -f ansible/files/05-02/onenav-proxy.yaml
 ```
 
 ---
@@ -43,3 +51,8 @@ curl -I --max-time 3 http://192.168.2.61/
 - `05-01-k3s-部署homer首页面板.md`
 - `03-04-k3s-cloudflare-tunnel-配置接入.md`
 
+## 排障
+
+- **先看 playbook 输出**：失败时先定位是 deploy/wait/http_check 哪一步。
+- **集群侧总览**：`kubectl get nodes -o wide`、`kubectl -n kube-system get pods -o wide`。
+- **事件与日志**：`kubectl -n <ns> describe ...`、`kubectl -n <ns> logs ... --tail=200`。