dsh-remote-ui 0.6.0 → 0.6.2

package/lib/client.js

@@ -91,6 +91,13 @@ window.__ModuleLoader__.load({
       ".dru-msg-err{color:#cf222e}",
       ".dru-msg-warn{color:#9a6700}",
       ".dru-hint{font-size:12px;color:#57606a;line-height:1.6}",
+      // ── 重启 DeepSeek harness（首次安装/更新后置顶提醒 + 底部常驻按钮） ──
+      ".dru-restart-alert{display:flex;gap:10px;align-items:flex-start;background:#fff8c5;border:1px solid #d4a72c;border-radius:10px;padding:12px 14px;margin-bottom:12px}",
+      ".dru-restart-alert-icon{font-size:18px;line-height:1.2}",
+      ".dru-restart-alert-title{font-size:13px;font-weight:700;color:#7d4e00}",
+      ".dru-restart-alert-sub{font-size:12px;color:#6b5900;margin-top:4px;line-height:1.6}",
+      ".dru-restart-foot{margin-top:14px;padding-top:12px;border-top:1px solid #eaeef2;display:flex;gap:10px;align-items:center;flex-wrap:wrap}",
+      ".dru-restart-foot .dru-hint{flex:1;min-width:180px;margin:0}",
       // ── 用户反馈模块 ──
       ".dru-fb-tabs{display:flex;gap:8px;margin-bottom:10px}",
       ".dru-fb-tab{flex:1;padding:6px 0;text-align:center;border-radius:8px;cursor:pointer;font-size:12.5px;font-weight:600;color:#57606a;background:#eaeef2;border:1px solid #d0d7de;user-select:none}",
@@ -134,6 +141,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 +357,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 +506,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 +515,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 +760,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 +1179,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 +1209,21 @@ window.__ModuleLoader__.load({
 
       var loggedIn = !!(st && st.config && (st.config.phone || st.config.hasLocalKey));
       var serviceRunning = !!(st && st.service && st.service.running);
+      // 0.6.2：运行环境是否就绪 + launchd 是否处于崩溃循环（入口脚本缺失导致的 KeepAlive 重拉）。
+      // 旧版把「作业在 launchd 里但进程秒退」显示成「运行中」，用户完全看不出问题在哪。
+      var serviceRuntimeReady = !(st && st.service && st.service.runtimeReady === false);
+      var serviceLaunchd = (st && st.service && st.service.launchd) || {};
+      var serviceCrashing = !!serviceLaunchd.crashing;
+      var serviceStateText = !st ? "查询中…"
+        : serviceRunning ? "运行中"
+        : serviceCrashing ? "启动失败（已自动转入修复）"
+        : !serviceRuntimeReady ? "运行环境安装中…"
+        : "已停止";
+      // 是否需要重启 DeepSeek harness（首次安装/在线更新后置顶提醒 + 底部常驻按钮）
+      var restartInfo = (st && st.restart) || {};
+      var restartPending = !!restartInfo.pending;
+      // 账号标识（掩码手机号）：登录成功/换账号时变化 → 触发上方的重取 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 +1235,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 +1289,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 +1323,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 +1350,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 +1514,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 }); }
 
@@ -1561,6 +1738,39 @@ window.__ModuleLoader__.load({
           .finally(function () { setBusy(""); });
       };
 
+      /**
+       * 重启 DeepSeek harness：插件本体与浏览器半在进程启动时装载，首次安装/在线更新后
+       * 必须重启才生效。重启会短暂断开本页面 —— 这里轮询等它回来，然后自动刷新。
+       */
+      var restartHarness = function () {
+        setBusy("restart");
+        post("/dsh-remote/harness/restart")
+          .then(function (body) {
+            setSt(body);
+            setMsg("ok", "🔄 正在重启 DeepSeek harness" + (body && body.mode ? "（" + body.mode + "）" : "") +
+              "…约 2~10 秒，页面会自动刷新，无需手动操作。");
+            waitHarnessBack(0, false);
+          })
+          .catch(function (e) {
+            setMsg("err", "重启失败: " + e.message + " —— 请手动重启 DeepSeek harness（退出 dsh web 后重新启动）。");
+            setBusy("");
+          });
+      };
+
+      /** 轮询等待 harness 回来；观察到「断过又恢复」或等待足够久后自动刷新页面。 */
+      var waitHarnessBack = function (tries, sawDown) {
+        if (tries > 40) { setMsg("err", "重启后仍未就绪，请手动刷新页面或重启 DeepSeek harness。"); setBusy(""); return; }
+        setTimeout(function () {
+          fetch("/dsh-remote/status", { cache: "no-store" })
+            .then(function (r) { if (!r.ok) throw new Error("HTTP " + r.status); return r.json(); })
+            .then(function () {
+              if (sawDown || tries >= 8) { location.reload(); return; }
+              waitHarnessBack(tries + 1, sawDown);
+            })
+            .catch(function () { waitHarnessBack(tries + 1, true); });
+        }, 1500);
+      };
+
       var saveLocal = function () {
         if (!selfHost.trim() || !localKey.trim()) { setMsg("err", "请填写服务器地址与访问密钥"); return; }
         setBusy("local");
@@ -1760,7 +1970,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 +2099,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
         ]);
       }
 
@@ -1970,7 +2192,7 @@ window.__ModuleLoader__.load({
           card("🖥 Bridge 服务",
             h("div", { className: "dru-status-line" },
               h("span", { className: "dru-dot " + (serviceRunning ? "dru-dot-on" : "dru-dot-off") }),
-              h("span", null, st ? (serviceRunning ? "运行中" : "已停止") : "查询中…"),
+              h("span", null, st ? serviceStateText : "查询中…"),
               launchdPid ? h("span", { className: "dru-meta", style: { marginTop: 0 } }, "(pid=" + launchdPid + ")") : null
             ),
             h("div", { className: "dru-actions", style: { marginTop: 10 } },
@@ -1980,6 +2202,14 @@ window.__ModuleLoader__.load({
             ),
             h("div", { className: "dru-meta" }, st && st.config && st.config.deviceId ? "设备 ID：" + st.config.deviceId : "设备 ID：生成中"),
             h("div", { className: "dru-meta" }, st ? (st.service && st.service.plistExists ? "自启动服务已安装" : "自启动服务未安装（启动时自动创建）") : ""),
+            // 0.6.2：把「运行环境缺失 / launchd 崩溃循环」如实告诉用户，而不是显示「运行中」
+            st && !serviceRuntimeReady
+              ? h("div", { className: "dru-hint", style: { marginTop: 8 } },
+                  "🛠 插件市场只装「面板插件」，桌面运行环境（bridge）需要额外补装——已自动在后台安装，装完会自动启动 bridge，不用做任何操作。若超过几分钟仍未变成「运行中」，点上方版本卡的「一键更新」手动补全。")
+              : serviceCrashing
+                ? h("div", { className: "dru-hint", style: { marginTop: 8 } },
+                    "⚠️ 上一次启动失败（自启动入口失效），已自动清理失效自启动项并重新补装运行环境。稍候会自动恢复；仍失败请点「一键更新」。")
+                : null,
             st && st.service && st.service.bindError
               ? h("div", { className: "dru-msg dru-msg-err", style: { marginTop: 8 } },
                   "⚠️ 设备注册失败：" + (st.service.bindError.message || "未说明原因"),
@@ -1995,7 +2225,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 +2243,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" }, "📱"),
@@ -2012,8 +2275,38 @@ window.__ModuleLoader__.load({
           )
         ),
         h("div", { className: "dru-settings-body" },
+          restartPending
+            ? h("div", { className: "dru-restart-alert", role: "status" },
+                h("span", { className: "dru-restart-alert-icon" }, "🔔"),
+                h("div", { style: { flex: "1" } },
+                  h("div", { className: "dru-restart-alert-title" },
+                    restartInfo.kind === "update" ? "在线更新已完成，需要重启 DeepSeek harness" : "首次安装需要重启 DeepSeek harness"),
+                  h("div", { className: "dru-restart-alert-sub" },
+                    "插件本体与「远程访问」面板是在 DeepSeek harness 启动时装载的，重启之后即可正常使用（账号、二维码、bridge 全部生效）。"),
+                  h("div", { className: "dru-actions", style: { marginTop: 10 } },
+                    h("button", {
+                      type: "button",
+                      className: "dru-btn dru-btn-primary",
+                      disabled: busy !== "",
+                      onClick: function () { restartHarness(); }
+                    }, busy === "restart" ? "重启中…" : "重启 DeepSeek harness")
+                  )
+                )
+              )
+            : null,
           view === "feedback" ? renderFeedback() : view === "invite" ? renderInvite() : renderHome()
-        )
+        ),
+        // 常驻入口最底部：「重启 DeepSeek harness」按钮始终可达（首次安装/更新/排查都用它）
+        h("div", { className: "dru-restart-foot" },
+          h("div", { className: "dru-hint" }, "重启 DeepSeek harness：插件与面板在 harness 启动时装载，首次安装或在线更新后重启即可生效；仅重启 dsh web，不影响 bridge 与手机端连接。"),
+          h("button", {
+            type: "button",
+            className: "dru-btn " + (restartPending ? "dru-btn-primary" : "dru-btn-ghost"),
+            disabled: busy !== "",
+            onClick: function () { restartHarness(); }
+          }, busy === "restart" ? "重启中…" : "🔄 重启 DeepSeek harness")
+        ),
+        renderCommunityModal()
       );
     }