降低线上轮询压力：后台标签页暂停轮询、关闭 access log

线上容器（cpu-basic，2 共享 vCPU）实测 1841 req/s，超出承载数倍，
导致连返回静态 JS 都要 55 秒。日志拆解后，热点全是自家前端的全局轮询接口：

/auth/session 375/s
/api/chat-room/unread 359/s
/api/chat-room/direct-conversations 350/s
/api/presence/ping 334/s
/api/announcements 106/s

四项改动（均不改变任何功能，用户感知不到差别）：

1) Dockerfile 去掉 --access-log
实测 access log 占日志体积一半（约 285 KB/s、1800 行/秒），容器只有
2 核，每条请求都多一次格式化 + write 系统调用。注意 main.py 末尾的
uvicorn.run(access_log=False) 在线上不会执行（CLI 启动），所以必须改这里。

2) use-chat-room-unread：只在页面可见时轮询
这个 hook 挂在全局导航，每个标签页都在跑，含切到后台/被遗忘的标签页。
后台没人看角标，请求却照打。切回页面时立刻补拉一次。

3) announcements-popover：同样只在可见时轮询
该组件在顶栏挂了 2 份（移动端/桌面端各一），每个标签页跑两份。

4) use-auth-guard：权限兜底同步 5s → 30s
原本是 force 校验（绕过本地缓存直打服务端），是全站最重接口、占请求 20%。
权限和登录态不会 5 秒一变；focus / visibilitychange 仍会立刻强制校验一次，
真实感知比 30 秒更灵敏。

presence 心跳保持后台上报（约 25s）不变 —— 那是「在线人数」要统计后台标签页的
有意设计，属功能行为，未改动。

真机验证（artifacts/_visibility_gate_test.py）10/10 通过：
可见时 unread / direct-conversations 正常轮询
切后台后四项 gated 接口 45s 内全部 0 次，而 presence 心跳仍在
切回前台 5s 内立刻补拉 unread / direct-conversations / announcements

Dockerfile

@@ -69,4 +69,8 @@ PY
 
 EXPOSE 7860
 
-CMD ["uv", "run", "uvicorn", "main:app", "--host", "0.0.0.0", "--port", "7860", "--access-log"]
+# ⚠️ 不要加 --access-log：线上实测它占日志体积一半（约 285 KB/s，1800 条/秒），
+# 而容器只有 2 个共享 vCPU，每条请求都多一次格式化 + write 系统调用。
+# 注意 main.py 末尾的 uvicorn.run(access_log=False) 在线上**不会执行**（这里是 CLI 启动），
+# 所以只改 main.py 无效，必须在这里保持一致。
+CMD ["uv", "run", "uvicorn", "main:app", "--host", "0.0.0.0", "--port", "7860"]

web/src/components/announcements-popover.tsx

@@ -166,10 +166,35 @@ export function AnnouncementsPopover({ session }: { session: StoredAuthSession }
       }
     };
     void load();
-    const timer = window.setInterval(() => void load(), 5 * 60_000);
+
+    // ⚠️ 只在页面可见时轮询：这个组件在顶栏挂了 2 份（移动端 / 桌面端各一），
+    // 每个标签页都在跑。后台标签页没人看公告，却在持续打服务端。
+    // 切回页面时立刻补拉一次，感知不到差别。
+    let timer: number | undefined;
+    const stopPolling = () => {
+      if (timer === undefined) return;
+      window.clearInterval(timer);
+      timer = undefined;
+    };
+    const startPolling = () => {
+      if (timer !== undefined) return;
+      timer = window.setInterval(() => void load(), 5 * 60_000);
+    };
+    const onVisibilityChange = () => {
+      if (document.visibilityState === "visible") {
+        void load();
+        startPolling();
+      } else {
+        stopPolling();
+      }
+    };
+
+    startPolling();
+    document.addEventListener("visibilitychange", onVisibilityChange);
     return () => {
       active = false;
-      window.clearInterval(timer);
+      stopPolling();
+      document.removeEventListener("visibilitychange", onVisibilityChange);
     };
   }, [itemsStorageKey]);
 

web/src/lib/use-auth-guard.ts

@@ -15,7 +15,16 @@ type UseAuthGuardResult = {
   session: StoredAuthSession | null;
 };
 
-const AUTH_PERMISSION_SYNC_INTERVAL_MS = 5_000;
+/**
+ * 权限 / 登录态的兜底同步间隔。
+ *
+ * ⚠️ 原来是 5 秒一次 **force** 校验（绕过 10 秒本地缓存，每次都实打服务端），
+ * 这是全站最重的轮询接口 —— 线上实测 /auth/session 约 375 req/s，占全站请求 20%。
+ * 而权限和登录态本来就不会 5 秒一变，30 秒完全够用；
+ * 另外下面还监听 focus / visibilitychange，用户切回标签页会**立刻**强制校验一次，
+ * 所以真实感知比 30 秒更灵敏。
+ */
+const AUTH_PERMISSION_SYNC_INTERVAL_MS = 30_000;
 
 function sameSession(left: StoredAuthSession | null, right: StoredAuthSession) {
   return Boolean(

web/src/lib/use-chat-room-unread.ts

@@ -141,11 +141,37 @@ export function useChatRoomUnread(enabled: boolean, active: boolean) {
     window.addEventListener("chatgpt2api:chat-room-read", onRead);
 
     // 停在聊天室页面时无需轮询（页面内部自己会更新已读）。
-    const timer = active ? undefined : window.setInterval(load, UNREAD_POLL_INTERVAL_MS);
+    //
+    // ⚠️ 还要**只在页面可见时轮询**：这个 hook 挂在全局导航上，每个打开页面的标签页
+    // 都会跑（含切到后台/被遗忘的标签页）。后台标签页的未读角标没人看，
+    // 但请求照样打满服务端 —— 线上实测这几个轮询接口合计上千 req/s，把 2 核容器压垮。
+    // 切回页面时下面会立刻补拉一次，所以用户感知不到任何差别。
+    let timer: number | undefined;
+    const stopPolling = () => {
+      if (timer === undefined) return;
+      window.clearInterval(timer);
+      timer = undefined;
+    };
+    const startPolling = () => {
+      if (active || timer !== undefined) return;
+      timer = window.setInterval(load, UNREAD_POLL_INTERVAL_MS);
+    };
+    const onVisibilityChange = () => {
+      if (document.visibilityState === "visible") {
+        void load();
+        startPolling();
+      } else {
+        stopPolling();
+      }
+    };
+
+    startPolling();
+    document.addEventListener("visibilitychange", onVisibilityChange);
 
     return () => {
       disposed = true;
-      if (timer !== undefined) window.clearInterval(timer);
+      stopPolling();
+      document.removeEventListener("visibilitychange", onVisibilityChange);
       window.removeEventListener("chatgpt2api:chat-room-read", onRead);
     };
   }, [enabled, active]);