对齐文件规范

docs/05-08-openclaw-k3s-实验部署.md

@@ -3,6 +3,14 @@
 > **实验性文档**：尝试将 OpenClaw Gateway 直接以 Deployment/Service/Ingress 的形式运行在 K3s 中。  
 > 官方推荐的方式仍是 **Docker / Docker Compose 部署**（参考 `05-07-openclaw应用部署.md` 与官方文档），本篇仅供有 K8s 经验的读者实验与参考。
 
+
+## TL;DR
+
+- **自动化验收**：`./scripts/verify.sh run 05-08`
+- **关键前置**：按本文「前置条件」准备环境变量/Secret/入口 IP
+- **成功判据**：达到本文「预期」且 playbook 断言通过
+- **排障**：见本文「排障」
+
 ## 前置条件
 
 - 已完成基础集群安装：`01-01`、`01-02`
@@ -42,14 +50,14 @@ docker push registry.local/openclaw:local
 
 下面是一个**高度简化的实验性 Deployment/Service/Ingress 示例**，其目标只是让你能在集群内/通过 Traefik 访问 OpenClaw Gateway 控制界面。
 
-**唯一真源**：[`ansible/files/05-08-openclaw/openclaw-k3s-experimental.yaml`](../ansible/files/05-08-openclaw/openclaw-k3s-experimental.yaml)（实验用；替换镜像与域名）。
+**唯一真源**：[`ansible/files/05-08/openclaw-k3s-experimental.yaml`](../ansible/files/05-08/openclaw-k3s-experimental.yaml)（实验用；替换镜像与域名）。
 
 > 说明：示例使用 `emptyDir`；若要持久化请改为 PVC/hostPath。
 
 应用部署：
 
 ```bash
-kubectl apply -f ansible/files/05-08-openclaw/openclaw-k3s-experimental.yaml
+kubectl apply -f ansible/files/05-08/openclaw-k3s-experimental.yaml
 ```
 
 ---
@@ -97,6 +105,11 @@ curl -I --max-time 5 http://openclaw-k3s.example.com/
 
 ## 下一步
 
-- 若你验证了本实验方案在自己的环境中稳定可用，可以在 `00-02-验证矩阵.md` 中为本篇补充状态与备注（注明镜像版本、节点架构与日期）。  
+- 若你验证了本实验方案在自己的环境中稳定可用，建议在本篇文档中补充验证备注（注明镜像版本、节点架构与日期）。  
 - 返回 `00-00-构建总览.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`。