feat: 加入 TiDB 全面支持，新增 6 个 TiDB 分布式优化案例 (v1.7.0)

基础设施:
- docker-compose.yml 新增 TiDB 集群（PD + TiKV + TiDB 三容器，端口 4000）
- run-case.sh 新增 --ver tidb 支持
- validate-sql.yml CI 矩阵新增 TiDB 验证

新增分类「八、TiDB 分布式优化」6 个案例:
- 81 · TiDB EXPLAIN 算子树解读 — MySQL vs TiDB EXPLAIN 对照
- 82 · 协处理器下推优化 — cop[tikv] vs root task
- 83 · AUTO_RANDOM 避免写热点 — 分布式 ID 消除单 Region 瓶颈
- 84 · TiDB 统计信息管理 — ANALYZE / 健康度 / stale stats
- 85 · TiDB 事务模型对比 — 乐观事务 vs 悲观事务
- 86 · IndexLookUp 回表与覆盖索引 — Build→Probe 两阶段

文档更新:
- config.ts / HomeFeatures.vue / README / cases/index 同步更新
- 首页统计: 7→8 场景, 80→86 案例
- new-case.sh 脚手架支持 tidb 分类

Author: slowleelab

.github/workflows/validate-sql.yml

@@ -2,43 +2,68 @@ name: 验证 SQL 案例
 on:
   push:
     branches: [main, master]
-    paths: ['sql/**', 'scripts/**']
+    paths: ['sql/**', 'scripts/**', 'docker-compose.yml']
   pull_request:
-    paths: ['sql/**', 'scripts/**']
+    paths: ['sql/**', 'scripts/**', 'docker-compose.yml']
 
 jobs:
   validate:
     runs-on: ubuntu-latest
     strategy:
+      fail-fast: false
       matrix:
-        mysql-version: ['5.7', '8.0']
+        mysql-version: ['5.7', '8.0', 'tidb']
     steps:
       - uses: actions/checkout@v4
 
-      - name: 启动 MySQL ${{ matrix.mysql-version }}
+      - name: 启动 ${{ matrix.mysql-version == 'tidb' && 'TiDB 集群' || format('MySQL {0}', matrix.mysql-version) }}
         run: |
           if [[ "${{ matrix.mysql-version }}" == "5.7" ]]; then
             docker compose up -d mysql57
             PORT=3307
-          else
+            for i in $(seq 1 60); do
+              docker exec sql-treasure-mysql57 mysqladmin ping -h localhost -proot &>/dev/null && break
+              sleep 2
+            done
+          elif [[ "${{ matrix.mysql-version }}" == "8.0" ]]; then
             docker compose up -d mysql80
             PORT=3308
+            for i in $(seq 1 60); do
+              docker exec sql-treasure-mysql80 mysqladmin ping -h localhost -proot &>/dev/null && break
+              sleep 2
+            done
+          else
+            # TiDB: 启动整个集群（pd → tikv → tidb）
+            docker compose up -d pd tikv tidb
+            # 等待 TiDB SQL 层就绪（从宿主机通过 4000 端口连接）
+            echo "等待 TiDB 集群就绪..."
+            for i in $(seq 1 120); do
+              if mysql -h 127.0.0.1 -P 4000 -uroot -e "SELECT 1" &>/dev/null; then
+                echo "TiDB 已就绪"
+                break
+              fi
+              [[ $i -eq 120 ]] && { echo "::error::TiDB 启动超时"; docker compose logs tidb; exit 1; }
+              sleep 2
+            done
           fi
-          # 等待就绪
-          for i in $(seq 1 60); do
-            docker exec sql-treasure-mysql$(echo ${{ matrix.mysql-version }} | tr -d '.') mysqladmin ping -h localhost -proot &>/dev/null && break
-            sleep 2
-          done
 
       - name: 验证所有案例的 SQL 语法
         run: |
-          PORT=$( [[ "${{ matrix.mysql-version }}" == "5.7" ]] && echo 3307 || echo 3308 )
           FAIL=0
           for case_dir in sql/cases/*/; do
             case_name=$(basename "$case_dir")
-            echo "::group::验证案例: $case_name (MySQL ${{ matrix.mysql-version }})"
+
+            # TiDB 只验证专属案例（编号 81+）
+            if [[ "${{ matrix.mysql-version }}" == "tidb" ]]; then
+              case_num=$(echo "$case_name" | grep -o '^[0-9]*')
+              if [[ -z "$case_num" || "$case_num" -lt 81 ]]; then
+                continue
+              fi
+            fi
+
+            echo "::group::验证案例: $case_name (${{ matrix.mysql-version }})"
             if ! ./scripts/run-case.sh "$case_name" --ver ${{ matrix.mysql-version }}; then
-              echo "::error::案例 $case_name 在 MySQL ${{ matrix.mysql-version }} 上运行失败"
+              echo "::error::案例 $case_name 在 ${{ matrix.mysql-version }} 上运行失败"
               FAIL=1
             fi
             echo "::endgroup::"

CHANGELOG.md

@@ -1,5 +1,28 @@
 # 更新日志
 
+## v1.7.0 (2026-07-28)
+
+### 新增
+
+- **加入 TiDB 全面支持**，案例总数从 80 增至 86
+- **新增分类「八、TiDB 分布式优化」**（6 个案例）：
+  - 81 · TiDB EXPLAIN 算子树解读 — 从 MySQL EXPLAIN 到 TiDB 树形算子的过渡指南
+  - 82 · 协处理器下推优化 — cop[tikv] vs root task 的执行位置差异
+  - 83 · AUTO_RANDOM 避免写热点 — 分布式 ID 替代 AUTO_INCREMENT 消除单 Region 写入瓶颈
+  - 84 · TiDB 统计信息管理 — ANALYZE、健康度、stale stats 导致选错索引
+  - 85 · TiDB 事务模型对比 — 乐观事务 vs 悲观事务、TSO、AS OF TIMESTAMP
+  - 86 · IndexLookUp 回表与覆盖索引 — Build→Probe 两阶段 vs IndexReader 覆盖索引
+- **基础设施**：
+  - docker-compose.yml 新增 TiDB 集群（PD + TiKV + TiDB 三容器，端口 4000）
+  - run-case.sh 新增 `--ver tidb` 支持
+  - CI 矩阵新增 TiDB 验证
+
+### 变更
+
+- README 新增 TiDB 徽章和案例表格
+- 首页统计更新：7→8 场景，80→86 案例
+- sidebar、cases/index.md、introduction 同步更新
+
 ## v1.6.0 (2026-07-28)
 
 ### 重构

README.md

@@ -1,13 +1,14 @@
 # SQL Lab
 
-> 🐳 一套**能跑、能量化对比**的 MySQL 优化实战案例集  
+> 🐳 一套**能跑、能量化对比**的 MySQL + TiDB 优化实战案例集  
 > 每个案例都带真实数据，Docker 一键复现，bad/good EXPLAIN 量化对比
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![MySQL](https://img.shields.io/badge/MySQL-5.7%20%7C%208.0-blue.svg)](https://www.mysql.com/)
+[![TiDB](https://img.shields.io/badge/TiDB-v7.5.1-purple.svg)](https://pingcap.com/)
 [![CI](https://github.com/slowleelab/sql-lab/actions/workflows/validate-sql.yml/badge.svg)](https://github.com/slowleelab/sql-lab/actions)
 [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](CONTRIBUTING.md)
-[![Cases](https://img.shields.io/badge/cases-80-orange.svg)](docs/cases/)
+[![Cases](https://img.shields.io/badge/cases-86-orange.svg)](docs/cases/)
 
 📖 **在线文档**：[https://slowleelab.github.io/sql-lab/](https://slowleelab.github.io/sql-lab/)  
 🤖 **AI 对话**：接入 DeepWiki，可直接与仓库对话提问
@@ -27,7 +28,7 @@
 | 能否复现 | ❌ 只能看 | ✅ Docker 一键跑 |
 | 数据量 | ❌ 假数据/无数据 | ✅ 百万级真实数据 |
 | 效果验证 | ❌ 口头说快 | ✅ EXPLAIN 量化对比 |
-| 版本覆盖 | ❌ 不区分版本 | ✅ 5.7 + 8.0 双版本 |
+| 版本覆盖 | ❌ 不区分版本 | ✅ 5.7 + 8.0 + TiDB |
 | 场景贴近 | ❌ 教科书式 | ✅ 生产场景命名 |
 
 ## 🚀 快速开始
@@ -60,7 +61,7 @@ type: ref    rows: 12    Extra: Using index
 
 ## 📚 案例总览
 
-共 **80 个精选案例**，覆盖 MySQL 优化的七大核心场景：
+共 **86 个精选案例**，覆盖 MySQL + TiDB 优化的八大核心场景：
 
 ### 一、索引设计与失效（18 个）
 | # | 案例 | 难度 | 版本 |
@@ -169,17 +170,28 @@ type: ref    rows: 12    Extra: Using index
 | 78 | [派生条件下推优化](docs/cases/optimizer/78-derived-condition-pushdown.md) | ⭐⭐⭐ | 5.7 & 8.0 |
 | 79 | [大批量 UPDATE 分批优化](docs/cases/optimizer/79-batch-update.md) | ⭐⭐ | 5.7 & 8.0 |
 | 80 | [慢查询排查方法论](docs/cases/optimizer/80-slow-query-diagnosis.md) | ⭐⭐⭐ | 5.7 & 8.0 |
+
+### 八、TiDB 分布式优化（6 个）
+| # | 案例 | 难度 | 版本 |
+|---|------|------|------|
+| 81 | [TiDB EXPLAIN 算子树解读](docs/cases/tidb/81-tidb-explain-tree.md) | ⭐⭐ | TiDB |
+| 82 | [协处理器下推优化](docs/cases/tidb/82-coprocessor-pushdown.md) | ⭐⭐⭐ | TiDB |
+| 83 | [AUTO_RANDOM 避免写热点](docs/cases/tidb/83-auto-random.md) | ⭐⭐ | TiDB |
+| 84 | [TiDB 统计信息管理](docs/cases/tidb/84-tidb-statistics.md) | ⭐⭐⭐ | TiDB |
+| 85 | [TiDB 事务模型对比](docs/cases/tidb/85-tidb-transaction.md) | ⭐⭐⭐ | TiDB |
+| 86 | [IndexLookUp 回表与覆盖索引](docs/cases/tidb/86-index-lookup.md) | ⭐⭐ | TiDB |
+
 ## 🛠️ 项目结构
 
 ```
 sql-lab/
 ├── docs/                  # VitePress 文档站
 │   ├── .vitepress/        # 配置 + 自定义组件
 │   ├── guide/             # 使用指南
-│   └── cases/             # 80 篇案例文档
+│   └── cases/             # 86 篇案例文档
 ├── sql/cases/             # 可运行 SQL（schema + seed + bad + good）
 ├── scripts/run-case.sh    # 一键运行案例
-├── docker-compose.yml     # MySQL 5.7 + 8.0
+├── docker-compose.yml     # MySQL 5.7 + 8.0 + TiDB
 ├── .github/workflows/     # CI: SQL 校验 + 文档部署
 └── CONTRIBUTING.md        # 贡献指南
 ```

docker-compose.yml

@@ -40,6 +40,60 @@ services:
     volumes:
       - mysql80_data:/var/lib/mysql
 
+  # ─────────── TiDB 集群（分布式 SQL）───────────
+  # PD 调度节点（元数据管理 + 时间戳分配）
+  pd:
+    image: pingcap/pd:v7.5.1
+    container_name: sql-treasure-pd
+    restart: on-failure
+    ports:
+      - "2379:2379"
+      - "2380:2380"
+    volumes:
+      - pd_data:/var/lib/pd
+    command:
+      - --name=pd
+      - --data-dir=/var/lib/pd
+      - --client-urls=http://0.0.0.0:2379
+      - --peer-urls=http://0.0.0.0:2380
+      - --advertise-client-urls=http://pd:2379
+      - --advertise-peer-urls=http://pd:2380
+      - --initial-cluster=pd=http://pd:2380
+
+  # TiKV 存储节点（RocksDB 持久化 + Raft 共识）
+  tikv:
+    image: pingcap/tikv:v7.5.1
+    container_name: sql-treasure-tikv
+    restart: on-failure
+    ports:
+      - "20160:20160"
+    volumes:
+      - tikv_data:/var/lib/tikv
+    command:
+      - --addr=0.0.0.0:20160
+      - --advertise-addr=tikv:20160
+      - --data-dir=/var/lib/tikv
+      - --pd=pd:2379
+    depends_on:
+      - pd
+
+  # TiDB SQL 计算节点（MySQL 协议兼容，端口 4000）
+  tidb:
+    image: pingcap/tidb:v7.5.1
+    container_name: sql-treasure-tidb
+    restart: on-failure
+    ports:
+      - "4000:4000"
+      - "10080:10080"
+    command:
+      - --store=tikv
+      - --path=pd:2379
+      - --advertise-address=tidb
+    depends_on:
+      - tikv
+
 volumes:
   mysql57_data:
   mysql80_data:
+  pd_data:
+  tikv_data:

docs/.vitepress/config.ts

@@ -142,13 +142,25 @@ const sidebar = {
         { text: '80 · 慢查询排查方法论', link: '/cases/optimizer/80-slow-query-diagnosis' },
       ],
     },
+    {
+      text: '八、TiDB 分布式优化',
+      collapsed: false,
+      items: [
+        { text: '81 · TiDB EXPLAIN 算子树解读', link: '/cases/tidb/81-tidb-explain-tree' },
+        { text: '82 · 协处理器下推优化', link: '/cases/tidb/82-coprocessor-pushdown' },
+        { text: '83 · AUTO_RANDOM 避免写热点', link: '/cases/tidb/83-auto-random' },
+        { text: '84 · TiDB 统计信息管理', link: '/cases/tidb/84-tidb-statistics' },
+        { text: '85 · TiDB 事务模型对比', link: '/cases/tidb/85-tidb-transaction' },
+        { text: '86 · IndexLookUp 回表与覆盖索引', link: '/cases/tidb/86-index-lookup' },
+      ],
+    },
   ],
 }
 
 // ────────────────────────────── 站点配置 ──────────────────────────────
 export default defineConfig({
   title: 'SQL Lab',
-  description: '一套能跑、能量化对比的 MySQL 优化实战案例集',
+  description: '一套能跑、能量化对比的 MySQL + TiDB 优化实战案例集',
   lang: 'zh-CN',
   lastUpdated: true,
   cleanUrls: true,
@@ -166,19 +178,19 @@ export default defineConfig({
     ['link', { rel: 'icon', href: '/sql-lab/favicon.svg' }],
 
     // SEO: 关键词
-    ['meta', { name: 'keywords', content: 'MySQL优化,SQL优化,EXPLAIN,索引优化,MySQL 8.0,数据库性能,Docker,慢查询,事务锁,查询改写' }],
+    ['meta', { name: 'keywords', content: 'MySQL优化,SQL优化,EXPLAIN,索引优化,MySQL 8.0,数据库性能,Docker,慢查询,事务锁,查询改写,TiDB,分布式数据库,NewSQL,TiKV,coprocessor' }],
 
     // Open Graph（社交分享卡片）
     ['meta', { property: 'og:site_name', content: 'SQL Lab' }],
     ['meta', { property: 'og:type', content: 'website' }],
-    ['meta', { property: 'og:title', content: 'SQL Lab · 80 个能跑的 MySQL 优化实战案例' }],
-    ['meta', { property: 'og:description', content: '一套能跑、能量化对比的 MySQL 优化实战案例集。80 个精选案例，7 大场景，Docker 一键复现，bad/good EXPLAIN 量化对比。' }],
+    ['meta', { property: 'og:title', content: 'SQL Lab · 86 个能跑的 MySQL/TiDB 优化实战案例' }],
+    ['meta', { property: 'og:description', content: '一套能跑、能量化对比的 MySQL 优化实战案例集。86 个精选案例，8 大场景，覆盖 MySQL 5.7/8.0 和 TiDB，Docker 一键复现，bad/good EXPLAIN 量化对比。' }],
     ['meta', { property: 'og:url', content: 'https://slowleelab.github.io/sql-lab/' }],
     ['meta', { property: 'og:image', content: 'https://slowleelab.github.io/sql-lab/og-image.svg' }],
 
     // Twitter Card
     ['meta', { name: 'twitter:card', content: 'summary_large_image' }],
-    ['meta', { name: 'twitter:title', content: 'SQL Lab · 80 个能跑的 MySQL 优化实战案例' }],
+    ['meta', { name: 'twitter:title', content: 'SQL Lab · 86 个能跑的 MySQL/TiDB 优化实战案例' }],
     ['meta', { name: 'twitter:description', content: '一套能跑、能量化对比的 MySQL 优化实战案例集。Docker 一键复现，bad/good EXPLAIN 量化对比。' }],
     ['meta', { name: 'twitter:image', content: 'https://slowleelab.github.io/sql-lab/og-image.svg' }],
   ],

docs/.vitepress/theme/components/HomeFeatures.vue

@@ -6,9 +6,9 @@
 import { withBase } from 'vitepress'
 
 const stats = [
-  { number: '80', label: '精选案例' },
-  { number: '7', label: '场景分类' },
-  { number: '2', label: 'MySQL 版本' },
+  { number: '86', label: '精选案例' },
+  { number: '8', label: '场景分类' },
+  { number: '3', label: '数据库引擎' },
   { number: '100%', label: '可复现' },
 ]
 
@@ -20,6 +20,7 @@ const categories = [
   { icon: '🏗️', name: '架构级优化', count: '11 个案例', link: withBase('/cases/architecture/52-dynamic-filter') },
   { icon: '🔒', name: '事务与锁', count: '9 个案例', link: withBase('/cases/transaction/63-deadlock-analysis') },
   { icon: '⚡', name: '优化器与 8.0', count: '9 个案例', link: withBase('/cases/optimizer/72-descending-index') },
+  { icon: '🔮', name: 'TiDB 分布式优化', count: '6 个案例', link: withBase('/cases/tidb/81-tidb-explain-tree') },
   { icon: '🚀', name: '全部案例', count: '查看总览', link: withBase('/cases/') },
 ]
 </script>
@@ -35,8 +36,8 @@ const categories = [
 
   <!-- 分类导航 -->
   <div class="home-categories">
-    <h2 class="home-categories-title">七大场景 · 80 个案例</h2>
-    <p class="home-categories-subtitle">从索引失效到事务锁、从查询改写到 8.0 新特性，覆盖 MySQL 优化全链路</p>
+    <h2 class="home-categories-title">八大场景 · 86 个案例</h2>
+    <p class="home-categories-subtitle">从索引失效到事务锁、从查询改写到 8.0 新特性，覆盖 MySQL + TiDB 优化全链路</p>
     <div class="home-category-grid">
       <a
         v-for="c in categories"

docs/404.md

@@ -4,7 +4,7 @@
 
 ## 快速导航
 
-- [🏠 返回首页](/) — 查看 80 个精选案例
+- [🏠 返回首页](/) — 查看 86 个精选案例
 - [📚 案例总览](/cases/) — 按分类浏览所有案例
 - [📖 快速开始](/guide/quick-start) — Docker 一键跑通第一个案例
 - [❓ 如何阅读案例](/guide/how-to-read) — 理解 EXPLAIN 和案例结构

docs/cases/index.md

@@ -1,6 +1,6 @@
 # 案例总览
 
-共 **80 个精选案例**，覆盖 MySQL 优化的七大核心场景。每个案例都带真实数据，可一键复现。
+共 **86 个精选案例**，覆盖 MySQL + TiDB 优化的八大核心场景。每个案例都带真实数据，可一键复现。
 
 ## 一、索引设计与失效（18 个）
 
@@ -116,6 +116,17 @@
 | 78 | [派生条件下推优化](./optimizer/78-derived-condition-pushdown) | ⭐⭐⭐ | 5.7 & 8.0 |
 | 79 | [大批量 UPDATE 分批优化](./optimizer/79-batch-update) | ⭐⭐ | 5.7 & 8.0 |
 | 80 | [慢查询排查方法论](./optimizer/80-slow-query-diagnosis) | ⭐⭐⭐ | 5.7 & 8.0 |
+## 八、TiDB 分布式优化（6 个）
+
+| # | 案例 | 难度 | 版本 |
+|---|------|:----:|:----:|
+| 81 | [TiDB EXPLAIN 算子树解读](./tidb/81-tidb-explain-tree) | ⭐⭐ | TiDB |
+| 82 | [协处理器下推优化](./tidb/82-coprocessor-pushdown) | ⭐⭐⭐ | TiDB |
+| 83 | [AUTO_RANDOM 避免写热点](./tidb/83-auto-random) | ⭐⭐ | TiDB |
+| 84 | [TiDB 统计信息管理](./tidb/84-tidb-statistics) | ⭐⭐⭐ | TiDB |
+| 85 | [TiDB 事务模型对比](./tidb/85-tidb-transaction) | ⭐⭐⭐ | TiDB |
+| 86 | [IndexLookUp 回表与覆盖索引](./tidb/86-index-lookup) | ⭐⭐ | TiDB |
+
 ---
 
 ::: tip 难度说明