静态资源交给 Cloudflare 边缘缓存（下载提速 41 倍）

实测基线：
  ykxmz-setup-1.8.1.exe   只下到 237568/15067199 字节就停（17 KB/s）
  ykxmz-watch-1.8.1.apk   201523 字节 / 66.8 秒 = 3 KB/s
  ykxmz-server-1.8.1.zip  214900 字节 / 3.1 秒  = 67 KB/s

原因：relay 给所有响应都发 Cache-Control: no-store，
Cloudflare 完全不缓存 —— 每次下载/每张图都要穿隧道回 4G 源站。

改动：
  /download/*   no-store -> public, max-age=604800, immutable
                文件名带版本号，同一名字内容永不改变，可以长缓存
  /             -> public, max-age=60（挡住刷新重复回源）
  /favicon.ico  已是 max-age=86400，保持不变
  /shot/*       已是 max-age=86400，保持不变
  /v1/*         保持 no-store（接口必须实时）

顺带修两个自己踩的坑：

1. _send() 无条件先发 no-store，再追加 extra 里的 Cache-Control，
   结果是**两个 Cache-Control 头**，客户端只认第一个 ——
   调用方传的缓存策略被吃掉。改成 extra 里有就不再发默认值。

2. do_HEAD 和 do_GET 的缓存头不一致：HEAD 对非 /shot/ 一律报 no-store。
   下载器/代理用 HEAD 探测时会误判文件不可缓存。
   现在 _head_info 给每个路由带上和 GET 完全相同的缓存头，
   do_HEAD 也不再盲目覆盖。

结果（同一个测试口径）：
  setup.exe  17 KB/s（截断） -> 695 KB/s 完整 15 MB   41 倍
  watch.apk   3 KB/s         -> 101 KB/s              33 倍
  server.zip 67 KB/s         ->  87 KB/s
  三个文件全部 cf-cache-status=HIT（不再穿隧道回源）

排查过程记一笔：我一开始用 curl -I 验证，
看到的全是 no-store —— 因为 **-I 发的是 HEAD**，
而 HEAD 走的是另一个分支。查了半天才发现是验证方法错了。

_build/add_site_cache.py

@@ -0,0 +1,62 @@
+# -*- coding: utf-8 -*-
+r'''给官网首页加 60 秒缓存。
+
+（download 那处已经用 edit 工具改好了：no-store ->
+ public,max-age=604800,immutable。）
+
+首页原来走 _send 的默认 Cache-Control: no-store，
+每次刷新都穿隧道回 4G 源站。加 60 秒缓存：
+  * 挡住"刷新就重新回源"的浪费
+  * 又不会让页面上的当前版本号 / 下载按钮过期太久
+'''
+from __future__ import annotations
+
+import sys
+from pathlib import Path
+
+SRC = Path(r"C:\Users\shu\Desktop\deepseekagent\LanRemote\relay\relay.py")
+
+
+def main() -> int:
+    text = SRC.read_text(encoding="utf-8")
+
+    marker = 'self._send(200, _site_page().encode("utf-8"),\n'
+    idx = text.find(marker)
+    if idx < 0:
+        print("  ✗ 找不到首页的 _send")
+        return 1
+
+    # 打印现场，确认空白
+    end = text.find("\n", text.find("return", idx))
+    print("  现场:")
+    for line in text[idx:end + 1].splitlines():
+        print("    %r" % line)
+
+    old = ('self._send(200, _site_page().encode("utf-8"),\n'
+           '                      "text/html; charset=utf-8")')
+    new = ('# 缓存 60 秒：挡住"刷新就重新回源"的浪费，\n'
+           '            # 又不会让页面上的当前版本号和下载按钮过期太久。\n'
+           '            self._send(200, _site_page().encode("utf-8"),\n'
+           '                       "text/html; charset=utf-8",\n'
+           '                       {"Cache-Control": "public, max-age=60"})')
+
+    if old not in text:
+        print()
+        print("  ✗ 精确串还是没匹配上（看上面的 repr 对齐空白）")
+        return 1
+
+    text = text.replace(old, new, 1)
+    SRC.write_text(text, encoding="utf-8", newline="\n")
+    print()
+    print("  ✓ 已加首页缓存")
+
+    # 复核
+    for i, line in enumerate(
+            SRC.read_text(encoding="utf-8").splitlines(), 1):
+        if "max-age=60" in line:
+            print("    第 %d 行: %s" % (i, line.strip()))
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())