style(docs): standardize heading formats and numbering

- Enforce Level 1-3 structural numbering based on SUMMARY.md hierarchy
- Remove structural numbering from Level 4+ headings
- Eliminate single child headings by converting to bold text
- Auto-inject summary text for headings with multiple children missing intro text
- Exclude Appendix chapters from structural numbering
- Avoid modifying code block contents
- Add script to detect non-standard English usage in headers

12_kubernetes_concepts/advanced.md

@@ -1,8 +1,8 @@
-## Kubernetes 高级特性
+## 12.4 Kubernetes 高级特性
 
 掌握了 Kubernetes 的核心概念 (Pod，Service，Deployment) 后，我们需要了解更多高级特性以构建生产级应用。
 
-### Helm - 包管理工具
+### 12.4.1 Helm - 包管理工具
 
 [Helm](https://helm.sh/) 被称为 Kubernetes 的包管理器 (类似于 Linux 的 apt/yum)。它将一组 Kubernetes 资源定义文件打包为一个 **Chart**。
 
@@ -10,7 +10,7 @@
 *   **版本管理**：轻松回滚应用的发布版本。
 *   **模板化**：支持复杂的应用部署逻辑配置。
 
-### Ingress - 服务的入口
+### 12.4.2 Ingress - 服务的入口
 
 Service 虽然提供了负载均衡，但通常是 4 层 (TCP/UDP)。**Ingress** 提供了 7 层 (HTTP/HTTPS) 路由能力，充当集群的网关。
 
@@ -20,7 +20,7 @@ Service 虽然提供了负载均衡，但通常是 4 层 (TCP/UDP)。**Ingress**
 
 常见的 Ingress Controller 有 Nginx Ingress Controller，Traefik，Istio Gateway 等。
 
-### Persistent Volume 与 StorageClass
+### 12.4.3 Persistent Volume 与 StorageClass
 
 容器内的文件是临时的。对于有状态应用 (如数据库)，需要持久化存储。
 
@@ -28,7 +28,7 @@ Service 虽然提供了负载均衡，但通常是 4 层 (TCP/UDP)。**Ingress**
 *   **PV (Persistent Volume)**：实际的存储资源 (NFS，AWS EBS，Ceph 等)。
 *   **StorageClass**：定义存储类，支持动态创建 PV。
 
-### Horizontal Pod Autoscaling
+### 12.4.4 Horizontal Pod Autoscaling
 
 HPA 根据 CPU 利用率或其他指标 (如内存、自定义指标) 自动扩缩 Deployment 或 ReplicaSet 中的 Pod 数量。
 
@@ -53,7 +53,7 @@ spec:
         averageUtilization: 50
 ```
 
-### ConfigMap 与 Secret
+### 12.4.5 ConfigMap 与 Secret
 
 *   **ConfigMap**：存储非机密的配置数据 (配置文件、环境变量)。
 *   **Secret**：存储机密数据 (密码、Token、证书)，在 Etcd 中加密存储。

12_kubernetes_concepts/concepts.md

@@ -1,4 +1,4 @@
-## 基本概念
+## 12.2 基本概念
 
 如图 12-2 所示，Kubernetes 由控制平面与工作节点构成。
 
@@ -17,7 +17,7 @@
 * web 界面 (`ux`)：用户可以通过 web 界面操作 Kubernetes。
 * 命令行操作 (`cli`)：`kubectl` 命令。
 
-### 节点
+### 12.2.1 节点
 
 在 `Kubernetes` 中，节点是实际工作的点，节点可以是虚拟机或者物理机器，依赖于一个集群环境。每个节点都有一些必要的服务以运行容器组，并且它们都可以通过主节点来管理。必要服务包括 Docker，kubelet 和代理服务。
 
@@ -69,7 +69,7 @@ Kubernetes 校验节点可用依赖于 ID。在当前的版本中，有两个接
 
 节点控制有一个同步轮询，主要监听所有云平台的虚拟实例，会根据节点状态创建和删除。可以通过 `--node_sync_period` 标志来控制该轮询。如果一个实例已经创建，节点控制将会为其创建一个结构。同样的，如果一个节点被删除，节点控制也会删除该结构。在 Kubernetes 启动时可用通过 `--machines` 标记来显示指定节点。同样可以使用 `kubectl` 来一条一条的添加节点，两者是相同的。通过设置 `--sync_nodes=false` 标记来禁止集群之间的节点同步，你也可以使用 api/kubectl 命令行来增删节点。
 
-### 容器组
+### 12.2.2 容器组
 
 在 Kubernetes 中，使用的最小单位是容器组，容器组是创建，调度，管理的最小单位。一个容器组使用相同的 Docker 容器并共享卷 (挂载点)。一个容器组是一个特定应用的打包集合，包含一个或多个容器。
 
@@ -179,30 +179,30 @@ Kubernetes 校验节点可用依赖于 ID。在当前的版本中，有两个接
   * 节点控制器标记容器组 `failed`
   * 如果容器组运行在一个控制器下，容器组将会在其他地方重新创建
 
-### Replication Controllers
+### 12.2.3 Replication Controllers
 
 > 注：Replication Controller (RC) 是早期的控制器类型，现代 Kubernetes 更推荐使用 ReplicaSet/Deployment。
 
-### 服务
+### 12.2.4 服务
 
 > 注：服务 (Service) 定义一组 Pod 的逻辑集合和访问它们的策略。
 
-### 卷
+### 12.2.5 卷
 
 > 注：卷 (Volume) 包含可被 Pod 中容器访问的数据的目录。
 
-### 标签
+### 12.2.6 标签
 
 > 注：标签 (Label) 是附加到对象 (如 Pods) 上的键值对，用于组织和选择对象子集。
 
-### 接口权限
+### 12.2.7 接口权限
 
 > 注：接口权限通过认证、授权和准入控制来保护 Kubernetes API 的访问。
 
-### web 界面
+### 12.2.8 web 界面
 
 > 注：Kubernetes Dashboard 是一个基于 Web 的用户界面，用于管理集群。
 
-### 命令行操作
+### 12.2.9 命令行操作
 
 > 注：kubectl 是 Kubernetes 的命令行工具，用于与集群进行交互。

12_kubernetes_concepts/design.md

@@ -1,8 +1,8 @@
-## 架构设计
+## 12.3 架构设计
 
 任何优秀的项目都离不开优秀的架构设计。本小节将介绍 Kubernetes 在架构方面的设计考虑。
 
-### 基本考虑
+### 12.3.1 基本考虑
 
 如果让我们自己从头设计一套容器管理平台，有如下几个方面是很容易想到的：
 
@@ -11,7 +11,7 @@
 * 一套资源调度系统，管理哪个容器该分配到哪个节点上；
 * 一套对容器内服务进行抽象和 HA 的系统。
 
-### 运行原理
+### 12.3.2 运行原理
 
 如图 12-3 所示，该图完整展示了 Kubernetes 的运行原理。
 
@@ -25,7 +25,7 @@
 
 从这张图上，我们没有能发现 Kubernetes 中对于控制平面的分布式实现，但是由于数据后端自身就是一套分布式的数据库 Etcd，因此可以很容易扩展到分布式实现。
 
-### 控制平面
+### 12.3.3 控制平面
 
 控制平面 (Control Plane) 是 Kubernetes 集群的大脑，负责做出全局决策 (如调度) 以及检测和响应集群事件。
 
@@ -45,7 +45,7 @@
 
 组件可以自动的去侦测 Etcd 中的数值变化来获得通知，并且获得更新后的数据来执行相应的操作。
 
-### 工作节点
+### 12.3.4 工作节点
 
 * kubelet 是工作节点执行操作的 agent，负责具体的容器生命周期管理，根据从数据库中获取的信息来管理容器，并上报 pod 运行状态等；
 * kube-proxy 是一个简单的网络访问代理，同时也是一个 Load Balancer。它负责将访问到某个服务的请求具体分配给工作节点上的 Pod (同一类标签)。

12_kubernetes_concepts/intro.md

@@ -1,4 +1,4 @@
-## Kubernetes 简介
+## 12.1 Kubernetes 简介
 
 如图 12-1 所示，Kubernetes 使用舵手图标作为项目标识。
 
@@ -6,7 +6,7 @@
 
 图 12-1 Kubernetes 项目标识
 
-### 什么是 Kubernetes
+### 12.1.1 什么是 Kubernetes
 
 Kubernetes (常简称为 K8s) 是 Google 开源的容器编排引擎。如果说 Docker 解决了 “如何打包和运送集装箱” 的问题，那么 Kubernetes 解决的就是 “如何管理海量集装箱的调度、运行和维护” 的问题。
 
@@ -16,7 +16,7 @@ Kubernetes (常简称为 K8s) 是 Google 开源的容器编排引擎。如果说
 
 ---
 
-### 为什么需要 Kubernetes
+### 12.1.2 为什么需要 Kubernetes
 
 当我们在单机运行几个容器时，Docker Compose 就足够了。但在生产环境中，我们需要面对：
 
@@ -30,7 +30,7 @@ Kubernetes 完美解决了这些问题。
 
 ---
 
-### 核心概念
+### 12.1.3 核心概念
 
 本节涵盖了相关内容与详细描述，主要探讨以下几个方面：
 
@@ -56,7 +56,7 @@ Kubernetes 的最小调度单位。一个 Pod 可以包含一个或多个紧密
 
 ---
 
-### Docker 用户如何过渡
+### 12.1.4 Docker 用户如何过渡
 
 如果你已经熟悉 Docker，学习 K8s 会很容易：
 
@@ -69,7 +69,7 @@ Kubernetes 的最小调度单位。一个 Pod 可以包含一个或多个紧密
 
 ---
 
-### 架构
+### 12.1.5 架构
 
 Kubernetes 也是 C/S 架构，由 **Control Plane (控制平面)** 和 **Worker Node (工作节点)** 组成：
 
@@ -78,7 +78,7 @@ Kubernetes 也是 C/S 架构，由 **Control Plane (控制平面)** 和 **Worker
 
 ---
 
-### 学习建议
+### 12.1.6 学习建议
 
 Kubernetes 的学习曲线较陡峭。建议的学习路径：
 
@@ -89,7 +89,7 @@ Kubernetes 的学习曲线较陡峭。建议的学习路径：
 
 ---
 
-### 延伸阅读
+### 12.1.7 延伸阅读
 
 - [Minikube 安装](../setup/README.md)：本地体验 K8s
 - [Kubernetes 官网](https://kubernetes.io/)：官方文档

12_kubernetes_concepts/practice.md

@@ -1,14 +1,14 @@
-## Kubernetes 实战练习
+## 12.5 Kubernetes 实战练习
 
 本章将通过一个具体的案例：部署一个 Nginx 网站，并为其配置 Service 和 Ingress，来串联前面学到的知识。
 
-### 目标
+### 12.5.1 目标
 
 1.  部署一个 Nginx Deployment。
 2.  创建一个 Service 暴露 Nginx。
 3.  (可选) 通过 Ingress 访问服务。
 
-### 步骤 1：创建 Deployment
+### 12.5.2 步骤 1：创建 Deployment
 
 创建一个名为 `nginx-deployment.yaml` 的文件：
 
@@ -42,7 +42,7 @@ spec:
 kubectl apply -f nginx-deployment.yaml
 ```
 
-### 步骤 2：创建 Service
+### 12.5.3 步骤 2：创建 Service
 
 创建一个名为 `nginx-service.yaml` 的文件：
 
@@ -75,7 +75,7 @@ kubectl get svc nginx-service
 
 如果输出端口是 `80:30080/TCP`，你可以通过 `http://<NodeIP>:30080` 访问 Nginx。
 
-### 步骤 3：模拟滚动更新
+### 12.5.4 步骤 3：模拟滚动更新
 
 修改 `nginx-deployment.yaml`，将镜像版本改为 `nginx:1.27-alpine`。
 
@@ -89,7 +89,7 @@ kubectl apply -f nginx-deployment.yaml
 kubectl rollout status deployment/nginx-deployment
 ```
 
-### 步骤 4：清理资源
+### 12.5.5 步骤 4：清理资源
 
 练习结束后，记得清理资源：