@mrrisega/dsh-remote 0.7.0-beta.2 → 0.7.0-beta.4

package/clients/dsh-remote/wechat-runtime.mjs

@@ -199,10 +199,22 @@ const SPECIAL_EVENT_KINDS = Object.freeze([
 const NOTICE_FORMATTER_KINDS = Object.freeze(["quota", "membership"]);
 
 /**
- * 主动推送失败后的**待补发队列**上限（见 `#pushProactive`）。
- * 为什么是 20：够放下"一轮里所有该告诉用户的事"；再多下去，补发就变成刷屏了。
+ * 主动推送失败后的**待补发队列**上限（见 `#pushProactive`）：只留**最近几条**。
+ *
+ * 2026-10-09 业主口径：「积压超过一定时限后就丢弃掉最早的数据，只保留最近几条」。
+ * 从 20 收到 5 的理由：一轮里真正还值得看的就最近那么两三条；攒到 20 条的结果是
+ * 平台一恢复就**一次连打十几条** —— 实测正是这种突发批量触发 `ret=-2 prepare failed`
+ * 被限流，于是补发又失败、队列再涨，越积越多永远还不上（现场观察到的就是这个循环）。
+ */
+const MAX_OUTBOX = 5;
+/**
+ * 待补发条目的**保质期**：超过这个时长还没送达就丢弃（先丢最旧的）。
+ *
+ * 为什么必须有（同一条业主口径）：一条"任务跑完了"的通知迟到几小时就**毫无价值** ——
+ * 补发出去只会让用户以为刚刚才发生；而队列的价值在于"网络抖动期间的短暂失败"，
+ * 那是分钟级的。2 小时足够覆盖抖动与短时离线，又不会把半天前的旧事翻出来刷屏。
  */
-const MAX_OUTBOX = 20;
+const OUTBOX_TTL_MS = 2 * 60 * 60 * 1000;
 /** 补发时的正文前缀（迟到必须如实说，不能让用户以为刚刚才发生）。 */
 const OUTBOX_MARK = "（补发）";
 
@@ -337,6 +349,12 @@ function sendJson(res, status, body) {
 }
 
 export class WeChatRuntime {
+  /**
+   * 「预期内的订阅拒绝」已报过的 (code|sessionId) 集合 —— 见 fault 处理器。
+   * 只是防刷屏：每生成一个**子代理**会话都会被订阅层拒一次，不记集合就是每个子代理刷一行 warn。
+   */
+  #expectedFaultSeen = new Set();
+
   /**
    * @param {{
    *   relayDir: string,
@@ -508,7 +526,9 @@ export class WeChatRuntime {
       followed_sessions: this.subscriber && typeof this.subscriber.sessions === "function"
         ? this.subscriber.sessions()
         : [],
-      pending_outbox: Array.isArray(state.pending_outbox) ? state.pending_outbox.length : 0,
+      // 报**有效**条数（按保质期过滤后）：否则进程重启后，面板会一直显示那几条早已过期、
+      // 永远不会被补发的条目，看起来像"队列卡住了"。真正的清理由 #trimOutbox 落盘。
+      pending_outbox: this.#pruneOutbox(state.pending_outbox).kept.length,
       last_fault: state.last_fault || null,
       last_completed_session_id: state.last_completed_session_id || "",
       last_completed_at: Number(state.last_completed_at || 0),
@@ -1547,14 +1567,44 @@ export class WeChatRuntime {
     return list;
   }
 
+  /**
+   * 丢掉**过期**条目（返回保留的与丢掉的数量）。
+   * `at` 缺失/非法 = 更早的落盘格式（那时还没有 at 字段）→ 一律视为过期：
+   * 留着只会把"最近几条"挤掉，而它们必然比 TTL 更老。
+   */
+  #pruneOutbox(list) {
+    const now = this.clock();
+    const kept = [];
+    let dropped = 0;
+    for (const item of Array.isArray(list) ? list : []) {
+      const at = Number(item && item.at);
+      if (!Number.isFinite(at) || at <= 0 || now - at > OUTBOX_TTL_MS) { dropped += 1; continue; }
+      kept.push(item);
+    }
+    return { kept, dropped };
+  }
+
+  /** 丢弃过期的、并按上限只留最近几条；丢了就**如实记一行日志**（绝不静默丢）。 */
+  #trimOutbox(list) {
+    const { kept, dropped } = this.#pruneOutbox(list);
+    let overflow = 0;
+    while (kept.length > MAX_OUTBOX) { kept.shift(); overflow += 1; }
+    const lost = dropped + overflow;
+    if (lost > 0) {
+      const mins = Math.round(OUTBOX_TTL_MS / 60000);
+      const why = [dropped ? `${dropped} 条超 ${mins} 分钟未送达` : "", overflow ? `${overflow} 条超出最近 ${MAX_OUTBOX} 条上限` : ""]
+        .filter(Boolean).join("、");
+      this.logger.warn(`[wechat] 待补发队列丢弃 ${lost} 条（${why}），保留最近 ${kept.length} 条`);
+    }
+    return kept;
+  }
+
   #enqueueOutbox(text, kind = "") {
     const body = String(text || "");
     if (!body) return 0;
     const list = this.#outbox();
     list.push({ text: body, kind: String(kind || ""), at: this.clock() });
-    // 上限：丢最旧的（用户最需要的是"最近发生了什么"，而无限攒下去只会让补发像刷屏）
-    while (list.length > MAX_OUTBOX) list.shift();
-    return this.#writeOutbox(list).length;
+    return this.#writeOutbox(this.#trimOutbox(list)).length;
   }
 
   /**
@@ -1562,7 +1612,11 @@ export class WeChatRuntime {
    * @returns {Promise<number>} 这次补发成功的条数
    */
   async #flushOutbox(to) {
-    const list = this.#outbox();
+    // 补发前先按保质期清一遍：**过期的不发**（迟到几小时的"任务跑完了"只会误导用户），
+    // 也避免一次性连打十几条把平台打限流（那正是队列越积越多的成因）。
+    const raw = this.#outbox();
+    const list = this.#trimOutbox(raw);              // 只在真丢了东西时才落盘（避免每轮都写状态文件）
+    if (list.length !== raw.length) this.#writeOutbox(list);
     if (!list.length || !to) return 0;
     let sent = 0;
     const rest = [...list];
@@ -1645,10 +1699,20 @@ export class WeChatRuntime {
       const code = String((info && info.code) || "unknown");
       const message = String((info && info.message) || "").slice(0, 160);
       const sessionId = String((info && info.sessionId) || "");
-      this.logger.warn(`[wechat/events] 订阅异常 ${code}${sessionId ? ` session=${sessionId}` : ""}: ${message}`);
-      if (!(info && info.expected === true)) {
-        this.channel.writeState({ last_fault: { code, message, session_id: sessionId, at: this.clock() } });
+      // 预期内的拒绝（子代理会话必然被拒 `session/agent-busy` / 会话刚被删 `session/not-found`）
+      // **不是故障**：每生成一个子代理就会来一条，写成 warn 会把真正的故障淹掉
+      // （2026-10-09 现场：日志里成片 `订阅异常 session/agent-busy … require their durable parent address`）。
+      // 但也不能完全静默（2026-09-25 的教训：fault 以前没人接，全丢）→ 降为 info，且同一对只报一次。
+      if (info && info.expected === true) {
+        const key = `${code}|${sessionId}`;
+        if (this.#expectedFaultSeen.size < 200 && !this.#expectedFaultSeen.has(key)) {
+          this.#expectedFaultSeen.add(key);
+          this.logger.info(`[wechat/events] 订阅跳过(预期，不重试) ${code}${sessionId ? ` session=${sessionId}` : ""}: ${message}`);
+        }
+        return;
       }
+      this.logger.warn(`[wechat/events] 订阅异常 ${code}${sessionId ? ` session=${sessionId}` : ""}: ${message}`);
+      this.channel.writeState({ last_fault: { code, message, session_id: sessionId, at: this.clock() } });
     });
   }
 

package/dsh-setup.mjs

@@ -362,9 +362,13 @@ const SERVICE_PATH = "/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/
  * 插件市场那条路径由插件半自愈补装：插件 spawn 本安装器时显式传入
  * DSH_BRIDGE_INSTALL_SOURCE=plugin_market，这里原样透传（外部注入 > 硬编码默认）。
  * install_version：优先取外部注入（插件/在线更新器），否则取本包 package.json 版本。
+ * harness_version：**只能由外部注入** —— 宿主（DeepSeek Harness）版本要从宿主进程的 argv /
+ *   安装目录推出来，而安装器是独立进程，推不出来。插件会在宿主进程内问出来再传进来；
+ *   用户直接跑 `npx @mrrisega/dsh-remote` 时没有这个值 → 留空（= 未上报，绝不猜一个错的）。
  */
 const INSTALL_SOURCE = String(process.env.DSH_BRIDGE_INSTALL_SOURCE || "").trim() || "npx";
 const INSTALL_VERSION = String(process.env.DSH_BRIDGE_INSTALL_VERSION || "").trim() || pkgVersion();
+const HARNESS_VERSION = String(process.env.DSH_BRIDGE_HARNESS_VERSION || "").trim();
 
 /**
  * 把文件权限收紧到「只有本人可读写」。
@@ -708,7 +712,7 @@ function writeAutostartFile() {
   <key>LimitLoadToSessionType</key><array><string>Aqua</string><string>Background</string></array>
   <key>StandardOutPath</key><string>${path.join(CONFIG_DIR, ".dsh-bridge.log")}</string>
   <key>StandardErrorPath</key><string>${path.join(CONFIG_DIR, ".dsh-bridge.log")}</string>
-  <key>EnvironmentVariables</key><dict><key>PATH</key><string>${SERVICE_PATH}</string>${SERVICE_NODE_ENV_PLIST}<key>DSH_BRIDGE_INSTALL_SOURCE</key><string>${INSTALL_SOURCE}</string><key>DSH_BRIDGE_INSTALL_VERSION</key><string>${INSTALL_VERSION}</string></dict>
+  <key>EnvironmentVariables</key><dict><key>PATH</key><string>${SERVICE_PATH}</string>${SERVICE_NODE_ENV_PLIST}<key>DSH_BRIDGE_INSTALL_SOURCE</key><string>${INSTALL_SOURCE}</string><key>DSH_BRIDGE_INSTALL_VERSION</key><string>${INSTALL_VERSION}</string><key>DSH_BRIDGE_HARNESS_VERSION</key><string>${HARNESS_VERSION}</string></dict>
 </dict></plist>`;
     // ~/Library/LaunchAgents 在全新账户/精简系统上可能不存在,必须先建目录,
     // 否则 writeFileSync 抛 ENOENT 直接把安装流程打断(用户反馈里也踩过类似的路径问题)。
@@ -724,7 +728,7 @@ function writeAutostartFile() {
   if (process.platform === "linux") {
     const dir = path.join(os.homedir(), ".config/systemd/user");
     fs.mkdirSync(dir, { recursive: true });
-    const unit = `[Unit]\nDescription=dsh-remote bridge (auto-starts with dsh web)\n\n[Service]\nExecStart=${runCmd}\nRestart=on-failure\nRestartSec=5\nEnvironment=PATH=${SERVICE_PATH}\n${SERVICE_NODE_ENV_UNIT}Environment=DSH_BRIDGE_INSTALL_SOURCE=${INSTALL_SOURCE}\nEnvironment=DSH_BRIDGE_INSTALL_VERSION=${INSTALL_VERSION}\n\n[Install]\nWantedBy=default.target\n`;
+    const unit = `[Unit]\nDescription=dsh-remote bridge (auto-starts with dsh web)\n\n[Service]\nExecStart=${runCmd}\nRestart=on-failure\nRestartSec=5\nEnvironment=PATH=${SERVICE_PATH}\n${SERVICE_NODE_ENV_UNIT}Environment=DSH_BRIDGE_INSTALL_SOURCE=${INSTALL_SOURCE}\nEnvironment=DSH_BRIDGE_INSTALL_VERSION=${INSTALL_VERSION}\nEnvironment=DSH_BRIDGE_HARNESS_VERSION=${HARNESS_VERSION}\n\n[Install]\nWantedBy=default.target\n`;
     const unitPath = autostartFilePath();
     fs.writeFileSync(unitPath, unit);
     return unitPath; // 路径在最终汇总里统一展示
@@ -803,6 +807,28 @@ function spawnDetachedBridge() {
  *      但实测 kickstart 只解决"这一次"，进程被杀后不会重建（KeepAlive 已被系统绕过）→ 如实告知
  *   ③ 后台进程  ← 连 launchd 都托管不了时保证可用
  */
+/**
+ * 🔴 标签占用保护（2026-10-10 事故）：`com.dshremote.bridge` 这个 launchd label 是**全局唯一**的，
+ *   谁 bootstrap 谁就接管它。当天跑测试时，某个用例用**假 HOME + 真 launchctl** 把测试临时目录的
+ *   plist 登记到了同一个 label 上 → **真桥被顶掉**、远程访问中断，而日志里看不出任何异常。
+ *
+ *   所以 bootstrap 之前先问一句：这个 label 现在登记的 plist 是**本 relayDir 的**那份吗？
+ *   · 不是（别人家的）→ **拒绝接管**并明确报错。要强行接管得显式设
+ *     `DSH_BRIDGE_ALLOW_LABEL_TAKEOVER=1`（给人留后门，但默认安全）。
+ *   · 查不出来（launchctl 不可用/未登记）→ 照旧继续，不误伤正常安装。
+ */
+function labelOwnedByOtherDir(plistPath, domain) {
+  try {
+    const r = sh(`launchctl print ${domain}/${BRIDGE_LABEL}`);
+    if (!r.ok) return null;                       // 未登记 → 不是"别人家的"
+    const cur = String(r.stdout || "").match(/^\s*path = (.+)$/m);
+    if (!cur) return null;                        // 读不出路径 → 不拦
+    const a = cur[1].trim();
+    const b = String(plistPath).trim();
+    return a === b ? false : a;                   // 返回"占用者的 plist 路径"= 别人家的
+  } catch { return null; }
+}
+
 function startBridgeDarwin(plistPath) {
   const uid = process.getuid();
   const q = (s) => "'" + String(s).replace(/'/g, `'\\''`) + "'";
@@ -813,6 +839,16 @@ function startBridgeDarwin(plistPath) {
     for (const d of [`user/${uid}`, `gui/${uid}`]) {
       if (d !== domain) sh(`launchctl bootout ${d}/${BRIDGE_LABEL}`);
     }
+    // 先确认这个 label 不是别人（别的 relayDir）的，否则**拒绝接管**——见 labelOwnedByOtherDir
+    const foreign = labelOwnedByOtherDir(plistPath, domain);
+    if (foreign && String(process.env.DSH_BRIDGE_ALLOW_LABEL_TAKEOVER || "") !== "1") {
+      return {
+        ok: false,
+        status: "label-owned-by-other",
+        detail: `${domain}/${BRIDGE_LABEL} 已被另一个 relayDir 占用（${foreign}）—— 拒绝接管。`
+          + `真要用本目录接管，请先停掉那边的桥，或显式设 DSH_BRIDGE_ALLOW_LABEL_TAKEOVER=1。`,
+      };
+    }
     sh(`launchctl bootout ${target}`);
     let boot = sh(`launchctl bootstrap ${domain} ${q(plistPath)}`);
     if (!boot.ok) {
@@ -1505,6 +1541,8 @@ async function runBridge() {
         // 安装口径透传给 bridge（bridge 把它随设备登记请求一起上报给账号 API）
         DSH_BRIDGE_INSTALL_SOURCE: INSTALL_SOURCE,
         DSH_BRIDGE_INSTALL_VERSION: INSTALL_VERSION,
+        // 宿主版本：外部注入（插件在宿主进程内问出来的），安装器只是搬运工；没有就是空串
+        DSH_BRIDGE_HARNESS_VERSION: HARNESS_VERSION,
         ...(saas ? { DSH_BRIDGE_PHONE: (cfg.phone || cfg.email || ""), DSH_BRIDGE_PASSWORD: cfg.password, DSH_BRIDGE_API: apiUrl, DSH_BRIDGE_SECRET: cfg.bridge_secret || "" } : {}),
         ...(local ? { DSH_BRIDGE_LOCAL_KEY: cfg.local_key } : {})
       };
@@ -2191,10 +2229,21 @@ function copyPluginIntoProfile(profileDir, pluginDir) {
     // 注意：插件源(npx 缓存 / npm 全局)本身就位于某个 node_modules 之下，
     // 过滤必须基于“相对插件目录”的路径片段，绝不能整条 src 路径包含判断，
     // 否则会把插件文件全过滤掉、拷出空目录(此前反复“插件入口缺失”的总根因)。
+    //
+    // 🔴 2026-10-10 修：**插件自带的 runtime/node_modules 不能被剔掉**。
+    //   旧规则是"任何一段叫 node_modules 就过滤"，这条原本只想剔掉插件自己的依赖目录
+    //   （那些由 profile 的包管理器管），却把 `runtime/node_modules/ws` 一起剔了 ——
+    //   而那份运行时正是"只有插件半"的机器**自愈补装时的来源**。剔掉它 = 自愈出来的运行环境
+    //   缺 ws（bridge 顶层 `import WebSocket from "ws"`）→ 一启动就崩，还"自检通过"。
+    //   现在：`runtime/` 之内一律保留；只过滤 runtime 之外的 node_modules。
     filter: (src) => {
       if (src === pluginDir) return true;
-      const rel = path.relative(pluginDir, src);
-      return !String(rel).split(path.sep).some((seg) => seg === "node_modules" || seg === ".git" || seg === ".DS_Store");
+      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;
     }
   };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.7.0-beta.2",
+  "version": "0.7.0-beta.4",
   "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",
@@ -51,13 +51,14 @@
   },
   "scripts": {
     "test": "npm run test:router && npm run test:plugin && npm run test:bridge",
-    "test:router": "NODE_OPTIONS=\"--require $PWD/scripts/test-net-guard.cjs ${NODE_OPTIONS:-}\" node --test packages/relay-router/test/native-device-selection.test.mjs packages/relay-router/test/native-app-entry.test.mjs packages/relay-router/test/presence-report.test.mjs packages/relay-router/test/logger.test.mjs packages/relay-router/test/device-free-assets.test.mjs packages/relay-router/test/sse-streaming-contract.test.mjs",
-    "_comment:test:plugin": "DSH_RELAY_BUNDLED_RUNTIME=/nonexistent = 强制走 npx 兜底分支（否则本机跑过 npm pack 后 packages/dsh-remote-web/runtime 存在，用例会改成走本地拷贝）。DSH_RELAY_SKIP_SERVICE=1 = 测试隔离：插件加载时不做真实系统操作（npx 补装 / launchctl / 重启 harness）；需要真实分支的用例自行 unset（见 account-switch / runtime-provision / harness-restart 用例注释）。DSH_RELAY_DEFAULT_API= 死端口：用例拆掉临时目录后，仍在飞的后台请求（装机上报重试等）会读到空配置并回落「默认云端地址」—— 指到本地死端口才不会打生产。",
-    "test:plugin": "DSH_REMOTE_TELEMETRY=0 DSH_RELAY_SKIP_SERVICE=1 DSH_RELAY_DEFAULT_API=http://127.0.0.1:1 DSH_RELAY_BUNDLED_RUNTIME=/nonexistent-dsh-bundled NODE_OPTIONS=\"--require $PWD/scripts/test-net-guard.cjs ${NODE_OPTIONS:-}\" node --test --test-concurrency=1 packages/dsh-remote-web/test/*.test.mjs",
+    "test:router": "DSH_PROFILE_DIR= NODE_OPTIONS=\"--require $PWD/scripts/test-net-guard.cjs ${NODE_OPTIONS:-}\" node --test packages/relay-router/test/native-device-selection.test.mjs packages/relay-router/test/native-app-entry.test.mjs packages/relay-router/test/presence-report.test.mjs packages/relay-router/test/logger.test.mjs packages/relay-router/test/device-free-assets.test.mjs packages/relay-router/test/sse-streaming-contract.test.mjs",
+    "_comment:test:plugin": "DSH_PROFILE_DIR= = 测试隔离铁律：本套件跑在 DSH 宿主里时环境**天然带着** DSH_PROFILE_DIR（指向真实 ~/.dsh/profiles/desktop），而多数用例只隔离了 HOME —— 于是它们会去写**真实** profile 的 cordis.patch.yml（2026-10-10 事故：测试 relayDir 被写进真 profile，面板连到假配置、验证码/公告全 502）。这里显式清空，让 profile 解析回落到各用例自己的假 HOME。 DSH_RELAY_BUNDLED_RUNTIME=/nonexistent = 强制走 npx 兜底分支（否则本机跑过 npm pack 后 packages/dsh-remote-web/runtime 存在，用例会改成走本地拷贝）。DSH_RELAY_SKIP_SERVICE=1 = 测试隔离：插件加载时不做真实系统操作（npx 补装 / launchctl / 重启 harness）；需要真实分支的用例自行 unset（见 account-switch / runtime-provision / harness-restart 用例注释）。DSH_RELAY_DEFAULT_API= 死端口：用例拆掉临时目录后，仍在飞的后台请求（装机上报重试等）会读到空配置并回落「默认云端地址」—— 指到本地死端口才不会打生产。",
+    "test:plugin": "DSH_PROFILE_DIR= DSH_REMOTE_TELEMETRY=0 DSH_RELAY_SKIP_SERVICE=1 DSH_RELAY_DEFAULT_API=http://127.0.0.1:1 DSH_RELAY_BUNDLED_RUNTIME=/nonexistent-dsh-bundled NODE_OPTIONS=\"--require $PWD/scripts/test-net-guard.cjs ${NODE_OPTIONS:-}\" node --test --test-concurrency=1 packages/dsh-remote-web/test/*.test.mjs",
     "_comment:test:bridge": "⚠️ 必须 --test-concurrency=1（与 test:plugin 对齐）：tunnel-auth 有一条「bridge 5 秒内必须重连」的硬期限，并行跑时新增用例抢 CPU 会把它撞破 → 偶发假红（实测单独跑 2/2 通过、并发跑偶发 0/2）。假红比慢更贵。",
-    "test:bridge": "DSH_RELAY_DEFAULT_API=http://127.0.0.1:1 NODE_OPTIONS=\"--require $PWD/scripts/test-net-guard.cjs ${NODE_OPTIONS:-}\" node --test --test-concurrency=1 clients/dsh-remote/test/*.test.mjs",
+    "test:bridge": "DSH_PROFILE_DIR= DSH_RELAY_DEFAULT_API=http://127.0.0.1:1 NODE_OPTIONS=\"--require $PWD/scripts/test-net-guard.cjs ${NODE_OPTIONS:-}\" node --test --test-concurrency=1 clients/dsh-remote/test/*.test.mjs",
     "check": "node --check scripts/check-profile-activation.mjs && node --check clients/dsh-remote/dsh-bridge.mjs && node --check clients/dsh-remote/wechat-channel.mjs && node --check clients/dsh-remote/wechat-runtime.mjs && node --check clients/dsh-remote/dsh-events.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 && node --check packages/relay-router/src/index.mjs && node --check packages/relay-router/src/logger.mjs && bash -n deploy/install-open.sh && grep -q 'command -v setsid' deploy/install-open.sh && grep -q 'command -v ss' deploy/install-open.sh",
-    "release:tarballs": "bash scripts/release-tarballs.sh"
+    "release:tarballs": "bash scripts/release-tarballs.sh",
+    "sync:local": "node scripts/sync-local.mjs"
   },
   "dependencies": {
     "ws": "^8.18.0"

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

@@ -9,6 +9,10 @@
 //       ① 官方「设置」→「远程访问」栏目（settings.section，位于「Agent 预设」下方，官方扩展点）；
 //       ② 左侧官方「设置」按钮旁注入独立「📱 远程访问」快捷按钮（id=dru-nav-remote，非 clone，
 //          插在其前方、同布局不覆盖官方按钮；点击直达该栏目，首次带引导红点）
+//          ⚠️ 只认**语义锚点**（`button[aria-haspopup="dialog"]`，且必须在设置弹层之外）：
+//             0.2 桌面端的设置面板本身就是 role="dialog" 的弹层，它的栏目也叫「通用设置」，
+//             旧代码用「文本包含『设置』」去找锚点 → 按钮被塞进设置面板栏目列表最上面（业主反馈的
+//             「植入错了地方」）。现在找不到锚点就**不注入**，绝不将就一个错误的落点。
 //   - 栏目内联渲染配置面板（浅色高对比 UI，遵循主流登录体验）
 //     · 登录态：已登录显示账号 + 退出登录；未登录显示 登录/注册 tabs
 //     · 🔒 修改密码（账号卡）：已登录账号经 图形验证码+短信验证码 重置（/dsh-remote/password/reset 代理）；
@@ -465,7 +469,7 @@ window.__ModuleLoader__.load({
       ".dru-e2ee-line.ok{color:var(--dru-success)}",
       // ── 📣 公告（0.6.18）──────────────────────────────────────────────────────
       // 侧栏入口上的**未读数字徽标**：与首次引导红点（.dru-nav-remote-dot）同一落点。
-      // 两者同时出现会叠在一起，所以 JS 侧是"徽标优先"（有未读就不挂红点，见 mountNavEntry）。
+      // 两者同时出现会叠在一起，所以 JS 侧是"徽标优先"（有未读就不挂红点，见 RemoteNavEntry）。
       // 数字用白字蓝底（不是红底）：红点=「你还没点过我」，未读数=「有多少条内容」，
       // 语义不同就不该长一样；红色在这个面板里已经被"危险/未读公告本身"占用了。
       ".dru-nav-remote-badge{position:absolute;top:-7px;right:-7px;min-width:16px;height:16px;box-sizing:border-box;padding:0 4px;border-radius:999px;background:var(--dru-accent-fill);color:var(--dru-on-accent);font:700 10.5px/16px inherit;text-align:center;box-shadow:0 0 0 2px var(--dru-surface-2);pointer-events:none}",
@@ -511,6 +515,13 @@ window.__ModuleLoader__.load({
       // 独立 button(非 clone),插在官方「设置」按钮之前,同源同布局不覆盖官方热区。
       ".dru-nav-remote{display:inline-flex;align-items:center;gap:6px;height:30px;margin:0 0 2px;padding:0 10px;border:1px solid var(--dru-border-ctl);border-radius:8px;background:var(--dru-surface-2);color:var(--dru-accent);font:500 12.5px/1 inherit;cursor:pointer;white-space:nowrap;user-select:none}",
       ".dru-nav-remote:hover:not(:disabled){background:var(--dru-accent-tint-2);border-color:var(--dru-accent)}",
+      // 📱 侧栏底部入口（官方槽位 sidebar.footer.action 内，2026-10-10 三修）：
+      // 原生底部项是「整行、无边框、hover 浅底、14px 字」，之前那个自绘胶囊按钮与邻居格格不入。
+      ".dru-foot-entry{display:flex;align-items:center;gap:8px;width:100%;box-sizing:border-box;min-height:32px;padding:6px 10px;border:none;border-radius:8px;background:transparent;color:inherit;font:inherit;font-size:14px;text-align:left;cursor:pointer;position:relative;white-space:nowrap;user-select:none}",
+      ".dru-foot-entry:hover{background:var(--dru-hover)}",
+      ".dru-foot-entry:focus-visible{outline:2px solid var(--dru-focus);outline-offset:1px}",
+      ".dru-foot-entry .ico{flex:none;width:18px;text-align:center;font-size:15px;line-height:1}",
+      ".dru-foot-entry .lbl{overflow:hidden;text-overflow:ellipsis}",
       ".dru-nav-remote-dot{position:absolute;top:-2px;right:-2px;width:8px;height:8px;border-radius:50%;background:var(--dru-reddot);box-shadow:0 0 0 2px var(--dru-surface-2);pointer-events:none}",
       // 侧栏入口与官方按钮同高（30px）；用 ::after 把命中区补到 ≥44px，不破坏与原按钮的对齐
       ".dru-nav-remote::after{content:\"\";position:absolute;left:0;right:0;top:-7px;bottom:-7px}",
@@ -792,90 +803,167 @@ window.__ModuleLoader__.load({
         return !!el.closest('[role="navigation"], nav, [class*="sidebar" i], [class*="sidenav" i], [class*="appnav" i], [class*="navRail" i]');
       } catch (e) { return false; }
     }
-    function pickNavByToken(token) {
+    /**
+     * 是否位于「设置」弹层内部。
+     *
+     * 🔴 这一条是 2026-10-09 桌面端事故的根治点。官方设置面板本身就是一个
+     * `role="dialog" aria-modal="true"` 的弹层（0.2 实测，见 ui-settings-general 的 SettingsRoot），
+     * 它的左侧栏目同样长得像「导航」（`nav` + `navCell`），于是会被 navCellLike 命中。
+     * 旧代码用「文本包含『设置』」去找侧栏那颗齿轮按钮 —— 而弹层里的第一项叫
+     * **「通用设置」**，`indexOf("设置") !== -1` 直接命中，注入按钮就被塞进了
+     * 设置面板的栏目列表最上面（用户反馈的「植入错了地方」）。
+     */
+    function navInDialog(el) {
+      try { return !!el.closest('[role="dialog"], [aria-modal="true"]'); } catch (e) { return false; }
+    }
+    /**
+     * 官方「设置」触发器（侧栏那颗齿轮按钮）—— **只认语义锚点**。
+     *
+     * 两个版本（Web 0.1.x / 桌面端 0.2）的触发器都是同一个形状（各自实测源码一致）：
+     *   `<button aria-label="设置" aria-haspopup="dialog" aria-expanded=…>`，外层 `…triggerRow`。
+     * `aria-haspopup="dialog"` 是**语言无关**的语义标记，比匹配文案稳（换语言/换文案都不失效）。
+     * 找不到就**不注入** —— 宁可不显示快捷入口，也绝不把按钮塞到别人家的面板里。
+     */
+    /**
+     * 官方「设置」触发器的**候选列表**（设置-like 的排前面）。
+     *
+     * 🔴 2026-10-10 修（业主实测"点入口没反应"）：这里以前还要求 `navCellLike(el)`
+     *   —— 而桌面端侧栏那套 class 里**没有** sidebar/nav 字样（都是 `_3WPZCG_*`），
+     *   于是候选全被挡掉 → 触发器 null → 点击静默返回，表现就是"点了没反应"。
+     *   现在只认语义特征：`aria-haspopup="dialog"` + 不在弹层内 + 不是菜单类；
+     *   其中 **带 aria-keyshortcuts / 文案或 aria-label 含「设置」** 的优先（语言无关 + 精确）。
+     */
+    function settingsTriggerCandidates() {
+      var out = [];
+      try {
+        var cands = document.querySelectorAll('button[aria-haspopup="dialog"], [aria-haspopup="dialog"]');
+        var rest = [];
+        for (var i = 0; i < cands.length; i++) {
+          var el = cands[i];
+          if (!el || el.id === NAV_ENTRY_ID) continue;   // 排除我们自己的入口
+          if (navInDialog(el)) continue;                 // 弹层内的（关闭键/栏目）一律不要
+          if (NAV_BAD_RE.test(String(el.className || ""))) continue;
+          var label = String(navAttrOf(el) || navCleanText(el) || "");
+          var hasShortcut = !!(el.getAttribute && el.getAttribute("aria-keyshortcuts"));
+          if (hasShortcut || /设置|Settings/i.test(label)) out.push(el);
+          else rest.push(el);
+        }
+        return out.concat(rest);   // 兜底也不能空着：实在认不出就逐个试（见 openRemoteSettings）
+      } catch (e) { return out; }
+    }
+    /** 官方「设置」触发器（首选候选，保持旧名字给测试与调用方用）。 */
+    function pickSettingsTrigger() {
+      var list = settingsTriggerCandidates();
+      return list.length ? list[0] : null;
+    }
+    /**
+     * 按文案/aria-label 找导航项。
+     * @param {string} token 目标文案（如「远程访问」「设置」）
+     * @param {{exactOnly?:boolean, insideDialog?:boolean}} [opts]
+     *   exactOnly=true 只接受完全相等；insideDialog 限定是否必须在设置弹层内。
+     *   无论哪种模式：**精确相等优先于子串**（老代码只要子串命中就返回，误伤面很大）。
+     */
+    function pickNavByToken(token, opts) {
+      var exactOnly = !!(opts && opts.exactOnly);
+      var insideDialog = opts ? opts.insideDialog : undefined;
       try {
         var els = document.querySelectorAll("button, [role='tab'], [role='menuitem'], [role='button'], a, [aria-label]");
+        var loose = null;
         for (var i = 0; i < els.length; i++) {
           var el = els[i];
           if (!el || el.id === NAV_ENTRY_ID) continue; // 排除注入按钮自身(防递归)
           if (!navCellLike(el)) continue;
           if (NAV_BAD_RE.test(String(el.className || ""))) continue;
+          var inDlg = navInDialog(el);
+          if (insideDialog === true && !inDlg) continue;
+          if (insideDialog === false && inDlg) continue;
           var t = navCleanText(el);
-          if (t && !/\r|\n/.test(t) && t.length <= NAV_TEXT_MAX &&
-              (t === token || t.indexOf(token) === 0 || t.indexOf(token) !== -1)) return el;
           var at = navAttrOf(el);
-          if (at && (at === token || at.indexOf(token) === 0)) return el;
+          var textOK = !!(t && !/\r|\n/.test(t) && t.length <= NAV_TEXT_MAX);
+          if ((textOK && t === token) || (at && at === token)) return el;              // 精确命中：立即返回
+          if (!loose && ((textOK && t.indexOf(token) !== -1) || (at && at.indexOf(token) === 0))) loose = el;
         }
+        return exactOnly ? null : loose;
       } catch (e) { /* 忽略 */ }
       return null;
     }
-    /** 打开「远程访问」设置栏目：栏目已渲染直接点；否则先点官方「设置」再 ≤3s 轮询补点。 */
+    /**
+     * 打开「远程访问」设置栏目。
+     * 栏目已渲染 → 直接点；否则**依次试每个"设置"候选**：点一下 → 轮询 ≤3s 看栏目出没出来 →
+     * 没出来就换下一个候选。为什么要逐个试（2026-10-10）：桌面端侧栏可能同时有多个
+     * `aria-haspopup="dialog"`（账号/更多…），认错了就会"点了没反应"；逐个试则只要有**一个**
+     * 能打开设置面板，入口就一定能用。
+     */
     function openRemoteSettings() {
       try {
-        var cell = pickNavByToken("远程访问");
+        var cell = pickNavByToken("远程访问", { insideDialog: true });
         if (cell) { cell.click(); return; }
-        var st = pickNavByToken("设置");
-        if (!st) return;
-        st.click();
-        var tries = 0;
-        var iv = setInterval(function () {
-          tries++;
-          var c2 = pickNavByToken("远程访问");
-          if (c2) { clearInterval(iv); c2.click(); }
-          else if (tries >= NAV_POLL_MAX) clearInterval(iv);
-        }, 150);
+        var cands = settingsTriggerCandidates();
+        if (!cands.length) return;
+        var idx = 0;
+        var tryNext = function () {
+          if (idx >= cands.length) return;
+          var el = cands[idx++];
+          try { el.click(); } catch (eClick) { return tryNext(); }
+          var tries = 0;
+          var iv = setInterval(function () {
+            tries++;
+            var c2 = pickNavByToken("远程访问", { insideDialog: true });
+            if (c2) { clearInterval(iv); c2.click(); return; }
+            if (tries >= NAV_POLL_MAX) { clearInterval(iv); tryNext(); }   // 这个候选没打开设置 → 换下一个
+          }, 150);
+          try { if (iv && typeof iv.unref === "function") iv.unref(); } catch (eIv) { /* 忽略 */ }
+        };
+        tryNext();
       } catch (e) { /* 忽略 */ }
     }
-    /** 注入侧栏按钮到官方「设置」按钮之前（独立 button；首次未见过引导红点）。 */
-    function mountNavEntry(host) {
-      try {
-        if (document.getElementById(NAV_ENTRY_ID)) return;
-        var wrap = host && host.parentNode;
-        if (!wrap || !wrap.insertBefore || !wrap.contains) return;
-        var btn = document.createElement("button");
-        btn.type = "button";
-        btn.id = NAV_ENTRY_ID;
-        btn.className = "dru-nav-remote";
-        btn.setAttribute("data-dru-remote", "1");
-        // 🎨 侧栏入口在面板之外，拿不到面板根上的令牌 → 自己也挂一份主题属性
-        btn.setAttribute("data-dru-theme", themeGet());
-        themeState.navEl = btn;
-        // 入口常驻，所以它自己就是主题观察器的一个订阅者：
-        // 用户切深色时（哪怕面板没开着）这里也要立刻跟上。
-        themeStartWatch();
-        btn.title = "打开「远程访问」设置(快捷入口)";
-        btn.style.position = "relative";
-        btn.textContent = "📱 远程访问";
-        btn.addEventListener("click", function (e) {
-          try { e.stopPropagation(); e.preventDefault(); } catch (err) {}
-          dotMarkSeen(); // 用过快捷入口=已了解入口位置 → 关闭首次红点(含官方栏目红点)
-          openRemoteSettings();
-        });
-        wrap.insertBefore(btn, host);
-        // 徽标优先于首次引导红点：两者落点相同（右上角），同时挂会叠在一起。
-        // 有未读公告时"有多少条内容"比"你还没点过我"更值得占那个位置；红点本来也只到用户点一次为止。
-        var badgeOn = !!(annState.ok && annState.bubble && annState.unread > 0);
-        if (!dotSeen() && !badgeOn) {
-          var d = document.createElement("span");
-          d.className = "dru-nav-remote-dot";
-          btn.appendChild(d);
+    /**
+     * 打开「远程访问」栏目的入口（供官方槽位里的按钮调用）。
+     * 由下面的导航模块赋值 —— 让"入口在哪渲染"与"点了怎么打开"彻底解耦。
+     */
+    var remoteNavOpen = null;
+
+    /* 📱 侧栏底部的「远程访问」入口（2026-10-10 三修：改用**官方槽位**）。====================
+       前两次都栽在"自己找 DOM 落点"上：
+         · 一修前：按文案包含「设置」找锚点 → 命中的是设置面板里的「通用设置」→ 按钮跑到设置面板顶部；
+         · 二修：改成只认 aria-haspopup="dialog" 且必须在弹层外 → 桌面端侧栏那颗齿轮不满足
+           navCellLike，于是**干脆不注入**（业主看到的就是"那个位置是空的"）。
+       而宿主本来就为这个位置提供了官方列表槽 `sidebar.footer.action`（0.1.x 与 0.2 都有；
+       0.2 实测该槽就在侧栏底部、且**当前是空的**）—— 位置、宽度、折叠态全由宿主负责。
+       所以这里不再注入任何 DOM，直接注册进槽位。id 仍保留 `dru-nav-remote`：
+       公告徽标 / 首次红点那套按 id 取节点的既有逻辑因此不用改。 */
+    function RemoteNavEntry(props) {
+      var wide = !(props && props.wide === false);
+      var seenArr = useState(false);
+      var clicked = seenArr[0];
+      var setClicked = seenArr[1];
+      var showDot = !clicked && !dotSeen();
+      return h("button", {
+        type: "button",
+        id: NAV_ENTRY_ID,
+        className: "dru-foot-entry",
+        title: "打开「远程访问」设置",
+        "data-dru-remote": "1",
+        onClick: function (e) {
+          try { e.preventDefault(); } catch (err) { /* 忽略 */ }
+          setClicked(true);
+          dotMarkSeen();                       // 用过入口 = 已了解位置 → 收起首次红点
+          if (remoteNavOpen) remoteNavOpen();
         }
-        annRenderNavBadge();
-      } catch (e) { /* 忽略 */ }
+      }, [
+        h("span", { className: "ico", key: "ico" }, "📱"),
+        wide ? h("span", { className: "lbl", key: "lbl" }, "远程访问") : null,
+        showDot ? h("span", { className: "dru-nav-remote-dot", key: "dot" }) : null
+      ]);
     }
-    /** 常驻确保：官方「设置」按钮出现后在它前面挂一次入口(去重；2s 心跳，成本极低)。 */
+
     function navEnsureStart() {
       if (window.__dshRemoteNavStarted) return;
       window.__dshRemoteNavStarted = true;
       try { window.__dshRemoteNav = { open: openRemoteSettings }; } catch (e) {}
-      var iv = setInterval(function () {
-        try {
-          if (document.getElementById(NAV_ENTRY_ID)) return; // 已注入
-          var host = pickNavByToken("设置");
-          if (host) mountNavEntry(host);
-        } catch (e) { /* 忽略 */ }
-      }, 2000);
-      try { if (iv && typeof iv.unref === "function") iv.unref(); } catch (e) {} // node 测试环境不阻塞退出
+      // ⚠️ 这里**不再**做 DOM 注入（见 RemoteNavEntry 的注释）：入口由官方槽位渲染。
+      //    保留本函数只为实现"继续暴露 window.__dshRemoteNav"（老调用方与诊断仍在用）。
+      try { if (typeof openRemoteSettings === "function") remoteNavOpen = openRemoteSettings; } catch (e) { /* 忽略 */ }
     }
 
     // ══ 📣 公告（0.6.18）模块级状态 ═══════════════════════════════════════════
@@ -5673,6 +5761,22 @@ window.__ModuleLoader__.load({
       // 【0.6.11】本插件在这个槽里**只有一个栏目**（📱 远程访问）：🤖 微信机器人原先以 order 31
       // 注册成第二个栏目，业主口径「不要给它单独弄一个菜单，直接放到面板里面」→ 已改成面板里的
       // 第三个 tab（renderMainTabs / renderWeChat）。不要再往这个槽里加第二个 register。
+      /* 📱 侧栏底部的快捷入口 —— 官方列表槽 `sidebar.footer.action`（2026-10-10 三修）。
+         这个槽由 `@deepseek-ai/dsh-client-ui-sidebar` 声明，渲染在侧栏底部的 footerActions 里
+         （在「设置」那一行的上方、与「意见反馈/登录/更多」同属底部区域）。0.1.x 与 0.2 都有该槽，
+         0.2 实测此槽当前为空 —— 正合业主"就要放那个位置"的要求，而且不用我们再猜任何 DOM。
+         order 60：排在该槽内既有条目之后（宿主自己的条目不带 order，按注册序在前）。
+         老宿主若没有这个槽，`inject` 会静默不生效（不会抛）——面板内的 settings.section 入口仍在。 */
+      try {
+        ctx.slots.inject("sidebar.footer.action", function () {
+          return ctx.slots.register({
+            name: "sidebar.footer.action",
+            id: "dsh-remote-nav",
+            order: 60,
+            label: function () { return "远程访问"; }
+          }, RemoteNavEntry);
+        });
+      } catch (eFootSlot) { /* 老宿主没有这个槽：忽略，面板入口仍然可用 */ }
       ctx.slots.inject("settings.section", function () {
         var d1 = ctx.slots.register({
           name: "settings.section",
@@ -5708,7 +5812,7 @@ window.__ModuleLoader__.load({
       try {
         // 侧栏徽标的 DOM 订阅者（非 React）：store 一变就重画徽标。
         // 即便入口按钮此刻还没注入（官方「设置」按钮尚未出现），订阅本身也是零成本的 ——
-        // mountNavEntry 挂上按钮时会主动画一次。
+        // RemoteNavEntry 挂上按钮时会主动画一次。
         annSubscribe(annRenderNavBadge);
         annPullOnce();
       } catch (e) { /* 静默降级：不显示公告入口/徽标，页面照常 */ }
@@ -5718,7 +5822,7 @@ window.__ModuleLoader__.load({
       // 侧栏「远程访问」快捷入口（2026-09 恢复注入：与官方「设置」按钮共存不遮挡）
       navEnsureStart();
       // 🎨 主题：**不在这里**建 observer —— 观察器只在真有订阅者时才创建
-      // （面板/弹窗挂载 → themeSubscribe；侧栏入口挂上 → mountNavEntry）。
+      // （面板/弹窗挂载 → themeSubscribe；侧栏入口挂上 → RemoteNavEntry）。
       // 这样「没有任何东西需要跟随主题」时不会白留一个 MutationObserver，
       // 也避免与本插件已有的红点观察器互相干扰。