From b6ba1c2f13d39390193394a8f6dceaee20932507 Mon Sep 17 00:00:00 2001
From: pikastech <liang6516@outlook.com>
Date: Tue, 21 Jul 2026 08:06:49 +0200
Subject: [PATCH] perf: enlarge confirmed registry GC batches

---
 config/unidesk-cli.yaml | 2 +-
 docs/reference/gc.md    | 1 +
 2 files changed, 2 insertions(+), 1 deletion(-)

diff --git a/config/unidesk-cli.yaml b/config/unidesk-cli.yaml
index 5393e50e..d559e21f 100644
--- a/config/unidesk-cli.yaml
+++ b/config/unidesk-cli.yaml
@@ -180,7 +180,7 @@ gc:
           estimateBlobLimit: 5000
           automatic:
             enabled: false
-            maxDeleteManifestsPerRun: 100
+            maxDeleteManifestsPerRun: 500
             writerGraceMinutes: 30
             requireIdleNamespaces:
               - devops-infra
diff --git a/docs/reference/gc.md b/docs/reference/gc.md
index 46504f14..f5609142 100644
--- a/docs/reference/gc.md
+++ b/docs/reference/gc.md
@@ -57,6 +57,7 @@
   - PVC 只挂载给 GC Pod，不删除 PVC、PV、blob 目录、containerd 或 k3s storage；
   - 无论成功或失败都恢复原副本数，并复核 Deployment readiness 与 `/v2/` endpoint。
   - writer idle guard 只阻塞 YAML grace 窗口内的新任务，或仍有 `Pending`/`Running` Pod 的 Tekton run；超过 grace 且没有活动 Pod 的残留 run 只报告为 stale，不得永久阻塞维护。
+  - 每批 manifest 上限由 YAML `automatic.maxDeleteManifestsPerRun` 控制；即使自动策略关闭，人工确认态也复用该批量边界并在每批前重新计算保护闭包。
 - `--include-tool-caches`：本机和远端都必须是显式 opt-in，只清理固定 allowlist 的可重建 npm/npx/Bun 缓存；不得扩大成清理 `~/.npm`、`~/.bun`、`node_modules`、auth/config 或运行面依赖。
 
 所有成功和失败输出都必须是 JSON。`plan` 必须标记 `dryRun=true`、`mutation=false`；`run` 必须要求 `--confirm` 并报告 `diskBefore`、`diskAfter`、`summary`、`results` 和 `protected`。远端 GC 可用 `--target-use-percent N` 显式表达目标根盘水位；`summary.target` 必须给出目标所需释放量、候选估算、预计水位、缺口和 `safeStop` 决策，避免靠人工心算判断是否应该继续扩大清理范围。