@mrrisega/dsh-remote 0.7.6-beta.1 → 0.7.6-beta.3

package/dsh-setup.mjs

@@ -2583,6 +2583,45 @@ function missingPluginFiles(dir) {
  *
  * 另外清掉上次被强杀留下的 `.staging-*` / `.backup-*`，不留垃圾。
  */
+// ── 桌面端「暫存安装」：应用运行中不能改写它的 profile（会把它弄退出/重启），
+// 但用户点「一键更新」必须能装到桌面端。做法：先整份拷到 ~/.dsh-remote/pending-plugin/ 并写 marker，
+// 由常驻的 bridge 在检测到应用退出后自动原子替换 profile 内的插件目录（见 dsh-bridge.mjs）。
+const PENDING_PLUGIN_MARKER = path.join(CONFIG_DIR, ".plugin-update-pending.json");
+const PENDING_PLUGIN_DIR = path.join(CONFIG_DIR, "pending-plugin");
+
+/** 暂存一份插件更新（供 bridge 在应用退出后安装）。返回 marker 对象。 */
+function stagePluginUpdateForProfile(profileDir, pluginDir) {
+  fs.rmSync(PENDING_PLUGIN_DIR, { recursive: true, force: true });
+  fs.mkdirSync(PENDING_PLUGIN_DIR, { recursive: true });
+  const cpOpts = {
+    recursive: true,
+    filter: (src) => {
+      if (src === pluginDir) return true;
+      const rel = String(path.relative(pluginDir, src));
+      const segs = rel.split(path.sep);
+      if (segs.some((seg) => seg === ".git" || seg === ".DS_Store")) return false;
+      const inBundledRuntime = segs[0] === "runtime";
+      if (!inBundledRuntime && segs.some((seg) => seg === "node_modules")) return false;
+      return true;
+    }
+  };
+  fs.cpSync(pluginDir, PENDING_PLUGIN_DIR, cpOpts);
+  for (const rel of PLUGIN_REQUIRED_FILES) {
+    const f = path.join(PENDING_PLUGIN_DIR, rel);
+    if (!fs.existsSync(f)) throw new Error(`暂存校验失败：缺少 ${rel}`);
+  }
+  const version = JSON.parse(fs.readFileSync(path.join(pluginDir, "package.json"), "utf8")).version;
+  const marker = {
+    version,
+    profileDir,
+    pluginDirName: PLUGIN_LOCAL_DIR,
+    stageDir: PENDING_PLUGIN_DIR,
+    stagedAt: Date.now()
+  };
+  fs.writeFileSync(PENDING_PLUGIN_MARKER, JSON.stringify(marker, null, 2) + "\n");
+  return marker;
+}
+
 function copyPluginIntoProfile(profileDir, pluginDir) {
   // 清理历史名残留目录（≤0.4.9 的 dsh-remote-ui-plugin），避免与新版并存
   for (const id of PLUGIN_LEGACY_IDS) {
@@ -3031,16 +3070,21 @@ async function pluginCmd(argv) {
   let last = null;
   let ok = 0;
   let skippedRunning = 0;
+  let stagedRunning = 0;
   const force = hasFlag(argv, "--force");
   for (const t of targets) {
     // ⚠️ 桌面应用在运行时**绝不改写它的 profile**：应用会因此退出/重启（2026-10-11 实测故障）
     if (t.name === "desktop" && !force && dshDesktopAppRunning()) {
-      console.log(`⚠️ 跳过 desktop：DeepSeek Harness 应用正在运行。`);
-      console.log(`   应用独占该 profile，运行中改写会让应用自己退出/重启。请任选其一：`);
-      console.log(`     · 完全退出应用后重跑本命令；或`);
-      console.log(`     · 在应用内「插件」页安装/更新 dsh-remote-web（官方路径，装完即热加载）。`);
-      console.log(`   （确实要强行写入：加 --force）`);
-      skippedRunning += 1;
+      console.log(`⚠️ DeepSeek Harness 应用正在运行 → 不直接改写它的 profile（会把它弄退出/重启）。`);
+      try {
+        const staged = stagePluginUpdateForProfile(t.dir, path.join(THIS_DIR, "packages", PLUGIN_ID));
+        stagedRunning += 1;
+        console.log(`   ✅ 新版本 ${staged.version} 已暂存：**退出 DeepSeek Harness 后会自动安装**，重新打开应用即生效（无需终端）。`);
+      } catch (e) {
+        console.log(`   ⚠️ 暂存失败：${e && e.message ? e.message : e}`);
+        console.log(`   请完全退出应用后重跑本命令，或在应用内「插件」页安装/更新 dsh-remote-web。`);
+        skippedRunning += 1;
+      }
       continue;
     }
     if (multi) console.log(`\n── profile: ${t.name}（${t.dir}）`);
@@ -3050,6 +3094,7 @@ async function pluginCmd(argv) {
     if (r !== undefined && r !== null) last = r;
   }
   if (ok === 0 && skippedRunning === 0) process.exit(1);
+  if (stagedRunning > 0) console.log(`ℹ 桌面端插件已暂存（${stagedRunning} 个）：退出 DeepSeek Harness 后由后台服务自动安装，重开应用生效。`);
   if (skippedRunning > 0) console.log(`ℹ 本次跳过了 ${skippedRunning} 个 profile（应用在运行）；桥与运行环境不受影响。`);
   return last;
 }

package/package.json

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

@@ -2739,6 +2739,70 @@ window.__ModuleLoader__.load({
       return { kind: "off", text: text };
     }
 
+    // ══ 🎉 加入用户交流群引导（实际使用满 2 小时后弹一次；2026-10-23 业主需求）═════
+    //
+    // 与手机 Web 端共用同一套企业端接口；桌面端浏览器半没有企业端用户 token 直连，
+    // 由 node 半 `/dsh-remote/community-invite/*` 用 device-login token 代调（见 lib/index.js 同名注释）。
+    //   GET  /dsh-remote/community-invite/status → { ok, show, reason, used_seconds, required_seconds, qr_url }
+    //   POST /dsh-remote/community-invite/shown  → { ok:true }（幂等）
+    //
+    // 纪律（与手机端保持同一套，别改松）：
+    // ① **弹不弹完全由服务端 show 决定**：时长口径（relay_sessions 累计 ≥ required_seconds）只在服务端算，
+    //    前端一个字节都不自己算；show 非严格 true 一律不弹（fail closed）。
+    // ② **每桌面会话一次**：sessionStorage + 内存双标记；服务端 already_shown（show:false）是第二道保险。
+    // ③ **「看过即算」**：弹层一显示就 POST shown（幂等）——用户直接关页面/不点按钮也不会被反复骚扰；
+    //    两个按钮关闭时**再调一次**同样幂等。
+    // ④ **一切失败静默**：不弹、不报错、不阻塞面板主流程（连日志都不往用户面前抛）。
+    // ⑤ 二维码降级：qr_url 为空 / 图片加载失败 → 隐藏图片但**保留文案与按钮**（绝不弹空白二维码区）。
+    var CI_SEEN_KEY = "dsh-remote-community-invite-seen-v1";
+    var ciSeenInMemory = false;   // sessionStorage 不可用（隐私模式）时的兜底：每桌面会话仍只弹一次
+    var ciReported = false;       // 已上报 shown 的本地标记（幂等；失败允许关闭时再补一次）
+    /** 本桌面会话内是否已弹过（内存 + sessionStorage 双标记）。 */
+    function ciSeen() {
+      if (ciSeenInMemory) return true;
+      try { return sessionStorage.getItem(CI_SEEN_KEY) === "1"; } catch (e) { return false; }
+    }
+    function ciMarkSeen() {
+      ciSeenInMemory = true;
+      try { sessionStorage.setItem(CI_SEEN_KEY, "1"); } catch (e) { /* 隐私模式忽略 */ }
+    }
+    /** 二维码 URL 安全化：只接受 http(s) 绝对地址或站内绝对路径；data:/javascript: 一律不加载。 */
+    function ciSafeQrUrl(raw) {
+      var s = String(raw || "").trim();
+      if (!s) return "";
+      if (/^https?:\/\//i.test(s)) return s;
+      if (s.charAt(0) === "/" && s.charAt(1) !== "/") {
+        var origin = (typeof location !== "undefined" && location && location.origin) || "";
+        return origin + s;
+      }
+      return "";
+    }
+    /** POST /dsh-remote/community-invite/shown（幂等）。失败静默，并允许关闭时再补一次。 */
+    function ciReportShown() {
+      if (ciReported) return;
+      ciReported = true;
+      api("/dsh-remote/community-invite/shown", { method: "POST", headers: { "content-type": "application/json" }, body: "{}" })
+        .then(function (b) { if (!b || b.ok === false) ciReported = false; })
+        .catch(function () { ciReported = false; /* 网络失败：关闭时再试一次即可 */ });
+    }
+    /**
+     * 问服务端要不要弹。`alive` 由 effect 的 cleanup 控制：面板卸载后回来的响应直接丢弃。
+     * @returns {Promise<{qrUrl:string}|null>} 需要弹 → 返回弹层数据；不弹/失败 → null
+     */
+    function ciMaybeShow() {
+      if (ciSeen()) return Promise.resolve(null);
+      return api("/dsh-remote/community-invite/status")
+        .then(function (b) {
+          if (!b || b.ok === false || b.show !== true) return null; // 服务端说不弹就不弹
+          return { qrUrl: ciSafeQrUrl(b.qr_url) };
+        })
+        .catch(function () { return null; }); // 静默：接口/网络/字段异常一律不弹
+    }
+
+    // 【2026-10-24 移除】业主决定：面板不再展示购买协议（协议只在**手机端支付扫码前**展示）。
+    // 相关常量 / 渲染函数 / 样式已一并删除；node 半 `GET /dsh-remote/purchase-agreement` 代理保留
+    // （手机端 / 其它端后续可复用，见 lib/index.js 同名段注释）。
+
     // ── 面板主体（渲染于设置页 settings.section 栏目内） ─────────────────────
     // 匿名装机统计的「面板打开」只上报一次/每页（node 半还会每进程去重）。
     var panelOpenedSent = false;
@@ -2886,6 +2950,8 @@ window.__ModuleLoader__.load({
         : "已停止";
       // 是否需要重启 DeepSeek harness（首次安装/在线更新后置顶提醒 + 底部常驻按钮）
       var restartInfo = (st && st.restart) || {};
+      // 桌面端「暫存插件更新」：新版本已下载，退出应用后由 bridge 自动安装（见 dsh-bridge 的 applier）
+      var desktopUpdatePending = (st && st.desktopUpdatePending) || null;
       var restartPending = !!restartInfo.pending;
       // 宿主形态（node 半下发）：桌面端（Electron）Host 由桌面应用托管，重启这个动作
       // 在那边**做不到也不该做**（强行退出会弹原生致命错误）。面板据此：
@@ -5065,6 +5131,23 @@ window.__ModuleLoader__.load({
       // annVer 只用于让 useSyncExternalStore 的重渲染生效，本身不参与任何计算 —— 显式丢弃，免得被读成漏用。
       void annVer;
 
+      // ── 🎉 交流群引导：hook 追加在**最后一个既有 hook 之后**（同上"hook 序号铁律"）──────
+      // 触发时机 = 「面板加载完成 + 已登录 SaaS 账号」：st 由 refresh() 拉回、loggedIn 由它派生；
+      // 这里不写定时器、不抢首屏（数据回调后再 setState 渲染弹层）。本地模式（自建）不弹：
+      // node 半对这种模式直接回 ok:false/reason:local_mode（没有企业端账号体系）。
+      var ciArr = useState(null); var ciInvite = ciArr[0]; var setCiInvite = ciArr[1]; // {qrUrl}|null
+      useEffect(function () {
+        if (!loggedIn || mode !== "saas") return undefined;
+        var alive = true;
+        ciMaybeShow().then(function (data) {
+          if (!alive || !data) return;
+          ciMarkSeen();        // 先标记再展示：同一次桌面会话绝不重复弹
+          setCiInvite(data);
+          ciReportShown();     // 看过即算（幂等）：用户不点按钮、直接关页面也不会被反复骚扰
+        });
+        return function () { alive = false; };
+      }, [loggedIn, mode, phoneKey]);
+
       /** 取消本次自动重启(按事件持久化:同一 pending 事件不再自动重启)。 */
       var cancelAutoRestart = function () {
         markAutoRestartCancelled(restartInfo.at || 0);
@@ -5095,6 +5178,42 @@ window.__ModuleLoader__.load({
         );
       }
 
+      /**
+       * 🎉 交流群引导弹层（使用满 2 小时后由服务端 show 触发；与上面的「加入交流群」二维码弹窗
+       * 共用 dru-popup 视觉，不引入新设计语言）。
+       * 关闭纪律：两个按钮 + 点遮罩都走同一个 close —— 关闭时**调用**幂等上报 shown 再收起
+       * （展示时已成功报过则本地标记跳过网络；那次失败时这里正好补报）。
+       * 展示时已经报过一次，所以即使这次上报失败（网络抖动）也已经是"看过即算"。
+       */
+      function renderCommunityInviteModal() {
+        if (!ciInvite) return null;
+        var close = function () { ciReportShown(); setCiInvite(null); };
+        var qrUrl = ciInvite.qrUrl;
+        return h("div", { className: "dru-popup", "data-dru-theme": theme, 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-title" }, "🎉 加入用户交流群"),
+              h("div", { className: "dru-popup-sub" }, "在群里可以交流使用心得、提想法和建议，遇到问题也更容易找到我们"),
+              qrUrl
+                ? h("img", {
+                    className: "dru-community-qr",
+                    src: qrUrl,
+                    alt: "用户交流群二维码",
+                    // 二维码加载失败：只藏图片，文案与按钮照旧（绝不因为一张图挂了就把引导整块丢掉）
+                    onError: function (e) { try { if (e && e.target) e.target.style.display = "none"; } catch (err) { /* 忽略 */ } }
+                  })
+                : null,
+              h("div", { className: "dru-hint", style: { marginTop: 10 } },
+                qrUrl ? "用手机微信/企业微信扫码即可入群。" : "二维码暂不可用，可稍后再看（不影响正常使用）。")
+            ),
+            h("div", { className: "dru-popup-actions", style: { padding: "0 22px 20px" } },
+              h("button", { type: "button", className: "dru-btn dru-btn-primary", onClick: close }, "加入交流群"),
+              h("button", { type: "button", className: "dru-btn dru-btn-ghost", onClick: close }, "稍后再看")
+            )
+          )
+        );
+      }
+
       // ── 📣 公告（0.6.18）：面板入口卡 / 详情弹窗 / 远程访问卡里的提醒入口 ──────────
       //
       // 数据来源只有一个：模块级的 annState（由 apply() 里的一次性拉取填充，见 annPull）。
@@ -5192,12 +5311,18 @@ window.__ModuleLoader__.load({
           // 不该混在桌面端适配里顺手做掉。桌面端才走新文案。
           // 2026-10-17（业主）：桌面端运行环境由应用托管、更新自动热加载 ——
           // **不再引导用户重启 DeepSeek Harness**，统一只说「刷新页面即可生效」。
-          var restartRowText = (desktopHost || !isRestartHard)
-            ? "🔄 插件已更新：刷新页面即可生效"
-            : "🔄 插件已更新：重启 dsh web 后生效";
+          // 桌面端：插件更新需要退出并重新打开应用（应用独占 profile，不能热改）；
+          // 若已暂存新版本，bridge 会在应用退出后自动安装，重开即生效 —— 绝不说「刷新页面即可」。
+          var restartRowText = desktopHost
+            ? (desktopUpdatePending
+              ? "🆕 新版本已下载：退出并重新打开 DeepSeek Harness 后自动生效（无需终端）"
+              : "🔄 插件已更新：退出并重新打开 DeepSeek Harness 后生效")
+            : (!isRestartHard
+              ? "🔄 插件已更新：刷新页面即可生效"
+              : "🔄 插件已更新：重启 dsh web 后生效");
           rows.push(h("div", { className: "dru-access-tip-row", key: "restart" },
             h("span", null, restartRowText),
-            (isRefreshOnly || !desktopHost) ? h("button", {
+            (!desktopHost || isRefreshOnly) && !desktopHost ? h("button", {
               type: "button",
               className: "dru-linkbtn",
               disabled: busy !== "",
@@ -5249,13 +5374,17 @@ window.__ModuleLoader__.load({
                     // **任何情况都不再引导"重启/退出重开应用"**，只说「刷新页面即可生效」。
                     // 非桌面端（自建 dsh web）保留原有 isRestartHard 判据，文案不变。
                     desktopHost
-                      ? "插件已更新：刷新页面即可生效"
+                      ? (desktopUpdatePending
+                        ? "新版本已下载：退出并重新打开 DeepSeek Harness 后生效"
+                        : "插件已更新：退出并重新打开 DeepSeek Harness 后生效")
                       : (isRestartHard
                         ? "插件已更新，重启 dsh web 后生效"
                         : (isRefreshOnly ? "插件已更新，刷新页面即可生效" : "需要重启 dsh web 才能载入新插件"))),
                   h("div", { className: "dru-restart-alert-sub" },
                     desktopHost
-                      ? "新插件已经在磁盘上，刷新一下这个页面即可载入（手机端连接与已登录状态都不受影响）。如果刷新后仍看不到面板，在应用内「插件」页重新安装一次即可。"
+                      ? (desktopUpdatePending
+                        ? "新版本已经下载到本机；DeepSeek Harness 退出后，后台服务会自动完成安装，重新打开应用即生效（无需终端，手机端连接与已登录状态都不受影响）。"
+                        : "新插件已在磁盘上，但桌面应用仍在运行旧插件；退出 DeepSeek Harness 后重新打开即可载入新版（应用退出后后台服务会自动完成安装，无需终端）。")
                       : (isRestartHard
                         ? "新版本已经装到这台电脑上，但当前运行的 dsh web 还是旧代码（新的后台路由与面板要等它重新载入）。手机端连接与已登录状态都不受影响；重启期间页面会短暂断开，然后自动恢复。"
                         : (isRefreshOnly
@@ -5325,6 +5454,8 @@ window.__ModuleLoader__.load({
           }, busy === "restart" ? "重启中…" : "🔄 重启 dsh web")
         ),
         renderCommunityModal(),
+        // 🎉 使用满 2 小时的交流群引导（服务端 show 决定的自动弹层；同一层，点遮罩即收起）
+        renderCommunityInviteModal(),
         // 📣 公告详情弹窗（与交流群弹窗同一层：都挂在面板根上，点遮罩即收起）
         renderAnnouncementDetail()
       );

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

@@ -2817,6 +2817,29 @@ function writeRestartState(relayDir, state) {
  * 标记「需要用户动一下」的状态。kind = refresh(插件被运行时改写,刷新页面即可)。
  * 历史 kind(first-install / update)已废弃:热加载落地后,装插件与在线更新都不再需要重启 harness。
  */
+/** 桌面端「暫存插件更新」marker（dsh-setup 在应用运行时暂存；bridge 在应用退出后自动安装）。 */
+function readDesktopUpdatePending(relayDir) {
+  try {
+    const m = JSON.parse(readFileSync(join(relayDir, ".plugin-update-pending.json"), "utf8"));
+    return { version: String(m.version || ""), stagedAt: Number(m.stagedAt) || 0 };
+  } catch {
+    return null;
+  }
+}
+
+/** 更新进程成功收尾后写「待生效」提示：桌面端暂存更新 → 退出应用后自动安装；其它 → 重启 dsh web。 */
+function markUpdateRestartPending(relayDir) {
+  const staged = readDesktopUpdatePending(relayDir);
+  if (staged) {
+    return markRestartPending(
+      relayDir,
+      "restart-app",
+      `新版本${staged.version ? ` ${staged.version}` : ""} 已下载：退出并重新打开 DeepSeek Harness 后自动生效（无需终端）`
+    );
+  }
+  return markRestartPending(relayDir, "restart", "插件已更新，重启 dsh web 后生效");
+}
+
 function markRestartPending(relayDir, kind, reason) {
   const cur = readRestartState(relayDir);
   if (cur.pending && cur.kind === kind) return cur; // 幂等：同一原因不反复重写
@@ -3417,6 +3440,51 @@ async function communityInfo(relayDir) {
   return data;
 }
 
+// ---------- 📄 会员服务购买协议 URL（购买入口的《会员服务购买协议》链接） ----------
+
+/**
+ * 购买入口必须带《会员服务购买协议》链接（业主要求，2026-10-23 客户端 0.7.5-beta.1）。
+ *
+ * URL 来源优先级：
+ *   1) 企业端 `public-config` 的 `agreement_url`（**新字段**；企业端还没上线时没有 → 忽略）；
+ *   2) 固定兜底 `DEFAULT_PURCHASE_AGREEMENT_URL`（正式协议由企业端提供，未就绪也能点开）。
+ *
+ * 安全：只允许 **http(s) 绝对地址**；`javascript:` / `data:` / 协议相对（`//host`）/ 相对路径
+ * 一律回兜底 —— 这个值最终会进 `<a href>`，绝不能吃进可执行协议（与 qr_url 同一套纪律）。
+ *
+ * 软着陆：public-config 不可达 / 非对象 / 字段缺失全部回兜底并 `ok:true`。
+ * 协议链接**永远不该**成为购买流程的故障点（打不开也不影响旁边的「升级 / 续费」按钮）。
+ */
+export const DEFAULT_PURCHASE_AGREEMENT_URL = "https://n.risegao.cn:13443/relay-api/api/purchase-agreement";
+
+/** 从 public-config 解析协议 URL（纯函数，便于单测：优先级 + 安全过滤 + 降级一次看完）。 */
+export function purchaseAgreementUrlFrom(publicConfig) {
+  const raw = publicConfig && typeof publicConfig === "object"
+    ? String(publicConfig.agreement_url == null ? "" : publicConfig.agreement_url).trim()
+    : "";
+  if (/^https?:\/\/[^\s]+$/i.test(raw)) return raw;
+  return DEFAULT_PURCHASE_AGREEMENT_URL;
+}
+
+/** GET /dsh-remote/purchase-agreement 的实现：读公开配置 → 安全过滤 → 兜底。 */
+async function purchaseAgreementInfo(relayDir) {
+  let body = null;
+  try {
+    const r = await relayFetch(relayDir, "/api/public-config");
+    body = r && r.ok && r.body && typeof r.body === "object" ? r.body : null;
+  } catch {
+    body = null; // relayFetch 本身不抛；这里只是防御（协议链接不能把面板打挂）
+  }
+  const raw = body && typeof body === "object" ? String(body.agreement_url == null ? "" : body.agreement_url).trim() : "";
+  const url = purchaseAgreementUrlFrom(body);
+  return {
+    ok: true,
+    url,
+    // 便于排障：这个 URL 是服务端配的，还是走兜底（面板不展示，只出现在响应里）
+    source: url !== DEFAULT_PURCHASE_AGREEMENT_URL ? "public_config" : (raw ? "public_config_invalid" : "fallback"),
+  };
+}
+
 // ---------- 一次性访问密钥 / 已授权设备代理（E1 企业端新增 auth-key / mobile-sessions） ----------
 
 /** 从 relay 响应里尽量提取人类可读错误信息（兼容 {error:{message}} / {error:".."} / {message} / 纯文本）。 */
@@ -3703,6 +3771,8 @@ async function composeStatus(relayDir) {
     // 是否需要重启 DeepSeek harness（首次安装 / 在线更新后必须重启才加载插件本体）：
     // {pending, kind: first-install|update, reason, at}，供面板顶部醒目提示 + 重启按钮。
     restart: readRestartState(relayDir),
+    // 桌面端暂存的插件更新（存在 = 新版本已下载，退出应用后由 bridge 自动安装并生效）
+    desktopUpdatePending: readDesktopUpdatePending(relayDir),
     // 安装/配对自检（2026-10-17 事故）：运行时（clients/）与配对（.dsh-config.json）是否齐全、
     // 缺什么、下一步该做什么；配对主配置缺失但备份存在时给出可一键恢复的 backup.action。
     // 字段契约见 setupStateOf；connect.setup 是同一份对象（bridge-status 短轮询也能拿到）。
@@ -3930,6 +4000,84 @@ async function proxyAnnouncements(relayDir, req, res, pathname) {
   }
 }
 
+// ---------- 🎉 企微交流群引导代理（实际使用满 2 小时弹一次；2026-10-23 业主需求） ----------
+/**
+ * 桌面端插件面板的「加入企业微信群」引导数据来自企业端**用户级**接口：
+ *   GET  /api/community-invite/status → { ok, show, reason, used_seconds, required_seconds, qr_url }
+ *   POST /api/community-invite/shown  → { ok:true }（幂等）
+ * 浏览器半没有企业端用户 token（它跑在 dsh web 同源页里，只认本机 node 半的路由），
+ * 所以由 node 半用 **device-login token** 代调（企业端 device token 的 sub 就是 user，
+ * 与 /api/me、/api/mobile-sessions 走的是同一条身份链）。
+ *
+ * 三条纪律：
+ * ① **不透传浏览器带来的 Authorization**：这是纯用户级接口，身份只应该是"本机登录账号"。
+ *    面板浏览器手里没有任何企业端用户 token，透传只会让"谁的身份"变得含混
+ *    （与 announcements 的 user/install 二选一不同，那个接口两种维度都合法）。
+ * ② **判定与记账全在服务端**：show=false（未满 2h / 已弹过 / 后台没配二维码）原样透传，
+ *    前端绝不自己算时长；`shown` 幂等，展示时与关闭时各调一次是安全超集。
+ * ③ **失败一律软着陆**：未登录/自建（没有企业端账号体系）→ 200 + ok:false + reason
+ *    （面板静默、不弹不报错）；上游 4xx/5xx → 透传状态码 + 可读 error（排障能看见，
+ *    面板依旧静默）；网络不可达 → 502 JSON，绝不抛回 webServer。
+ */
+async function proxyCommunityInvite(relayDir, req, res, pathname) {
+  const method = String(req.method || "GET").toUpperCase();
+  const suffix = pathname.replace(/^\/dsh-remote\/community-invite/, "") || "/";
+  const isStatus = method === "GET" && suffix === "/status";
+  const isShown = method === "POST" && suffix === "/shown";
+  if (!isStatus && !isShown) {
+    return sendJson(res, 404, { ok: false, show: false, reason: "unknown_route", error: "unknown community-invite route" });
+  }
+  const cfg = loadConfig(relayDir);
+  // 自建部署：没有企业端账号体系，交流群引导不适用 —— 不发请求、也不让面板弹
+  if (cfg.local_key) return sendJson(res, 200, { ok: false, show: false, reason: "local_mode" });
+  // 没配账号：面板登录前也可能误调 —— 静默拒绝（前端本来就只在 loggedIn 后调）
+  if (!(cfg.phone && cfg.password)) return sendJson(res, 200, { ok: false, show: false, reason: "not_logged_in" });
+  const token = await relayToken(relayDir).catch(() => "");
+  if (!token) return sendJson(res, 200, { ok: false, show: false, reason: "not_logged_in" });
+
+  const upstreamPath = isShown ? "/api/community-invite/shown" : "/api/community-invite/status";
+  const init = { method: isShown ? "POST" : "GET", headers: { authorization: `Bearer ${token}` } };
+  if (isShown) {
+    init.headers["content-type"] = "application/json";
+    init.body = "{}";
+  }
+  const r = await relayFetch(relayDir, upstreamPath, init);
+  const d = flattenRelayBody(r);
+  if (!r.ok) {
+    // 透传状态码 + 可读错误：面板仍然静默（它只看 ok/show），但排障时能直接看到 401/404/500
+    return sendJson(res, (r && r.status) || 502, {
+      ok: false,
+      show: false,
+      reason: isShown ? "report_failed" : "status_failed",
+      error: relayErrorMessage(r),
+      relayStatus: (r && r.status) || 0
+    });
+  }
+  if (isShown) {
+    // 幂等上报：不关心上游回什么（只认 ok:false 才报失败），面板两个按钮都会调
+    return sendJson(res, 200, { ok: d.ok !== false, relayStatus: r.status || 200 });
+  }
+  // status：只挑面板需要的字段（不整包透传，避免把内部字段带进浏览器；字段容错见契约）
+  // qr_url 归一化：企业端后台配的可能是站内相对路径（如 /qr/group-qr.png），
+  // 与 /dsh-remote/community 同一约定拼成**企业端绝对地址**再下发 —— 面板跑在 dsh web 源上，
+  // 相对路径会被浏览器解析到 127.0.0.1，图片必然挂。其它协议（data:/javascript:/协议相对）一律丢弃，
+  // 前端按"二维码不可用"降级（保留文案与按钮）。
+  const apiBase = String(cfg.api_url || DEFAULT_API).replace(/\/+$/, "");
+  const rawQr = typeof d.qr_url === "string" ? d.qr_url.trim() : "";
+  let qrUrl = "";
+  if (/^https?:\/\//i.test(rawQr)) qrUrl = rawQr;
+  else if (rawQr.charAt(0) === "/" && rawQr.charAt(1) !== "/") qrUrl = apiBase + rawQr;
+  return sendJson(res, 200, {
+    ok: d.ok !== false,
+    show: d.show === true, // fail closed：非严格 true 一律不弹
+    reason: typeof d.reason === "string" ? d.reason : "",
+    used_seconds: Number(d.used_seconds) || 0,
+    required_seconds: Number(d.required_seconds) || 0,
+    qr_url: qrUrl,
+    relayStatus: r.status || 200
+  });
+}
+
 // ---------- 自管理：版本 / 在线更新 / 彻底卸载（面板内“版本与更新”卡片） ----------
 
 /** 插件 id / 包名（2026-09 由 dsh-remote-ui 更名）。 */
@@ -4463,7 +4611,7 @@ async function runOnlineUpdate(relayDir) {
           updateFailures.delete(String(relayDir));
           sweepIfSucceeded(); // C8：装完清残留（按更新前的 pid 点名 + 命令行复核）
           // 更新成功 → 落一条「必须重启 dsh web」的强提醒（见 run() 成功分支的同款注释）
-          markRestartPending(relayDir, "restart", "插件已更新，重启 dsh web 后生效");
+          markUpdateRestartPending(relayDir);
         }
       });
       child.unref();
@@ -4553,7 +4701,7 @@ async function runOnlineUpdate(relayDir) {
           // 客户端按 kind 一一对应地换文案与主按钮（见 client.js 的 restartAlert），
           // 混用一个 kind 就会再次出现"文案说刷新、状态其实是重启"。
           // settleRestartState() 靠 bootId 自动结清 —— 用户真的重启后这条提示自己消失，不需要额外清理。
-          markRestartPending(relayDir, "restart", "插件已更新，重启 dsh web 后生效");
+          markUpdateRestartPending(relayDir);
         }
       });
       child.unref();
@@ -7285,6 +7433,15 @@ function registerRoutes(ctx, relayDir) {
         sendJson(res, 200, { ok: true, ...(await communityInfo(relayDir)) });
       },
     },
+    // 📄 会员服务购买协议 URL（购买入口的《会员服务购买协议》链接；public-config.agreement_url → 兜底）
+    //    永远 200 ok:true + 一个可点 URL：协议链接不得成为购买流程的故障点。
+    {
+      method: "GET",
+      path: "/dsh-remote/purchase-agreement",
+      handler: async (_req, res) => {
+        sendJson(res, 200, await purchaseAgreementInfo(relayDir));
+      },
+    },
     // 一次性访问密钥（📱 远程访问卡）：GET 即创建新 key，企业端 POST /api/auth-key（Bearer）
     {
       method: "GET",
@@ -7654,6 +7811,19 @@ function registerRoutes(ctx, relayDir) {
         await proxyAnnouncements(relayDir, req, res, url.pathname);
       },
     },
+    // 🎉 企微交流群引导（桌面端面板使用满 2h 后弹一次；与手机 Web 共用同一套企业端接口）：
+    //   GET  /dsh-remote/community-invite/status → 上游 GET  {api}/api/community-invite/status
+    //   POST /dsh-remote/community-invite/shown  → 上游 POST {api}/api/community-invite/shown（幂等）
+    //   与 feedback/announcements 同一形态（prefix + handler 内判别），以后加子接口不用动路由表。
+    {
+      method: "ALL",
+      path: "/dsh-remote/community-invite",
+      prefix: true,
+      handler: async (req, res) => {
+        const url = new URL(req.url ?? "/", "http://x");
+        await proxyCommunityInvite(relayDir, req, res, url.pathname);
+      },
+    },
   ];
 
   const disposers = [];

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

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-web",
-  "version": "0.7.6-beta.1",
+  "version": "0.7.6-beta.3",
   "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",