@mrrisega/dsh-remote 0.6.0 → 0.6.1

package/README.md

@@ -28,7 +28,12 @@ dsh-remote 是一个轻量的**隧道模式**远程控制方案：电脑端运
                            └→ bridge (电脑端) → 127.0.0.1:3080 (dsh web)
 ```
 
-## 0.6.0 速览（用户最关心的新能力）
+## 0.6.1 速览（用户最关心的新能力）
+
+- **首次安装体验修复**：装完插件立即登录，二维码与已授权设备列表不再报「尚未登录」红字；中继未就绪时面板自动退避重试，不用再手动刷新页面。
+- **企微交流群**：README 底部扫码入群；服务端可在管理后台「推广」页上传交流群二维码，官网、付费页底部、设置面板「加入交流群」按钮与用户反馈页会同步展示。
+
+**0.6.0 起已有**
 
 - **扫码即加密，不再要求再输一次密码**：用电脑生成的二维码/一次性链接进入后，由电脑自动授权开启端到端加密；密码登录点设备也自动解锁。全程不输 E2EE 密码、不存服务端。
 - **记住本机：刷新/重开不掉回明文**：解锁一次后，手机 App 刷新、镜像页刷新都自动恢复加密（退出登录即清除；浏览器无痕可不用此功能）。
@@ -151,6 +156,14 @@ npx @mrrisega/dsh-remote setup --server wss://<你的域名>:端口 --key <访
 
 测试：`npm test`（router 契约 + 插件 + bridge 全部单测与回归）。
 
+## 企微交流群
+
+扫码加入 **企微交流群**：安装/使用答疑、问题反馈、版本更新都会在群里同步，欢迎来聊。
+
+<img src="image/企微交流群.jpg" alt="企微交流群" width="240">
+
+> 也可以在仓库提 [Issue](https://github.com/mrRisega/dsh-remote/issues)；安全相关问题请按 [SECURITY.md](SECURITY.md) 私下反馈。
+
 ## 文档
 
 - [docs/self-hosting.md](docs/self-hosting.md) — 开源自建完整指南（含安全提示）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.6.0",
+  "version": "0.6.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",
@@ -52,7 +52,9 @@
     "test:router": "node --test packages/relay-router/test/native-device-selection.test.mjs packages/relay-router/test/quotas.test.mjs",
     "test:plugin": "node --test --test-concurrency=1 packages/dsh-remote-web/test/*.test.mjs",
     "test:bridge": "node --test clients/dsh-remote/test/*.test.mjs",
-    "check": "node --check clients/dsh-remote/dsh-bridge.mjs && node --check clients/dsh-remote/e2ee-shim.mjs && node --check dsh-setup.mjs && node --check packages/dsh-remote-web/lib/index.js && node --check packages/dsh-remote-web/lib/client.js && bash -n deploy/install-open.sh"
+    "check": "node --check clients/dsh-remote/dsh-bridge.mjs && node --check clients/dsh-remote/e2ee-shim.mjs && node --check dsh-setup.mjs && node --check packages/dsh-remote-web/lib/index.js && node --check packages/dsh-remote-web/lib/client.js && bash -n deploy/install-open.sh && npm run check:alias",
+    "sync:alias": "node scripts/sync-legacy-alias.mjs",
+    "check:alias": "node scripts/sync-legacy-alias.mjs --check"
   },
   "dependencies": {
     "ws": "^8.18.0"

package/packages/dsh-remote-web/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()
       );
     }