@mrrisega/dsh-remote 0.8.1 → 0.8.2-beta.1

package/clients/dsh-remote/dsh-bridge.mjs

@@ -2531,12 +2531,21 @@ async function registerDeviceInAccount(token) {
         ...(Number.isFinite(Number(d.error?.limit ?? policy.limit)) ? { limit: Number(d.error?.limit ?? policy.limit) } : {}),
         ...(d.error?.upgrade_to || policy.upgrade_to ? { upgrade_to: d.error?.upgrade_to || policy.upgrade_to } : {})
       };
-      if (code === "device_bind_cap") {
-        // 防滥用硬上限：永久性失败 → 专用退出码，watcher 按指数退避重拉（契约 §6.3/§6.4）
+      if (code === "device_bind_cap" || code === "machine_already_bound") {
+        // 永久性失败（用户不解绑就不会自愈）→ 专用退出码，watcher 按指数退避重拉（契约 §6.3/§6.4）：
+        //   · device_bind_cap       = 按套餐/防滥用硬上限，已绑定条数满了；
+        //   · machine_already_bound = 同一台电脑上已有另一份实例占位（2026-11-14 先到先得），
+        //                            必须由用户在手机端「管理电脑」解绑后才轮到这份登记。
         persistBindError({ code, status: 409, message, ...details });
-        console.error(`[bridge] 设备绑定已达上限：${message}`);
-        console.error("[bridge] 这是按套餐设定的防滥用硬上限（不是网络问题），本机不会反复空撞接口。");
-        console.error("[bridge] 请在手机端「管理电脑」解绑不再使用的设备；守护会按指数退避自动重试，解绑后自动恢复。");
+        if (code === "machine_already_bound") {
+          console.error(`[bridge] 这台电脑已有另一份 dsh-remote 在运行，本实例注册不上来：${message}`);
+          console.error("[bridge] 若要用这一份：先关掉另一份实例，并在手机端「管理电脑」解绑那台设备后再重试。");
+          console.error("[bridge] 这是服务端的「先到先得」策略，不是网络问题；守护会按指数退避自动重试，解绑后自动恢复。");
+        } else {
+          console.error(`[bridge] 设备绑定已达上限：${message}`);
+          console.error("[bridge] 这是按套餐设定的防滥用硬上限（不是网络问题），本机不会反复空撞接口。");
+          console.error("[bridge] 请在手机端「管理电脑」解绑不再使用的设备；守护会按指数退避自动重试，解绑后自动恢复。");
+        }
         process.exit(DEVICE_BIND_CAP_EXIT_CODE);
       }
       if (code === "device_limit_exceeded" || code === "device_locked") {

package/clients/dsh-remote/mobile-adapter.mjs

@@ -1281,6 +1281,8 @@ const SCRIPT = `(() => {
         compatOfficial: maCompatOfficial,
         scrim: maScrimStats,
         retry: maRetryStats,
+        /* 登录态失效（2026-11-14）：只读镜像页自己的判定结果，供"复制诊断信息"与排障使用。 */
+        authExpired: maAuthExpired === true,
         load: { slow: maLoadWatch.slow, progress: maLoadWatch.progress, apiFails: maLoadWatch.apiFails,
                 lastApiStatus: maLoadWatch.lastApiStatus,
                 activeMs: (typeof maLoadActiveMs === "function") ? maLoadActiveMs() : -1,
@@ -1447,6 +1449,10 @@ const SCRIPT = `(() => {
       /* 界面已经就绪 = 这次失败没有卡住首屏。此时重建元素可能让模块/插件**再执行一遍**
          （官方模块加载器是队列式），风险大于收益 —— 只记录、不重试。 */
       if (maLoadReadyNow()) return false;
+      /* 已经判定登录态失效 → 再重建元素也只会再吃一个 401，不再排队重试（省一条 499）。 */
+      if (maAuthExpired) return false;
+      /* 首屏没就绪时才值得怀疑"是不是登录态过期了"（见下方 maProbeAuthOnce 的长注释）。 */
+      maProbeAuthOnce();
       if (n >= MA_RES_RETRY_MAX) { maRetry.exhausted = true; return false; }
       maRetry.perUrl[key] = n + 1;
       var delay = MA_RES_RETRY_BASE_MS * Math.pow(2, n); // 2s → 4s（指数退避）
@@ -1455,6 +1461,90 @@ const SCRIPT = `(() => {
     } catch (e) { return false; }
   }
 
+  /* ===== 会话过期探测：让"登录失效"自己说出来（2026-11-14）=====
+     为什么需要（生产现场 dev-f9b47a20d23a）：
+       · 会话(dsh_token)过期时，中继对**页面导航**回 302 到 /app/?reason=expired（外壳有提示）；
+       · 但 <script>/<link> 这类**子资源**拿的是 401 JSON —— 浏览器把它当 JS 解析失败，只触发
+         resource error，页面上看不到任何状态码；
+       · 适配层既有的"会话过期条"只观察 fetch（且只认 401），**看不见子资源的状态码**。
+     结果：首屏 12 个资源失败、自动重试 8 次全部打空（重试还是 401），用户干等 27 秒，
+     只看到"资源加载失败"，完全不知道该重新登录 —— 这就是"token 过期提醒不友好"。
+     做法：首屏资源失败且界面还没就绪时，**节流地**探一次 /_quota（同源、需登录态、极轻）。
+       拿到 401 → 判定登录态失效（不是资源/网络问题）→ 弹一条可点的「去重新登录」，
+       并把自动重试停掉（再刷也是 401，只会制造 499）。
+     纪律：只读探测；不动任何业务请求；不新增上报字段（诊断里只多一个 authExpired 布尔）。 */
+  var maAuthExpired = false;
+  var maAuthProbe = { at: 0, inflight: false };
+  var AUTH_PROBE_MIN_MS = 8000;
+
+  /** 弹出极简"会话过期"浮层（幂等；不依赖菜单是否已建出来）。 */
+  function maShowAuthOverlay() {
+    try {
+      var D = (typeof document !== "undefined" && document)
+        || (window && window.document)
+        || null;
+      if (!D) return;
+      if (D.getElementById && D.getElementById("dsh-ma-auth-expired")) return;
+      var box = D.createElement("div");
+      box.id = "dsh-ma-auth-expired";
+      try { box.setAttribute("id", "dsh-ma-auth-expired"); } catch (eId) { /* 老实现只有属性反射时兜底 */ }
+      box.setAttribute("style",
+        "position:fixed;left:0;right:0;bottom:0;z-index:2147483000;padding:14px 16px;"
+        + "background:#1b1f24;color:#e6edf3;border-top:1px solid #30363d;"
+        + "font:14px/1.5 -apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;"
+        + "display:flex;gap:10px;align-items:center;flex-wrap:wrap");
+      var msg = D.createElement("span");
+      msg.setAttribute("style", "flex:1 1 200px;min-width:0");
+      msg.textContent = "登录状态已过期，需要重新登录后才能进入。";
+      var btn = D.createElement("button");
+      btn.type = "button";
+      btn.textContent = "去重新登录";
+      btn.setAttribute("style",
+        "flex:0 0 auto;padding:8px 14px;border-radius:8px;border:0;background:#2f81f7;color:#fff;font-weight:600");
+      btn.onclick = function () {
+        try { window.location.assign("/app/?reason=expired&from=mirror-auth"); }
+        catch (e1) { try { window.location.href = "/app/?reason=expired&from=mirror-auth"; } catch (e2) { /* 忽略 */ } }
+      };
+      box.appendChild(msg);
+      box.appendChild(btn);
+      var host = D.body || D.documentElement;
+      if (host) host.appendChild(box);
+    } catch (e) { /* 浮层坏了也绝不影响页面 */ }
+  }
+
+  /** 判定登录态失效：停自动重试 + 出浮层 + 诊断字符串换档（原因=auth）。 */
+  function maOnAuthExpired(why) {
+    try {
+      if (maAuthExpired) return;
+      maAuthExpired = true;
+      /* 停掉自动重试：401 不是"再试一次就好"的失败，重试只会继续制造 499 与白屏时间。 */
+      maRetry.manual = true;
+      maRetry.exhausted = true;
+      maShowAuthOverlay();
+      try { maBumpRetryStats("auth:" + String(why || "")); } catch (e0) { /* 忽略 */ }
+      try { maPublishDiag(); } catch (e1) { /* 忽略 */ }
+    } catch (e) { /* 忽略 */ }
+  }
+
+  /** 节流探测登录态（只认 401；网络错误/5xx 一律按未知处理，不误报"请重新登录"）。 */
+  function maProbeAuthOnce() {
+    try {
+      if (maAuthExpired) return;
+      if (typeof window === "undefined" || typeof window.fetch !== "function") return;
+      var now = Date.now();
+      if (maAuthProbe.inflight) return;
+      if (now - (maAuthProbe.at || 0) < AUTH_PROBE_MIN_MS) return;
+      maAuthProbe.at = now;
+      maAuthProbe.inflight = true;
+      var p = window.fetch("/_quota", { credentials: "same-origin", cache: "no-store" });
+      if (!p || typeof p.then !== "function") { maAuthProbe.inflight = false; return; }
+      p.then(function (r) {
+        maAuthProbe.inflight = false;
+        if (r && r.status === 401) maOnAuthExpired("probe401");
+      }, function () { maAuthProbe.inflight = false; });
+    } catch (e) { maAuthProbe.inflight = false; }
+  }
+
   /** 整页受控重试：仅当"官方界面还没就绪 + 没被用户手动接管 + 每标签页额度没用完"。 */
   function maSchedulePageRetry(why) {
     try {
@@ -1534,6 +1624,9 @@ const SCRIPT = `(() => {
          说的"文案归因错误"——截图 09 面板同时显示 95ms 顺畅）。
          W3：窗口改用**活跃时间**——挂起 8 分钟回来不该把"10 秒内有过 5xx"直接判成过期。 */
       var act = (typeof maLoadActiveMs === "function") ? maLoadActiveMs() : Date.now();
+      /* 登录态失效优先于"资源/网络"：否则用户看到的永远是"资源加载失败，正在重试…"，
+         而真实动作是「去重新登录」（2026-11-14：12 个首屏资源 401、8 次重试全空转）。 */
+      if (maAuthExpired) return "auth";
       if ((maLoadWatch.apiFails || 0) > 0 && act - (maLoadWatch.apiFailAt || 0) < 10000) return "offline";
       if (maRetry.resFails.length > 0) return "resource";
     } catch (e) { /* 落到 slow */ }
@@ -2022,6 +2115,7 @@ const SCRIPT = `(() => {
     var tail = maLoadHiddenSuffix();
     /* W3：12s（活跃时间）起先给中性进度——"正在准备界面…"不是故障判定，不吓人。 */
     if (!maLoadWatch.slow) return "正在准备界面…（已等待 " + sec + " 秒" + tail + "）";
+    if (reason === "auth") return "登录状态已过期，请重新登录（已等待 " + sec + " 秒" + tail + "）";
     if (reason === "offline") return "电脑端可能未连接（已等待 " + sec + " 秒" + tail + "）";
     if (reason === "resource") {
       if (maRetry.exhausted) return "页面资源加载失败，自动重试已用尽（已等待 " + sec + " 秒" + tail + "）";

package/clients/dsh-remote/test/mobile-adapter-load-watch.test.mjs

@@ -810,3 +810,79 @@ test("★ W3 诊断串：page/res 拆分、exhausted、挂起时长、最后失
   assert.match(line, /挂起 518 秒/, "挂起时长");
   assert.ok(line.length <= 400, `单行 ≤400 字符（实际 ${line.length}）`);
 });
+
+// ══════════════════════════════════════════════════════════════════════════════
+// ⑦ 会话过期（token 过期）的**可识别性**（2026-11-14 生产现场）
+//
+// 现场：dev-f9b47a20d23a 手机端干等 27 秒，诊断串 原因=resource、首屏资源失败=12、自动重试=8。
+// 根因：会话过期时中继对**页面导航**回 302（外壳有提示），对 <script>/<link> 子资源回 401 JSON ——
+//      浏览器只报 resource error，拿不到状态码；适配层只观察 fetch，于是 8 次重试全打在 401 上，
+//      用户看不到任何「请重新登录」。
+// 修法：首屏资源失败时**节流探一次 /_quota**，401 → 判定登录态失效 → 弹「去重新登录」+ 停自动重试。
+// ══════════════════════════════════════════════════════════════════════════════
+
+/** 造一个"探针会拿到 401"的 fetch（其它请求一律 200）。 */
+function authProbeFetch(probeStatus, probeRejects) {
+  const calls = { quota: 0 };
+  const fetchImpl = (input) => {
+    const u = String(input);
+    if (u.indexOf("/_quota") >= 0) {
+      calls.quota += 1;
+      if (probeRejects) return Promise.reject(new Error("network down"));
+      return Promise.resolve({ ok: probeStatus === 200, status: probeStatus, headers: { get: () => null } });
+    }
+    return Promise.resolve({ ok: true, status: 200, headers: { get: () => null } });
+  };
+  return { fetchImpl, calls };
+}
+
+test("★ 首屏资源失败 + /_quota 探到 401 → 弹「去重新登录」，并停掉自动重试", async () => {
+  const probe = authProbeFetch(401, false);
+  const env = runScript(harness({ fetch: probe.fetchImpl }));
+  const el = failingScript("/assets/index-abc.js", "module");
+  env.body.appendChild(el);
+  env.fireWindowEvent("error", { target: el });
+  await new Promise((r) => setImmediate(r));
+
+  assert.equal(probe.calls.quota, 1, "首屏资源失败应触发一次 /_quota 登录态探测");
+  const overlay = env.body.children.find((c) => c.attrs && c.attrs.id === "dsh-ma-auth-expired");
+  assert.ok(overlay, "★ 必须弹出可点的「去重新登录」浮层（旧实现只会说「资源加载失败，正在重试…」）");
+  assert.equal(env.win.__dshMaDiag.authExpired, true, "诊断出口要标出 authExpired（客服一看就知道是登录态）");
+
+  // 判定失效后，后续资源失败不再排队重试（否则继续吃 401、继续制造 499）
+  const before = env.countTimers(2000);
+  const el2 = failingScript("/assets/vendor-xyz.js", "module");
+  env.body.appendChild(el2);
+  env.fireWindowEvent("error", { target: el2 });
+  assert.equal(env.countTimers(2000), before, "auth 失效后不得再排新的资源重试");
+  assert.equal(probe.calls.quota, 1, "同一页最多一次探测（8 秒节流 + 已经判定就不再探）");
+});
+
+test("探针拿到 200（资源失败但不是登录问题）→ 不误报，照常重试", async () => {
+  const probe = authProbeFetch(200, false);
+  const env = runScript(harness({ fetch: probe.fetchImpl }));
+  const el = failingScript("/assets/index-abc.js", "module");
+  env.body.appendChild(el);
+  env.fireWindowEvent("error", { target: el });
+  await new Promise((r) => setImmediate(r));
+
+  assert.equal(probe.calls.quota, 1, "仍应探测（只是结论不是登录态）");
+  const overlay = env.body.children.find((c) => c.attrs && c.attrs.id === "dsh-ma-auth-expired");
+  assert.equal(overlay, undefined, "不是 401 就绝不提示「请重新登录」（会把人引到错误动作）");
+  assert.equal(env.win.__dshMaDiag.authExpired, false);
+  assert.equal(env.countTimers(2000) >= 1, true, "资源重试照常排队");
+});
+
+test("探针网络错误（不是 401）→ 不误报", async () => {
+  const probe = authProbeFetch(0, true);
+  const env = runScript(harness({ fetch: probe.fetchImpl }));
+  const el = failingScript("/assets/index-abc.js", "module");
+  env.body.appendChild(el);
+  env.fireWindowEvent("error", { target: el });
+  await new Promise((r) => setImmediate(r));
+
+  assert.equal(probe.calls.quota, 1);
+  const overlay = env.body.children.find((c) => c.attrs && c.attrs.id === "dsh-ma-auth-expired");
+  assert.equal(overlay, undefined, "网络错误不等于登录过期");
+  assert.equal(env.win.__dshMaDiag.authExpired, false);
+});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.8.1",
+  "version": "0.8.2-beta.1",
   "description": "手机远程控制 DeepSeek Harness · Remote control DeepSeek Harness (dsh web) from any phone browser — 100% 全功能 App 级体验：发消息、看工具执行、审批权限、改设置、管凭据，含特权操作，免内网穿透。一条命令安装 npx @mrrisega/dsh-remote。Mobile remote control for DSH, self-host or SaaS, no server needed on LAN.",
   "keywords": [
     "deepseek-harness",

package/packages/dsh-remote-web/lib/index.js

@@ -5576,9 +5576,13 @@ function bindFailSignatureOf(bindError) {
   return [bindError.code || "", bindError.device_id || "", bindError.message || ""].join("|");
 }
 
-/** 是否是「永久性」登记失败（硬上限；用户不解绑就不会自愈，必须指数退避而不是每 10s 重试）。 */
+/** 是否是「永久性」登记失败（用户不解绑就不会自愈，必须指数退避而不是每 10s 重试）。
+ *  · device_bind_cap：按套餐/防滥用硬上限，已绑定条数满了；
+ *  · machine_already_bound（2026-11-14）：同一台电脑上已有一份实例在线（先到先得），
+ *    后装的这份注册不上来 —— 必须由用户在手机端「管理电脑」解绑后才会自愈。 */
 function isPermanentBindFailure(bindError) {
-  return Boolean(bindError && typeof bindError === "object" && bindError.code === "device_bind_cap");
+  if (!bindError || typeof bindError !== "object") return false;
+  return bindError.code === "device_bind_cap" || bindError.code === "machine_already_bound";
 }
 
 /** 第 step 次（从 1 开始）拉起后的退避时长：10s→1min→5min→15min，之后封顶 30min。 */

package/packages/dsh-remote-web/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-web",
-  "version": "0.8.1",
+  "version": "0.8.2-beta.1",
   "description": "公网远程控制 DeepSeek Harness（dsh web）：安装即得专属加密地址，人在外面也能用手机访问电脑上的 dsh——无需同一局域网/WiFi、无需公网 IP 与内网穿透，全程加密；手机端 100% 还原电脑体验（对话/工具/审批/设置）。技术用户可选自建服务，流量走自己的服务器。Remote control DeepSeek Harness (dsh web) from anywhere over the public internet — install, get an encrypted URL, use it from your phone on any network (dual-half cordis plugin: Settings panel + same-origin /dsh-remote routes). (2026-09 由 dsh-remote-ui 更名 / renamed from dsh-remote-ui; dsh-remote 的 dsh web 插件半，不是纯 UI/皮肤插件)",
   "type": "module",
   "main": "lib/index.js",

package/packages/dsh-remote-web/runtime/clients/dsh-remote/dsh-bridge.mjs

@@ -2531,12 +2531,21 @@ async function registerDeviceInAccount(token) {
         ...(Number.isFinite(Number(d.error?.limit ?? policy.limit)) ? { limit: Number(d.error?.limit ?? policy.limit) } : {}),
         ...(d.error?.upgrade_to || policy.upgrade_to ? { upgrade_to: d.error?.upgrade_to || policy.upgrade_to } : {})
       };
-      if (code === "device_bind_cap") {
-        // 防滥用硬上限：永久性失败 → 专用退出码，watcher 按指数退避重拉（契约 §6.3/§6.4）
+      if (code === "device_bind_cap" || code === "machine_already_bound") {
+        // 永久性失败（用户不解绑就不会自愈）→ 专用退出码，watcher 按指数退避重拉（契约 §6.3/§6.4）：
+        //   · device_bind_cap       = 按套餐/防滥用硬上限，已绑定条数满了；
+        //   · machine_already_bound = 同一台电脑上已有另一份实例占位（2026-11-14 先到先得），
+        //                            必须由用户在手机端「管理电脑」解绑后才轮到这份登记。
         persistBindError({ code, status: 409, message, ...details });
-        console.error(`[bridge] 设备绑定已达上限：${message}`);
-        console.error("[bridge] 这是按套餐设定的防滥用硬上限（不是网络问题），本机不会反复空撞接口。");
-        console.error("[bridge] 请在手机端「管理电脑」解绑不再使用的设备；守护会按指数退避自动重试，解绑后自动恢复。");
+        if (code === "machine_already_bound") {
+          console.error(`[bridge] 这台电脑已有另一份 dsh-remote 在运行，本实例注册不上来：${message}`);
+          console.error("[bridge] 若要用这一份：先关掉另一份实例，并在手机端「管理电脑」解绑那台设备后再重试。");
+          console.error("[bridge] 这是服务端的「先到先得」策略，不是网络问题；守护会按指数退避自动重试，解绑后自动恢复。");
+        } else {
+          console.error(`[bridge] 设备绑定已达上限：${message}`);
+          console.error("[bridge] 这是按套餐设定的防滥用硬上限（不是网络问题），本机不会反复空撞接口。");
+          console.error("[bridge] 请在手机端「管理电脑」解绑不再使用的设备；守护会按指数退避自动重试，解绑后自动恢复。");
+        }
         process.exit(DEVICE_BIND_CAP_EXIT_CODE);
       }
       if (code === "device_limit_exceeded" || code === "device_locked") {

package/packages/dsh-remote-web/runtime/clients/dsh-remote/mobile-adapter.mjs

@@ -1281,6 +1281,8 @@ const SCRIPT = `(() => {
         compatOfficial: maCompatOfficial,
         scrim: maScrimStats,
         retry: maRetryStats,
+        /* 登录态失效（2026-11-14）：只读镜像页自己的判定结果，供"复制诊断信息"与排障使用。 */
+        authExpired: maAuthExpired === true,
         load: { slow: maLoadWatch.slow, progress: maLoadWatch.progress, apiFails: maLoadWatch.apiFails,
                 lastApiStatus: maLoadWatch.lastApiStatus,
                 activeMs: (typeof maLoadActiveMs === "function") ? maLoadActiveMs() : -1,
@@ -1447,6 +1449,10 @@ const SCRIPT = `(() => {
       /* 界面已经就绪 = 这次失败没有卡住首屏。此时重建元素可能让模块/插件**再执行一遍**
          （官方模块加载器是队列式），风险大于收益 —— 只记录、不重试。 */
       if (maLoadReadyNow()) return false;
+      /* 已经判定登录态失效 → 再重建元素也只会再吃一个 401，不再排队重试（省一条 499）。 */
+      if (maAuthExpired) return false;
+      /* 首屏没就绪时才值得怀疑"是不是登录态过期了"（见下方 maProbeAuthOnce 的长注释）。 */
+      maProbeAuthOnce();
       if (n >= MA_RES_RETRY_MAX) { maRetry.exhausted = true; return false; }
       maRetry.perUrl[key] = n + 1;
       var delay = MA_RES_RETRY_BASE_MS * Math.pow(2, n); // 2s → 4s（指数退避）
@@ -1455,6 +1461,90 @@ const SCRIPT = `(() => {
     } catch (e) { return false; }
   }
 
+  /* ===== 会话过期探测：让"登录失效"自己说出来（2026-11-14）=====
+     为什么需要（生产现场 dev-f9b47a20d23a）：
+       · 会话(dsh_token)过期时，中继对**页面导航**回 302 到 /app/?reason=expired（外壳有提示）；
+       · 但 <script>/<link> 这类**子资源**拿的是 401 JSON —— 浏览器把它当 JS 解析失败，只触发
+         resource error，页面上看不到任何状态码；
+       · 适配层既有的"会话过期条"只观察 fetch（且只认 401），**看不见子资源的状态码**。
+     结果：首屏 12 个资源失败、自动重试 8 次全部打空（重试还是 401），用户干等 27 秒，
+     只看到"资源加载失败"，完全不知道该重新登录 —— 这就是"token 过期提醒不友好"。
+     做法：首屏资源失败且界面还没就绪时，**节流地**探一次 /_quota（同源、需登录态、极轻）。
+       拿到 401 → 判定登录态失效（不是资源/网络问题）→ 弹一条可点的「去重新登录」，
+       并把自动重试停掉（再刷也是 401，只会制造 499）。
+     纪律：只读探测；不动任何业务请求；不新增上报字段（诊断里只多一个 authExpired 布尔）。 */
+  var maAuthExpired = false;
+  var maAuthProbe = { at: 0, inflight: false };
+  var AUTH_PROBE_MIN_MS = 8000;
+
+  /** 弹出极简"会话过期"浮层（幂等；不依赖菜单是否已建出来）。 */
+  function maShowAuthOverlay() {
+    try {
+      var D = (typeof document !== "undefined" && document)
+        || (window && window.document)
+        || null;
+      if (!D) return;
+      if (D.getElementById && D.getElementById("dsh-ma-auth-expired")) return;
+      var box = D.createElement("div");
+      box.id = "dsh-ma-auth-expired";
+      try { box.setAttribute("id", "dsh-ma-auth-expired"); } catch (eId) { /* 老实现只有属性反射时兜底 */ }
+      box.setAttribute("style",
+        "position:fixed;left:0;right:0;bottom:0;z-index:2147483000;padding:14px 16px;"
+        + "background:#1b1f24;color:#e6edf3;border-top:1px solid #30363d;"
+        + "font:14px/1.5 -apple-system,BlinkMacSystemFont,'Segoe UI',sans-serif;"
+        + "display:flex;gap:10px;align-items:center;flex-wrap:wrap");
+      var msg = D.createElement("span");
+      msg.setAttribute("style", "flex:1 1 200px;min-width:0");
+      msg.textContent = "登录状态已过期，需要重新登录后才能进入。";
+      var btn = D.createElement("button");
+      btn.type = "button";
+      btn.textContent = "去重新登录";
+      btn.setAttribute("style",
+        "flex:0 0 auto;padding:8px 14px;border-radius:8px;border:0;background:#2f81f7;color:#fff;font-weight:600");
+      btn.onclick = function () {
+        try { window.location.assign("/app/?reason=expired&from=mirror-auth"); }
+        catch (e1) { try { window.location.href = "/app/?reason=expired&from=mirror-auth"; } catch (e2) { /* 忽略 */ } }
+      };
+      box.appendChild(msg);
+      box.appendChild(btn);
+      var host = D.body || D.documentElement;
+      if (host) host.appendChild(box);
+    } catch (e) { /* 浮层坏了也绝不影响页面 */ }
+  }
+
+  /** 判定登录态失效：停自动重试 + 出浮层 + 诊断字符串换档（原因=auth）。 */
+  function maOnAuthExpired(why) {
+    try {
+      if (maAuthExpired) return;
+      maAuthExpired = true;
+      /* 停掉自动重试：401 不是"再试一次就好"的失败，重试只会继续制造 499 与白屏时间。 */
+      maRetry.manual = true;
+      maRetry.exhausted = true;
+      maShowAuthOverlay();
+      try { maBumpRetryStats("auth:" + String(why || "")); } catch (e0) { /* 忽略 */ }
+      try { maPublishDiag(); } catch (e1) { /* 忽略 */ }
+    } catch (e) { /* 忽略 */ }
+  }
+
+  /** 节流探测登录态（只认 401；网络错误/5xx 一律按未知处理，不误报"请重新登录"）。 */
+  function maProbeAuthOnce() {
+    try {
+      if (maAuthExpired) return;
+      if (typeof window === "undefined" || typeof window.fetch !== "function") return;
+      var now = Date.now();
+      if (maAuthProbe.inflight) return;
+      if (now - (maAuthProbe.at || 0) < AUTH_PROBE_MIN_MS) return;
+      maAuthProbe.at = now;
+      maAuthProbe.inflight = true;
+      var p = window.fetch("/_quota", { credentials: "same-origin", cache: "no-store" });
+      if (!p || typeof p.then !== "function") { maAuthProbe.inflight = false; return; }
+      p.then(function (r) {
+        maAuthProbe.inflight = false;
+        if (r && r.status === 401) maOnAuthExpired("probe401");
+      }, function () { maAuthProbe.inflight = false; });
+    } catch (e) { maAuthProbe.inflight = false; }
+  }
+
   /** 整页受控重试：仅当"官方界面还没就绪 + 没被用户手动接管 + 每标签页额度没用完"。 */
   function maSchedulePageRetry(why) {
     try {
@@ -1534,6 +1624,9 @@ const SCRIPT = `(() => {
          说的"文案归因错误"——截图 09 面板同时显示 95ms 顺畅）。
          W3：窗口改用**活跃时间**——挂起 8 分钟回来不该把"10 秒内有过 5xx"直接判成过期。 */
       var act = (typeof maLoadActiveMs === "function") ? maLoadActiveMs() : Date.now();
+      /* 登录态失效优先于"资源/网络"：否则用户看到的永远是"资源加载失败，正在重试…"，
+         而真实动作是「去重新登录」（2026-11-14：12 个首屏资源 401、8 次重试全空转）。 */
+      if (maAuthExpired) return "auth";
       if ((maLoadWatch.apiFails || 0) > 0 && act - (maLoadWatch.apiFailAt || 0) < 10000) return "offline";
       if (maRetry.resFails.length > 0) return "resource";
     } catch (e) { /* 落到 slow */ }
@@ -2022,6 +2115,7 @@ const SCRIPT = `(() => {
     var tail = maLoadHiddenSuffix();
     /* W3：12s（活跃时间）起先给中性进度——"正在准备界面…"不是故障判定，不吓人。 */
     if (!maLoadWatch.slow) return "正在准备界面…（已等待 " + sec + " 秒" + tail + "）";
+    if (reason === "auth") return "登录状态已过期，请重新登录（已等待 " + sec + " 秒" + tail + "）";
     if (reason === "offline") return "电脑端可能未连接（已等待 " + sec + " 秒" + tail + "）";
     if (reason === "resource") {
       if (maRetry.exhausted) return "页面资源加载失败，自动重试已用尽（已等待 " + sec + " 秒" + tail + "）";