houtai xintiao jiang pin dao 50s, fangkuan zaixian chuangkou dao 120s

presence xintiao shi wei yi "qie dao houtai ye zhao da" de quanju lunxun,
xian shang shi ce dan zhe yi xiang jiu you 300+ req/s, er rongqi zhi you
2 ge gongxiang vCPU。

- qian tai: 25s (bu bian, hu ying bu shou ying xiang)
- hou tai: 50s (jiang yi ban)
- fuwu duan zaixian chuang kou: 60s -> 120s

50s x 2 = 100s < 120s, lian diu liang ci xintiao reng suan zaixian,
bi yuan lai de 25s/60s geng bu rongyi wu pan li xian。
qie hui qian tai shi li ke bu yi ci, zaixian renshu dangchang bian zhun。

zhen ji: artifacts/_visibility_gate_test.py 10/10; tsc / eslint jun lv。

services/presence_service.py

@@ -4,8 +4,11 @@ import threading
 import time
 from typing import Any
 
-# 在线判定窗口：客户端心跳间隔 25s，窗口取 60s 以便容忍一次丢包 / 休眠恢复的抖动。
-DEFAULT_ONLINE_WINDOW_SECS = 60
+# 在线判定窗口。
+# ⚠️ 取 120s 而不是 60s：客户端前台心跳 25s、**后台降到 50s**（后台也照打是最贵的轮询，
+# 线上单这一项就有 300+ req/s，而容器只有 2 个共享 vCPU）。
+# 50s × 2 = 100s < 120s ⇒ 连丢两次心跳仍算在线，比原来的 25s/60s 更不容易误判离线。
+DEFAULT_ONLINE_WINDOW_SECS = 120
 
 # 站内角色 → 展示分组。「user」是内部用户（不消耗积分、走模型每日限额）。
 _ROLE_GROUP = {"normal": "normal", "user": "internal", "admin": "admin"}

web/src/components/presence-provider.tsx

@@ -4,9 +4,21 @@ import { createContext, useContext, useEffect, useRef, useState, type ReactNode
 
 import { leavePresence, loadPresenceAuthKey, pingPresence } from "@/lib/api";
 
-// 心跳间隔要显著小于服务端 60s 在线窗口，容忍一次丢包 / 网络抖动后仍算在线。
+// 心跳间隔要显著小于服务端在线窗口，容忍一次丢包 / 网络抖动后仍算在线。
 const HEARTBEAT_INTERVAL_MS = 25_000;
 
+/**
+ * 后台标签页的心跳间隔。
+ *
+ * ⚠️ 这是**唯一「切到后台也照打」的全局轮询**，线上实测它单独就有 300+ req/s，
+ * 而容器只有 2 个共享 vCPU。后台标签页不需要 25s 的精度 —— 但也不能直接停：
+ * 停了「在线人数」就会漏掉开着页面去干别的事的用户，那正是当初把它放全局的原因。
+ *
+ * 折中：后台降到 50s。配合**服务端窗口从 60s 放宽到 120s**，仍然容忍连丢两次心跳，
+ * 比改之前更不容易误判离线（改之前 25s 间隔 + 60s 窗口，丢一次就濒临掉线）。
+ */
+const HEARTBEAT_INTERVAL_MS_HIDDEN = 50_000;
+
 const PresenceContext = createContext<number | null>(null);
 
 /**
@@ -30,6 +42,7 @@ export function PresenceProvider({ children }: { children: ReactNode }) {
 
   useEffect(() => {
     let disposed = false;
+    let timer: number | undefined;
 
     const beat = async () => {
       try {
@@ -42,6 +55,19 @@ export function PresenceProvider({ children }: { children: ReactNode }) {
       }
     };
 
+    /** 按当前可见性选间隔重排定时器（切前后台时都要重排一次）。 */
+    const schedule = () => {
+      if (timer !== undefined) {
+        window.clearInterval(timer);
+      }
+      const interval = document.visibilityState === "visible"
+        ? HEARTBEAT_INTERVAL_MS
+        : HEARTBEAT_INTERVAL_MS_HIDDEN;
+      timer = window.setInterval(() => {
+        void beat();
+      }, interval);
+    };
+
     void (async () => {
       const key = await loadPresenceAuthKey();
       if (!disposed) {
@@ -50,9 +76,16 @@ export function PresenceProvider({ children }: { children: ReactNode }) {
       void beat();
     })();
 
-    const timer = window.setInterval(() => {
-      void beat();
-    }, HEARTBEAT_INTERVAL_MS);
+    const onVisibilityChange = () => {
+      schedule();
+      // 切回前台立刻补一次：在线状态和人数当场变准，不用等下一个周期。
+      if (document.visibilityState === "visible") {
+        void beat();
+      }
+    };
+
+    schedule();
+    document.addEventListener("visibilitychange", onVisibilityChange);
 
     // pagehide 覆盖关闭标签页 / 前进后退 / 移动端切走；刷新时也会触发，
     // 但新页面挂载后立刻就会重新 ping，不会造成空窗。
@@ -63,7 +96,10 @@ export function PresenceProvider({ children }: { children: ReactNode }) {
 
     return () => {
       disposed = true;
-      window.clearInterval(timer);
+      if (timer !== undefined) {
+        window.clearInterval(timer);
+      }
+      document.removeEventListener("visibilitychange", onVisibilityChange);
       window.removeEventListener("pagehide", handlePageHide);
     };
   }, []);