diff --git a/docs/V21-UI-ACCEPTANCE-CHECKLIST.md b/docs/V21-UI-ACCEPTANCE-CHECKLIST.md
index 092e49f46..f3ffebdf7 100644
--- a/docs/V21-UI-ACCEPTANCE-CHECKLIST.md
+++ b/docs/V21-UI-ACCEPTANCE-CHECKLIST.md
@@ -130,3 +130,9 @@ V21 结构：三张套餐 feature 卡片，免费版/专业版/企业版，推
 - 已将 runner .runner.address 修正为 https://git.xiaoxiajianji.com/ 并重启，runner 已可拉取任务。
 - 随后发现 deploy workflow 使用 github.ref 条件在 Gitea 中判断为 false，已改为 github.ref_name == 'main' || github.ref_name == 'develop'。
 
+
+## 2026-06-24 CI 镜像修复记录
+
+- xiaoxia-ci-python:3.12 本地镜像缺失，runner 尝试从 Docker Hub 拉取不存在/不可达镜像。
+- 由于外网代理拉 python:3.12-slim 超时，已临时从服务器已有 xiaoxia-saas-api:dev 派生构建 xiaoxia-ci-python:3.12，补齐 black/isort/flake8/bandit/pytest。
+