From 7811ab4bc042822db5109722fc799954d7e41b15 Mon Sep 17 00:00:00 2001
From: Frank945946 <108602632+Frank945946@users.noreply.github.com>
Date: Fri, 30 Aug 2024 18:54:46 +0800
Subject: [PATCH 01/25] Update system-variables.md

---
 system-variables.md | 8 ++------
 1 file changed, 2 insertions(+), 6 deletions(-)

diff --git a/system-variables.md b/system-variables.md
index 0d2bfe6ad14b..f107ed4b7ad6 100644
--- a/system-variables.md
+++ b/system-variables.md
@@ -4511,17 +4511,13 @@ EXPLAIN FORMAT='brief' SELECT COUNT(1) FROM t WHERE a = 1 AND b IS NOT NULL;
 
 ### `tidb_schema_cache_size` <span class="version-mark">从 v8.0.0 版本开始引入</span>
 
-> **警告：**
->
-> 当前版本中该变量控制的功能尚未生效，请保留默认值。
-
 - 作用域：GLOBAL
 - 是否持久化到集群：是
 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否
 - 类型：整数型
 - 默认值：`0`
-- 范围：`[0, 9223372036854775807]`
-- 这个变量用来控制 TiDB schema 信息缓存的大小。单位为 byte。默认值为 `0`，表示不打开缓存限制功能。开启该功能后，TiDB 将使用该变量的值做为可用的内存上限，并使用 Least Recently Used (LRU) 算法缓存所需的表，有效降低 schema 信息占用的内存。
+- 取值范围：0 或 `[536870912, 9223372036854775807]`
+- 这个变量用来控制 TiDB schema 信息缓存的大小。单位为 byte。默认值为 `0`，表示不打开缓存限制功能。如需开启，则需要将值设置在 [536870912, 9223372036854775807] 的范围内，TiDB 将使用该变量的值做为可用的内存上限，并使用 Least Recently Used (LRU) 算法缓存所需的表，有效降低 schema 信息占用的内存。
 
 ### `tidb_schema_version_cache_limit` <span class="version-mark">从 v7.4.0 版本开始引入</span>
 

From 1fe714b17aaf542ab9c54e6e0bd3f2b340ba5352 Mon Sep 17 00:00:00 2001
From: houfaxin <hfxsd@hotmail.com>
Date: Mon, 2 Sep 2024 12:09:43 +0800
Subject: [PATCH 02/25] Update release-8.3.0.md

---
 releases/release-8.3.0.md | 1 +
 1 file changed, 1 insertion(+)

diff --git a/releases/release-8.3.0.md b/releases/release-8.3.0.md
index d2559da71a4b..81c4cd04bf4c 100644
--- a/releases/release-8.3.0.md
+++ b/releases/release-8.3.0.md
@@ -215,6 +215,7 @@ TiDB 版本：8.3.0
 | [`tidb_gc_concurrency`](/system-variables.md#tidb_gc_concurrency-从-v50-版本开始引入) | 修改 | 从 v8.3.0 起，该变量可以控制[垃圾回收 (GC)](/garbage-collection-overview.md) 过程中 [Resolve Locks（清理锁）](/garbage-collection-overview.md#resolve-locks清理锁)和 [Delete Range（删除区间）](/garbage-collection-overview.md#delete-ranges删除区间)的并发线程数。在 v8.3.0 之前，该变量只能控制 Resolve Locks（清理锁）的线程数。|
 | [`tidb_low_resolution_tso`](/system-variables.md#tidb_low_resolution_tso) | 修改 | 增加 GLOBAL 作用域。|
 | [`tidb_opt_projection_push_down`](/system-variables.md#tidb_opt_projection_push_down-从-v610-版本开始引入) | 修改 | 增加 GLOBAL 作用域，变量值可以持久化到集群。经进一步的测试，默认值从 `OFF` 修改为 `ON`，即默认允许优化器将 `Projection` 算子下推到 TiKV。|
+| [`tidb_schema_cache_size`](/system-variables.md#tidb_schema_cache_size-从-v800-版本开始引入)  | 修改 | 取值范围修改为 `0` 或 [536870912,9223372036854775807]。 |
 | [`tidb_analyze_column_options`](/system-variables.md#tidb_analyze_column_options-从-v830-版本开始引入) | 新增 | 控制 `ANALYZE TABLE` 语句的行为。将其设置为默认值 `PREDICATE` 表示仅收集 [predicate columns](/statistics.md#收集部分列的统计信息) 的统计信息；将其设置为 `ALL` 表示收集所有列的统计信息。 |
 | [`tidb_enable_lazy_cursor_fetch`](/system-variables.md#tidb_enable_lazy_cursor_fetch-从-v830-版本开始引入) | 新增 | 这个变量用于控制 [Cursor Fetch](/develop/dev-guide-connection-parameters.md#使用-streamingresult-流式获取执行结果) 功能的行为。|
 | [`tidb_enable_shared_lock_promotion`](/system-variables.md#tidb_enable_shared_lock_promotion-从-v830-版本开始引入)      | 新增  | 控制是否启用共享锁升级为排他锁的功能。默认值为 `OFF`，表示不启用共享锁升级为排他锁的功能。  |

From b5971a3fee52eca6c5460697c94d3e8b0ec63fbd Mon Sep 17 00:00:00 2001
From: houfaxin <hfxsd@hotmail.com>
Date: Mon, 2 Sep 2024 12:16:45 +0800
Subject: [PATCH 03/25] Update release-8.3.0.md

---
 releases/release-8.3.0.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/releases/release-8.3.0.md b/releases/release-8.3.0.md
index 81c4cd04bf4c..f5659965dba5 100644
--- a/releases/release-8.3.0.md
+++ b/releases/release-8.3.0.md
@@ -215,7 +215,7 @@ TiDB 版本：8.3.0
 | [`tidb_gc_concurrency`](/system-variables.md#tidb_gc_concurrency-从-v50-版本开始引入) | 修改 | 从 v8.3.0 起，该变量可以控制[垃圾回收 (GC)](/garbage-collection-overview.md) 过程中 [Resolve Locks（清理锁）](/garbage-collection-overview.md#resolve-locks清理锁)和 [Delete Range（删除区间）](/garbage-collection-overview.md#delete-ranges删除区间)的并发线程数。在 v8.3.0 之前，该变量只能控制 Resolve Locks（清理锁）的线程数。|
 | [`tidb_low_resolution_tso`](/system-variables.md#tidb_low_resolution_tso) | 修改 | 增加 GLOBAL 作用域。|
 | [`tidb_opt_projection_push_down`](/system-variables.md#tidb_opt_projection_push_down-从-v610-版本开始引入) | 修改 | 增加 GLOBAL 作用域，变量值可以持久化到集群。经进一步的测试，默认值从 `OFF` 修改为 `ON`，即默认允许优化器将 `Projection` 算子下推到 TiKV。|
-| [`tidb_schema_cache_size`](/system-variables.md#tidb_schema_cache_size-从-v800-版本开始引入)  | 修改 | 取值范围修改为 `0` 或 [536870912,9223372036854775807]。 |
+| [`tidb_schema_cache_size`](/system-variables.md#tidb_schema_cache_size-从-v800-版本开始引入)  | 修改 | 取值范围修改为 `0` 或 `[536870912,9223372036854775807]`。 |
 | [`tidb_analyze_column_options`](/system-variables.md#tidb_analyze_column_options-从-v830-版本开始引入) | 新增 | 控制 `ANALYZE TABLE` 语句的行为。将其设置为默认值 `PREDICATE` 表示仅收集 [predicate columns](/statistics.md#收集部分列的统计信息) 的统计信息；将其设置为 `ALL` 表示收集所有列的统计信息。 |
 | [`tidb_enable_lazy_cursor_fetch`](/system-variables.md#tidb_enable_lazy_cursor_fetch-从-v830-版本开始引入) | 新增 | 这个变量用于控制 [Cursor Fetch](/develop/dev-guide-connection-parameters.md#使用-streamingresult-流式获取执行结果) 功能的行为。|
 | [`tidb_enable_shared_lock_promotion`](/system-variables.md#tidb_enable_shared_lock_promotion-从-v830-版本开始引入)      | 新增  | 控制是否启用共享锁升级为排他锁的功能。默认值为 `OFF`，表示不启用共享锁升级为排他锁的功能。  |

From b81ae80fac11fc077b0232817310d5b26026b060 Mon Sep 17 00:00:00 2001
From: Frank945946 <108602632+Frank945946@users.noreply.github.com>
Date: Wed, 24 Dec 2025 19:38:25 +0800
Subject: [PATCH 04/25] Update the Compatibility changes of release-8.5.4

---
 releases/release-8.5.4.md | 46 ++++++++++++++++++++++-----------------
 1 file changed, 26 insertions(+), 20 deletions(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index c47266728d77..66b0c3300ff3 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -61,26 +61,32 @@ TiDB 版本：8.5.4
 
 ## 兼容性变更
 
-### 系统变量
-
-- 系统变量 [`tidb_mpp_store_fail_ttl`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_mpp_store_fail_ttl) 默认值从 `60s` 修改为 `0s`，意味着 TiDB 不再需要额外等待即可向新启动的 TiFlash 节点发送查询请求，无需再通过延迟来避免查询失败 [#61826](https://github.com/pingcap/tidb/issues/61826) @[gengliqi](https://github.com/gengliqi)
-
-- 系统变量 [`tidb_replica_read`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_replica_read-从-v40-版本开始引入) 从 v8.5.4 开始仅对只读 SQL 语句生效，以提高数据读取的安全性并减少与其他功能的重叠 [#62856](https://github.com/pingcap/tidb/issues/62856) @[you06](https://github.com/you06)
-
-- 新增以下系统变量：
-
-    - [`tidb_opt_enable_no_decorrelate_in_select`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_opt_enable_no_decorrelate_in_select-从-v854-版本开始引入)：控制是否对 `SELECT` 列表中的子查询进行解关联操作，默认值为 `OFF` [#51116](https://github.com/pingcap/tidb/issues/51116) @[terry1purcell](https://github.com/terry1purcell)
-    - [`tidb_opt_enable_semi_join_rewrite`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_opt_enable_semi_join_rewrite-从-v854-版本开始引入)：控制是否改写 `EXISTS` 子查询，默认值为 `OFF` [#44850](https://github.com/pingcap/tidb/issues/44850) @[terry1purcell](https://github.com/terry1purcell)
-    - [`tidb_stats_update_during_ddl`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_stats_update_during_ddl-从-v854-版本开始引入)：控制是否开启内嵌于 DDL 的 Analyze 特性，默认值为 `OFF` [#57948](https://github.com/pingcap/tidb/issues/57948) @[terry1purcell](https://github.com/terry1purcell) @[AilinKid](https://github.com/AilinKid)
-
-### 配置参数
-
-- 废弃以下 TiKV 配置项，并由新的 [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置项替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar)
-
-    - 废弃配置项：[`region-compact-check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-interval)、[`region-compact-check-step`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-step)、[`region-compact-min-tombstones`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones)、[`region-compact-tombstones-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent)、[`region-compact-min-redundant-rows`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-从-v710-版本开始引入) 和 [`region-compact-redundant-rows-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-从-v710-版本开始引入)。
-    - 新增配置项：[`gc.auto-compaction.check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#check-interval-从-v757-和-v854-版本开始引入)、[`gc.auto-compaction.tombstone-num-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#tombstone-num-threshold-从-v757-和-v854-版本开始引入)、[`gc.auto-compaction.tombstone-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#tombstone-percent-threshold-从-v757-和-v854-版本开始引入)、[`gc.auto-compaction.redundant-rows-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-threshold-从-v757-和-v854-版本开始引入)、[`gc.auto-compaction.redundant-rows-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-percent-threshold-从-v757-和-v854-版本开始引入) 和 [`gc.auto-compaction.bottommost-level-force`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#bottommost-level-force-从-v757-和-v854-版本开始引入)。
-
-- 新增 TiFlash 配置项 [`flash.graceful_wait_shutdown_timeout`](https://docs.pingcap.com/zh/tidb/v8.5/tiflash-configuration#graceful_wait_shutdown_timeout-从-v854-版本开始引入)，用于控制在关闭 TiFlash 服务器时的最长等待时间，默认值为 `600` 秒。在此期间，TiFlash 允许尚未完成的 MPP 任务继续执行，但不再接收新的 MPP 任务。如果所有正在运行的 MPP 任务都在此超时时间之前完成，TiFlash 将立即关闭；否则将在等待时间结束后强制关闭。 [#10266](https://github.com/pingcap/tiflash/issues/10266) @[gengliqi](https://github.com/gengliqi)
+## Highlights
+
+- 新建的 v8.5.3 集群可以平滑升级到 v8.5.4。但本次发布包含若干系统变量和配置参数的默认值变更和行为调整，需要注意。
+  - 大多数变更对于常规升级是安全的，但对于进行过性能调优、使用 TiFlash 或 TiKV compaction 自定义配置的集群，需要仔细检查本节内容。
+  - 一些老旧配置项已被废弃，不再推荐使用，建议使用新的配置组。
+
+## 系统变量
+
+| 变量 | 类型 | 默认值 | 描述 | PR | 提交者 |
+|------|------|--------|------|----|-------------|
+| [`tidb_mpp_store_fail_ttl`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_mpp_store_fail_ttl) | 默认值变更 | `0` | 默认值从 `60s` → `0s`。TiDB 不再需要额外等待即可向新启动的 TiFlash 节点发送查询请求，无需通过设置等待时间来避免查询失败。 | [#61826](https://github.com/pingcap/tidb/issues/61826) | [@gengliqi](https://github.com/gengliqi) |
+| [`tidb_replica_read`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_replica_read-从-v40-版本开始引入) | 行为变更 | `leader` | 从 v8.5.4 开始，仅对只读 SQL 语句生效，提高数据读取安全性并减少与其他功能的重叠。 | [#62856](https://github.com/pingcap/tidb/issues/62856) | [@you06](https://github.com/you06) |
+| [`tidb_opt_enable_no_decorrelate_in_select`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_opt_enable_no_decorrelate_in_select-从-v854-版本开始引入) | 新增 | `OFF` | 控制是否对 `SELECT` 列表中的子查询进行解关联操作。 | [#51116](https://github.com/pingcap/tidb/issues/51116) | [@terry1purcell](https://github.com/terry1purcell) |
+| [`tidb_opt_enable_semi_join_rewrite`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_opt_enable_semi_join_rewrite-从-v854-版本开始引入) | 新增 | `OFF` | 控制是否改写 `EXISTS` 子查询。 | [#44850](https://github.com/pingcap/tidb/issues/44850) | [@terry1purcell](https://github.com/terry1purcell) |
+| [`tidb_stats_update_during_ddl`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_stats_update_during_ddl-从-v854-版本开始引入) | 新增 | `OFF` | 启用后，`ADD INDEX` 会在 DDL 执行期间收集新索引的统计信息，使索引添加完成后，优化器可以立即使用该索引。对于大表加索引的场景可能增加 DDL 执行时间。 | [#57948](https://github.com/pingcap/tidb/issues/57948) | [@terry1purcell](https://github.com/terry1purcell), [@AilinKid](https://github.com/AilinKid) |
+
+## 配置参数
+
+| 配置参数 | 类型 | 默认值 | 描述 | PR | 提交者 |
+|-------------------------|------|---------------|-------------|----|-------------|
+| [`max-manifest-file-size`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#max-manifest-file-size) | 默认值变更 | `256 MiB` | 将 `rocksdb.max-manifest-file-size` 默认值从 `128 MiB` 提升到 `256 MiB`，可能影响依赖之前默认值的用户。 | [#18889](https://github.com/tikv/tikv/issues/18889) | [@glorv](https://github.com/glorv) |
+| [`grpc-raft-conn-num`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-raft-conn-num) | 默认值变更 | CPU 核数 / 8 | 默认值更新为 `MAX(1, MIN(4, CPU 核数 / 8))`。当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4。 | [#18806](https://github.com/tikv/tikv/issues/18806) | [@LykxSassinator](https://github.com/LykxSassinator) |
+| [`grpc-concurrency`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-concurrency) | 默认值变更 | `grpc-raft-conn-num * 3 + 2` | 默认值计算方式为 `grpc_raft_conn_num * 3 + 2`。 | [#18806](https://github.com/tikv/tikv/issues/18806) | [@LykxSassinator](https://github.com/LykxSassinator) |
+| [`region-compact-check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-interval), [`region-compact-check-step`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-step), [`region-compact-min-tombstones`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones), [`region-compact-tombstones-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-从-v710-版本开始引入), [`region-compact-redundant-rows-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-从-v710-版本开始引入) | 废弃 | – | 废弃，并由 [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为。 | [#18727](https://github.com/tikv/tikv/issues/18727) | [@v01dstar](https://github.com/v01dstar) |
+| [`gc.auto-compaction.check-interval`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#check-interval-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-num-threshold`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#tombstone-num-threshold-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#tombstone-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.bottommost-level-force`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#bottommost-level-force-从-v757-版本开始引入) | 新增 | – | 新增配置组，用于控制自动 compaction 行为。 | [#18727](https://github.com/tikv/tikv/issues/18727) | [@v01dstar](https://github.com/v01dstar) |
+| [`flash.graceful_wait_shutdown_timeout`](https://docs.pingcap.com/zh/tidb/v8.5/tiflash-configuration#graceful_wait_shutdown_timeout-从-v854-版本开始引入) | 新增 | `600` | TiFlash 优雅关闭最长等待时间（秒）。TiFlash 会继续执行未完成的 MPP 任务，但不再接收新的任务。如果所有任务在超时时间前完成，TiFlash 将立即关闭；否则等待时间结束后强制关闭。 | [#10266](https://github.com/pingcap/tiflash/issues/10266) | [@gengliqi](https://github.com/gengliqi) |
 
 ### MySQL 兼容性
 

From 0b1d3958a251d030b8f525125754c7acf0294c48 Mon Sep 17 00:00:00 2001
From: Frank945946 <108602632+Frank945946@users.noreply.github.com>
Date: Wed, 24 Dec 2025 19:39:39 +0800
Subject: [PATCH 05/25] Update release-8.5.4.md

---
 releases/release-8.5.4.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index 66b0c3300ff3..4cfd5426b40c 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -61,7 +61,7 @@ TiDB 版本：8.5.4
 
 ## 兼容性变更
 
-## Highlights
+## 要点
 
 - 新建的 v8.5.3 集群可以平滑升级到 v8.5.4。但本次发布包含若干系统变量和配置参数的默认值变更和行为调整，需要注意。
   - 大多数变更对于常规升级是安全的，但对于进行过性能调优、使用 TiFlash 或 TiKV compaction 自定义配置的集群，需要仔细检查本节内容。

From 6163f21284926c9173624114c0f5692b2d188946 Mon Sep 17 00:00:00 2001
From: Grace Cai <qqzczy@126.com>
Date: Wed, 31 Dec 2025 09:50:42 +0800
Subject: [PATCH 06/25] Apply suggestions from code review

---
 releases/release-8.5.4.md | 12 +++++-------
 1 file changed, 5 insertions(+), 7 deletions(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index 4cfd5426b40c..be36b1c0d145 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -61,13 +61,11 @@ TiDB 版本：8.5.4
 
 ## 兼容性变更
 
-## 要点
+新建的 v8.5.3 集群可以平滑升级到 v8.5.4。但 v8.5.4 发布包含若干系统变量和配置参数的默认值变更和行为调整，需要注意以下要点：
+- 大多数变更对于常规升级是安全的，但对于曾进行过性能调优、使用 TiFlash、或对 TiKV compaction 进行了自定义配置的集群，需要仔细检查本节内容。
+- 一些老旧配置项已被废弃，不再推荐使用，建议使用新的配置组。
 
-- 新建的 v8.5.3 集群可以平滑升级到 v8.5.4。但本次发布包含若干系统变量和配置参数的默认值变更和行为调整，需要注意。
-  - 大多数变更对于常规升级是安全的，但对于进行过性能调优、使用 TiFlash 或 TiKV compaction 自定义配置的集群，需要仔细检查本节内容。
-  - 一些老旧配置项已被废弃，不再推荐使用，建议使用新的配置组。
-
-## 系统变量
+### 系统变量
 
 | 变量 | 类型 | 默认值 | 描述 | PR | 提交者 |
 |------|------|--------|------|----|-------------|
@@ -77,7 +75,7 @@ TiDB 版本：8.5.4
 | [`tidb_opt_enable_semi_join_rewrite`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_opt_enable_semi_join_rewrite-从-v854-版本开始引入) | 新增 | `OFF` | 控制是否改写 `EXISTS` 子查询。 | [#44850](https://github.com/pingcap/tidb/issues/44850) | [@terry1purcell](https://github.com/terry1purcell) |
 | [`tidb_stats_update_during_ddl`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_stats_update_during_ddl-从-v854-版本开始引入) | 新增 | `OFF` | 启用后，`ADD INDEX` 会在 DDL 执行期间收集新索引的统计信息，使索引添加完成后，优化器可以立即使用该索引。对于大表加索引的场景可能增加 DDL 执行时间。 | [#57948](https://github.com/pingcap/tidb/issues/57948) | [@terry1purcell](https://github.com/terry1purcell), [@AilinKid](https://github.com/AilinKid) |
 
-## 配置参数
+### 配置参数
 
 | 配置参数 | 类型 | 默认值 | 描述 | PR | 提交者 |
 |-------------------------|------|---------------|-------------|----|-------------|

From 2170267fa596295743db07fe44655b36505fa092 Mon Sep 17 00:00:00 2001
From: qiancai <qqzczy@126.com>
Date: Wed, 31 Dec 2025 11:28:46 +0800
Subject: [PATCH 07/25] merge info in Default value, PR, and Author columns to
 the Description column

---
 releases/release-8.5.4.md | 31 ++++++++++++++++---------------
 1 file changed, 16 insertions(+), 15 deletions(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index be36b1c0d145..ecfc6489fe1e 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -62,29 +62,30 @@ TiDB 版本：8.5.4
 ## 兼容性变更
 
 新建的 v8.5.3 集群可以平滑升级到 v8.5.4。但 v8.5.4 发布包含若干系统变量和配置参数的默认值变更和行为调整，需要注意以下要点：
+
 - 大多数变更对于常规升级是安全的，但对于曾进行过性能调优、使用 TiFlash、或对 TiKV compaction 进行了自定义配置的集群，需要仔细检查本节内容。
 - 一些老旧配置项已被废弃，不再推荐使用，建议使用新的配置组。
 
 ### 系统变量
 
-| 变量 | 类型 | 默认值 | 描述 | PR | 提交者 |
-|------|------|--------|------|----|-------------|
-| [`tidb_mpp_store_fail_ttl`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_mpp_store_fail_ttl) | 默认值变更 | `0` | 默认值从 `60s` → `0s`。TiDB 不再需要额外等待即可向新启动的 TiFlash 节点发送查询请求，无需通过设置等待时间来避免查询失败。 | [#61826](https://github.com/pingcap/tidb/issues/61826) | [@gengliqi](https://github.com/gengliqi) |
-| [`tidb_replica_read`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_replica_read-从-v40-版本开始引入) | 行为变更 | `leader` | 从 v8.5.4 开始，仅对只读 SQL 语句生效，提高数据读取安全性并减少与其他功能的重叠。 | [#62856](https://github.com/pingcap/tidb/issues/62856) | [@you06](https://github.com/you06) |
-| [`tidb_opt_enable_no_decorrelate_in_select`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_opt_enable_no_decorrelate_in_select-从-v854-版本开始引入) | 新增 | `OFF` | 控制是否对 `SELECT` 列表中的子查询进行解关联操作。 | [#51116](https://github.com/pingcap/tidb/issues/51116) | [@terry1purcell](https://github.com/terry1purcell) |
-| [`tidb_opt_enable_semi_join_rewrite`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_opt_enable_semi_join_rewrite-从-v854-版本开始引入) | 新增 | `OFF` | 控制是否改写 `EXISTS` 子查询。 | [#44850](https://github.com/pingcap/tidb/issues/44850) | [@terry1purcell](https://github.com/terry1purcell) |
-| [`tidb_stats_update_during_ddl`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_stats_update_during_ddl-从-v854-版本开始引入) | 新增 | `OFF` | 启用后，`ADD INDEX` 会在 DDL 执行期间收集新索引的统计信息，使索引添加完成后，优化器可以立即使用该索引。对于大表加索引的场景可能增加 DDL 执行时间。 | [#57948](https://github.com/pingcap/tidb/issues/57948) | [@terry1purcell](https://github.com/terry1purcell), [@AilinKid](https://github.com/AilinKid) |
+| 变量 | 类型 | 描述 |
+|------|------|------|
+| [`tidb_mpp_store_fail_ttl`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_mpp_store_fail_ttl) | 修改 | 默认值从 `60s` 修改为 `0s`，意味着 TiDB 不再需要额外等待即可向新启动的 TiFlash 节点发送查询请求，无需再通过延迟来避免查询失败 [#61826](https://github.com/pingcap/tidb/issues/61826) @[gengliqi](https://github.com/gengliqi) |
+| [`tidb_replica_read`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_replica_read-从-v40-版本开始引入) | 修改 | 从 v8.5.4 开始，该变量仅对只读 SQL 语句生效，以提高数据读取安全性并减少与其他功能的重叠 [#62856](https://github.com/pingcap/tidb/issues/62856) @[you06](https://github.com/you06) |
+| [`tidb_opt_enable_no_decorrelate_in_select`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_opt_enable_no_decorrelate_in_select-从-v854-版本开始引入) | 新增 | 控制是否对 `SELECT` 列表中的子查询进行解关联操作，默认值为 `OFF` [#51116](https://github.com/pingcap/tidb/issues/51116) @[terry1purcell](https://github.com/terry1purcell) |
+| [`tidb_opt_enable_semi_join_rewrite`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_opt_enable_semi_join_rewrite-从-v854-版本开始引入) | 新增 | 控制是否改写 `EXISTS` 子查询，默认值为 `OFF` [#44850](https://github.com/pingcap/tidb/issues/44850) @[terry1purcell](https://github.com/terry1purcell) |
+| [`tidb_stats_update_during_ddl`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_stats_update_during_ddl-从-v854-版本开始引入) | 新增 | 控制是否开启[内嵌于 DDL 的 Analyze 特性](https://docs.pingcap.com/zh/tidb/v8.5/ddl_embedded_analyze)，默认值为 `OFF`。启用后，`ADD INDEX` DDL 会在执行期间收集新索引的统计信息，使索引添加完成后，优化器可以立即使用该索引。需要注意的是，对于大表加索引的场景，启用该变量可能增加 DDL 执行时间。 [#57948](https://github.com/pingcap/tidb/issues/57948) @[terry1purcell](https://github.com/terry1purcell) @[AilinKid](https://github.com/AilinKid) |
 
 ### 配置参数
 
-| 配置参数 | 类型 | 默认值 | 描述 | PR | 提交者 |
-|-------------------------|------|---------------|-------------|----|-------------|
-| [`max-manifest-file-size`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#max-manifest-file-size) | 默认值变更 | `256 MiB` | 将 `rocksdb.max-manifest-file-size` 默认值从 `128 MiB` 提升到 `256 MiB`，可能影响依赖之前默认值的用户。 | [#18889](https://github.com/tikv/tikv/issues/18889) | [@glorv](https://github.com/glorv) |
-| [`grpc-raft-conn-num`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-raft-conn-num) | 默认值变更 | CPU 核数 / 8 | 默认值更新为 `MAX(1, MIN(4, CPU 核数 / 8))`。当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4。 | [#18806](https://github.com/tikv/tikv/issues/18806) | [@LykxSassinator](https://github.com/LykxSassinator) |
-| [`grpc-concurrency`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-concurrency) | 默认值变更 | `grpc-raft-conn-num * 3 + 2` | 默认值计算方式为 `grpc_raft_conn_num * 3 + 2`。 | [#18806](https://github.com/tikv/tikv/issues/18806) | [@LykxSassinator](https://github.com/LykxSassinator) |
-| [`region-compact-check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-interval), [`region-compact-check-step`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-step), [`region-compact-min-tombstones`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones), [`region-compact-tombstones-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-从-v710-版本开始引入), [`region-compact-redundant-rows-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-从-v710-版本开始引入) | 废弃 | – | 废弃，并由 [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为。 | [#18727](https://github.com/tikv/tikv/issues/18727) | [@v01dstar](https://github.com/v01dstar) |
-| [`gc.auto-compaction.check-interval`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#check-interval-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-num-threshold`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#tombstone-num-threshold-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#tombstone-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.bottommost-level-force`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#bottommost-level-force-从-v757-版本开始引入) | 新增 | – | 新增配置组，用于控制自动 compaction 行为。 | [#18727](https://github.com/tikv/tikv/issues/18727) | [@v01dstar](https://github.com/v01dstar) |
-| [`flash.graceful_wait_shutdown_timeout`](https://docs.pingcap.com/zh/tidb/v8.5/tiflash-configuration#graceful_wait_shutdown_timeout-从-v854-版本开始引入) | 新增 | `600` | TiFlash 优雅关闭最长等待时间（秒）。TiFlash 会继续执行未完成的 MPP 任务，但不再接收新的任务。如果所有任务在超时时间前完成，TiFlash 将立即关闭；否则等待时间结束后强制关闭。 | [#10266](https://github.com/pingcap/tiflash/issues/10266) | [@gengliqi](https://github.com/gengliqi) |
+| 配置参数 | 类型 | 描述 |
+|------|------|------|
+| [`rocksdb.max-manifest-file-size`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能[#18889](https://github.com/tikv/tikv/issues/18889) [@glorv](https://github.com/glorv) |
+| [`grpc-raft-conn-num`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-raft-conn-num) | 修改 | 默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) [@LykxSassinator](https://github.com/LykxSassinator) |
+| [`grpc-concurrency`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-concurrency) | 修改 | 默认值从 `1` 修改为 `grpc-raft-conn-num * 3 + 2` [@LykxSassinator](https://github.com/LykxSassinator) |
+| [`region-compact-check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-interval), [`region-compact-check-step`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-step), [`region-compact-min-tombstones`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones), [`region-compact-tombstones-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-从-v710-版本开始引入), [`region-compact-redundant-rows-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-从-v710-版本开始引入) | 废弃 | 由 [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) [@v01dstar](https://github.com/v01dstar) |
+|  [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组：[`gc.auto-compaction.check-interval`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#check-interval-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-num-threshold`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#tombstone-num-threshold-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#tombstone-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.bottommost-level-force`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#bottommost-level-force-从-v757-版本开始引入) | 新增 | 该配置组用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) [@v01dstar](https://github.com/v01dstar) |
+| [`flash.graceful_wait_shutdown_timeout`](https://docs.pingcap.com/zh/tidb/v8.5/tiflash-configuration#graceful_wait_shutdown_timeout-从-v854-版本开始引入) | 新增 | 控制 TiFlash 优雅关闭的最长等待时间（秒），默认为 `600` 秒。当关闭 TiFlash 时，TiFlash 会继续执行尚未完成的 MPP 任务，但不再接收新的 MPP 任务。如果所有 MPP 任务在此超时时间前完成，TiFlash 将立即关闭；否则将在等待时间结束后强制关闭。[#10266](https://github.com/pingcap/tiflash/issues/10266) [@gengliqi](https://github.com/gengliqi) |
 
 ### MySQL 兼容性
 

From 4d65bac4a7575535abb68f7c8cd82f2b99769c22 Mon Sep 17 00:00:00 2001
From: Grace Cai <qqzczy@126.com>
Date: Wed, 31 Dec 2025 11:35:05 +0800
Subject: [PATCH 08/25] add a space

---
 releases/release-8.5.4.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index ecfc6489fe1e..36e04a6cb3c5 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -80,7 +80,7 @@ TiDB 版本：8.5.4
 
 | 配置参数 | 类型 | 描述 |
 |------|------|------|
-| [`rocksdb.max-manifest-file-size`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能[#18889](https://github.com/tikv/tikv/issues/18889) [@glorv](https://github.com/glorv) |
+| [`rocksdb.max-manifest-file-size`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能 [#18889](https://github.com/tikv/tikv/issues/18889) [@glorv](https://github.com/glorv) |
 | [`grpc-raft-conn-num`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-raft-conn-num) | 修改 | 默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) [@LykxSassinator](https://github.com/LykxSassinator) |
 | [`grpc-concurrency`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-concurrency) | 修改 | 默认值从 `1` 修改为 `grpc-raft-conn-num * 3 + 2` [@LykxSassinator](https://github.com/LykxSassinator) |
 | [`region-compact-check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-interval), [`region-compact-check-step`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-step), [`region-compact-min-tombstones`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones), [`region-compact-tombstones-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-从-v710-版本开始引入), [`region-compact-redundant-rows-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-从-v710-版本开始引入) | 废弃 | 由 [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) [@v01dstar](https://github.com/v01dstar) |

From 8cbab92988135552d911ade1871563db04b6469b Mon Sep 17 00:00:00 2001
From: Grace Cai <qqzczy@126.com>
Date: Wed, 31 Dec 2025 11:36:52 +0800
Subject: [PATCH 09/25] update the author format

---
 releases/release-8.5.4.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index 36e04a6cb3c5..c3c2baee3c90 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -81,8 +81,8 @@ TiDB 版本：8.5.4
 | 配置参数 | 类型 | 描述 |
 |------|------|------|
 | [`rocksdb.max-manifest-file-size`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能 [#18889](https://github.com/tikv/tikv/issues/18889) [@glorv](https://github.com/glorv) |
-| [`grpc-raft-conn-num`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-raft-conn-num) | 修改 | 默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) [@LykxSassinator](https://github.com/LykxSassinator) |
-| [`grpc-concurrency`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-concurrency) | 修改 | 默认值从 `1` 修改为 `grpc-raft-conn-num * 3 + 2` [@LykxSassinator](https://github.com/LykxSassinator) |
+| [`grpc-raft-conn-num`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-raft-conn-num) | 修改 | 默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
+| [`grpc-concurrency`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-concurrency) | 修改 | 默认值从 `1` 修改为 `grpc-raft-conn-num * 3 + 2` [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
 | [`region-compact-check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-interval), [`region-compact-check-step`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-step), [`region-compact-min-tombstones`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones), [`region-compact-tombstones-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-从-v710-版本开始引入), [`region-compact-redundant-rows-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-从-v710-版本开始引入) | 废弃 | 由 [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) [@v01dstar](https://github.com/v01dstar) |
 |  [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组：[`gc.auto-compaction.check-interval`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#check-interval-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-num-threshold`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#tombstone-num-threshold-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#tombstone-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.bottommost-level-force`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#bottommost-level-force-从-v757-版本开始引入) | 新增 | 该配置组用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) [@v01dstar](https://github.com/v01dstar) |
 | [`flash.graceful_wait_shutdown_timeout`](https://docs.pingcap.com/zh/tidb/v8.5/tiflash-configuration#graceful_wait_shutdown_timeout-从-v854-版本开始引入) | 新增 | 控制 TiFlash 优雅关闭的最长等待时间（秒），默认为 `600` 秒。当关闭 TiFlash 时，TiFlash 会继续执行尚未完成的 MPP 任务，但不再接收新的 MPP 任务。如果所有 MPP 任务在此超时时间前完成，TiFlash 将立即关闭；否则将在等待时间结束后强制关闭。[#10266](https://github.com/pingcap/tiflash/issues/10266) [@gengliqi](https://github.com/gengliqi) |

From 96728dc134f44c9be53076b87ea02b406981165f Mon Sep 17 00:00:00 2001
From: Grace Cai <qqzczy@126.com>
Date: Wed, 31 Dec 2025 11:38:42 +0800
Subject: [PATCH 10/25] update the author format

---
 releases/release-8.5.4.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index c3c2baee3c90..5290e6349510 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -83,9 +83,9 @@ TiDB 版本：8.5.4
 | [`rocksdb.max-manifest-file-size`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能 [#18889](https://github.com/tikv/tikv/issues/18889) [@glorv](https://github.com/glorv) |
 | [`grpc-raft-conn-num`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-raft-conn-num) | 修改 | 默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
 | [`grpc-concurrency`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-concurrency) | 修改 | 默认值从 `1` 修改为 `grpc-raft-conn-num * 3 + 2` [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
-| [`region-compact-check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-interval), [`region-compact-check-step`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-step), [`region-compact-min-tombstones`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones), [`region-compact-tombstones-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-从-v710-版本开始引入), [`region-compact-redundant-rows-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-从-v710-版本开始引入) | 废弃 | 由 [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) [@v01dstar](https://github.com/v01dstar) |
-|  [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组：[`gc.auto-compaction.check-interval`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#check-interval-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-num-threshold`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#tombstone-num-threshold-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#tombstone-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.bottommost-level-force`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#bottommost-level-force-从-v757-版本开始引入) | 新增 | 该配置组用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) [@v01dstar](https://github.com/v01dstar) |
-| [`flash.graceful_wait_shutdown_timeout`](https://docs.pingcap.com/zh/tidb/v8.5/tiflash-configuration#graceful_wait_shutdown_timeout-从-v854-版本开始引入) | 新增 | 控制 TiFlash 优雅关闭的最长等待时间（秒），默认为 `600` 秒。当关闭 TiFlash 时，TiFlash 会继续执行尚未完成的 MPP 任务，但不再接收新的 MPP 任务。如果所有 MPP 任务在此超时时间前完成，TiFlash 将立即关闭；否则将在等待时间结束后强制关闭。[#10266](https://github.com/pingcap/tiflash/issues/10266) [@gengliqi](https://github.com/gengliqi) |
+| [`region-compact-check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-interval), [`region-compact-check-step`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-step), [`region-compact-min-tombstones`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones), [`region-compact-tombstones-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-从-v710-版本开始引入), [`region-compact-redundant-rows-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-从-v710-版本开始引入) | 废弃 | 由 [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
+|  [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组：[`gc.auto-compaction.check-interval`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#check-interval-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-num-threshold`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#tombstone-num-threshold-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#tombstone-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.bottommost-level-force`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#bottommost-level-force-从-v757-版本开始引入) | 新增 | 该配置组用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
+| [`flash.graceful_wait_shutdown_timeout`](https://docs.pingcap.com/zh/tidb/v8.5/tiflash-configuration#graceful_wait_shutdown_timeout-从-v854-版本开始引入) | 新增 | 控制 TiFlash 优雅关闭的最长等待时间（秒），默认为 `600` 秒。当关闭 TiFlash 时，TiFlash 会继续执行尚未完成的 MPP 任务，但不再接收新的 MPP 任务。如果所有 MPP 任务在此超时时间前完成，TiFlash 将立即关闭；否则将在等待时间结束后强制关闭。[#10266](https://github.com/pingcap/tiflash/issues/10266) @[gengliqi](https://github.com/gengliqi) |
 
 ### MySQL 兼容性
 

From 772e35aa8908ee9a13b743def038a3f87f56f77f Mon Sep 17 00:00:00 2001
From: Grace Cai <qqzczy@126.com>
Date: Wed, 31 Dec 2025 11:39:20 +0800
Subject: [PATCH 11/25] update the author format

---
 releases/release-8.5.4.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index 5290e6349510..5d491e8e3dd4 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -80,7 +80,7 @@ TiDB 版本：8.5.4
 
 | 配置参数 | 类型 | 描述 |
 |------|------|------|
-| [`rocksdb.max-manifest-file-size`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能 [#18889](https://github.com/tikv/tikv/issues/18889) [@glorv](https://github.com/glorv) |
+| [`rocksdb.max-manifest-file-size`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能 [#18889](https://github.com/tikv/tikv/issues/18889) @[glorv](https://github.com/glorv) |
 | [`grpc-raft-conn-num`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-raft-conn-num) | 修改 | 默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
 | [`grpc-concurrency`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-concurrency) | 修改 | 默认值从 `1` 修改为 `grpc-raft-conn-num * 3 + 2` [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
 | [`region-compact-check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-interval), [`region-compact-check-step`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-step), [`region-compact-min-tombstones`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones), [`region-compact-tombstones-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-从-v710-版本开始引入), [`region-compact-redundant-rows-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-从-v710-版本开始引入) | 废弃 | 由 [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |

From 0a3c3a3f7f7a8f35f7d9474ff2ccba38a3297e34 Mon Sep 17 00:00:00 2001
From: Grace Cai <qqzczy@126.com>
Date: Mon, 12 Jan 2026 13:44:13 +0800
Subject: [PATCH 12/25] Apply suggestions from code review

---
 releases/release-8.5.4.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index 5d491e8e3dd4..a12930b61946 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -63,7 +63,7 @@ TiDB 版本：8.5.4
 
 新建的 v8.5.3 集群可以平滑升级到 v8.5.4。但 v8.5.4 发布包含若干系统变量和配置参数的默认值变更和行为调整，需要注意以下要点：
 
-- 大多数变更对于常规升级是安全的，但对于曾进行过性能调优、使用 TiFlash、或对 TiKV compaction 进行了自定义配置的集群，需要仔细检查本节内容。
+- 大多数变更对于常规升级是安全的，但对于曾进行过性能调优、包含 TiFlash 节点、或对 TiKV compaction 进行了自定义配置的集群，需要仔细检查本节内容。
 - 一些老旧配置项已被废弃，不再推荐使用，建议使用新的配置组。
 
 ### 系统变量
@@ -81,8 +81,8 @@ TiDB 版本：8.5.4
 | 配置参数 | 类型 | 描述 |
 |------|------|------|
 | [`rocksdb.max-manifest-file-size`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能 [#18889](https://github.com/tikv/tikv/issues/18889) @[glorv](https://github.com/glorv) |
-| [`grpc-raft-conn-num`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-raft-conn-num) | 修改 | 默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
-| [`grpc-concurrency`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-concurrency) | 修改 | 默认值从 `1` 修改为 `grpc-raft-conn-num * 3 + 2` [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
+| [`grpc-raft-conn-num`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-raft-conn-num) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
+| [`grpc-concurrency`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-concurrency) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `5` 修改为 `grpc-raft-conn-num * 3 + 2` [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
 | [`region-compact-check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-interval), [`region-compact-check-step`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-step), [`region-compact-min-tombstones`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones), [`region-compact-tombstones-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-从-v710-版本开始引入), [`region-compact-redundant-rows-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-从-v710-版本开始引入) | 废弃 | 由 [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
 |  [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组：[`gc.auto-compaction.check-interval`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#check-interval-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-num-threshold`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#tombstone-num-threshold-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#tombstone-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.bottommost-level-force`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#bottommost-level-force-从-v757-版本开始引入) | 新增 | 该配置组用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
 | [`flash.graceful_wait_shutdown_timeout`](https://docs.pingcap.com/zh/tidb/v8.5/tiflash-configuration#graceful_wait_shutdown_timeout-从-v854-版本开始引入) | 新增 | 控制 TiFlash 优雅关闭的最长等待时间（秒），默认为 `600` 秒。当关闭 TiFlash 时，TiFlash 会继续执行尚未完成的 MPP 任务，但不再接收新的 MPP 任务。如果所有 MPP 任务在此超时时间前完成，TiFlash 将立即关闭；否则将在等待时间结束后强制关闭。[#10266](https://github.com/pingcap/tiflash/issues/10266) @[gengliqi](https://github.com/gengliqi) |

From e984d1f43113af7567690634d865946f5e702dc4 Mon Sep 17 00:00:00 2001
From: Grace Cai <qqzczy@126.com>
Date: Mon, 12 Jan 2026 13:44:20 +0800
Subject: [PATCH 13/25] Update releases/release-8.5.4.md

---
 releases/release-8.5.4.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index a12930b61946..cf09db38afc0 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -61,7 +61,7 @@ TiDB 版本：8.5.4
 
 ## 兼容性变更
 
-新建的 v8.5.3 集群可以平滑升级到 v8.5.4。但 v8.5.4 发布包含若干系统变量和配置参数的默认值变更和行为调整，需要注意以下要点：
+新建的 v8.5.3 集群可以平滑升级到 v8.5.4。但 v8.5.4 发布包含若干系统变量和配置参数的默认值变更和行为调整，升级时需要注意以下要点：
 
 - 大多数变更对于常规升级是安全的，但对于曾进行过性能调优、包含 TiFlash 节点、或对 TiKV compaction 进行了自定义配置的集群，需要仔细检查本节内容。
 - 一些老旧配置项已被废弃，不再推荐使用，建议使用新的配置组。

From 5239d9a3f636b7acb22f8fc1cf6d9cf1e904a2af Mon Sep 17 00:00:00 2001
From: qiancai <qqzczy@126.com>
Date: Mon, 12 Jan 2026 13:55:43 +0800
Subject: [PATCH 14/25] add a column for parameter changes

---
 releases/release-8.5.4.md | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index cf09db38afc0..1c46580fd0b9 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -78,14 +78,14 @@ TiDB 版本：8.5.4
 
 ### 配置参数
 
-| 配置参数 | 类型 | 描述 |
-|------|------|------|
-| [`rocksdb.max-manifest-file-size`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能 [#18889](https://github.com/tikv/tikv/issues/18889) @[glorv](https://github.com/glorv) |
-| [`grpc-raft-conn-num`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-raft-conn-num) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
-| [`grpc-concurrency`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-concurrency) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `5` 修改为 `grpc-raft-conn-num * 3 + 2` [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
-| [`region-compact-check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-interval), [`region-compact-check-step`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-step), [`region-compact-min-tombstones`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones), [`region-compact-tombstones-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-从-v710-版本开始引入), [`region-compact-redundant-rows-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-从-v710-版本开始引入) | 废弃 | 由 [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
-|  [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组：[`gc.auto-compaction.check-interval`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#check-interval-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-num-threshold`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#tombstone-num-threshold-从-v757-版本开始引入), [`gc.auto-compaction.tombstone-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#tombstone-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-threshold-从-v757-版本开始引入), [`gc.auto-compaction.redundant-rows-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-percent-threshold-从-v757-版本开始引入), [`gc.auto-compaction.bottommost-level-force`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#bottommost-level-force-从-v757-版本开始引入) | 新增 | 该配置组用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
-| [`flash.graceful_wait_shutdown_timeout`](https://docs.pingcap.com/zh/tidb/v8.5/tiflash-configuration#graceful_wait_shutdown_timeout-从-v854-版本开始引入) | 新增 | 控制 TiFlash 优雅关闭的最长等待时间（秒），默认为 `600` 秒。当关闭 TiFlash 时，TiFlash 会继续执行尚未完成的 MPP 任务，但不再接收新的 MPP 任务。如果所有 MPP 任务在此超时时间前完成，TiFlash 将立即关闭；否则将在等待时间结束后强制关闭。[#10266](https://github.com/pingcap/tiflash/issues/10266) @[gengliqi](https://github.com/gengliqi) |
+| 配置文件或组件 | 配置参数 | 类型 | 描述 |
+|------|------|------|------|
+| TiKV | [`rocksdb.max-manifest-file-size`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能 [#18889](https://github.com/tikv/tikv/issues/18889) @[glorv](https://github.com/glorv) |
+| TiKV | [`grpc-raft-conn-num`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-raft-conn-num) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
+| TiKV | [`grpc-concurrency`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-concurrency) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `5` 修改为 `grpc-raft-conn-num * 3 + 2` [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
+| TiKV | [`region-compact-check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-interval), [`region-compact-check-step`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-step), [`region-compact-min-tombstones`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones), [`region-compact-tombstones-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-从-v710-版本开始引入), [`region-compact-redundant-rows-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-从-v710-版本开始引入) | 废弃 | 由 [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
+| TiKV |[`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组：[`gc.auto-compaction.check-interval`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#check-interval-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.tombstone-num-threshold`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#tombstone-num-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.tombstone-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#tombstone-percent-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.redundant-rows-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.redundant-rows-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-percent-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.bottommost-level-force`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#bottommost-level-force-从-v757-和-v854-版本开始引入) | 新增 | 该配置组用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
+| TiFlash | [`flash.graceful_wait_shutdown_timeout`](https://docs.pingcap.com/zh/tidb/v8.5/tiflash-configuration#graceful_wait_shutdown_timeout-从-v854-版本开始引入) | 新增 | 控制 TiFlash 优雅关闭的最长等待时间（秒），默认为 `600` 秒。当关闭 TiFlash 时，TiFlash 会继续执行尚未完成的 MPP 任务，但不再接收新的 MPP 任务。如果所有 MPP 任务在此超时时间前完成，TiFlash 将立即关闭；否则将在等待时间结束后强制关闭。[#10266](https://github.com/pingcap/tiflash/issues/10266) @[gengliqi](https://github.com/gengliqi) |
 
 ### MySQL 兼容性
 

From 800ec8cfa9c36df7039f93dc432687126d67edba Mon Sep 17 00:00:00 2001
From: qiancai <qqzczy@126.com>
Date: Mon, 12 Jan 2026 14:51:08 +0800
Subject: [PATCH 15/25] Update release-8.5.4.md

---
 releases/release-8.5.4.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index 1c46580fd0b9..1739e2fe1a7f 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -61,10 +61,10 @@ TiDB 版本：8.5.4
 
 ## 兼容性变更
 
-新建的 v8.5.3 集群可以平滑升级到 v8.5.4。但 v8.5.4 发布包含若干系统变量和配置参数的默认值变更和行为调整，升级时需要注意以下要点：
+新建的 v8.5.3 集群可以平滑升级到 v8.5.4。但 v8.5.4 发布包含若干系统变量和配置参数的默认值变更和行为调整，在升级前，请注意以下事项：
 
-- 大多数变更对于常规升级是安全的，但对于曾进行过性能调优、包含 TiFlash 节点、或对 TiKV compaction 进行了自定义配置的集群，需要仔细检查本节内容。
-- 一些老旧配置项已被废弃，不再推荐使用，建议使用新的配置组。
+- 大多数变更对于常规升级是安全的。但如果你的集群曾进行过性能调优，例如自定义了 TiFlash 配置或 TiKV 的 compaction 配置，请务必仔细阅读本节内容。
+- 一些老旧的 TiKV 配置项在 v8.5.4 中已被废弃，不再推荐使用，建议将这些配置项迁移到本节中提供新增 TiKV 配置组。
 
 ### 系统变量
 

From a2259701dfed9b3dc9fdb8d10a8008cfa2e1aeed Mon Sep 17 00:00:00 2001
From: qiancai <qqzczy@126.com>
Date: Mon, 12 Jan 2026 14:52:05 +0800
Subject: [PATCH 16/25] Update release-8.5.4.md

---
 releases/release-8.5.4.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index 1739e2fe1a7f..7b3cc3b50850 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -64,7 +64,7 @@ TiDB 版本：8.5.4
 新建的 v8.5.3 集群可以平滑升级到 v8.5.4。但 v8.5.4 发布包含若干系统变量和配置参数的默认值变更和行为调整，在升级前，请注意以下事项：
 
 - 大多数变更对于常规升级是安全的。但如果你的集群曾进行过性能调优，例如自定义了 TiFlash 配置或 TiKV 的 compaction 配置，请务必仔细阅读本节内容。
-- 一些老旧的 TiKV 配置项在 v8.5.4 中已被废弃，不再推荐使用，建议将这些配置项迁移到本节中提供新增 TiKV 配置组。
+- 一些老旧的 TiKV 配置项在 v8.5.4 中已被废弃，不再推荐使用。作为替代，建议使用本节中提供的新增 TiKV 配置组。
 
 ### 系统变量
 

From 4a2e4b11f5e8b7a24ad8e325b2d5b05295f3c6d1 Mon Sep 17 00:00:00 2001
From: xixirangrang <hfxsd@hotmail.com>
Date: Mon, 12 Jan 2026 19:08:26 +0800
Subject: [PATCH 17/25] Update releases/release-8.5.4.md

---
 releases/release-8.5.4.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index 7b3cc3b50850..2eb899571043 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -64,7 +64,7 @@ TiDB 版本：8.5.4
 新建的 v8.5.3 集群可以平滑升级到 v8.5.4。但 v8.5.4 发布包含若干系统变量和配置参数的默认值变更和行为调整，在升级前，请注意以下事项：
 
 - 大多数变更对于常规升级是安全的。但如果你的集群曾进行过性能调优，例如自定义了 TiFlash 配置或 TiKV 的 compaction 配置，请务必仔细阅读本节内容。
-- 一些老旧的 TiKV 配置项在 v8.5.4 中已被废弃，不再推荐使用。作为替代，建议使用本节中提供的新增 TiKV 配置组。
+- 从 v8.5.4 开始，某些老旧的 TiKV 配置项被废弃，不推荐使用。作为替代，建议使用本节中提供的新增 TiKV 配置项。
 
 ### 系统变量
 

From 629ae5019fede702039561393947db974de6e9ed Mon Sep 17 00:00:00 2001
From: xixirangrang <hfxsd@hotmail.com>
Date: Mon, 12 Jan 2026 19:38:35 +0800
Subject: [PATCH 18/25] Apply suggestions from code review

---
 releases/release-8.5.4.md | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index 2eb899571043..f3c4a7899bf9 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -70,22 +70,22 @@ TiDB 版本：8.5.4
 
 | 变量 | 类型 | 描述 |
 |------|------|------|
-| [`tidb_mpp_store_fail_ttl`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_mpp_store_fail_ttl) | 修改 | 默认值从 `60s` 修改为 `0s`，意味着 TiDB 不再需要额外等待即可向新启动的 TiFlash 节点发送查询请求，无需再通过延迟来避免查询失败 [#61826](https://github.com/pingcap/tidb/issues/61826) @[gengliqi](https://github.com/gengliqi) |
-| [`tidb_replica_read`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_replica_read-从-v40-版本开始引入) | 修改 | 从 v8.5.4 开始，该变量仅对只读 SQL 语句生效，以提高数据读取安全性并减少与其他功能的重叠 [#62856](https://github.com/pingcap/tidb/issues/62856) @[you06](https://github.com/you06) |
-| [`tidb_opt_enable_no_decorrelate_in_select`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_opt_enable_no_decorrelate_in_select-从-v854-版本开始引入) | 新增 | 控制是否对 `SELECT` 列表中的子查询进行解关联操作，默认值为 `OFF` [#51116](https://github.com/pingcap/tidb/issues/51116) @[terry1purcell](https://github.com/terry1purcell) |
-| [`tidb_opt_enable_semi_join_rewrite`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_opt_enable_semi_join_rewrite-从-v854-版本开始引入) | 新增 | 控制是否改写 `EXISTS` 子查询，默认值为 `OFF` [#44850](https://github.com/pingcap/tidb/issues/44850) @[terry1purcell](https://github.com/terry1purcell) |
-| [`tidb_stats_update_during_ddl`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables/#tidb_stats_update_during_ddl-从-v854-版本开始引入) | 新增 | 控制是否开启[内嵌于 DDL 的 Analyze 特性](https://docs.pingcap.com/zh/tidb/v8.5/ddl_embedded_analyze)，默认值为 `OFF`。启用后，`ADD INDEX` DDL 会在执行期间收集新索引的统计信息，使索引添加完成后，优化器可以立即使用该索引。需要注意的是，对于大表加索引的场景，启用该变量可能增加 DDL 执行时间。 [#57948](https://github.com/pingcap/tidb/issues/57948) @[terry1purcell](https://github.com/terry1purcell) @[AilinKid](https://github.com/AilinKid) |
+| [`tidb_mpp_store_fail_ttl`](/system-variables.md#tidb_mpp_store_fail_ttl) | 修改 | 默认值从 `60s` 修改为 `0s`，意味着 TiDB 不再需要额外等待即可向新启动的 TiFlash 节点发送查询请求，无需再通过延迟来避免查询失败 [#61826](https://github.com/pingcap/tidb/issues/61826) @[gengliqi](https://github.com/gengliqi) |
+| [`tidb_replica_read`](/system-variables.md#tidb_replica_read-从-v40-版本开始引入) | 修改 | 从 v8.5.4 开始，该变量仅对只读 SQL 语句生效，以提高数据读取安全性并减少与其他功能的重叠 [#62856](https://github.com/pingcap/tidb/issues/62856) @[you06](https://github.com/you06) |
+| [`tidb_opt_enable_no_decorrelate_in_select`](/system-variables.md#tidb_opt_enable_no_decorrelate_in_select-从-v854-版本开始引入) | 新增 | 控制是否对 `SELECT` 列表中的子查询进行解关联操作，默认值为 `OFF` [#51116](https://github.com/pingcap/tidb/issues/51116) @[terry1purcell](https://github.com/terry1purcell) |
+| [`tidb_opt_enable_semi_join_rewrite`](/system-variables.md#tidb_opt_enable_semi_join_rewrite-从-v854-版本开始引入) | 新增 | 控制是否改写 `EXISTS` 子查询，默认值为 `OFF` [#44850](https://github.com/pingcap/tidb/issues/44850) @[terry1purcell](https://github.com/terry1purcell) |
+| [`tidb_stats_update_during_ddl`](/system-variables.md#tidb_stats_update_during_ddl-从-v854-版本开始引入) | 新增 | 控制是否开启[内嵌于 DDL 的 Analyze 特性](/ddl_embedded_analyze.md)，默认值为 `OFF`。启用后，`ADD INDEX` DDL 会在执行期间收集新索引的统计信息，使索引添加完成后，优化器可以立即使用该索引。需要注意的是，对于大表加索引的场景，启用该变量可能增加 DDL 执行时间。 [#57948](https://github.com/pingcap/tidb/issues/57948) @[terry1purcell](https://github.com/terry1purcell) @[AilinKid](https://github.com/AilinKid) |
 
 ### 配置参数
 
 | 配置文件或组件 | 配置参数 | 类型 | 描述 |
 |------|------|------|------|
-| TiKV | [`rocksdb.max-manifest-file-size`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能 [#18889](https://github.com/tikv/tikv/issues/18889) @[glorv](https://github.com/glorv) |
-| TiKV | [`grpc-raft-conn-num`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-raft-conn-num) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
-| TiKV | [`grpc-concurrency`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-concurrency) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `5` 修改为 `grpc-raft-conn-num * 3 + 2` [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
-| TiKV | [`region-compact-check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-interval), [`region-compact-check-step`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-step), [`region-compact-min-tombstones`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones), [`region-compact-tombstones-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-从-v710-版本开始引入), [`region-compact-redundant-rows-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-从-v710-版本开始引入) | 废弃 | 由 [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
-| TiKV |[`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file/#gcauto-compaction) 配置组：[`gc.auto-compaction.check-interval`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#check-interval-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.tombstone-num-threshold`](https://docs.pingcap.com/zh/tidb/stable/tikv-configuration-file/#tombstone-num-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.tombstone-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#tombstone-percent-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.redundant-rows-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.redundant-rows-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-percent-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.bottommost-level-force`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#bottommost-level-force-从-v757-和-v854-版本开始引入) | 新增 | 该配置组用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
-| TiFlash | [`flash.graceful_wait_shutdown_timeout`](https://docs.pingcap.com/zh/tidb/v8.5/tiflash-configuration#graceful_wait_shutdown_timeout-从-v854-版本开始引入) | 新增 | 控制 TiFlash 优雅关闭的最长等待时间（秒），默认为 `600` 秒。当关闭 TiFlash 时，TiFlash 会继续执行尚未完成的 MPP 任务，但不再接收新的 MPP 任务。如果所有 MPP 任务在此超时时间前完成，TiFlash 将立即关闭；否则将在等待时间结束后强制关闭。[#10266](https://github.com/pingcap/tiflash/issues/10266) @[gengliqi](https://github.com/gengliqi) |
+| TiKV | [`rocksdb.max-manifest-file-size`](/tikv-configuration-file.md#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能 [#18889](https://github.com/tikv/tikv/issues/18889) @[glorv](https://github.com/glorv) |
+| TiKV | [`grpc-raft-conn-num`](/tikv-configuration-file.md#grpc-raft-conn-num) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
+| TiKV | [`grpc-concurrency`](/tikv-configuration-file.md#grpc-concurrency) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `5` 修改为 `grpc-raft-conn-num * 3 + 2` [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
+| TiKV | [`region-compact-check-interval`](/tikv-configuration-file.md#region-compact-check-interval), [`region-compact-check-step`](/tikv-configuration-file.md#region-compact-check-step), [`region-compact-min-tombstones`](/tikv-configuration-file.md#region-compact-min-tombstones), [`region-compact-tombstones-percent`](/tikv-configuration-file.md#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](/tikv-configuration-file.md#region-compact-min-redundant-rows-从-v710-版本开始引入), [`region-compact-redundant-rows-percent`](/tikv-configuration-file.md#region-compact-redundant-rows-percent-从-v710-版本开始引入) | 废弃 | 由 [`gc.auto-compaction`](/tikv-configuration-file.md#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
+| TiKV |[`gc.auto-compaction`](/tikv-configuration-file.md#gcauto-compaction) 配置组包括：[`gc.auto-compaction.check-interval`](/tikv-configuration-file.md#check-interval-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.tombstone-num-threshold`](/tikv-configuration-file.md#tombstone-num-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.tombstone-percent-threshold`](/tikv-configuration-file.md#tombstone-percent-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.redundant-rows-threshold`](/tikv-configuration-file.md#redundant-rows-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.redundant-rows-percent-threshold`](/tikv-configuration-file.md#redundant-rows-percent-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.bottommost-level-force`](/tikv-configuration-file.md#bottommost-level-force-从-v757-和-v854-版本开始引入) | 新增 | 该配置组用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
+| TiFlash | [`flash.graceful_wait_shutdown_timeout`](/tiflash-configuration.md#graceful_wait_shutdown_timeout-从-v854-版本开始引入) | 新增 | 控制 TiFlash 优雅关闭的最长等待时间（秒），默认为 `600` 秒。当关闭 TiFlash 时，TiFlash 会继续执行尚未完成的 MPP 任务，但不再接收新的 MPP 任务。如果所有 MPP 任务在此超时时间前完成，TiFlash 将立即关闭；否则将在等待时间结束后强制关闭。[#10266](https://github.com/pingcap/tiflash/issues/10266) @[gengliqi](https://github.com/gengliqi) |
 
 ### MySQL 兼容性
 

From 25dc8b0cc6763b7420bccd9f32548b1d56389e6d Mon Sep 17 00:00:00 2001
From: xixirangrang <hfxsd@hotmail.com>
Date: Mon, 12 Jan 2026 20:06:57 +0800
Subject: [PATCH 19/25] Update releases/release-8.5.4.md

---
 releases/release-8.5.4.md | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index f3c4a7899bf9..bea76e6abd33 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -83,8 +83,8 @@ TiDB 版本：8.5.4
 | TiKV | [`rocksdb.max-manifest-file-size`](/tikv-configuration-file.md#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能 [#18889](https://github.com/tikv/tikv/issues/18889) @[glorv](https://github.com/glorv) |
 | TiKV | [`grpc-raft-conn-num`](/tikv-configuration-file.md#grpc-raft-conn-num) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
 | TiKV | [`grpc-concurrency`](/tikv-configuration-file.md#grpc-concurrency) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `5` 修改为 `grpc-raft-conn-num * 3 + 2` [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
-| TiKV | [`region-compact-check-interval`](/tikv-configuration-file.md#region-compact-check-interval), [`region-compact-check-step`](/tikv-configuration-file.md#region-compact-check-step), [`region-compact-min-tombstones`](/tikv-configuration-file.md#region-compact-min-tombstones), [`region-compact-tombstones-percent`](/tikv-configuration-file.md#region-compact-tombstones-percent), [`region-compact-min-redundant-rows`](/tikv-configuration-file.md#region-compact-min-redundant-rows-从-v710-版本开始引入), [`region-compact-redundant-rows-percent`](/tikv-configuration-file.md#region-compact-redundant-rows-percent-从-v710-版本开始引入) | 废弃 | 由 [`gc.auto-compaction`](/tikv-configuration-file.md#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
-| TiKV |[`gc.auto-compaction`](/tikv-configuration-file.md#gcauto-compaction) 配置组包括：[`gc.auto-compaction.check-interval`](/tikv-configuration-file.md#check-interval-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.tombstone-num-threshold`](/tikv-configuration-file.md#tombstone-num-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.tombstone-percent-threshold`](/tikv-configuration-file.md#tombstone-percent-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.redundant-rows-threshold`](/tikv-configuration-file.md#redundant-rows-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.redundant-rows-percent-threshold`](/tikv-configuration-file.md#redundant-rows-percent-threshold-从-v757-和-v854-版本开始引入), [`gc.auto-compaction.bottommost-level-force`](/tikv-configuration-file.md#bottommost-level-force-从-v757-和-v854-版本开始引入) | 新增 | 该配置组用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
+| TiKV | <ul><li>[`region-compact-check-interval`](/tikv-configuration-file.md#region-compact-check-interval)</li><li>[`region-compact-check-step`](/tikv-configuration-file.md#region-compact-check-step)</li><li>[`region-compact-min-tombstones`](/tikv-configuration-file.md#region-compact-min-tombstones)</li><li>[`region-compact-tombstones-percent`](/tikv-configuration-file.md#region-compact-tombstones-percent)</li><li>[`region-compact-min-redundant-rows`](/tikv-configuration-file.md#region-compact-min-redundant-rows-从-v710-版本开始引入)</li><li>[`region-compact-redundant-rows-percent`](/tikv-configuration-file.md#region-compact-redundant-rows-percent-从-v710-版本开始引入) </li></ul>| 废弃 | 由 [`gc.auto-compaction`](/tikv-configuration-file.md#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
+| TiKV |[`gc.auto-compaction`](/tikv-configuration-file.md#gcauto-compaction) 配置组包括：<ul><li>[`gc.auto-compaction.check-interval`](/tikv-configuration-file.md#check-interval-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.tombstone-num-threshold`](/tikv-configuration-file.md#tombstone-num-threshold-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.tombstone-percent-threshold`](/tikv-configuration-file.md#tombstone-percent-threshold-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.redundant-rows-threshold`](/tikv-configuration-file.md#redundant-rows-threshold-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.redundant-rows-percent-threshold`](/tikv-configuration-file.md#redundant-rows-percent-threshold-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.bottommost-level-force`](/tikv-configuration-file.md#bottommost-level-force-从-v757-和-v854-版本开始引入)</li></ul> | 新增 | 该配置组用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
 | TiFlash | [`flash.graceful_wait_shutdown_timeout`](/tiflash-configuration.md#graceful_wait_shutdown_timeout-从-v854-版本开始引入) | 新增 | 控制 TiFlash 优雅关闭的最长等待时间（秒），默认为 `600` 秒。当关闭 TiFlash 时，TiFlash 会继续执行尚未完成的 MPP 任务，但不再接收新的 MPP 任务。如果所有 MPP 任务在此超时时间前完成，TiFlash 将立即关闭；否则将在等待时间结束后强制关闭。[#10266](https://github.com/pingcap/tiflash/issues/10266) @[gengliqi](https://github.com/gengliqi) |
 
 ### MySQL 兼容性

From cb91233aa031be4c35ee3b7c9b4ce030c553573c Mon Sep 17 00:00:00 2001
From: xixirangrang <hfxsd@hotmail.com>
Date: Mon, 12 Jan 2026 20:30:41 +0800
Subject: [PATCH 20/25] Apply suggestions from code review

---
 releases/release-8.5.4.md | 22 +++++++++++-----------
 1 file changed, 11 insertions(+), 11 deletions(-)

diff --git a/releases/release-8.5.4.md b/releases/release-8.5.4.md
index bea76e6abd33..80afccbb7998 100644
--- a/releases/release-8.5.4.md
+++ b/releases/release-8.5.4.md
@@ -70,22 +70,22 @@ TiDB 版本：8.5.4
 
 | 变量 | 类型 | 描述 |
 |------|------|------|
-| [`tidb_mpp_store_fail_ttl`](/system-variables.md#tidb_mpp_store_fail_ttl) | 修改 | 默认值从 `60s` 修改为 `0s`，意味着 TiDB 不再需要额外等待即可向新启动的 TiFlash 节点发送查询请求，无需再通过延迟来避免查询失败 [#61826](https://github.com/pingcap/tidb/issues/61826) @[gengliqi](https://github.com/gengliqi) |
-| [`tidb_replica_read`](/system-variables.md#tidb_replica_read-从-v40-版本开始引入) | 修改 | 从 v8.5.4 开始，该变量仅对只读 SQL 语句生效，以提高数据读取安全性并减少与其他功能的重叠 [#62856](https://github.com/pingcap/tidb/issues/62856) @[you06](https://github.com/you06) |
-| [`tidb_opt_enable_no_decorrelate_in_select`](/system-variables.md#tidb_opt_enable_no_decorrelate_in_select-从-v854-版本开始引入) | 新增 | 控制是否对 `SELECT` 列表中的子查询进行解关联操作，默认值为 `OFF` [#51116](https://github.com/pingcap/tidb/issues/51116) @[terry1purcell](https://github.com/terry1purcell) |
-| [`tidb_opt_enable_semi_join_rewrite`](/system-variables.md#tidb_opt_enable_semi_join_rewrite-从-v854-版本开始引入) | 新增 | 控制是否改写 `EXISTS` 子查询，默认值为 `OFF` [#44850](https://github.com/pingcap/tidb/issues/44850) @[terry1purcell](https://github.com/terry1purcell) |
-| [`tidb_stats_update_during_ddl`](/system-variables.md#tidb_stats_update_during_ddl-从-v854-版本开始引入) | 新增 | 控制是否开启[内嵌于 DDL 的 Analyze 特性](/ddl_embedded_analyze.md)，默认值为 `OFF`。启用后，`ADD INDEX` DDL 会在执行期间收集新索引的统计信息，使索引添加完成后，优化器可以立即使用该索引。需要注意的是，对于大表加索引的场景，启用该变量可能增加 DDL 执行时间。 [#57948](https://github.com/pingcap/tidb/issues/57948) @[terry1purcell](https://github.com/terry1purcell) @[AilinKid](https://github.com/AilinKid) |
+| [`tidb_mpp_store_fail_ttl`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables#tidb_mpp_store_fail_ttl) | 修改 | 默认值从 `60s` 修改为 `0s`，意味着 TiDB 不再需要额外等待即可向新启动的 TiFlash 节点发送查询请求，无需再通过延迟来避免查询失败 [#61826](https://github.com/pingcap/tidb/issues/61826) @[gengliqi](https://github.com/gengliqi) |
+| [`tidb_replica_read`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables#tidb_replica_read-从-v40-版本开始引入) | 修改 | 从 v8.5.4 开始，该变量仅对只读 SQL 语句生效，以提高数据读取安全性并减少与其他功能的重叠 [#62856](https://github.com/pingcap/tidb/issues/62856) @[you06](https://github.com/you06) |
+| [`tidb_opt_enable_no_decorrelate_in_select`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables#tidb_opt_enable_no_decorrelate_in_select-从-v854-版本开始引入) | 新增 | 控制是否对 `SELECT` 列表中的子查询进行解关联操作，默认值为 `OFF` [#51116](https://github.com/pingcap/tidb/issues/51116) @[terry1purcell](https://github.com/terry1purcell) |
+| [`tidb_opt_enable_semi_join_rewrite`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables#tidb_opt_enable_semi_join_rewrite-从-v854-版本开始引入) | 新增 | 控制是否改写 `EXISTS` 子查询，默认值为 `OFF` [#44850](https://github.com/pingcap/tidb/issues/44850) @[terry1purcell](https://github.com/terry1purcell) |
+| [`tidb_stats_update_during_ddl`](https://docs.pingcap.com/zh/tidb/v8.5/system-variables#tidb_stats_update_during_ddl-从-v854-版本开始引入) | 新增 | 控制是否开启[内嵌于 DDL 的 Analyze 特性](/ddl_embedded_analyze.md)，默认值为 `OFF`。启用后，`ADD INDEX` DDL 会在执行期间收集新索引的统计信息，使索引添加完成后，优化器可以立即使用该索引。需要注意的是，对于大表加索引的场景，启用该变量可能增加 DDL 执行时间。 [#57948](https://github.com/pingcap/tidb/issues/57948) @[terry1purcell](https://github.com/terry1purcell) @[AilinKid](https://github.com/AilinKid) |
 
 ### 配置参数
 
 | 配置文件或组件 | 配置参数 | 类型 | 描述 |
 |------|------|------|------|
-| TiKV | [`rocksdb.max-manifest-file-size`](/tikv-configuration-file.md#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能 [#18889](https://github.com/tikv/tikv/issues/18889) @[glorv](https://github.com/glorv) |
-| TiKV | [`grpc-raft-conn-num`](/tikv-configuration-file.md#grpc-raft-conn-num) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
-| TiKV | [`grpc-concurrency`](/tikv-configuration-file.md#grpc-concurrency) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `5` 修改为 `grpc-raft-conn-num * 3 + 2` [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
-| TiKV | <ul><li>[`region-compact-check-interval`](/tikv-configuration-file.md#region-compact-check-interval)</li><li>[`region-compact-check-step`](/tikv-configuration-file.md#region-compact-check-step)</li><li>[`region-compact-min-tombstones`](/tikv-configuration-file.md#region-compact-min-tombstones)</li><li>[`region-compact-tombstones-percent`](/tikv-configuration-file.md#region-compact-tombstones-percent)</li><li>[`region-compact-min-redundant-rows`](/tikv-configuration-file.md#region-compact-min-redundant-rows-从-v710-版本开始引入)</li><li>[`region-compact-redundant-rows-percent`](/tikv-configuration-file.md#region-compact-redundant-rows-percent-从-v710-版本开始引入) </li></ul>| 废弃 | 由 [`gc.auto-compaction`](/tikv-configuration-file.md#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
-| TiKV |[`gc.auto-compaction`](/tikv-configuration-file.md#gcauto-compaction) 配置组包括：<ul><li>[`gc.auto-compaction.check-interval`](/tikv-configuration-file.md#check-interval-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.tombstone-num-threshold`](/tikv-configuration-file.md#tombstone-num-threshold-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.tombstone-percent-threshold`](/tikv-configuration-file.md#tombstone-percent-threshold-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.redundant-rows-threshold`](/tikv-configuration-file.md#redundant-rows-threshold-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.redundant-rows-percent-threshold`](/tikv-configuration-file.md#redundant-rows-percent-threshold-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.bottommost-level-force`](/tikv-configuration-file.md#bottommost-level-force-从-v757-和-v854-版本开始引入)</li></ul> | 新增 | 该配置组用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
-| TiFlash | [`flash.graceful_wait_shutdown_timeout`](/tiflash-configuration.md#graceful_wait_shutdown_timeout-从-v854-版本开始引入) | 新增 | 控制 TiFlash 优雅关闭的最长等待时间（秒），默认为 `600` 秒。当关闭 TiFlash 时，TiFlash 会继续执行尚未完成的 MPP 任务，但不再接收新的 MPP 任务。如果所有 MPP 任务在此超时时间前完成，TiFlash 将立即关闭；否则将在等待时间结束后强制关闭。[#10266](https://github.com/pingcap/tiflash/issues/10266) @[gengliqi](https://github.com/gengliqi) |
+| TiKV | [`rocksdb.max-manifest-file-size`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#max-manifest-file-size) | 修改 | 默认值从 `128MiB` 修改为 `256MiB`，以避免在单个 TiKV 节点的 SST 文件数量过多时，频繁触发 Manifest 文件的 compaction，从而影响整体性能 [#18889](https://github.com/tikv/tikv/issues/18889) @[glorv](https://github.com/glorv) |
+| TiKV | [`grpc-raft-conn-num`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-raft-conn-num) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `1` 修改为 `MAX(1, MIN(4, CPU 核数 / 8))`，当 CPU 核数 ≥ 32 时，最大默认连接数限制为 4 [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
+| TiKV | [`grpc-concurrency`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#grpc-concurrency) | 修改 | 为实现 gRPC 相关线程配置能根据 CPU 核数进行自适应调整，默认值从 `5` 修改为 `grpc-raft-conn-num * 3 + 2` [#18806](https://github.com/tikv/tikv/issues/18806) @[LykxSassinator](https://github.com/LykxSassinator) |
+| TiKV | <ul><li>[`region-compact-check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-interval)</li><li>[`region-compact-check-step`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-check-step)</li><li>[`region-compact-min-tombstones`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-tombstones)</li><li>[`region-compact-tombstones-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-tombstones-percent)</li><li>[`region-compact-min-redundant-rows`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-min-redundant-rows-从-v710-版本开始引入)</li><li>[`region-compact-redundant-rows-percent`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#region-compact-redundant-rows-percent-从-v710-版本开始引入) </li></ul>| 废弃 | 由 [`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#gcauto-compaction) 配置组替代，用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
+| TiKV |[`gc.auto-compaction`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#gcauto-compaction) 配置组包括：<ul><li>[`gc.auto-compaction.check-interval`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#check-interval-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.tombstone-num-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#tombstone-num-threshold-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.tombstone-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#tombstone-percent-threshold-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.redundant-rows-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-threshold-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.redundant-rows-percent-threshold`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#redundant-rows-percent-threshold-从-v757-和-v854-版本开始引入)</li><li>[`gc.auto-compaction.bottommost-level-force`](https://docs.pingcap.com/zh/tidb/v8.5/tikv-configuration-file#bottommost-level-force-从-v757-和-v854-版本开始引入)</li></ul> | 新增 | 该配置组用于控制自动 compaction 行为 [#18727](https://github.com/tikv/tikv/issues/18727) @[v01dstar](https://github.com/v01dstar) |
+| TiFlash | [`flash.graceful_wait_shutdown_timeout`](https://docs.pingcap.com/zh/tidb/v8.5/tiflash-configuration#graceful_wait_shutdown_timeout-从-v854-版本开始引入) | 新增 | 控制 TiFlash 优雅关闭的最长等待时间（秒），默认为 `600` 秒。当关闭 TiFlash 时，TiFlash 会继续执行尚未完成的 MPP 任务，但不再接收新的 MPP 任务。如果所有 MPP 任务在此超时时间前完成，TiFlash 将立即关闭；否则将在等待时间结束后强制关闭。[#10266](https://github.com/pingcap/tiflash/issues/10266) @[gengliqi](https://github.com/gengliqi) |
 
 ### MySQL 兼容性
 

From 5f18c7241698001887a515ad91eba1c465f28d8b Mon Sep 17 00:00:00 2001
From: Frank945946 <108602632+Frank945946@users.noreply.github.com>
Date: Mon, 9 Mar 2026 15:29:42 +0800
Subject: [PATCH 21/25] Update system-variables.md
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Update variable description of ‘tidb_service_scope’
---
 system-variables.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/system-variables.md b/system-variables.md
index 07c20abe665f..f83ec0a610ee 100644
--- a/system-variables.md
+++ b/system-variables.md
@@ -5019,7 +5019,7 @@ EXPLAIN FORMAT='brief' SELECT COUNT(1) FROM t WHERE a = 1 AND b IS NOT NULL;
 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否
 - 类型：字符串
 - 默认值：""
-- 可选值：长度小于或等于 64 的字符串，可用合法字符包括数字 `0-9`、字母 `a-zA-Z`、下划线 `_` 和连字符 `-`
+- 可选值：长度小于或等于 64 的字符串，可用合法字符包括数字 `0-9`、字母 `a-zA-Z`、下划线 `_` 和连字符 `-`。该变量的取值大小写不敏感。系统会将输入值转换为小写形式进行存储和比较。
 - 该变量是一个实例级别的变量，用于控制 [TiDB 分布式执行框架](/tidb-distributed-execution-framework.md)下各 TiDB 节点的服务范围。分布式执行框架会根据该变量的值决定将分布式任务调度到哪些 TiDB 节点上执行，具体规则请参考[任务调度](/tidb-distributed-execution-framework.md#任务调度)。
 
 ### `tidb_session_alias` <span class="version-mark">从 v7.4.0 版本开始引入</span>

From 42475f75dc20a748b351ac7a2b7ade950421bd14 Mon Sep 17 00:00:00 2001
From: Frank945946 <108602632+Frank945946@users.noreply.github.com>
Date: Mon, 9 Mar 2026 15:32:08 +0800
Subject: [PATCH 22/25] Update system-variables.md

---
 system-variables.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/system-variables.md b/system-variables.md
index f83ec0a610ee..645aa8aa33b4 100644
--- a/system-variables.md
+++ b/system-variables.md
@@ -5019,7 +5019,7 @@ EXPLAIN FORMAT='brief' SELECT COUNT(1) FROM t WHERE a = 1 AND b IS NOT NULL;
 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否
 - 类型：字符串
 - 默认值：""
-- 可选值：长度小于或等于 64 的字符串，可用合法字符包括数字 `0-9`、字母 `a-zA-Z`、下划线 `_` 和连字符 `-`。该变量的取值大小写不敏感。系统会将输入值转换为小写形式进行存储和比较。
+- 可选值：长度小于或等于 64 的字符串，可用合法字符包括数字 `0-9`、字母 `a-zA-Z`、下划线 `_` 和连字符 `-`。从 v8.5.6 版本开始，该变量的取值大小写不敏感。系统会将输入值转换为小写形式进行存储和比较。
 - 该变量是一个实例级别的变量，用于控制 [TiDB 分布式执行框架](/tidb-distributed-execution-framework.md)下各 TiDB 节点的服务范围。分布式执行框架会根据该变量的值决定将分布式任务调度到哪些 TiDB 节点上执行，具体规则请参考[任务调度](/tidb-distributed-execution-framework.md#任务调度)。
 
 ### `tidb_session_alias` <span class="version-mark">从 v7.4.0 版本开始引入</span>

From af64e19f25cb814cc871c209a105f647a0ce4875 Mon Sep 17 00:00:00 2001
From: xixirangrang <hfxsd@hotmail.com>
Date: Mon, 16 Mar 2026 16:28:35 +0800
Subject: [PATCH 23/25] Update system-variables.md

---
 system-variables.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/system-variables.md b/system-variables.md
index 645aa8aa33b4..92ff68b4703b 100644
--- a/system-variables.md
+++ b/system-variables.md
@@ -5019,7 +5019,7 @@ EXPLAIN FORMAT='brief' SELECT COUNT(1) FROM t WHERE a = 1 AND b IS NOT NULL;
 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否
 - 类型：字符串
 - 默认值：""
-- 可选值：长度小于或等于 64 的字符串，可用合法字符包括数字 `0-9`、字母 `a-zA-Z`、下划线 `_` 和连字符 `-`。从 v8.5.6 版本开始，该变量的取值大小写不敏感。系统会将输入值转换为小写形式进行存储和比较。
+- 可选值：长度小于或等于 64 的字符串，可用合法字符包括数字 `0-9`、字母 `a-zA-Z`、下划线 `_` 和连字符 `-`。从 v9.0.0 版本和 v8.5.6 版本开始，该变量的取值大小写不敏感。TiDB 会将输入值转换为小写形式进行存储和比较。
 - 该变量是一个实例级别的变量，用于控制 [TiDB 分布式执行框架](/tidb-distributed-execution-framework.md)下各 TiDB 节点的服务范围。分布式执行框架会根据该变量的值决定将分布式任务调度到哪些 TiDB 节点上执行，具体规则请参考[任务调度](/tidb-distributed-execution-framework.md#任务调度)。
 
 ### `tidb_session_alias` <span class="version-mark">从 v7.4.0 版本开始引入</span>

From c91463e1b9a35049625c1e5a6e41f6884f559c5d Mon Sep 17 00:00:00 2001
From: xixirangrang <hfxsd@hotmail.com>
Date: Mon, 16 Mar 2026 16:32:47 +0800
Subject: [PATCH 24/25] Update system-variables.md

---
 system-variables.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/system-variables.md b/system-variables.md
index 92ff68b4703b..0caffb6be06a 100644
--- a/system-variables.md
+++ b/system-variables.md
@@ -5019,7 +5019,7 @@ EXPLAIN FORMAT='brief' SELECT COUNT(1) FROM t WHERE a = 1 AND b IS NOT NULL;
 - 是否受 Hint [SET_VAR](/optimizer-hints.md#set_varvar_namevar_value) 控制：否
 - 类型：字符串
 - 默认值：""
-- 可选值：长度小于或等于 64 的字符串，可用合法字符包括数字 `0-9`、字母 `a-zA-Z`、下划线 `_` 和连字符 `-`。从 v9.0.0 版本和 v8.5.6 版本开始，该变量的取值大小写不敏感。TiDB 会将输入值转换为小写形式进行存储和比较。
+- 可选值：长度小于或等于 64 的字符串，可用合法字符包括数字 `0-9`、字母 `a-zA-Z`、下划线 `_` 和连字符 `-`。从 v8.5.6 版本和 v9.0.0 版本开始，该变量的取值大小写不敏感。TiDB 会将输入值转换为小写形式进行存储和比较。
 - 该变量是一个实例级别的变量，用于控制 [TiDB 分布式执行框架](/tidb-distributed-execution-framework.md)下各 TiDB 节点的服务范围。分布式执行框架会根据该变量的值决定将分布式任务调度到哪些 TiDB 节点上执行，具体规则请参考[任务调度](/tidb-distributed-execution-framework.md#任务调度)。
 
 ### `tidb_session_alias` <span class="version-mark">从 v7.4.0 版本开始引入</span>

From b66d24c20e0d747e836e8e0e7d57ae6ee81f31a8 Mon Sep 17 00:00:00 2001
From: houfaxin <hfxsd@hotmail.com>
Date: Wed, 1 Apr 2026 17:19:11 +0800
Subject: [PATCH 25/25] Update system-variables.md

---
 system-variables.md | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/system-variables.md b/system-variables.md
index 0caffb6be06a..38000bf9a988 100644
--- a/system-variables.md
+++ b/system-variables.md
@@ -5126,7 +5126,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec)
 >
 > 跳过字符检查可能会使 TiDB 检测不到应用写入的非法 UTF-8 字符，进一步导致执行 `ANALYZE` 时解码错误，以及引入其他未知的编码问题。如果应用不能保证写入字符串的合法性，不建议跳过该检查。
 
-### `tidb_slow_log_max_per_sec` <span class="version-mark">从 v9.0.0 版本开始引入</span>
+### `tidb_slow_log_max_per_sec` <span class="version-mark">从 v8.5.6 和 v9.0.0 版本开始引入</span>
 
 - 作用域：GLOBAL
 - 是否持久化到集群：是
@@ -5137,9 +5137,9 @@ Query OK, 0 rows affected, 1 warning (0.00 sec)
 - 控制每个 TiDB 节点每秒打印的慢查询日志的数量上限。
     - 当值为 `0` （默认值）时，表示不限制每秒打印的慢查询日志数量。
     - 当值大于 `0` 时，TiDB 每秒最多打印指定数量的慢查询日志，超过部分将被丢弃，不会写入慢查询日志文件。
-- 该变量常与 [`tidb_slow_log_rules`](#tidb_slow_log_rules-从-v900-版本开始引入) 结合使用，以防止在高负载情况下产生过多的慢查询日志。
+- 该变量常与 [`tidb_slow_log_rules`](#tidb_slow_log_rules-从-v856-和-v900-版本开始引入) 结合使用，以防止在高负载情况下产生过多的慢查询日志。
 
-### `tidb_slow_log_rules` <span class="version-mark">从 v9.0.0 版本开始引入</span>
+### `tidb_slow_log_rules` <span class="version-mark">从 v8.5.6 和 v9.0.0 版本开始引入</span>
 
 - 作用域：SESSION | GLOBAL
 - 是否持久化到集群：是
@@ -5150,7 +5150,7 @@ Query OK, 0 rows affected, 1 warning (0.00 sec)
 
 > **Tip:**
 >
-> 建议在启用 `tidb_slow_log_rules` 后，同时配置 [`tidb_slow_log_max_per_sec`](#tidb_slow_log_max_per_sec-从-v900-版本开始引入)，以限制慢查询日志打印频率，防止基于规则的慢查询日志触发过于频繁。
+> 建议在启用 `tidb_slow_log_rules` 后，同时配置 [`tidb_slow_log_max_per_sec`](#tidb_slow_log_max_per_sec-从-v856-和-v900-版本开始引入)，以限制慢查询日志打印频率，防止基于规则的慢查询日志触发过于频繁。
 
 ### `tidb_slow_log_threshold`