严重修复：图片压缩参数被应用到了视频上，导致视频播不了 (#56)

用户报（2026-11-05）：「你好像把 .mp4 后面也带上了问号，写成了 1600
这样的参数…你刚才没有进行图片压缩的时候，我自己播放好像还是好的。
是你更新了这个功能之后，出了这个问题。」

用户完全正确，这是我的错。

根因：media.php 只看 $imgW，没判是不是图片：
  Storage::read($familyId, $key, $imgW > 0 ? $OssSizes[$imgW] : );
⇒ 视频 URL 带 ?w=1600 后，给 .mp4 对象传了
  x-oss-process=image/resize,l_1600
⇒ OSS 图片处理服务对非图片返回错误内容
⇒ <video> 拿不到有效数据 ⇒ 播不了

三道防线：

1. _attachments.php（直接触发点）
   原来对所有附件都传 w=1600。改为 $attKind === image 才传。
   视频只传 v（版本号，破缓存用）。

2. media.php（核心防线）
   $imgW 与 $isImageKey 绑定，只有图片才允许压缩。
   $isImageKey 判定提前到 Storage::read 之前，
   并扩到扩展名兜底（jpg/png/webp...），
   视频/文档扩展名强制 false。

3. media_url()（前置防线）
   生成 URL 时按扩展名过滤：非图片自动去掉 w。
   这样即使调用方传错，URL 里也不会出现无效参数。

验证（模拟事故场景，URL 带 ?w=1600 请求 .mp4）：
  HTTP 206，Content-Type: video/mp4
  无 hvc1，含 avc1
  ffprobe: h264/yuv420p，2.19MB  ✅ 正常

  media_url 生成视频 URL：...mp4&v=2295119（无 w）
  media_url 生成图片 URL：...jpg&w=1600&v=609017（有 w）

media.php

@@ -75,6 +75,25 @@ $OssSizes = [
 if (!array_key_exists($imgW, $OssSizes)) {
     $imgW = 0;   // 非法值一律按原图处理
 }
+
+/**
+ * 这个 key 是图片吗（#56）。
+ *
+ * ⚠️ **必须在 Storage::read 之前算好** —— 压缩参数只允许给图片，
+ *    给视频传 `x-oss-process=image/...` 会让 OSS 返回错误内容，
+ *    表现就是"视频播不了"。（这就是 2026-11-05 那次事故的根因。）
+ *
+ * ⚠️ 除了路径前缀，再看扩展名兜底：`files/xxx.mp4` 不在前缀里，
+ *    但万一将来有图片挪到别的目录，扩展名还能挡住视频。
+ */
+$isImageKey = (bool)preg_match('#^avatars/|^bookcovers/|^posters/|^photos/|^tickets/#', $key);
+if (!$isImageKey && preg_match('#\.(jpe?g|png|gif|webp|bmp|avif)$#i', $key)) {
+    $isImageKey = true;
+}
+/* 视频/文档扩展名强制非图片（防止上面的扩展名兜底误判） */
+if (preg_match('#\.(mp4|mov|m4v|webm|avi|mkv|mp3|m4a|pdf|docx?|xlsx?|pptx?|rar|zip)$#i', $key)) {
+    $isImageKey = false;
+}
 $stageTok = (string)($_GET['stage'] ?? '');
 
 /*
@@ -188,7 +207,6 @@ foreach (explode('/', $key) as $seg) {
            不让缓存无限长大把磁盘吃满。
 
    ⚠️ 顺序不能反：先放锁、再取内容（取内容可能要几百毫秒）。 */
-$isImageKey = (bool)preg_match('#^avatars/|^bookcovers/|^posters/|^photos/|^tickets/#', $key);
 if ($isImageKey) {
     // 图片是"只读、可重复取、可静态化"的，两次都用不到会话写权限
     if (session_status() === PHP_SESSION_ACTIVE) {
@@ -196,7 +214,23 @@ if ($isImageKey) {
     }
 }
 
-$res    = Storage::read($familyId, $key, $imgW > 0 ? $OssSizes[$imgW] : '');
+/* 🔴🔴 #56 严重修复（用户 2026-11-05：「你好像把 .mp4 后面也带上了问号…
+   是你更新了这个功能之后，出了这个问题」）：
+
+   **图片压缩参数绝不能应用到视频上。**
+
+   原来的写法只看 `$imgW`，不看这是不是图片：
+
+       $res = Storage::read($familyId, $key, $imgW > 0 ? $OssSizes[$imgW] : '');
+
+   ⇒ 视频请求带上 `?w=1600` 后，会给 **.mp4 对象**传
+      `x-oss-process=image/resize,l_1600` ⇒ OSS 图片处理服务
+      对非图片返回错误/空内容 ⇒ `<video>` 拿不到有效数据 ⇒ **播不了**。
+
+   ⇒ 现与 `$isImageKey` 绑定：**只有图片才允许压缩**。
+      视频/PDF/文档一律走原样。 */
+$res    = Storage::read($familyId, $key,
+    ($imgW > 0 && $isImageKey) ? $OssSizes[$imgW] : '');
 $status = (int)($res['status'] ?? 0);
 $body   = (string)($res['body'] ?? '');