@mrrisega/dsh-remote 0.6.1-beta.1 → 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.1-beta.1",
+  "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",

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,7 +350,25 @@ window.__ModuleLoader__.load({
       return api(path, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(data || {}) });
     };
 
-    // ── 登录后首次加载的自愈（0.6.1-beta.1） ───────────────────────────────
+    // ── 交流群（运营二维码;管理后台统一上传,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 共享密钥
     // 刚补齐或正在轮换、中继冷启动/网络抖动），旧版只报一次红字且不重试——必须手动刷新页面才行。
@@ -478,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 }); }
 
@@ -485,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);
@@ -724,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
       );
     }
 
@@ -1135,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");
@@ -1175,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");
@@ -2117,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),
@@ -2125,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" }, "📱"),
@@ -2135,7 +2215,8 @@ window.__ModuleLoader__.load({
         ),
         h("div", { className: "dru-settings-body" },
           view === "feedback" ? renderFeedback() : view === "invite" ? renderInvite() : renderHome()
-        )
+        ),
+        renderCommunityModal()
       );
     }
 

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

@@ -859,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} / 纯文本）。 */
@@ -1240,7 +1269,7 @@ const PLUGIN_ID = "dsh-remote-web";
 const PLUGIN_LEGACY_IDS = ["dsh-remote-ui"];
 const PLUGIN_ALL_IDS = [PLUGIN_ID, ...PLUGIN_LEGACY_IDS];
 /** 插件自身发布版本（与 dsh-remote 根包同步递增）。 */
-const PLUGIN_VERSION = "0.6.1-beta.1";
+const PLUGIN_VERSION = "0.6.1";
 const UPDATE_LOG = ".dsh-update.log";
 const UPDATE_MARKER = ".dsh-update-running";
 
@@ -1492,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",

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

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

package/packages/dsh-remote-web/test/community-qr-ui.test.mjs

@@ -0,0 +1,287 @@
+// 交流群二维码（运营配置）在插件侧的两处展示回归：
+//   ① 设置面板：「💬 加入交流群」按钮 → 点击弹出二维码大图（未配置后台码 → 按钮不存在）；
+//   ② 用户反馈页：底部直接展示企微交流群二维码 + 文案。
+// 数据来源：node 半 GET /dsh-remote/community（读公开配置 community.qrcode 并拼绝对地址）。
+// 采用真实 useEffect（依赖比较 + 提交后执行），与 login-selfheal-ui.test.mjs 同一套 vm 挂载方式。
+import assert from "node:assert/strict";
+import http from "node:http";
+import { readFileSync } from "node:fs";
+import { mkdtemp, rm, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import test from "node:test";
+import vm from "node:vm";
+import { apply } from "../lib/index.js";
+
+const SOURCE = readFileSync(new URL("../lib/client.js", import.meta.url), "utf8");
+const QR_PATH = "/qr/group-qr.png";
+const API_URL = "https://relay.test/relay-api";
+const QR_ABS = API_URL + QR_PATH;
+
+function walk(node, visit) {
+  if (node == null) return;
+  if (Array.isArray(node)) { for (const item of node) walk(item, visit); return; }
+  if (typeof node !== "object") return;
+  visit(node);
+  for (const child of node.children || []) walk(child, visit);
+}
+function find(tree, predicate) {
+  let match;
+  walk(tree, (node) => { if (!match && predicate(node)) match = node; });
+  return match;
+}
+function textHas(tree, substr) {
+  return !!find(tree, (node) => (node.children || []).some((c) => typeof c === "string" && c.includes(substr)));
+}
+function nodeWithText(tree, substr) {
+  return find(tree, (node) => typeof node.props?.onClick === "function" && (node.children || []).some((c) => typeof c === "string" && c.includes(substr)));
+}
+const flush = () => new Promise((resolve) => setImmediate(resolve));
+
+/**
+ * 迷你 React（真实 useEffect）+ 假定时器；fetch 覆盖 /dsh-remote/* 面板接口。
+ * @param {object} opts - community：/dsh-remote/community 的返回值（默认已配置二维码）
+ */
+function loadPlugin(opts = {}) {
+  let moduleFactory;
+  const registered = new Map();
+  const injects = new Map();
+  const requests = [];
+
+  let clock = 0;
+  let timerSeq = 1;
+  const timers = new Map();
+  const job = (fn) => { try { fn(); } catch (e) { /* 断言会暴露问题 */ } };
+  const fakeSetTimeout = (fn, ms) => { const id = timerSeq++; timers.set(id, { at: clock + (Number(ms) || 0), fn, every: 0 }); return id; };
+  const fakeSetInterval = (fn, ms) => { const id = timerSeq++; const every = Math.max(1, Number(ms) || 1); timers.set(id, { at: clock + every, fn, every }); return id; };
+  const fakeClear = (id) => { timers.delete(id); };
+
+  // ── 迷你 React：真实 useState/useEffect + 递归渲染函数组件(FeedbackCard 等嵌套组件) ──
+  // 每个组件实例按「树中位置路径」持有自己的 hook 槽位(近似 React 的位置化协调),故子组件状态
+  // 可跨渲染保持;effects 在对应子树展开后执行(cleanup 语义与 React 一致)。
+  const scopes = new Map(); // key -> { hook, effectCursor, slots, pending }
+  const scopeStack = [];
+  const currentScope = () => scopeStack[scopeStack.length - 1];
+
+  const react = {
+    createElement(type, props, ...children) { return { type, props: props || {}, children }; },
+    useState(initial) {
+      const sc = currentScope();
+      const index = sc.hook++;
+      if (!(index in sc.state)) sc.state[index] = typeof initial === "function" ? initial() : initial;
+      return [sc.state[index], (value) => { sc.state[index] = typeof value === "function" ? value(sc.state[index]) : value; }];
+    },
+    useEffect(fn, deps) {
+      const sc = currentScope();
+      const index = sc.effectCursor++;
+      const prev = sc.effects[index];
+      const changed = !prev || !deps || deps.length !== prev.deps.length || deps.some((d, i) => !Object.is(d, prev.deps[i]));
+      if (changed) sc.pending.push({ index, fn, deps: deps ? [...deps] : deps });
+    },
+    useCallback(fn) { return fn; },
+    useSyncExternalStore(_subscribe, getSnapshot) { return getSnapshot(); },
+  };
+
+  /** 渲染一棵树:函数组件递归展开(含 effects),普通节点保留并递归子节点。 */
+  function renderNode(node, path) {
+    if (node == null) return node;
+    if (Array.isArray(node)) return node.map((n, i) => renderNode(n, path + "/" + i));
+    if (typeof node !== "object") return node;
+    if (typeof node.type === "function") {
+      const name = node.type.name || "anon";
+      const key = path + ":" + name;
+      const sc = scopes.get(key) || { hook: 0, effectCursor: 0, state: [], effects: [], pending: [] };
+      sc.hook = 0; sc.effectCursor = 0; sc.pending = [];
+      scopes.set(key, sc);
+      scopeStack.push(sc);
+      let out;
+      try {
+        out = node.type(node.props || {});
+      } finally {
+        scopeStack.pop();
+      }
+      const expanded = renderNode(out, key);
+      const todos = sc.pending;
+      sc.pending = [];
+      for (const t of todos) {
+        const prev = sc.effects[t.index];
+        if (prev && typeof prev.cleanup === "function") job(prev.cleanup);
+        const cleanup = t.fn();
+        sc.effects[t.index] = { deps: t.deps, cleanup: typeof cleanup === "function" ? cleanup : null };
+      }
+      return expanded;
+    }
+    return { ...node, children: (node.children || []).map((c, i) => renderNode(c, path + "/" + i)) };
+  }
+
+  const community = opts.community !== undefined ? opts.community : { ok: true, qrcode: QR_ABS, wechat: "dsh-remote-support" };
+  const status = opts.status || {
+    ok: true,
+    config: { phone: "138****0000", hasPhone: true, mode: "saas", deviceId: "dev-x" },
+    service: { running: true },
+    remoteUrl: "https://relay.test/app/",
+  };
+  const response = (s, body) => Promise.resolve({ ok: s >= 200 && s < 300, status: s, text: async () => JSON.stringify(body) });
+
+  const makeEl = () => ({
+    tag: "div", children: [], style: {}, className: "", attributes: {}, textContent: "",
+    setAttribute(k, v) { this.attributes[k] = v; },
+    getAttribute(k) { return this.attributes[k] ?? null; },
+    appendChild(c) { this.children.push(c); },
+    addEventListener() {}, removeEventListener() {},
+  });
+  const doc = {
+    hidden: false,
+    createElement: makeEl,
+    head: makeEl(),
+    body: makeEl(),
+    querySelector() { return null; },
+    querySelectorAll() { return []; },
+    getElementById() { return null; },
+    addEventListener() {}, removeEventListener() {},
+  };
+  class MutationObserverMock { constructor() {} observe() {} disconnect() {} }
+  const localStorage = {
+    _s: new Map(),
+    getItem(k) { return this._s.has(k) ? this._s.get(k) : null; },
+    setItem(k, v) { this._s.set(k, String(v)); },
+    removeItem(k) { this._s.delete(k); },
+  };
+
+  const sandbox = {
+    window: { __ModuleLoader__: { load(spec) { moduleFactory = spec.factory; } }, open() { return null; } },
+    document: doc,
+    localStorage,
+    MutationObserver: MutationObserverMock,
+    navigator: { clipboard: { writeText: async () => {} } },
+    setTimeout: fakeSetTimeout,
+    clearTimeout: fakeClear,
+    setInterval: fakeSetInterval,
+    clearInterval: fakeClear,
+    fetch(path, options = {}) {
+      requests.push({ path, method: options.method || "GET" });
+      if (path === "/dsh-remote/status") return response(200, status);
+      if (path === "/dsh-remote/community") return response(200, community);
+      return response(200, { ok: true });
+    },
+    Set, Symbol, Date, JSON, Math, Number, String, Object, Array, console,
+  };
+
+  vm.runInNewContext(SOURCE, sandbox);
+  const plugin = moduleFactory((name) => {
+    assert.equal(name, "react");
+    return react;
+  });
+  plugin.apply({
+    slots: {
+      inject(name, cb) { injects.set(name, cb); cb(); },
+      register(meta, component) { registered.set(meta.id, component); return () => {}; },
+    },
+  });
+
+  return {
+    requests,
+    /** 渲染 → 让在途请求落地 → 再渲染（返回最新树）。 */
+    async settle(times = 2) {
+      let tree = null;
+      for (let i = 0; i < times; i++) { tree = this.render(); await flush(); await flush(); }
+      return this.render();
+    },
+    render() {
+      const root = { type: registered.get("dsh-remote"), props: { close() {} }, children: [] };
+      return renderNode(root, "root");
+    },
+  };
+}
+
+test("node 半 /dsh-remote/community：读公开配置 community.qrcode 并拼成企业端绝对地址", async () => {
+  const tempDir = await mkdtemp(path.join(os.tmpdir(), "dsh-community-"));
+  const relay = http.createServer((req, res) => {
+    const send = (code, obj) => { res.writeHead(code, { "content-type": "application/json" }); res.end(JSON.stringify(obj)); };
+    if (req.url.startsWith("/api/public-config")) {
+      return send(200, {
+        service: "dsh-remote",
+        app_url: "https://relay.test/app/",
+        api_url: API_URL,
+        community: { qrcode: QR_PATH, wechat: "dsh-remote-support" },
+      });
+    }
+    send(404, { error: { code: "not_found" } });
+  });
+  await new Promise((r) => relay.listen(0, "127.0.0.1", r));
+  const port = relay.address().port;
+  await writeFile(path.join(tempDir, ".dsh-config.json"), JSON.stringify({
+    phone: "13800000000", password: "pw", api_url: `http://127.0.0.1:${port}`, bridge_secret: "s",
+  }));
+  const routes = new Map();
+  apply({ webServer: { register(rt) { routes.set(rt.path, rt.handler); return () => {}; } }, effect(reg) { return reg(); }, logger: { info() {}, warn() {} } }, { relayDir: tempDir });
+  const host = http.createServer((req, res) => {
+    const url = new URL(req.url, "http://x");
+    const h = routes.get(url.pathname);
+    (h || ((_r, rs) => { rs.writeHead(404); rs.end(); }))(req, res);
+  });
+  await new Promise((r) => host.listen(0, "127.0.0.1", r));
+  try {
+    const base = `http://127.0.0.1:${host.address().port}`;
+    const r = await (await fetch(`${base}/dsh-remote/community`)).json();
+    assert.equal(r.ok, true);
+    // 相对路径按「api_url + 路径」拼绝对地址(与手机端 PWA 的 API_BASE + qr 同一约定)
+    assert.equal(r.qrcode, `http://127.0.0.1:${port}${QR_PATH}`);
+    assert.equal(r.wechat, "dsh-remote-support");
+  } finally {
+    host.close();
+    relay.close();
+    await rm(tempDir, { recursive: true, force: true });
+  }
+});
+
+test("设置面板:后台已配置 → 「加入交流群」按钮出现;点击弹出二维码大图;关闭后收起", async () => {
+  const plugin = loadPlugin();
+  let tree = await plugin.settle();
+  assert.ok(plugin.requests.some((r) => r.path === "/dsh-remote/community"), "面板应拉取交流群配置");
+
+  const btn = nodeWithText(tree, "加入交流群");
+  assert.ok(btn, "应出现「💬 加入交流群」按钮");
+  assert.ok(!find(tree, (n) => n.props?.className === "dru-community-qr"), "未点击时不应有弹窗");
+
+  btn.props.onClick();
+  tree = plugin.render();
+  assert.ok(find(tree, (n) => n.props?.className === "dru-community-qr"), "点击后应弹出二维码");
+  const img = find(tree, (n) => n.props?.className === "dru-community-qr");
+  assert.equal(img.props.src, QR_ABS, "二维码用 node 半下发的绝对地址");
+  assert.equal(img.props.alt, "企微交流群二维码");
+  assert.ok(textHas(tree, "加入企微交流群"), "弹窗应有标题");
+  assert.ok(textHas(tree, "扫码入群"), "弹窗应有入群说明");
+
+  // 关闭:点「关闭」→ 弹窗消失
+  const closeBtn = nodeWithText(tree, "关闭");
+  assert.ok(closeBtn, "弹窗应有「关闭」按钮");
+  closeBtn.props.onClick();
+  tree = plugin.render();
+  assert.ok(!find(tree, (n) => n.props?.className === "dru-community-qr"), "关闭后弹窗应消失");
+});
+
+test("设置面板:后台未配置二维码 → 不展示任何入口（不留空壳按钮）", async () => {
+  const plugin = loadPlugin({ community: { ok: true, qrcode: "", wechat: "" } });
+  const tree = await plugin.settle();
+  assert.ok(plugin.requests.some((r) => r.path === "/dsh-remote/community"), "仍应尝试拉取");
+  assert.ok(!nodeWithText(tree, "加入交流群"), "未配置时不展示按钮");
+  assert.ok(!find(tree, (n) => n.props?.className === "dru-community-qr"), "未配置时不展示二维码");
+});
+
+test("用户反馈页:底部展示企微交流群二维码（含客服微信兜底文案）", async () => {
+  const plugin = loadPlugin();
+  await plugin.settle();
+  // 进入「用户反馈」视图
+  let tree = plugin.render();
+  const entry = nodeWithText(tree, "用户反馈");
+  assert.ok(entry, "应有「用户反馈」入口");
+  entry.props.onClick();
+  tree = await plugin.settle();
+
+  assert.ok(textHas(tree, "加入企微交流群"), "反馈页应展示交流群标题");
+  const img = find(tree, (n) => n.props?.className === "dru-community-qr");
+  assert.ok(img, "反馈页应展示二维码图片");
+  assert.equal(img.props.src, QR_ABS);
+  assert.ok(textHas(tree, "dsh-remote-support"), "应展示客服微信兜底文案");
+});