From 6aab0c4ee48bc01f8bbf6e2b3357e9a487d33cbb Mon Sep 17 00:00:00 2001
From: qiansc <van3008@163.com>
Date: Mon, 9 Nov 2026 01:31:12 +0000
Subject: [PATCH] docs: align storage and retention wording with snapshot
 eviction

The storage budget hint and the settings-update note describe oldest-first
release and retention after preparation.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 internal/service/management.go | 5 +++--
 web/assets/repo-page.js        | 2 +-
 2 files changed, 4 insertions(+), 3 deletions(-)

diff --git a/internal/service/management.go b/internal/service/management.go
index 15755ce..7cce577 100644
--- a/internal/service/management.go
+++ b/internal/service/management.go
@@ -79,7 +79,7 @@ func (s *Service) Preview(ctx context.Context, name string, u Update) (any, erro
 	if u.SyncIntervalMinutes != nil {
 		interval = *u.SyncIntervalMinutes
 	}
-	return map[string]any{"sync_interval_minutes": interval, "revision": r.Revision, "preview": preview(r, u), "retained_versions": len(r.Versions), "note": "Retention applies at successful synchronization; pinned snapshots and branch heads remain available. Expired Git objects are reclaimed after synchronization."}, nil
+	return map[string]any{"sync_interval_minutes": interval, "revision": r.Revision, "preview": preview(r, u), "retained_versions": len(r.Versions), "note": "Retention applies after each successful synchronization and preparation; branch heads, pinned snapshots and snapshots of active jobs remain available. Released Git objects are reclaimed in the background."}, nil
 }
 func (s *Service) Update(ctx context.Context, name string, u Update, revision int64) (control.Repository, error) {
 	if e := validateUpdate(u); e != nil {
@@ -156,7 +156,8 @@ func (s *Service) Update(ctx context.Context, name string, u Update, revision in
 		}
 	}
 	// Path changes invalidate the indexed scope; retention changes take effect
-	// at synchronization while already published snapshots remain available.
+	// at the next synchronization or preparation while already published
+	// snapshots remain available.
 	if groupsChanged {
 		r.DefaultBranch = ""
 		r.ObservedAt = time.Time{}
diff --git a/web/assets/repo-page.js b/web/assets/repo-page.js
index 8150157..053664f 100644
--- a/web/assets/repo-page.js
+++ b/web/assets/repo-page.js
@@ -201,7 +201,7 @@
         '<div class="flex flex-col gap-6 sm:flex-row sm:items-start sm:gap-10"><label class="block"><span>'+t('保留','Retention')+'</span><span class="ml-2 text-[13px] text-muted">'+t('未固定的过期快照会自动回收','Unpinned expired snapshots are collected')+'</span><div class="flex items-center gap-2"><input id="pvalue" required type="number" min="1" max="'+(draft.kind==='days'?365:4096)+'" class="'+inp+' w-24" value="'+esc(draft.value)+'"><select id="pkind" class="mt-2 rounded-control bg-transparent py-2 text-muted hover:text-ink"><option value="days" '+(draft.kind==='days'?'selected':'')+'>'+t('天','days')+'</option><option value="count" '+(draft.kind==='count'?'selected':'')+'>'+t('个提交','commits')+'</option></select></div></label>'+
         '<div class="shrink-0"><label for="psync-interval">'+t('同步间隔','Sync interval')+'</label><select id="psync-interval" class="'+inp+' block w-40 max-w-full">'+M.syncIntervalOptions(draft.syncInterval)+'</select></div><div><label for="pgit-timeout">'+t('Git 同步超时','Git sync timeout')+'</label><select id="pgit-timeout" class="'+inp+' block w-40 max-w-full">'+M.gitTimeoutOptions(draft.gitTimeout)+'</select></div></div>'+
  '<p class="text-[13px] text-muted">'+t('默认继承全局；用于 Git 拉取及文件对象补拉，新任务启动时生效。','Inherit global by default; used for Git fetching and object hydration when a new task starts.')+'</p>'+
-        '<div><label for="pstorage">'+t('仓库容量预算（GiB）','Repository storage budget (GiB)')+'</label><input id="pstorage" type="number" min="1" max="10240" step="1" required class="'+inp+' block" value="'+esc(draft.storageGiB)+'"><p class="mt-2 text-muted">'+t('包含 Git、索引和任务临时文件；达到预算会停止新增准备。','Includes Git, indexes and temporary job files; reaching the budget stops new preparation.')+'</p></div>'+
+        '<div><label for="pstorage">'+t('仓库容量预算（GiB）','Repository storage budget (GiB)')+'</label><input id="pstorage" type="number" min="1" max="10240" step="1" required class="'+inp+' block" value="'+esc(draft.storageGiB)+'"><p class="mt-2 text-muted">'+t('包含 Git、索引和任务临时文件；用满时先按先后释放未受保护的旧快照。','Includes Git, indexes and temporary job files; when it is full, the oldest unprotected snapshots are released first.')+'</p></div>'+
         '<div><label for="ppins">'+t('固定保留版本（每行一个完整 SHA）','Pinned snapshots (one full SHA per line)')+'</label><textarea id="ppins" rows="4" class="'+inp+' block w-full">'+esc(draft.pins)+'</textarea><p class="mt-2 text-muted">'+t('固定的版本不受保留策略和容量淘汰影响，只在此手动添加；准备版本不会自动固定。删除此处的 SHA 后，该版本重新受保留策略约束。','Pinned snapshots are never released by retention or capacity eviction and are only added here; preparing a commit does not pin it. Removing a SHA here returns it to ordinary retention.')+'</p></div>'+
         '<label class="flex items-center gap-2 text-muted"><input id="ppublic" type="checkbox" '+(draft.publicRead?'checked':'')+' class="accent-current">'+t('公开仓库：所有人可搜索和查看；取消后仅创建者、仓库管理员和站点管理员可见','Public repository: anyone can search and view it. When cleared, only its creator, repository managers and site administrators can see it')+'</label>'+
         '<label class="flex items-start gap-2 text-muted"><input id="pskip-generated" type="checkbox" '+(draft.skipGenerated?'checked':'')+' class="mt-1 accent-current"><span>'+t('不为压缩的 JS/CSS 和 source map 建立索引','Leave minified JS/CSS and source maps out of the index')+'<span class="mt-0.5 block text-[13px]">'+t('平均行长超过 110 字节的 .js/.css 与 .map 文件不可搜索，仍可直接查看；lock 文件不受影响。下次建立索引时生效','.js/.css files averaging over 110 bytes per line and .map files are not searchable but can still be viewed; lock files are unaffected. Applies from the next index build')+'</span></span></label>'+