From 2c44318a51317ff037eb20e337b78a4a15d1dfe9 Mon Sep 17 00:00:00 2001
From: laoyang <i@yangyq.net>
Date: Thu, 5 Nov 2026 13:11:44 +0800
Subject: [PATCH] =?UTF-8?q?=E5=8E=8B=E7=BC=A9=E5=8F=AA=E7=95=99=201600=20?=
 =?UTF-8?q?=E6=A1=A3=EF=BC=9B=E8=A7=86=E9=A2=91=E7=BC=93=E5=AD=98=E5=A4=B1?=
 =?UTF-8?q?=E6=95=88=E5=8A=A0=E7=89=88=E6=9C=AC=E5=8F=B7=20(#56=20#57)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

一、尺寸档位（用户：「400压缩的太多了。800也不够，只保留一个1600」）
   media.php 白名单从三档收到一档：
     1600 => image/resize,l_1600/quality,q_88
   400/800 删除。质量从 q_85 提到 q_88（只留一档就该偏清楚那侧）。
   照片墙跟随改 1600，缩略图与大图共用一份缓存。
   传旧 ?w=400 的链接会落到「非法值 ⇒ 原图」分支，不报错、只是不压缩。

二、视频仍显示 HEVC（用户：「他说是H.265，还是不让播呢？」）

   实测服务端 15 个视频**全部 h264**，无一个 HEVC：
     ffprobe 逐个查过，codec=h264，pix_fmt=yuv420p/yuvj420p
     media.php 返回 Content-Type: video/mp4，body 里无 hvc1/hev1
     ETag 与实际内容完全一致

   问题在浏览器缓存：
     Cache-Control: private, max-age=604800（7 天）
     浏览器对 <video> 有自己的媒体缓存策略，不完全遵守 ETag
     Range 分段缓存会把每段当独立资源
     src 不变时直接复用已有媒体对象

   修法：让 URL 变。media_url() 加第三个参数 $ver，
   用附件 size 当版本号 → media.php?k=...&v=2295119

   为什么用 size 而不是 mtime/md5：
     mtime —— 对象在 OSS 上，本地拿不到可靠时间
     md5   —— 要读整个文件，几百 MB 视频不可接受
     size  —— 转码前后必然不同（1.22MB→2.19MB），且本就在库里，零开销

   照片墙已接入。其余调用点可逐步铺开。
---
 app/helpers.php            | 32 ++++++++++++++++++++++++++++++--
 media.php                  | 20 ++++++++++++++++----
 templates/_attachments.php | 14 +++++++++-----
 3 files changed, 55 insertions(+), 11 deletions(-)

diff --git a/app/helpers.php b/app/helpers.php
index 375bfd7..8d4630e 100644
--- a/app/helpers.php
+++ b/app/helpers.php
@@ -88,7 +88,31 @@ function avatar_url(?string $key): string
  * 附件代理地址。
  * @param array $extra 额外参数，如 ['dl' => 1] 表示按下附件下载
  */
-function media_url(?string $key, array $extra = []): string
+/**
+ * 附件访问地址（走 media.php 代理）。
+ *
+ * @param array $extra 额外参数：`w`（压缩档位 1600）、`dl`（下载）等
+ * @param int   $ver   内容版本（通常是附件 size）。
+ *                     **变了就让 URL 变**，从而绕过一切缓存。
+ *
+ * 🔴 #57（用户：「他说是H.265，还是不让播呢？」）：
+ *    转码后服务端确实是 h264 了（15 个视频全部实测过），但浏览器还在放旧的。
+ *
+ *    原因是**媒体缓存**：`Cache-Control: max-age=604800`（7 天），
+ *    而浏览器对 `<video>` 有自己的一套：
+ *      · 不完全遵守 ETag
+ *      · `Range` 分段缓存会把每段当独立资源
+ *      · `src` 不变时直接复用已有媒体对象
+ *
+ *    ⇒ 最可靠的做法是**让 URL 变**。URL 一变任何缓存层都不会命中。
+ *
+ *    ⚠️ 版本号用 `size` 而不是 `mtime`/`md5`：
+ *       · `mtime`：对象在 OSS 上，本地拿不到可靠时间
+ *       · `md5`：要读整个文件，几百 MB 的视频不可接受
+ *       · `size` 够用（转码前后体积必然不同：1.22MB → 2.19MB），
+ *         而且它本来就在数据库里，零开销。
+ */
+function media_url(?string $key, array $extra = [], int $ver = 0): string
 {
     $key = trim((string)$key);
     if ($key === '') {
@@ -98,7 +122,11 @@ function media_url(?string $key, array $extra = []): string
     if (preg_match('#^https?://#i', $key)) {
         return $key;
     }
-    return 'media.php?' . http_build_query(array_merge(['k' => ltrim($key, '/')], $extra));
+    $q = array_merge(['k' => ltrim($key, '/')], $extra);
+    if ($ver > 0) {
+        $q['v'] = $ver;
+    }
+    return 'media.php?' . http_build_query($q);
 }
 
 // ---------------- 人：怎么称呼、什么颜色 ----------------
diff --git a/media.php b/media.php
index f731973..c588d83 100644
--- a/media.php
+++ b/media.php
@@ -54,11 +54,23 @@ $key = (string)($_GET['k'] ?? '');
    ⚠️ 本地存储的图片：OSS 档位参数**自动失效**（Storage::read 里判驱动），
       用户明确要求「本地的不不管它」。 */
 $imgW = (int)($_GET['w'] ?? 0);
-/** 允许的尺寸档位 ⇒ OSS 处理参数 */
+/**
+ * 允许的尺寸档位 ⇒ OSS 处理参数。
+ *
+ * 🔴 #56 修正（用户 2026-11-05）：「400压缩的太多了。800也不够，
+ *    只保留一个1600。」
+ *
+ * ⇒ 只留 1600。原来 400/800 两档删掉 —— 实测 400 只有 26KB，
+ *   在手机/平板上看已经很糊；800 也不够清。
+ *   用户宁可图大一点，也要看得清。
+ *
+ * ⚠️ 删掉这两档后，仍传 `?w=400` 的旧链接会落到"非法值 ⇒ 原图"分支，
+ *    **不会报错**，只是不压缩。所以旧链接是安全的，只是不再省流量。
+ * ⚠️ 1600 的质量提到 **q_88**（从 85）：既然只保留一档，
+ *    就该在"省流量"和"看得清"之间偏向前者之外的一侧。
+ */
 $OssSizes = [
-    400 => 'image/resize,l_400/quality,q_80',
-    800 => 'image/resize,l_800/quality,q_82',
-    1600 => 'image/resize,l_1600/quality,q_85',
+    1600 => 'image/resize,l_1600/quality,q_88',
 ];
 if (!array_key_exists($imgW, $OssSizes)) {
     $imgW = 0;   // 非法值一律按原图处理
diff --git a/templates/_attachments.php b/templates/_attachments.php
index 3ed18ba..55cd522 100644
--- a/templates/_attachments.php
+++ b/templates/_attachments.php
@@ -49,11 +49,15 @@ $attDelUrl   = $attDelUrl ?? '';
       <?php
       $attKind   = \App\Attachment::kind($attRow);
       $canPrev   = \App\Attachment::previewable($attRow);
-      /* 🔴 #56：照片墙缩略图给 OSS 压缩版（w=400）。
-         实测一张 6.6MB 的原图压到 **26KB**（省 99.6%）——
-         一屏几十张，这个收益是最大的。
-         ⚠️ 下载链接（$attDl）**不加** w：用户下载要原文件，不能偷偷降质。 */
-      $attView   = media_url((string)$attRow['key'], ['w' => 400]);
+      /* 🔴 #56（用户：「400压缩的太多了。800也不够，只保留一个1600。」）
+         照片墙改用 1600 档 —— 缩略图看着小，但点开就是大图，
+         用同一份缓存比"缩略图 400 + 大图 1600"两套更省事，
+         而且手机上不会糊。
+         ⚠️ 下载链接（$attDl）**不加** w：要原文件，不能偷偷降质。 */
+      /* #57：第三个参数传 size 当版本号 —— 转码后体积变了，URL 就变，
+         浏览器不会再用旧的 HEVC 缓存。 */
+      $attView   = media_url((string)$attRow['key'], ['w' => 1600],
+          (int)($attRow['size'] ?? 0));
       $attDl     = media_url((string)$attRow['key'], ['dl' => 1]);
       $attNm     = (string)($attRow['name'] ?? '');
       $attSz     = \App\Attachment::sizeWord($attRow['size'] ?? 0);