dsh-remote-ui 0.6.0 → 0.6.1

package/lib/client.js

@@ -134,6 +134,9 @@ window.__ModuleLoader__.load({
       ".dru-popup-foot button{border:none;background:none;color:#57606a;cursor:pointer;font-size:12px;font-family:inherit;padding:4px 6px}",
       ".dru-popup-foot button:hover{color:#0969da}",
       ".dru-popup .dru-msg{text-align:left}",
+      ".dru-community-qr{display:block;width:220px;max-width:62vw;margin:0 auto;background:#ffffff;padding:10px;border-radius:10px;border:1px solid #d0d7de;box-sizing:content-box}",
+      ".dru-fb-community{margin-top:16px;padding-top:14px;border-top:1px dashed #d0d7de;text-align:center}",
+      ".dru-fb-community .dru-community-qr{width:180px;max-width:56vw}",
       // ── 自管理：版本与更新（插件面板内提供在线更新/彻底卸载，市场无更新按钮） ──
       ".dru-ver-badge{display:inline-block;font-size:11px;border-radius:999px;padding:1px 8px;margin-left:6px;vertical-align:1px}",
       ".dru-ver-badge-new{color:#9a6700;background:#fff8c5;border:1px solid #eed888}",
@@ -347,6 +350,60 @@ window.__ModuleLoader__.load({
       return api(path, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(data || {}) });
     };
 
+    // ── 交流群（运营二维码;管理后台统一上传,node 半经公开配置下发） ─────────
+    // 设置面板「加入交流群」按钮与用户反馈页都展示同一张码;未配置(qrcode 为空)→ 不展示任何入口。
+    var COMMUNITY_TTL_MS = 5 * 60 * 1000; // 面板/反馈卡共用缓存:5 分钟内不重复请求
+    var communityCache = { at: 0, data: null };
+    /** 取交流群信息(模块级缓存;失败视为未配置,不打扰用户)。 */
+    function loadCommunity(force) {
+      if (!force && communityCache.data && Date.now() - communityCache.at < COMMUNITY_TTL_MS) {
+        return Promise.resolve(communityCache.data);
+      }
+      return api("/dsh-remote/community").then(function (b) {
+        communityCache = { at: Date.now(), data: { qrcode: (b && b.qrcode) || "", wechat: (b && b.wechat) || "" } };
+        return communityCache.data;
+      }).catch(function () {
+        communityCache = { at: Date.now(), data: { qrcode: "", wechat: "" } };
+        return communityCache.data;
+      });
+    }
+
+    // ── 登录后首次加载的自愈（0.6.1） ───────────────────────────────
+    // 现象（首次安装后立即登录）：面板在 loggedIn 翻真的瞬间就请求 /dsh-remote/access-key 与
+    // /dsh-remote/mobile-sessions；此时中继握手可能尚未就绪（bridge 刚被重启、device-login 共享密钥
+    // 刚补齐或正在轮换、中继冷启动/网络抖动），旧版只报一次红字且不重试——必须手动刷新页面才行。
+    // 现在：可重试类失败按退避自动重试（成功即自动清除红字），并给红字配「重试」按钮。
+    var LOGIN_LOAD_RETRY_MS = [1200, 3000, 6000];
+
+    /** node 半标记 retryable（中继未就绪）或网络/5xx → 值得自动重试；未登录/密码失效不重试。 */
+    function retryableFail(e) {
+      var body = e && e.body;
+      if (body && body.retryable === true) return true;
+      if (body && typeof body.hint === "string" && /^relay_/.test(body.hint)) return true;
+      var st = e && e.status;
+      if (typeof st !== "number") return true;       // fetch 本身失败（网络中断/被中止）
+      return st === 0 || st === 408 || st === 429 || st >= 500;
+    }
+
+    /** 定时器节流：tests/SSR 环境没有 setTimeout 时静默降级（不抛错、不阻塞面板）。 */
+    function later(fn, ms) {
+      try { return setTimeout(fn, ms); } catch (e) { return null; }
+    }
+    function clearLater(t) {
+      if (t == null) return;
+      try { clearTimeout(t); } catch (e) { /* 忽略 */ }
+    }
+
+    /** 一次性访问密钥 / 已授权设备列表的自动重试状态（放在组件外：不随渲染重建）。 */
+    var akeyRetry = { timer: null, attempt: 0 };
+    var devRetry = { timer: null, attempt: 0 };
+    // 请求在途标记同样放组件外：组件内 state 闭包会在定时器/轮询回调里过期，
+    // 导致 busy 护栏失效（重复请求）或误拦（该重试却跳过）。
+    var akeyInFlight = { v: false };
+    var devInFlight = { v: false };
+    function cancelAkeyRetry() { clearLater(akeyRetry.timer); akeyRetry.timer = null; }
+    function cancelDevRetry() { clearLater(devRetry.timer); devRetry.timer = null; }
+
     /** 一次性访问 url → 升级/续费页 url（带同一 auth，进入后即登录态到 /app/promo）。 */
     function promoUrlOf(u) {
       var s = String(u || "");
@@ -442,6 +499,8 @@ window.__ModuleLoader__.load({
       var mineListArr = useState(null); var mineList = mineListArr[0]; var setMineList = mineListArr[1];
       var mineErrArr = useState(false); var mineErr = mineErrArr[0]; var setMineErr = mineErrArr[1];
       var mineBusyArr = useState(false); var mineBusy = mineBusyArr[0]; var setMineBusy = mineBusyArr[1];
+      // 💬 交流群:反馈页底部展示「加入交流群」二维码(与设置面板共用同一份缓存)
+      var commArr = useState(communityCache.data); var comm = commArr[0]; var setComm = commArr[1];
 
       function setMsg(kind, text) { setFbMsg({ kind: kind, text: text }); }
 
@@ -449,6 +508,12 @@ window.__ModuleLoader__.load({
       // 自建/未登录(cfg.phone 为空)→ 仍走本地 thread_token,不发 /mine。
       var fbAccount = !!(cfg && cfg.phone && fbAuth === "account");
 
+      useEffect(function () {
+        var alive = true;
+        loadCommunity().then(function (d) { if (alive) setComm(d); });
+        return function () { alive = false; };
+      }, []);
+
       var loadCfg = useCallback(function () {
         api("/dsh-remote/feedback-config").then(function (b) {
           setCfg(b);
@@ -688,7 +753,15 @@ window.__ModuleLoader__.load({
               h("button", { type: "button", className: "dru-btn dru-btn-primary", style: { width: "100%" }, disabled: busy !== "", onClick: doSubmit }, busy === "submit" ? "提交中…" : "提交反馈"),
               fbMsg && h("div", { className: "dru-msg dru-msg-" + fbMsg.kind }, fbMsg.text)
             )
-          : renderMine()
+          : renderMine(),
+        // 反馈页底部:企微交流群二维码(后台上传后出现;未配置不展示)
+        comm && comm.qrcode
+          ? h("div", { className: "dru-fb-community" },
+              h("div", { className: "dru-fb-community-title" }, "💬 加入企微交流群"),
+              h("div", { className: "dru-hint", style: { marginBottom: 8 } }, "扫码入群：安装答疑 / 使用技巧 / 版本更新 / 问题反馈"),
+              h("img", { className: "dru-community-qr", src: comm.qrcode, alt: "企微交流群二维码" }),
+              comm.wechat ? h("div", { className: "dru-hint", style: { marginTop: 8 } }, "二维码失效或群满，可加客服微信：" + comm.wechat) : null)
+          : null
       );
     }
 
@@ -1099,6 +1172,9 @@ window.__ModuleLoader__.load({
       var pwdSmsArr = useState(""); var pwdSms = pwdSmsArr[0]; var setPwdSms = pwdSmsArr[1];
       var pwdSmsBtnArr = useState("获取验证码"); var pwdSmsBtn = pwdSmsBtnArr[0]; var setPwdSmsBtn = pwdSmsBtnArr[1];
       var pwdNewArr = useState(""); var pwdNew = pwdNewArr[0]; var setPwdNew = pwdNewArr[1];            // 新密码（≥8）
+      // ── 💬 交流群（「加入交流群」按钮 + 弹窗）：同样放在全部既有字段之后 ──
+      var communityArr = useState(null); var community = communityArr[0]; var setCommunity = communityArr[1]; // {qrcode,wechat}；null=未加载
+      var commOpenArr = useState(false); var commOpen = commOpenArr[0]; var setCommOpen = commOpenArr[1];
 
       var refresh = useCallback(function () {
         setBusy("status");
@@ -1126,6 +1202,8 @@ window.__ModuleLoader__.load({
 
       var loggedIn = !!(st && st.config && (st.config.phone || st.config.hasLocalKey));
       var serviceRunning = !!(st && st.service && st.service.running);
+      // 账号标识（掩码手机号）：登录成功/换账号时变化 → 触发上方的重取 effect（比布尔 loggedIn 更敏感）
+      var phoneKey = (st && st.config && st.config.phone) || "";
       var launchdPid = st && st.service && st.service.launchd && st.service.launchd.pid;
 
       // 已登录(SaaS)→ 拉我的信息/配额/公共配置
@@ -1137,6 +1215,13 @@ window.__ModuleLoader__.load({
       }, [st && st.config && st.config.phone]);
 
       useEffect(function () { refresh(); }, [refresh]);
+
+      // 交流群二维码(后台上传即可展示;未配置 → community.qrcode 为空,入口不出现)
+      useEffect(function () {
+        var alive = true;
+        loadCommunity().then(function (d) { if (alive) setCommunity(d); });
+        return function () { alive = false; };
+      }, []);
       useEffect(function () {
         // 展开「忘记密码」重置表单时不用预载登录表单验证码（收起的 reset 表单用独立 pwdCap）
         if (st !== null && !loggedIn && mode === "saas" && authTab === "login" && !pwdOpen && !lcap) loadCaptcha("login");
@@ -1184,20 +1269,26 @@ window.__ModuleLoader__.load({
         return d.getFullYear() + "-" + pad2(d.getMonth() + 1) + "-" + pad2(d.getDate()) + " " + pad2(d.getHours()) + ":" + pad2(d.getMinutes());
       }
 
-      /** 创建（或刷新）一次性访问密钥：GET /dsh-remote/access-key（node 半转发企业端 /api/auth-key）。 */
+      /**
+       * 创建（或刷新）一次性访问密钥：GET /dsh-remote/access-key（node 半转发企业端 /api/auth-key）。
+       * 失败自愈：中继未就绪类失败（node 半 retryable / 网络 / 5xx）按退避自动重试，
+       * 见「登录后首次加载自愈」——首次安装立即登录时不再需要手动刷新页面。
+       */
       function loadAccessKey() {
-        if (akeyBusy) return;
+        if (akeyInFlight.v) return;
         // 登录前不请求企业端（避免 401/404 噪音）；由账号登录成功后触发
         if (!(st && st.config && st.config.phone)) {
           setAkeyMsg(null);
+          cancelAkeyRetry();
           return;
         }
+        akeyInFlight.v = true;
         setAkeyBusy(true);
         api("/dsh-remote/access-key").then(function (b) {
           if (!b || !b.ok) {
             var why = (b && (b.error || (b.body && b.body.error))) || "未知错误";
-            setAkeyMsg({ kind: "err", text: "获取一次性访问地址失败：" + why });
-            return;
+            var e = new Error(why); e.body = b || null;
+            throw e;
           }
           // 契约容错：url 必须有；qr_data_url 取不到时仍展示链接/复制/直接打开
           if (!b.url) {
@@ -1212,9 +1303,16 @@ window.__ModuleLoader__.load({
             qr_data_url: b.qr_data_url != null ? b.qr_data_url : null
           });
           setAkeyMsg(null);
+          akeyRetry.attempt = 0;
         }).catch(function (e) {
-          setAkeyMsg({ kind: "err", text: "获取一次性访问地址失败：" + e.message });
-        }).finally(function () { setAkeyBusy(false); });
+          var text = "获取一次性访问地址失败：" + e.message;
+          if (retryableFail(e) && akeyRetry.attempt < LOGIN_LOAD_RETRY_MS.length) {
+            scheduleAkeyRetry(text);
+            return;
+          }
+          // 自动重试额度用尽（或不该重试）→ 红字 + 「立即重试」入口，不让用户只能刷新页面
+          setAkeyMsg({ kind: "err", text: text, retry: retryAkeyManually });
+        }).finally(function () { akeyInFlight.v = false; setAkeyBusy(false); });
       }
 
       var copyKeyUrl = function () {
@@ -1232,17 +1330,67 @@ window.__ModuleLoader__.load({
         try { window.open(akey.url, "_blank", "noopener"); } catch (e) {}
       };
 
-      /** 加载已授权设备列表：GET /dsh-remote/mobile-sessions。 */
+      /** 加载已授权设备列表：GET /dsh-remote/mobile-sessions（失败同上：可重试类自动重试）。 */
       function loadDevices() {
-        if (devBusy !== "") return;
+        if (devInFlight.v || devBusy !== "") return;
+        devInFlight.v = true;
         setDevBusy("list");
         api("/dsh-remote/mobile-sessions").then(function (b) {
           if (!b || !b.ok) throw new Error((b && b.error) || "加载已授权设备失败");
           setDevSessions(Array.isArray(b.sessions) ? b.sessions : []);
           setDevMsg(null);
+          devRetry.attempt = 0;
         }).catch(function (e) {
-          setDevMsg({ kind: "err", text: "加载已授权设备失败：" + e.message });
-        }).finally(function () { setDevBusy(""); });
+          var text = "加载已授权设备失败：" + e.message;
+          if (retryableFail(e) && devRetry.attempt < LOGIN_LOAD_RETRY_MS.length) {
+            scheduleDevRetry(text);
+            return;
+          }
+          setDevMsg({ kind: "err", text: text, retry: retryDevicesManually });
+        }).finally(function () { devInFlight.v = false; setDevBusy(""); });
+      }
+      /** 手动重试（红字旁的「重试」按钮）：重置退避计数后立即重新拉取。 */
+      var retryAkeyManually = function () {
+        cancelAkeyRetry();
+        akeyRetry.attempt = 0;
+        setAkeyMsg(null);
+        loadAccessKey();
+      };
+      var retryDevicesManually = function () {
+        cancelDevRetry();
+        devRetry.attempt = 0;
+        setDevMsg(null);
+        loadDevices();
+      };
+      /** 定时重试一次性访问密钥（黄字提示 + 退避；成功时由 loadAccessKey 清掉提示）。 */
+      function scheduleAkeyRetry(why) {
+        cancelAkeyRetry();
+        var wait = LOGIN_LOAD_RETRY_MS[akeyRetry.attempt] || LOGIN_LOAD_RETRY_MS[LOGIN_LOAD_RETRY_MS.length - 1];
+        akeyRetry.attempt += 1;
+        setAkeyMsg({
+          kind: "warn",
+          text: "中继连接尚未就绪，" + Math.round(wait / 1000) + " 秒后自动重试（第 " + akeyRetry.attempt + "/" + LOGIN_LOAD_RETRY_MS.length + " 次）：" + why,
+          retry: retryAkeyManually
+        });
+        akeyRetry.timer = later(function () {
+          akeyRetry.timer = null;
+          loadAccessKey(); // 在途标记由上一个请求的 finally 释放，退避窗口内用户也可手动刷新
+        }, wait);
+      }
+      /** 定时重试已授权设备列表（同上）。 */
+      function scheduleDevRetry(why) {
+        cancelDevRetry();
+        var wait = LOGIN_LOAD_RETRY_MS[devRetry.attempt] || LOGIN_LOAD_RETRY_MS[LOGIN_LOAD_RETRY_MS.length - 1];
+        devRetry.attempt += 1;
+        setDevMsg({
+          kind: "warn",
+          text: "中继连接尚未就绪，" + Math.round(wait / 1000) + " 秒后自动重试（第 " + devRetry.attempt + "/" + LOGIN_LOAD_RETRY_MS.length + " 次）：" + why,
+          retry: retryDevicesManually
+        });
+        devRetry.timer = later(function () {
+          devRetry.timer = null;
+          loadDevices();
+        }, wait);
       }
       /** 操作（取消配对/删除记录/清理已解绑）成功后静默重拉列表，覆盖行内状态。 */
       function refreshDeviceList() {
@@ -1346,13 +1494,22 @@ window.__ModuleLoader__.load({
 
       // 已登录云端主视图停留期间：打开即取一把新 key + 已授权设备；之后每 ~25s 自动轮换
       // （未登录不轮询，避免 401 空转；离开栏目/切视图/退出登录即清理定时器）
+      //
+      // 依赖里带上「账号」与「bridge 运行态」：登录成功（含换账号）与 bridge 拉起/重启后立即重取，
+      // 首次安装后立即登录不再需要手动刷新页面；失败重试由 loadAccessKey/loadDevices 内部退避处理。
       useEffect(function () {
         if (view !== "home" || mode !== "saas" || !loggedIn) return undefined;
+        cancelAkeyRetry(); cancelDevRetry();
+        akeyRetry.attempt = 0; devRetry.attempt = 0;
         loadAccessKey();
         loadDevices();
         var rotateIv = setInterval(function () { loadAccessKey(); }, KEY_AUTO_REFRESH_MS);
-        return function () { clearInterval(rotateIv); };
-      }, [view, mode, loggedIn]);
+        return function () {
+          clearInterval(rotateIv);
+          cancelAkeyRetry();
+          cancelDevRetry();
+        };
+      }, [view, mode, loggedIn, phoneKey, serviceRunning]);
 
       function setMsg(kind, text) { setMessage({ kind: kind, text: text }); }
 
@@ -1760,7 +1917,13 @@ window.__ModuleLoader__.load({
             h("span", null, statusTxt)
           ),
           renderE2eeBadge(),
-          akeyMsg ? h("div", { className: "dru-msg dru-msg-" + akeyMsg.kind, style: { marginTop: 8 } }, akeyMsg.text) : null,
+          akeyMsg
+            ? h("div", { className: "dru-msg dru-msg-" + akeyMsg.kind, style: { marginTop: 8 } },
+                akeyMsg.text,
+                akeyMsg.retry
+                  ? h("button", { type: "button", className: "dru-linkbtn", style: { marginLeft: 8 }, disabled: akeyBusy, onClick: akeyMsg.retry }, akeyBusy ? "重试中…" : "立即重试")
+                  : null)
+            : null,
           hasKey ? h("div", null, [
             h("div", { className: "dru-url big", style: { marginTop: 8 } },
               h("span", null, akey.url),
@@ -1883,7 +2046,13 @@ window.__ModuleLoader__.load({
             }, devBusy === "list" ? "加载中…" : btnLabel)
           ),
           devOpen ? renderDeviceList() : null,
-          devMsg ? h("div", { className: "dru-msg dru-msg-" + devMsg.kind, style: { marginTop: 6 } }, devMsg.text) : null
+          devMsg
+            ? h("div", { className: "dru-msg dru-msg-" + devMsg.kind, style: { marginTop: 6 } },
+                devMsg.text,
+                devMsg.retry
+                  ? h("button", { type: "button", className: "dru-linkbtn", style: { marginLeft: 8 }, disabled: devBusy !== "", onClick: devMsg.retry }, devBusy === "list" ? "重试中…" : "立即重试")
+                  : null)
+            : null
         ]);
       }
 
@@ -1995,7 +2164,17 @@ window.__ModuleLoader__.load({
             h("div", { className: "dru-hint", style: { marginBottom: 6 } }, "📱 远程访问：用手机或另一台电脑的浏览器，随时随地使用同一份 dsh web——人在哪都能用（免公网 IP、免内网穿透）；官方托管中继，4G/5G 即用，也可自建服务。"),
             h("div", { className: "dru-hint", style: { marginBottom: 6 } }, "🛠 电脑端一键安装：bridge 与「远程访问」面板一次到位——云端/自建切换、账号登录、bridge 启停、一次性扫码访问、已授权设备管理、意见反馈都在这里。"),
             h("div", { className: "dru-hint", style: { marginBottom: 6 } }, "🔒 安全与通道：HTTP / WebSocket 全量透传，一次性访问密钥认证，面板实时显示设备与已授权设备列表；服务端可配置流量配额。"),
-            h("div", { className: "dru-hint" }, "🛡 端到端加密：手机↔电脑之间的消息内容用「你的账号密码派生密钥」端到端加密——密钥与密码不落服务端（仅存校验值），中继只可见路径/大小/时间（详见 README「安全与隐私」）。")
+            h("div", { className: "dru-hint" }, "🛡 端到端加密：手机↔电脑之间的消息内容用「你的账号密码派生密钥」端到端加密——密钥与密码不落服务端（仅存校验值），中继只可见路径/大小/时间（详见 README「安全与隐私」）。"),
+            // 加入交流群（后台上传二维码后出现；点击弹出二维码大图便于扫码）
+            community && community.qrcode
+              ? h("div", { className: "dru-actions", style: { marginTop: 10 } },
+                  h("button", {
+                    type: "button",
+                    className: "dru-btn dru-btn-ghost",
+                    style: { width: "100%" },
+                    onClick: function () { setCommOpen(true); }
+                  }, "💬 加入交流群"))
+              : null
           ]),
           // 版本与更新（自管理：检测新版 / 一键在线更新 / 彻底卸载）
           h(SelfManageCard, null),
@@ -2003,6 +2182,29 @@ window.__ModuleLoader__.load({
         );
       }
 
+      /** 交流群弹窗（复用满意度弹窗的 dru-popup 视觉；点遮罩/关闭即收起）。 */
+      function renderCommunityModal() {
+        if (!commOpen || !(community && community.qrcode)) return null;
+        var close = function () { setCommOpen(false); };
+        return h("div", { className: "dru-popup", onMouseDown: function (e) { if (e.target === e.currentTarget) close(); } },
+          h("div", { className: "dru-popup-card", role: "dialog", "aria-label": "加入企微交流群" },
+            h("div", { className: "dru-popup-body" },
+              h("div", { className: "dru-popup-icon" }, "💬"),
+              h("div", { className: "dru-popup-title" }, "加入企微交流群"),
+              h("div", { className: "dru-popup-sub" }, "扫码入群：安装答疑 / 使用技巧 / 版本更新 / 问题反馈"),
+              h("img", { className: "dru-community-qr", src: community.qrcode, alt: "企微交流群二维码" }),
+              community.wechat
+                ? h("div", { className: "dru-hint", style: { marginTop: 10 } }, "二维码失效或群满，可加客服微信：" + community.wechat)
+                : h("div", { className: "dru-hint", style: { marginTop: 10 } }, "二维码失效或群满，可到 GitHub 提 Issue 联系作者")
+            ),
+            h("div", { className: "dru-popup-foot" },
+              h("span", null, "手机微信/企业微信扫码即可入群"),
+              h("button", { type: "button", onClick: close }, "关闭")
+            )
+          )
+        );
+      }
+
       return h("div", { className: "dru-settings-section", role: "region", "aria-label": "远程访问" },
         h("div", { className: "dru-settings-head" },
           h("span", { className: "dru-settings-icon" }, "📱"),
@@ -2013,7 +2215,8 @@ window.__ModuleLoader__.load({
         ),
         h("div", { className: "dru-settings-body" },
           view === "feedback" ? renderFeedback() : view === "invite" ? renderInvite() : renderHome()
-        )
+        ),
+        renderCommunityModal()
       );
     }
 

package/lib/index.js

@@ -612,15 +612,135 @@ async function relayFetch(relayDir, pathname, init) {
   }
 }
 
-// ---------- v2 账号/配额/邀请代理（我的信息 与 免费额度提示） ----------
+// ---------- bridge_secret 自愈（device-login 共享密钥） ----------
 
-/** 获取短期 relay token:SaaS → device-login;本地模式 → /_login(从隧道地址推导同源)。 */
-async function relayToken(relayDir) {
-  const cfg = loadConfig(relayDir);
+/**
+ * 企业端 POST /api/device-login 强制校验 `x-dsh-bridge-secret`（缺失/失效 → 401 "需要有效设备密钥"），
+ * 密钥由服务端公开配置 /api/public-config 下发、与 dsh-setup.mjs 的 `bridge_secret` 同源。
+ *
+ * 一键安装器（npx @mrrisega/dsh-remote → dsh-setup.mjs）会在安装时取一次并写入 .dsh-config.json；
+ * 但**只装插件**的路径（dsh plugin add / 插件市场安装）没有这一步，于是：
+ *   首次安装 → 打开设置面板立即登录 → 面板请求 /dsh-remote/access-key & mobile-sessions
+ *   → relayToken 拿不到 token（401 需要设备密钥）→ 面板显示「尚未登录」（其实是密钥缺失）
+ * 直到后台自愈（scheduleRuntime → ensureRuntime 跑一次 npx 安装器）把 bridge_secret 写回配置，
+ * 或用户手动刷新页面才恢复——这正是「首次安装后立即登录，二维码/设备列表报红字」的根因。
+ *
+ * 这里在插件侧补上同一份自愈：缺密钥就取一次、落盘并缓存；失败短退避后可再试，不阻塞面板。
+ */
+let bridgeSecretCache = { dir: "", secret: "", failedAt: 0 };
+const BRIDGE_SECRET_RETRY_MS = 15_000;
+
+/** 读取配置里已保存的 bridge_secret（无则空串）。 */
+function readBridgeSecret(relayDir) {
+  try {
+    return String(loadConfig(relayDir).bridge_secret || "").trim();
+  } catch {
+    return "";
+  }
+}
+
+/**
+ * 取 device-login 共享密钥：配置已有 → 直接用；否则向企业端公开配置取一次并写回配置（内存缓存兜底）。
+ * @param {string} relayDir 配置目录
+ * @param {object} [cfgOverride] 尚未落盘的配置（登录请求刚写入 phone/password 时用），仅用于判断模式
+ * @param {{force?: boolean, timeoutMs?: number}} [opts] force=true 跳过本地文件/缓存强制重取；
+ *        timeoutMs 限制单次公开配置请求耗时（登录路径用更短的上限，避免拖慢登录响应）
+ * @returns {Promise<string>} 密钥（取不到为空串，调用方按“中继未就绪”降级，不抛错）
+ */
+async function bridgeSecretOf(relayDir, cfgOverride, opts) {
+  const force = !!(opts && opts.force);
+  if (!force) {
+    const local = readBridgeSecret(relayDir);
+    if (local) {
+      bridgeSecretCache = { dir: relayDir, secret: local, failedAt: 0 };
+      return local;
+    }
+    if (bridgeSecretCache.dir === relayDir && bridgeSecretCache.secret) return bridgeSecretCache.secret;
+    if (bridgeSecretCache.dir === relayDir && Date.now() - bridgeSecretCache.failedAt < BRIDGE_SECRET_RETRY_MS) return ""; // 负缓存：别把公开配置打爆
+  }
+  const cfg = cfgOverride && typeof cfgOverride === "object" ? { ...loadConfig(relayDir), ...cfgOverride } : loadConfig(relayDir);
+  if (cfg.local_key) return ""; // 自建模式走 /_login，不用设备密钥
   const api = (cfg.api_url || DEFAULT_API).replace(/\/+$/, "");
-  if (cfg.local_key) {
-    // 本地认证:POST {tunnel 同源}/_login
-    const u = new URL(cfg.tunnel_url || api.replace(/^https?/, "wss"));
+  const timeoutMs = Number((opts && opts.timeoutMs) || 0) > 0 ? Number(opts.timeoutMs) : 6000;
+  let secret = "";
+  try {
+    const r = await fetch(`${api}/api/public-config`, { signal: AbortSignal.timeout(timeoutMs) });
+    if (r.ok) {
+      const d = await r.json();
+      secret = String((d && d.bridge_secret) || "").trim();
+    }
+  } catch { /* 网络抖动：负缓存短退避后再试 */ }
+  if (!secret) {
+    bridgeSecretCache = { dir: relayDir, secret: "", failedAt: Date.now() };
+    return "";
+  }
+  bridgeSecretCache = { dir: relayDir, secret, failedAt: 0 };
+  // 落盘（与 dsh-setup.mjs 同一份配置）：即使本进程退出，下次启动也不再缺密钥/不再是旧密钥
+  let healed = false;
+  try {
+    const cur = loadConfig(relayDir);
+    if (!cur.bridge_secret || (force && cur.bridge_secret !== secret)) {
+      cur.bridge_secret = secret;
+      saveConfig(relayDir, cur);
+      healed = true;
+    }
+  } catch { /* 写盘失败不致命：内存缓存本次进程内仍生效 */ }
+  // 密钥是「从无到有」补上的：已经在跑的 bridge 是用空密钥起的，隧道认证同样会失败——
+  // 后台重启一次让它带上密钥（一次性事件，失败只记日志不打断面板请求）。
+  if (healed && !UNINSTALLED_DIRS.has(relayDir)) {
+    setTimeout(() => {
+      try {
+        const st = launchdStatus();
+        if (!st.running) return;
+        const r = startBridge(relayDir);
+        console.log(`[dsh-remote-web] 已补记 bridge_secret，后台重启 bridge 使其生效: ${r.status}`);
+      } catch (e) {
+        console.warn(`[dsh-remote-web] 补记 bridge_secret 后重启 bridge 失败: ${e.message}`);
+      }
+    }, 50).unref?.();
+  }
+  return secret;
+}
+
+// ---------- v2 账号/配额/邀请代理（我的信息 与 免费额度提示） ----------
+
+/** token 获取失败的原因（供 UI 区分“未登录”与“中继未就绪”，不再一律谎报“尚未登录”）。 */
+const AUTH_NO_CREDENTIALS = "no_credentials";       // 本机没存账号/自建密钥 → 该去登录
+const AUTH_BAD_CREDENTIALS = "bad_credentials";     // 账号密码被企业端拒绝 → 该重新登录
+const AUTH_RELAY_UNREACHABLE = "relay_unreachable"; // 网络/5xx/超时 → 稍后重试
+const AUTH_RELAY_NOT_READY = "relay_not_ready";     // 凭证齐全但企业端未接受（缺失/轮换中的设备密钥等）→ 稍后重试
+
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+
+/** 单次 device-login：返回 { ok, status, token, code, detail }（不抛错，便于按原因降级/重试）。 */
+async function deviceLoginOnce(api, cfg, secret) {
+  try {
+    const r = await fetch(`${api}/api/device-login`, {
+      method: "POST",
+      headers: { "content-type": "application/json", ...(secret ? { "x-dsh-bridge-secret": secret } : {}) },
+      body: JSON.stringify({ phone: cfg.phone, email: cfg.phone, password: cfg.password }),
+      signal: AbortSignal.timeout(6000)
+    });
+    const text = await r.text();
+    let d = null;
+    try { d = JSON.parse(text); } catch { d = null; }
+    return {
+      ok: r.ok,
+      status: r.status,
+      token: (d && d.token) || "",
+      code: (d && d.error && d.error.code) || "",
+      detail: (d && d.error && (d.error.message || d.error.code)) || "",
+    };
+  } catch (e) {
+    return { ok: false, status: 0, token: "", code: "", detail: e.message };
+  }
+}
+
+/** 单次本地认证（自建模式）：POST {隧道同源}/_login。 */
+async function localLoginOnce(cfg, api) {
+  const fallbackApi = (api || cfg.api_url || DEFAULT_API).replace(/\/+$/, "");
+  try {
+    const u = new URL(cfg.tunnel_url || fallbackApi.replace(/^https?/, "wss"));
     u.protocol = u.protocol === "wss:" ? "https:" : "http:";
     u.pathname = "/_login";
     const r = await fetch(u.toString(), {
@@ -629,20 +749,59 @@ async function relayToken(relayDir) {
       body: JSON.stringify({ key: cfg.local_key }),
       signal: AbortSignal.timeout(6000)
     });
-    if (!r.ok) return "";
+    if (!r.ok) return { ok: false, status: r.status, token: "", code: "", detail: "" };
     const d = await r.json();
-    return d.token || "";
+    return { ok: true, status: 200, token: (d && d.token) || "", code: "", detail: "" };
+  } catch (e) {
+    return { ok: false, status: 0, token: "", code: "", detail: e.message };
   }
-  if (!cfg.phone || !cfg.password) return "";
-  const r = await fetch(`${api}/api/device-login`, {
-    method: "POST",
-    headers: { "content-type": "application/json", ...(cfg.bridge_secret ? { "x-dsh-bridge-secret": cfg.bridge_secret } : {}) },
-    body: JSON.stringify({ phone: cfg.phone, email: cfg.phone, password: cfg.password }),
-    signal: AbortSignal.timeout(6000)
-  });
-  if (!r.ok) return "";
-  const d = await r.json();
-  return d.token || "";
+}
+
+/**
+ * 获取短期 relay token:SaaS → device-login;本地模式 → /_login(从隧道地址推导同源)。
+ * 与旧版差异：① 缺 device-login 共享密钥时自愈补齐；② 服务端轮换密钥(401/403)自动重取重试；
+ * ③ 网络抖动/5xx 退避重试一次；④ 失败时给出**可判定原因**而非空串（消除“尚未登录”误报）。
+ * @returns {Promise<{token:string, reason:string, status:number, detail:string}>}
+ */
+async function relayTokenWithReason(relayDir, cfgOverride) {
+  const cfg = cfgOverride && typeof cfgOverride === "object" ? { ...loadConfig(relayDir), ...cfgOverride } : loadConfig(relayDir);
+  const api = (cfg.api_url || DEFAULT_API).replace(/\/+$/, "");
+  if (cfg.local_key) {
+    let r = await localLoginOnce(cfg, api);
+    if (!r.token && (r.status === 0 || r.status >= 500)) { await sleep(350); r = await localLoginOnce(cfg, api); }
+    if (r.token) return { token: r.token, reason: "", status: r.status, detail: "" };
+    return {
+      token: "",
+      reason: r.status === 401 || r.status === 403 ? AUTH_BAD_CREDENTIALS : AUTH_RELAY_UNREACHABLE,
+      status: r.status,
+      detail: r.detail,
+    };
+  }
+  if (!cfg.phone || !cfg.password) return { token: "", reason: AUTH_NO_CREDENTIALS, status: 0, detail: "" };
+
+  let secret = await bridgeSecretOf(relayDir, cfgOverride);
+  let r = await deviceLoginOnce(api, cfg, secret);
+  // 带了密钥仍被拒 → 可能是服务端轮换了共享密钥：丢弃缓存强制重取一次再试
+  if (!r.token && (r.status === 401 || r.status === 403) && secret) {
+    const fresh = await bridgeSecretOf(relayDir, cfgOverride, { force: true });
+    if (fresh && fresh !== secret) r = await deviceLoginOnce(api, cfg, fresh);
+  }
+  // 网络抖动/超时/5xx：短退避重试一次（首次安装后中继握手偶发失败很常见）
+  if (!r.token && (r.status === 0 || r.status >= 500)) {
+    await sleep(350);
+    r = await deviceLoginOnce(api, cfg, await bridgeSecretOf(relayDir, cfgOverride));
+  }
+  if (r.token) return { token: r.token, reason: "", status: r.status, detail: "" };
+  if (r.code === "bad_credentials") return { token: "", reason: AUTH_BAD_CREDENTIALS, status: r.status, detail: r.detail };
+  // 凭证齐全但企业端没给 token（设备密钥缺失/轮换中、限流、其它 4xx）→ 可重试，不谎报“未登录”
+  if (r.status === 0 || r.status >= 500) return { token: "", reason: AUTH_RELAY_UNREACHABLE, status: r.status, detail: r.detail };
+  return { token: "", reason: AUTH_RELAY_NOT_READY, status: r.status, detail: r.detail };
+}
+
+/** 兼容旧调用方（反馈/账号/配额等只需 token 字符串）。 */
+async function relayToken(relayDir) {
+  const r = await relayTokenWithReason(relayDir).catch(() => ({ token: "" }));
+  return r.token || "";
 }
 
 /** 我的信息:SaaS 账号的生效套餐/到期日/邀请码(经 /api/me)。 */
@@ -700,6 +859,35 @@ async function relayInviteRecords(relayDir) {
   return { records: r.body.records || [], rewards: r.body.rewards || [] };
 }
 
+// ---------- 交流群二维码（运营配置，公开读取） ----------
+
+/**
+ * 交流群二维码/客服微信：企业端配置经公开配置 /api/public-config 的 community 字段下发
+ * （community.qrcode 形如 "/qr/group-qr.png"）。面板与反馈页展示「加入交流群」用。
+ *
+ * 面板跑在电脑本机 dsh web（http://127.0.0.1:3080），相对路径无法直接当 <img src>，
+ * 故这里按企业端公开约定拼成绝对地址：<api_url><qrcode>（与手机端 PWA 的 API_BASE + qr 一致）。
+ * 30s 内存缓存：面板与反馈卡都会取，避免重复打公开配置。
+ */
+const COMMUNITY_TTL_MS = 30_000;
+let communityCache = { dir: "", at: 0, data: null };
+
+async function communityInfo(relayDir) {
+  if (communityCache.data && communityCache.dir === relayDir && Date.now() - communityCache.at < COMMUNITY_TTL_MS) {
+    return communityCache.data;
+  }
+  const cfg = loadConfig(relayDir);
+  const api = (cfg.api_url || DEFAULT_API).replace(/\/+$/, "");
+  const r = await relayFetch(relayDir, "/api/public-config");
+  const b = r.ok && r.body && typeof r.body === "object" ? r.body : {};
+  const c = b.community && typeof b.community === "object" ? b.community : {};
+  const raw = String(c.qrcode || "").trim();
+  const qrcode = raw && !/^https?:/i.test(raw) ? api + (raw.startsWith("/") ? raw : `/${raw}`) : raw;
+  const data = { qrcode, wechat: String(c.wechat || "") };
+  communityCache = { dir: relayDir, at: Date.now(), data };
+  return data;
+}
+
 // ---------- 一次性访问密钥 / 已授权设备代理（E1 企业端新增 auth-key / mobile-sessions） ----------
 
 /** 从 relay 响应里尽量提取人类可读错误信息（兼容 {error:{message}} / {error:".."} / {message} / 纯文本）。 */
@@ -722,6 +910,57 @@ function notLoggedInJson() {
   return { ok: false, error: "尚未登录：请先在「账号」卡片登录手机号账号（或切换到自建服务）后重试", hint: "login_required" };
 }
 
+/**
+ * 凭证齐全但拿不到 relay token 时的统一返回：区分「密码失效需重新登录」与「中继暂未就绪可重试」。
+ * 关键：不再把中继未就绪/设备密钥缺失谎报成“尚未登录”（旧版 UI 因此显示误导性红字）。
+ */
+function relayAuthFailureJson(reason, detail) {
+  if (reason === AUTH_NO_CREDENTIALS) return { status: 401, body: notLoggedInJson() };
+  if (reason === AUTH_BAD_CREDENTIALS) {
+    return {
+      status: 401,
+      body: {
+        ok: false,
+        error: "本机保存的账号密码已被中继拒绝（可能已在别处修改过密码）：请用新密码重新登录「账号」卡片后重试",
+        hint: "relogin_required",
+        retryable: false,
+        detail: String(detail || ""),
+      },
+    };
+  }
+  const unreachable = reason === AUTH_RELAY_UNREACHABLE;
+  return {
+    status: 503,
+    body: {
+      ok: false,
+      error: unreachable
+        ? "中继服务暂时不可达（网络波动或中继正在重启），请稍后重试"
+        : "账号已登录，但中继连接尚未就绪（正在建立安全通道），请稍后重试",
+      hint: unreachable ? "relay_unreachable" : "relay_not_ready",
+      retryable: true,
+      detail: String(detail || ""),
+    },
+  };
+}
+
+/**
+ * 取 relay token 或直接回错误响应（面板代理统一入口）。
+ * @returns {Promise<string>} token；为空串表示已写出错误响应（调用方直接 return）
+ */
+async function relayTokenOrReject(relayDir, res, cfgOverride) {
+  const a = await relayTokenWithReason(relayDir, cfgOverride).catch((e) => ({
+    token: "",
+    reason: AUTH_RELAY_UNREACHABLE,
+    status: 0,
+    detail: e && e.message,
+  }));
+  if (a.token) return a.token;
+  const { status, body } = relayAuthFailureJson(a.reason, a.detail);
+  console.warn(`[dsh-remote-web] 取 relay token 失败(${a.reason}/${a.status}): ${a.detail || "无详情"}`);
+  sendJson(res, status, body);
+  return "";
+}
+
 /**
  * 透传企业端响应体：契约字段可能在顶层或 data 子对象里（容错）。
  * 返回扁平对象；数组字段只取首层数组。
@@ -737,8 +976,8 @@ function flattenRelayBody(r) {
  * 契约容错：url 必须可用；qr_data_url 取不到时返回 null（UI 只展示链接并说明“二维码暂不可用”，不报错）。
  */
 async function proxyCreateAccessKey(relayDir, res) {
-  const token = await relayToken(relayDir).catch(() => "");
-  if (!token) return sendJson(res, 401, notLoggedInJson());
+  const token = await relayTokenOrReject(relayDir, res);
+  if (!token) return;
   const r = await relayFetch(relayDir, "/api/auth-key", {
     method: "POST",
     headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
@@ -766,8 +1005,8 @@ async function proxyCreateAccessKey(relayDir, res) {
  * GET /dsh-remote/mobile-sessions → 已授权设备列表（企业端 GET /api/mobile-sessions，Bearer）。
  */
 async function proxyMobileSessions(relayDir, res) {
-  const token = await relayToken(relayDir).catch(() => "");
-  if (!token) return sendJson(res, 401, notLoggedInJson());
+  const token = await relayTokenOrReject(relayDir, res);
+  if (!token) return;
   const r = await relayFetch(relayDir, "/api/mobile-sessions", {
     method: "GET",
     headers: { authorization: `Bearer ${token}` },
@@ -788,8 +1027,8 @@ async function proxyRevokeMobileSession(relayDir, req, res) {
   if (body.__parseError) return sendJson(res, 400, { ok: false, error: "JSON 解析失败" });
   const id = String(body.id ?? "").trim();
   if (!id) return sendJson(res, 400, { ok: false, error: "缺少参数 id（会话 ID）" });
-  const token = await relayToken(relayDir).catch(() => "");
-  if (!token) return sendJson(res, 401, notLoggedInJson());
+  const token = await relayTokenOrReject(relayDir, res);
+  if (!token) return;
   const r = await relayFetch(relayDir, `/api/mobile-sessions/${encodeURIComponent(id)}/revoke`, {
     method: "POST",
     headers: { authorization: `Bearer ${token}` },
@@ -812,8 +1051,8 @@ async function proxyDeleteMobileSession(relayDir, req, res) {
   if (body.__parseError) return sendJson(res, 400, { ok: false, error: "JSON 解析失败" });
   const id = String(body.id ?? "").trim();
   if (!id) return sendJson(res, 400, { ok: false, error: "缺少参数 id（会话 ID）" });
-  const token = await relayToken(relayDir).catch(() => "");
-  if (!token) return sendJson(res, 401, notLoggedInJson());
+  const token = await relayTokenOrReject(relayDir, res);
+  if (!token) return;
   const r = await relayFetch(relayDir, `/api/mobile-sessions/${encodeURIComponent(id)}`, {
     method: "DELETE",
     headers: { authorization: `Bearer ${token}` },
@@ -831,8 +1070,8 @@ async function proxyDeleteMobileSession(relayDir, req, res) {
  * （企业端 POST /api/mobile-sessions/purge，Bearer）。
  */
 async function proxyPurgeMobileSessions(relayDir, res) {
-  const token = await relayToken(relayDir).catch(() => "");
-  if (!token) return sendJson(res, 401, notLoggedInJson());
+  const token = await relayTokenOrReject(relayDir, res);
+  if (!token) return;
   const r = await relayFetch(relayDir, "/api/mobile-sessions/purge", {
     method: "POST",
     headers: { authorization: `Bearer ${token}` },
@@ -1030,7 +1269,7 @@ const PLUGIN_ID = "dsh-remote-ui";
 const PLUGIN_LEGACY_IDS = ["dsh-remote-web"];
 const PLUGIN_ALL_IDS = [PLUGIN_ID, ...PLUGIN_LEGACY_IDS];
 /** 插件自身发布版本（与 dsh-remote 根包同步递增）。 */
-const PLUGIN_VERSION = "0.6.0";
+const PLUGIN_VERSION = "0.6.1";
 const UPDATE_LOG = ".dsh-update.log";
 const UPDATE_MARKER = ".dsh-update-running";
 
@@ -1282,6 +1521,14 @@ function registerRoutes(ctx, relayDir) {
         });
       },
     },
+    // 交流群二维码（设置面板「加入交流群」按钮 + 用户反馈页展示；未配置返回空串，UI 不展示入口）
+    {
+      method: "GET",
+      path: "/dsh-remote/community",
+      handler: async (_req, res) => {
+        sendJson(res, 200, { ok: true, ...(await communityInfo(relayDir)) });
+      },
+    },
     // 一次性访问密钥（📱 远程访问卡）：GET 即创建新 key，企业端 POST /api/auth-key（Bearer）
     {
       method: "GET",
@@ -1352,6 +1599,14 @@ function registerRoutes(ctx, relayDir) {
           }
           // SaaS 权威归一化：清除自建残留(local_key/假 tunnel_url)，api/tunnel 一律按云端重算
           applySaaSMode(cfg);
+          // device-login 共享密钥自愈：只装插件的路径没有安装器那一步，缺密钥会导致
+          // 「首次安装后立即登录」时面板拿不到二维码/设备列表（旧版要等后台自愈或手动刷新）。
+          // 这里在启动 bridge 之前补齐，bridge 首次启动即可带上密钥。
+          if (!cfg.bridge_secret) {
+            // 3s 上限：这次取密钥在登录响应路径上，宁可先放行（后续请求还会自愈）也不拖慢登录
+            const secret = await bridgeSecretOf(relayDir, cfg, { timeoutMs: 3000 });
+            if (secret) cfg.bridge_secret = secret;
+          }
         }
         saveConfig(relayDir, cfg);
         const bridgeRestart = startBridge(relayDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-ui",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "【兼容别名包】dsh-remote 旧名 dsh-remote-ui 的别名，功能与 dsh-remote-web 完全一致（同一份代码同步生成）。 Legacy alias of dsh-remote-web — identical build, kept installable while the renamed entry is pending review. 公网远程控制 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",