diff --git a/.env.example b/.env.example
index 1c79ffe..a3345ba 100644
--- a/.env.example
+++ b/.env.example
@@ -110,3 +110,11 @@ IMAGE_DISK_CACHE_MAX_MB=1024
 # 文件最大保留时长，单位小时（默认 168，即 7 天）。超期的文件优先删除。
 # ⚠️ 清理任务每小时运行一次，改了不会立即生效，最长需等 1 小时。
 IMAGE_DISK_CACHE_MAX_AGE_HOURS=168
+
+# ─────────────────────────────────────────────────────────────
+# 图片尺寸缓存（blur-up 占位图的 aspect-ratio 来源）
+# ─────────────────────────────────────────────────────────────
+# 图片尺寸缓存的 TTL，单位秒（默认 86400，即 24 小时）。
+# 服务端读取图片 header 拿真实宽高，用于生成 aspect-ratio 避免布局跳动。
+# 图片尺寸永不变，理论可设很长，但缓存重启会清空。
+IMAGE_DIMENSIONS_CACHE_TTL_SECS=86400