对齐文件规范

docs/00-01-k3s-基础概念.md

@@ -2,11 +2,23 @@
 
 > 入门速查：先把核心概念看明白，再去做安装与排障。
 
+## TL;DR
+
+- **本文性质**：概念/术语速查（不对应独立铺栈）
+- **推荐动作**：按 `00-00-构建总览.md` 进入主线；真机验收用 `./scripts/verify.sh full`
+- **成功判据**：能看懂后续文档中的 K3s/K8s 术语（node/pod/service/ingress 等）
+- **排障**：执行类问题请转到对应实验篇（`01-*`/`02-*`/`03-*`）的「排障」
+
 ## 阅读建议
 
 - 新手按本页顺序读完即可
 - 遇到术语不懂，先回这里再继续操作文档
 
+## 排障
+
+- **概念读不懂**：先看 `00-04-部署环境说明.md` 了解本仓库“实验室约定”，再回到本篇对照术语与节点角色。
+- **想跑命令但本篇没有**：本篇不提供部署/验收命令；按 `00-00` 找到对应实验篇，再跑 `./scripts/verify.sh run <doc_id>`。
+
 ## 1. K3s 是什么
 
 - 轻量 Kubernetes 发行版，适合 Homelab。
@@ -116,7 +128,7 @@ K3s 自带 **local-path-provisioner**：当你创建 PVC 且不指定 `storageCl
 - **K3s 不会自动帮你搬本地数据**：调度器只管 Pod 放哪台节点，不会同步 `/var/lib/...` 或自建目录；所以“节点故障自动漂移”和“数据高可用”是两件事，要分别设计。
 - **常见做法**：重要数据用共享存储（NFS / 云盘 / CSI），通过 PV/PVC 给 Pod 用（参考 `01-05`、`03-07`）；缓存、临时文件用本地目录（`emptyDir` 或 `hostPath`），接受节点挂了可丢；或靠备份/同步把本地目录定期同步到别处，再在新节点恢复。
 
-**用途**：搞清楚数据放哪、节点挂了会不会丢，才能设计备份和高可用，不踩坑。
+**用途**：搞清楚数据放哪、节点挂了会不会丢，才能设计备份和高可用，避免常见存储与可用性误区。
 
 ## 9. 删除部署
 
@@ -124,8 +136,8 @@ K3s 自带 **local-path-provisioner**：当你创建 PVC 且不指定 `storageCl
 - **用法**：用部署时的 YAML 删除，与 `apply` 一一对应；或按资源类型和名称逐个删除。
 - **示例**：
   - `kubectl delete -f nginx-matrix.yaml`：删除该文件定义的所有资源
-  - `kubectl delete -f ansible/files/02-05-nginx-matrix/ -R`：递归删除该目录下所有 manifest 定义的资源（02-05 矩阵）
-  - `kubectl delete -f ansible/files/03-02-nginx-matrix-tls/ -R`：删除 03-02 TLS 矩阵（或见该文档 / playbook `nginx-matrix-tls-deploy.yml -e mode=cleanup`）
+  - `kubectl delete -f ansible/files/02-05/ -R`：递归删除该目录下所有 manifest 定义的资源（02-05 矩阵）
+  - `kubectl delete -f ansible/files/03-02/ -R`：删除 03-02 TLS 矩阵（或见该文档 / playbook `03-02.yml -e nginx_matrix_tls_enable=true -e mode=cleanup`）
   - `kubectl delete deployment nginx-m1 -n default`：按名称删除单个 Deployment
 - **用途**：清理测试应用、下线服务、重装部署前先删除旧资源。资源删除后对应 Pod 会被终止，数据（etcd 中记录）一并移除；若用了 PVC，PVC 本身通常需单独删除。