@mrrisega/dsh-remote 0.7.6-beta.9 → 0.7.7

package/dsh-setup.mjs

@@ -30,6 +30,7 @@ import { spawn, spawnSync, execSync } from "node:child_process";
 import { fileURLToPath } from "node:url";
 import { childStopped, stopChildGracefully } from "./clients/dsh-remote/src/lifecycle.mjs";
 import { discoverUpstream, resolveUpstreamHint, FALLBACK_UPSTREAM } from "./clients/dsh-remote/upstream-discovery.mjs";
+import { normalizeRefCode, applyRefCodeToConfig } from "./clients/dsh-remote/src/channel-ref.mjs";
 
 const THIS_DIR = path.dirname(fileURLToPath(import.meta.url)); // 本包目录（仓库或 node_modules）
 const IS_NPM_INSTALL = THIS_DIR.includes(`${path.sep}node_modules${path.sep}`);
@@ -74,6 +75,39 @@ const BRIDGE_PID_FILE = ".dsh-bridge.pid";
  */
 const DUPLICATE_INSTANCE_EXIT_CODE = 4;
 const DUPLICATE_BRIDGE_BACKOFF_MS = 5 * 60 * 1000;
+/**
+ * 设备绑定「永久性失败」的退避（契约 docs/device-overquota-lock-contract.md §6.3/§6.4）。
+ *
+ * bridge 遇到服务端 `device_bind_cap`（防滥用硬上限）会写 `.bind-error.json` 并以**专用退出码 5**
+ * 退出：这是永久性失败 —— 用户不去手机端解绑就不会好。旧逻辑与普通失败共用 exit(1)，
+ * watcher 于是每 10s 拉起一次、每 10s 撞一次 409（日志刷屏、白耗一次 device-login 额度）。
+ * 现在按 10s→1min→5min→15min 指数退避（封顶 30min）；`.bind-error.json` 的**内容签名**变化
+ * （换账号 / 解绑后重试得到了不同结论 / 提示被清掉）时复位，用户处理完不必等满退避窗口。
+ */
+const DEVICE_BIND_CAP_EXIT_CODE = 5;
+const BIND_CAP_BACKOFF_MS = [10_000, 60_000, 300_000, 900_000];
+const BIND_CAP_BACKOFF_MAX_MS = 30 * 60 * 1000;
+/** bridge 写的「设备登记失败提示」（面板读它展示原因；watcher 用它的签名判断是否需要复位退避）。 */
+const BIND_ERROR_FILE = path.join(CONFIG_DIR, ".bind-error.json");
+
+/**
+ * `.bind-error.json` 的稳定签名：只取 code/device_id/message，**不含 at** ——
+ * bridge 每次重试都会刷新 at，拿它当变化依据等于"永远变化"，退避会形同虚设。
+ */
+function bindErrorSignature() {
+  try {
+    const j = JSON.parse(fs.readFileSync(BIND_ERROR_FILE, "utf8")) || {};
+    return [j.code || "", j.device_id || "", j.message || ""].join("|");
+  } catch { return ""; }
+}
+
+/** 第 step 次（从 1 开始）退出码 5 后的退避时长：10s→1min→5min→15min，之后翻倍到封顶 30min。 */
+function bindCapBackoffMs(step) {
+  const list = BIND_CAP_BACKOFF_MS;
+  const n = Math.max(1, Number(step) || 1);
+  if (n <= list.length) return Math.min(BIND_CAP_BACKOFF_MAX_MS, list[n - 1]);
+  return BIND_CAP_BACKOFF_MAX_MS;
+}
 
 // ---------- 运行时自物化（npm/npx 安装 → 固化到配置目录，脱离 npx 缓存） ----------
 // npx 每次安装的缓存目录（~/.npm/_npx/<hash>）不固定：缓存一旦清理，指向它的自启动服务
@@ -104,9 +138,9 @@ function findDepWs(startDir) {
  * 同步运行时文件时一并覆盖的客户端脚本（bridge 会把这些直接发给手机/桌面，必须与装置器一致）。
  * ⚠️ `src/lifecycle.mjs` 也在表里：本安装器**自己**import 它（进程优雅停机的共用实现），
  * 漏同步就会出现「入口脚本在、依赖不在」的半装运行时（插件半据此判定「运行环境已就绪」，
- * 却永远起不来 bridge —— 2026-09-23 用户反馈的现场）。
+ * 却永远起不来 bridge —— 2026-09-23 用户反馈的现场）。`src/channel-ref.mjs` 同理（本安装器也 import）。
  */
-const RUNTIME_CLIENT_FILES = ["mobile-adapter.mjs", "dsh-bridge.mjs", "e2ee-shim.mjs", "e2ee-client.mjs", "e2ee-shim-script.js", "mobile-adapter.test.mjs", "wechat-channel.mjs", "dsh-events.mjs", "wechat-runtime.mjs", "src/lifecycle.mjs"];
+const RUNTIME_CLIENT_FILES = ["mobile-adapter.mjs", "dsh-bridge.mjs", "e2ee-shim.mjs", "e2ee-client.mjs", "e2ee-shim-script.js", "mobile-adapter.test.mjs", "wechat-channel.mjs", "dsh-events.mjs", "wechat-runtime.mjs", "src/lifecycle.mjs", "src/channel-ref.mjs"];
 
 /**
  * 把"客户端脚本"补齐到配置目录。
@@ -196,6 +230,9 @@ function printHelp() {
 自建模式（可选）:
   dsh-remote setup --server wss://你的域名:端口 --key 访问密钥
 
+可选参数:
+  --ref <标识>    指定接入标识（可选，用于路由/灰度分组）
+
 登录/连接配置: 打开 dsh web → 设置 → 「远程访问」→ 注册或登录手机号即可
 （自建用户切「自建服务」标签或直接用上方 setup 命令，无需另开页面）。
 文档: ${REPO_URL}
@@ -204,7 +241,7 @@ function printHelp() {
 
 // 认识的参数（只给 flag 也要能装上去，所以不认识时才拦）。
 const KNOWN_FLAGS = new Set([
-  "--api", "--server", "--key", "--profile",
+  "--api", "--server", "--key", "--profile", "--ref",
   "--no-autostart", "--no-plugin", "--no-restart", "--uninstall", "--force"
 ]);
 
@@ -1803,6 +1840,12 @@ async function runBridge() {
   let warnedDuplicateBridge = false;
   /** 限流提示只打一次，避免刷屏。 */
   let warnedRateLimit = false;
+  /** 设备绑定硬上限（bridge 退出码 5）的指数退避状态（契约 §6.4）。 */
+  let bindCapBackoffStep = 0;
+  let bindCapBackoffUntil = 0;
+  let bindCapErrorSig = "";
+  /** 退避提示只打一次，避免刷屏。 */
+  let warnedBindCap = false;
 
   // watcher：检测 dsh web 是否存活（端口动态解析，绝不写死 3080），存活才启动 bridge。
   // 走 isDshWebUp()：探测失败会自动做一次动态发现（DSH Desktop 的 43120 / 自定义端口都靠它）。
@@ -1863,6 +1906,7 @@ async function runBridge() {
       await stopChildGracefully(bridgeProc); // 先请它优雅退出，跑完微信通道下线通知
       bridgeAccountFp = "";
       duplicateBridgeBackoffUntil = 0; // 用户明确换了账号：清掉"让位"暂停，立即用新凭据拉起
+      bindCapBackoffStep = 0; bindCapBackoffUntil = 0; bindCapErrorSig = ""; // 换账号 = 绑定前提已变：设备绑定退避一并复位
       return; // 下一轮（10s 内）用新配置重新拉起
     }
     // 指纹又回到一致（或本来就没变）→ 之前的"疑似变化"作废，绝不让它跨轮累积。
@@ -1891,6 +1935,28 @@ async function runBridge() {
     }
     warnedDuplicateBridge = false;
 
+    // 设备绑定硬上限（bridge 退出码 5）：永久性失败 → 指数退避，别每 10s 空撞一次。
+    // 复位：`.bind-error.json` 的内容签名变了（换账号 / 用户解绑后重试得到不同结论 / 提示被清掉）。
+    // 提示只打一次；退避窗口内直接返回、不拉起 bridge（也不占用一次 device-login 额度）。
+    const bindSig = bindErrorSignature();
+    if (bindSig !== bindCapErrorSig) {
+      if (bindCapBackoffUntil > Date.now()) {
+        console.log("[dsh-remote] 设备登记失败提示已变化（解绑/换账号/服务端结论变了）→ 重置设备绑定退避，立即重试。");
+      }
+      bindCapErrorSig = bindSig;
+      bindCapBackoffStep = 0;
+      bindCapBackoffUntil = 0;
+    }
+    if (Date.now() < bindCapBackoffUntil) {
+      if (!warnedBindCap) {
+        warnedBindCap = true;
+        console.log(`[dsh-remote] 设备绑定已达上限（bridge code=${DEVICE_BIND_CAP_EXIT_CODE}）→ 本守护暂停拉起约 ${Math.ceil((bindCapBackoffUntil - Date.now()) / 1000)} 秒（指数退避，最长 30 分钟）。`);
+        console.log("   请在手机端「管理电脑」解绑不再使用的设备；解绑后会自动恢复，无需重启。");
+      }
+      return;
+    }
+    warnedBindCap = false;
+
     reconcileUpstreamEnvFromFile(); // dsh 可能刚重启并换了端口：拉起前再以最新端口文件为准
     const alive = await checkUpstream();
     if (alive && childStopped(bridgeProc)) {
@@ -1954,6 +2020,24 @@ async function runBridge() {
           console.log(`[dsh-remote] bridge 检测到同 deviceId 的另一个实例并退出（code=${code}）——本守护暂停 ${Math.round(DUPLICATE_BRIDGE_BACKOFF_MS / 60000)} 分钟后再试，避免两个实例反复互踢。`);
           return;
         }
+        // 设备绑定硬上限（退出码 5，契约 §6.3/§6.4）：永久性失败 → 指数退避重试，
+        // 绝不沿用"10s 后照常重拉"（那会每 10s 撞一次 409，日志刷屏且白耗登录额度）。
+        if (code === DEVICE_BIND_CAP_EXIT_CODE) {
+          const sig = bindErrorSignature();
+          if (sig && sig !== bindCapErrorSig) {
+            bindCapErrorSig = sig;
+            bindCapBackoffStep = 1;
+            console.log("[dsh-remote] 设备绑定失败提示已变化 → 重置设备绑定退避。");
+          } else {
+            bindCapBackoffStep = Math.min(bindCapBackoffStep + 1, 99);
+          }
+          const waitMs = bindCapBackoffMs(bindCapBackoffStep);
+          bindCapBackoffUntil = Date.now() + waitMs;
+          warnedBindCap = false;
+          console.log(`[dsh-remote] bridge 因设备绑定达到硬上限退出（code=${code}，第 ${bindCapBackoffStep} 次）——本守护 ${Math.round(waitMs / 1000)} 秒后再试（指数退避，最长 30 分钟）。`);
+          console.log("   请在手机端「管理电脑」解绑不再使用的设备；解绑后自动恢复，无需重启。");
+          return;
+        }
         console.log("[dsh-remote] bridge 退出，等待重启...");
       });
       // Windows：落 pid 文件，供插件半发现进程（Windows 没有 pgrep/ps）。
@@ -2022,6 +2106,11 @@ async function setup(argv) {
   const selfHosted = Boolean(server || key);
 
   let cfg = loadConfig();
+  // 接入标识（可选）：本次带合法 `--ref <数字>`（或环境变量 DSH_REF）才写入；没带/非法 →
+  // **保留**配置里已有的值。⚠️ saveConfig 是整对象覆盖写，所以必须在刚 loadConfig() 的这份
+  // 对象上合并再写回 —— 绝不能新建对象，否则升级装一次就把上一次的归因清空了。
+  // 非法值静默忽略：归因是附加信息，绝不能因此让安装失败。
+  cfg = applyRefCodeToConfig(cfg, argv);
 
   if (selfHosted) {
     if (!server || !key) {
@@ -3446,6 +3535,11 @@ else if (cmd === "status") {
   console.log("配置文件:", CONFIG_PATH);
   console.log("连接模式:", local ? `自建服务（${cfg.tunnel_url || "未设置服务器地址"}）` : `SaaS 云端服务（${cfg.phone || "未配置账号"}）`);
   console.log("API:", cfg.api_url || (local ? "（自建模式无需账号 API）" : DEFAULT_API));
+  // 接入标识（安装时 --ref 写入）：运维自查用；没设置就不打这一行，保持默认输出稳定。
+  {
+    const refCode = normalizeRefCode(cfg.ref_code);
+    if (refCode) console.log("接入标识:", refCode);
+  }
   console.log("远程地址/登录: 打开 dsh web → 设置 → 「远程访问」查看与操作");
   // 插件挂载诊断：报障时一眼看出是"链接坏了"还是"别的毛病"
   const profileDir = resolveProfileDir([]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.7.6-beta.9",
+  "version": "0.7.7",
   "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/client.js

@@ -1266,6 +1266,7 @@ window.__ModuleLoader__.load({
      * 之所以是模块级的：拉取发生在 apply() 里（组件还没挂载），而消费方有两个
      * （设置面板的卡片 / shell.overlay 上的弹窗），模块级 store 才能让两边看到同一份数据。
      */
+    var annRetryCount = 0;   // 公告首次拉取瞬态失败的有界重试计数（成功即清零）
     var annState = {
       ok: false,          // 拉取成功且结构是我们认识的那一种（老服务端 404 / 结构不符 → 一直是 false）
       bubble: false,      // bubble_enabled === true 才置真（字段缺失一律当 false = fail closed）
@@ -1428,6 +1429,7 @@ window.__ModuleLoader__.load({
         var norm = annNormalize(b);
         if (!norm) { annState.ok = false; annState.bubble = false; annState.items = []; annState.unread = 0; annEmit(); return false; }
         annState.ok = true;
+        annRetryCount = 0;
         annState.bubble = norm.bubble;
         annState.items = norm.items;
         annState.unread = norm.unread;
@@ -1436,13 +1438,24 @@ window.__ModuleLoader__.load({
         }
         annEmit();
         return true;
-      }).catch(function () {
+      }).catch(function (err) {
         // 404（老服务端）/ 不可达 / 超时：fail closed —— 不显示入口、不弹窗，**绝不抛**
         annState.ok = false;
         annState.bubble = false;
         annState.items = [];
         annState.unread = 0;
         annEmit();
+        // 2026-10-25（用户反馈「公告板块没了」）：dsh 重启后页面常常比插件宿主路由先就绪，
+        // 首次拉取失败一次，整页（sessionStorage 一次性标记）就再也没有公告入口。
+        // 这里只对**瞬态失败**做有界重试（最多 2 次、间隔 1.5s/3s）；404 明确是老服务端，不重试。
+        // 注意：这只发生在**失败后**，成功路径仍然严格"每次页面加载只拉一次"。
+        var st = Number(err && (err.status || err.statusCode));
+        if (st !== 404 && annRetryCount < 2) {
+          annRetryCount += 1;
+          try {
+            setTimeout(function () { annFetch({ openPopup: false }); }, 1500 * annRetryCount);
+          } catch (e2) { /* 忽略 */ }
+        }
         return false;
       });
     }
@@ -1623,6 +1636,33 @@ window.__ModuleLoader__.load({
       try { clearTimeout(t); } catch (e) { /* 忽略 */ }
     }
 
+    // ── 设备超额锁定（契约 docs/device-overquota-lock-contract.md §8）─────────────
+    /**
+     * 「设备被超额锁定」的统一文案（远程访问红条 / 后台服务卡共用，避免两处各写一套漂移）。
+     * 契约 §8.1 要求同时讲清三件事：① 当前套餐可同时用 N 台；② 两条出路（升级 Pro Max / 解绑）；
+     * ③ 解绑或升级后**本机会自动解锁**（不是"点重试直到成功"，也不能暗示无限重试）。
+     * @param {number|null} limit 服务端给的可用额度；null/未知时用 N 占位
+     */
+    function lockedPanelDetail(limit) {
+      var n = (limit === 0 || limit) ? String(limit) : "N";
+      return "本机已被锁定（当前套餐可同时使用 " + n + " 台）。"
+        + "升级 Pro Max 可多台设备同时使用；或到手机端「管理电脑」解绑其他设备后本机会自动解锁。";
+    }
+    /**
+     * 从云端地址派生「升级 Pro Max」页 URL：`https://host/app/…` → `https://host/app/promo`。
+     * **不硬编码任何域名**（官方/自建/测试环境都走同一个派生规则）；拿不到地址返回 ""，
+     * 调用方回退到既有「带登录态升级」通道（openUpgradeAuth）。
+     */
+    function upgradePromoUrlOf(base) {
+      var s = String(base || "");
+      if (!s) return "";
+      try {
+        var origin = s.split("/app")[0];
+        if (origin && /^https?:\/\//i.test(origin)) return origin.replace(/\/+$/, "") + "/app/promo";
+      } catch (e) { /* 落到返回空 */ }
+      return "";
+    }
+
     // ── 剪贴板（0.6.9 邀请区「一键复制」）────────────────────────────────────
     /**
      * 复制文本到剪贴板，返回 Promise<boolean>。
@@ -4664,11 +4704,15 @@ window.__ModuleLoader__.load({
         // 状态行优先用连接阶段文案（node 半下发的 user-facing 文案）：
         // 「正在准备运行环境（首次约 1~2 分钟）… / 正在启动 Bridge… / 正在连接中继… / 已连接 ✅ …」；
         // 旧版 host 没有 connect 字段 → 完全回退到原来的 running 文案（既有行为不变）。
+        // 锁定态的状态行不能沿用 CONNECT_TEXT.error（"连接失败，请按下方提示处理"）：用户会以为是自己网络/软件坏了。
+        var connLocked = Boolean(connInfo && connInfo.locked);
         var statusTxt = st === null
           ? "查询中…"
           : !loggedInSaaS
             ? "请先登录（下方账号卡片）后启用远程访问"
-            : connInfo ? connText : serviceRunning ? "已连接（可远程访问）" : "等待设备连接";
+            : connInfo
+              ? (connLocked ? "本机已被锁定（当前套餐设备额度已满，升级 Pro Max 或解绑其他设备后自动恢复）" : connText)
+              : serviceRunning ? "已连接（可远程访问）" : "等待设备连接";
         var dotOn = loggedInSaaS ? (connInfo ? connOnline : serviceRunning) : false;
         var dotCls = "dru-dot " + (dotOn ? "dru-dot-on" : "dru-dot-off");
 
@@ -4751,6 +4795,22 @@ window.__ModuleLoader__.load({
           return h("div", null, rows);
         }
 
+        /**
+         * 锁定态的主行动：「🚀 升级 Pro Max」。
+         * 链接从云端账号信息派生（public-config 的 app_url / 面板已拿到的 remoteUrl → origin + /app/promo），
+         * **不硬编码域名**；派生不出地址（未登录/取配置失败）时退回既有「带登录态升级」通道。
+         */
+        function openLockedUpgrade() {
+          var promo = "";
+          try { promo = upgradePromoUrlOf((st && st.remoteUrl) || (pub && pub.app_url)); } catch (e) { promo = ""; }
+          if (promo) {
+            try { window.open(promo, "_blank", "noopener"); } catch (e2) { /* 弹窗被拦截：下面给提示 */ }
+            return;
+          }
+          try { openUpgradeAuth(); } catch (e3) {
+            try { setMessage({ kind: "err", text: "打开升级页失败，请在手机端「我的 → 升级 Pro Max」完成升级" }); } catch (e4) { /* 忽略 */ }
+          }
+        }
         function renderConnectBlock() {
           if (!loggedInSaaS || !connInfo) return null;
           var phase = connInfo.phase || "";
@@ -4760,18 +4820,29 @@ window.__ModuleLoader__.load({
                 ? "设备已登记到你的账号：手机端「设备列表」可以看到这台电脑。"
                 : "设备已注册到中继：手机端扫码或打开链接即可进入这台电脑。");
           }
+          // 锁定态（契约 §8.1）：设备被超额锁定 ≠ 普通故障 —— bridge 活着并在 30s 轮询等解锁，
+          // 所以文案给「升级 / 解绑」两条出路，主行动是升级按钮，且**不显示"自动重试 N 次"**（那会暗示死循环）。
+          var lockedInfo = connInfo.locked && typeof connInfo.locked === "object" ? connInfo.locked : null;
+          var isLocked = Boolean(lockedInfo) || Boolean(connError && connError.code === "device_locked");
           var rows = [];
           if (phase === "error") {
             rows.push(h("div", { className: "dru-msg dru-msg-err", style: { marginTop: 6 } },
-              "⚠️ " + ((connError && connError.message) || connText)));
+              (isLocked ? "🔒 " : "⚠️ ") + ((connError && connError.message) || connText)));
             if (connInfo.detail) rows.push(h("div", { className: "dru-hint", style: { marginTop: 4 } }, connInfo.detail));
-            if (connInfo.nextRetryInMs > 0) {
+            if (!isLocked && connInfo.nextRetryInMs > 0) {
               rows.push(h("div", { className: "dru-hint", style: { marginTop: 4 } },
                 "已自动重试 " + (connInfo.attempts || 0) + " 次，约 " + Math.ceil(connInfo.nextRetryInMs / 1000) + " 秒后自动再试（也可以点下面按钮立刻重试）"));
             }
-            rows.push(h("div", { className: "dru-actions", style: { marginTop: 8 } },
-              h("button", { type: "button", className: "dru-btn dru-btn-primary", disabled: busy !== "", onClick: retryConnect }, busy === "connect-retry" ? "重试中…" : "重试"),
-              h("button", { type: "button", className: "dru-btn dru-btn-ghost", onClick: copyDiagnostics }, copiedDiag ? "已复制" : "复制诊断信息")));
+            if (isLocked) {
+              // 主行动：升级 Pro Max（红色错误条里最该点的就是它）
+              rows.push(h("div", { className: "dru-actions", style: { marginTop: 8 } },
+                h("button", { type: "button", className: "dru-btn dru-btn-primary", onClick: openLockedUpgrade }, "🚀 升级 Pro Max"),
+                h("button", { type: "button", className: "dru-btn dru-btn-ghost", onClick: copyDiagnostics }, copiedDiag ? "已复制" : "复制诊断信息")));
+            } else {
+              rows.push(h("div", { className: "dru-actions", style: { marginTop: 8 } },
+                h("button", { type: "button", className: "dru-btn dru-btn-primary", disabled: busy !== "", onClick: retryConnect }, busy === "connect-retry" ? "重试中…" : "重试"),
+                h("button", { type: "button", className: "dru-btn dru-btn-ghost", onClick: copyDiagnostics }, copiedDiag ? "已复制" : "复制诊断信息")));
+            }
             rows.push(h("div", { className: "dru-hint", style: { marginTop: 6 } },
               "查看日志：后台服务 " + (connInfo.logPath || "") + " ，安装 " + (connInfo.installLogPath || "") + "（把「复制诊断信息」的内容发给客服可加速定位）"));
             var diagToolsErr = renderDiagTools();
@@ -5121,7 +5192,8 @@ window.__ModuleLoader__.load({
             // 自动连接进度（登录后由面板 2.5s 短轮询自动推进）：让用户在 bridge 卡也能一眼看到
             // 「到底走到哪一步了」——进程在跑≠能用，注册到中继才算。
             connInfo && connPhase && connPhase !== "no_account"
-              ? h("div", { className: "dru-hint", style: { marginTop: 6 } }, "自动连接进度：" + connText)
+              ? h("div", { className: "dru-hint", style: { marginTop: 6 } },
+                  "自动连接进度：" + (connInfo.locked ? "本机已被锁定（当前套餐额度已满，升级或解绑后自动恢复）" : connText))
               : null,
             h("div", { className: "dru-actions", style: { marginTop: 10 } },
               !serviceRunning
@@ -5145,13 +5217,22 @@ window.__ModuleLoader__.load({
                     "⚠️ 上一次启动失败（自启动入口失效），已自动清理失效自启动项并重新补装运行环境。稍候会自动恢复；仍失败请点「一键更新」。")
                 : null,
             st && st.service && st.service.bindError
-              ? h("div", { className: "dru-msg dru-msg-err", style: { marginTop: 8 } },
-                  "⚠️ 设备注册失败：" + (st.service.bindError.message || "未说明原因"),
-                  h("div", { className: "dru-hint", style: { marginTop: 4 } },
-                    st.service.bindError.code === "device_limit_exceeded"
-                      ? "已达本套餐设备数上限。若是同一台电脑重装，稍等片刻会自动顶替旧设备；仍未恢复请在手机端「设备管理」解绑旧设备（免费用户每月可解绑 3 次）后，回到这里点「启动后台服务」。"
-                      : "请确认网络与账号状态后重试；仍未解决可点下方「彻底卸载」后重新安装。")
-                )
+              ? (function (be) {
+                  var isLocked = be.code === "device_locked" || be.code === "device_limit_exceeded";
+                  var isBindCap = be.code === "device_bind_cap";
+                  var beLimit = (be.limit === 0 || be.limit) ? be.limit : null;
+                  return h("div", { className: "dru-msg dru-msg-err", style: { marginTop: 8 } },
+                    (isLocked ? "🔒 本机已被锁定：" : "⚠️ 设备注册失败：") + (be.message || "未说明原因"),
+                    h("div", { className: "dru-hint", style: { marginTop: 4 } },
+                      isLocked
+                        // 契约 §8.1 的新语义：不是"解绑旧设备才能登录"，而是"超额锁定 → 升级或解绑，本机自动解锁"
+                        ? lockedPanelDetail(beLimit)
+                        : isBindCap
+                          // device_bind_cap = 防滥用硬上限（bridge 退出码 5）：守护按指数退避重试，不是无限重试
+                          ? "已绑定设备数达到上限：请在手机端「管理电脑」解绑不再使用的设备；解绑后本机会自动恢复（后台守护会按指数退避重试，无需反复点按钮）。"
+                          : "请确认网络与账号状态后重试；仍未解决可点下方「彻底卸载」后重新安装。")
+                  );
+                })(st.service.bindError)
               : null
           ),
           // 版本与更新（自管理：检测新版 / 一键在线更新 / 彻底卸载）
@@ -5332,8 +5413,12 @@ window.__ModuleLoader__.load({
       function renderAnnouncementsCard() {
         if (!annState.ok || !annState.bubble) return null;
         var items = annState.items;
-        if (!items.length) return null;
         var unread = annState.unread;
+        // 2026-10-25：列表为空时**保留板块**（显示「暂无公告」）而不是整卡消失 ——
+        // 板块本身是用户确认"公告功能还在"的锚点，静默消失会被当成功能坏了。
+        if (!items.length) {
+          return card("📣 公告", [h("div", { className: "dru-hint" }, "暂无公告")]);
+        }
         return card("📣 公告" + (unread > 0 ? "（" + unread + " 条未读）" : ""), [
           h("div", { className: "dru-ann-list" }, items.map(function (it) {
             return h("button", {