diff --git a/.env.example b/.env.example
index a3345ba..ebd2487 100644
--- a/.env.example
+++ b/.env.example
@@ -102,6 +102,17 @@ COMPRESSION_ALGORITHMS=gzip,brotli,deflate,zstd
 #   - 原始上传：更改其文件路径；
 #   - 处理变体：更改处理参数（查询串不同即视为新资源）。
 
+# ─────────────────────────────────────────────────────────────
+# 上传图片尺寸/像素上限（硬编码默认值，非环境变量）
+# ─────────────────────────────────────────────────────────────
+# 上传时在 header 阶段统一校验(JPEG/PNG/WebP/GIF 同一路径),超限直接 400 拒绝:
+#   单边最大 4096px(MAX_IMAGE_DIMENSION,见 src/api/image.rs)
+#   总像素最大约 2500 万(MAX_IMAGE_PIXELS,约 5000×5000)
+# 超限返回:"图片尺寸过大,请压缩到 4096×4096 以内或单图不超过约 5000 万像素后再上传"。
+# 这两个值同时也是图片解码的安全护栏(防超大图撑爆内存),不宜轻易下调。
+# 如需调整,改 src/api/image.rs 的 const 后重新编译。
+# 注:读取侧 GET /uploads/* 的动态处理(?w= 等)沿用同一上限,无参数取原图不查像素。
+
 # ─────────────────────────────────────────────────────────────
 # 图片磁盘缓存上限（uploads/.cache/，后台清理任务每小时扫描一次）
 # ─────────────────────────────────────────────────────────────