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

package/clients/dsh-remote/test/mobile-adapter-runtime.test.mjs

@@ -91,8 +91,16 @@ class El {
   get isConnected() { return true; }
 }
 
-/** 搭一个最小 dsh web 环境：frame（带官方 data 属性）内含 sidebar/center 两列 + 可选官方 toggle。 */
-function harness({ collapsedAttr = undefined, detailsAttr = undefined, sidebarRect = null, width = 390, withToggle = true } = {}) {
+/**
+ * 搭一个最小 dsh web 环境：frame（带官方 data 属性）内含 sidebar/center 两列 + 可选官方 toggle。
+ *
+ * `variant: "rc2"` 复刻**官方 0.1.5-rc.2 起**的 DOM：第三列由 `details` 改名 `rightbar`
+ * （`data-details-collapsed` → `data-rightbar-collapsed`、`pI_x6G_detailsCol` → `pI_x6G_rightbarCol`），
+ * 且 `overlayLayer`（官方 shell.overlay 宿主，`inset:0` 全屏、`data-shell-overlay`）留在 frame 末尾、
+ * 折叠时**没有拖拽把手**——这正是 2026-09-19 线上"整屏遮罩"的现场结构。
+ */
+function harness({ collapsedAttr = undefined, detailsAttr = undefined, sidebarRect = null, width = 390, withToggle = true,
+  variant = "rc1", rightbarAttr = undefined, overlayRect = null, rightbarRect = null } = {}) {
   const html = new El("html");
   // HOSTISH 门禁会读 documentElement.outerHTML 找官方特征（__ModuleLoader__ / DeepSeek Harness）
   html.outerHTML = '<html><head><script>window.__ModuleLoader__ = { mode: "queue" }</script>'
@@ -107,6 +115,17 @@ function harness({ collapsedAttr = undefined, detailsAttr = undefined, sidebarRe
   if (sidebarRect) sidebar._rect = sidebarRect;
   frame.appendChild(sidebar);
   frame.appendChild(center);
+  let rightbar = null;
+  let overlay = null;
+  if (variant === "rc2") {
+    if (rightbarAttr !== undefined) frame.setAttribute("data-rightbar-collapsed", rightbarAttr);
+    rightbar = new El("div", { class: "pI_x6G_rightbarCol" });
+    if (rightbarRect) rightbar._rect = rightbarRect;
+    frame.appendChild(rightbar);
+    overlay = new El("div", { class: "pI_x6G_overlayLayer", "data-shell-overlay": "" });
+    if (overlayRect) overlay._rect = overlayRect;
+    frame.appendChild(overlay);
+  }
   const toggle = new El("button");
   toggle.setAttribute("aria-label", "打开侧边栏");
 
@@ -127,7 +146,7 @@ function harness({ collapsedAttr = undefined, detailsAttr = undefined, sidebarRe
     addEventListener() {},
     querySelector(sel) {
       const s2 = String(sel);
-      if (s2.includes(".pI_x6G_frame") || s2.includes("[data-sidebar-collapsed], [data-details-collapsed]") || s2.includes("[data-shell-overlay]")) return frame;
+      if (s2.includes(".pI_x6G_frame") || /\[data-(sidebar|details|rightbar)-collapsed\]/.test(s2) || s2.includes("[data-shell-overlay]")) return frame;
       if (s2.includes("aria-label=")) return withToggle ? toggle : null;
       if (s2.includes(".hHd-Xa_toggle")) return withToggle ? toggle : null;
       if (s2.includes("hHd-Xa")) return sidebar; // 子列识别用（真实页面里这是侧栏）
@@ -154,12 +173,15 @@ function harness({ collapsedAttr = undefined, detailsAttr = undefined, sidebarRe
     MutationObserver: class { observe() {} disconnect() {} },
     ResizeObserver: class { observe() {} disconnect() {} },
   };
+  // 真实浏览器里 window.location 必然存在（注入层用 location.assign/href 跳转），假 DOM 也要有
+  const loc = { href: "https://n.risegao.cn:13443/remote/dev-x/", host: "n.risegao.cn", pathname: "/remote/dev-x/", origin: "https://n.risegao.cn:13443" };
+  win.location = loc;
   const ctx = vm.createContext({
     window: win, document: doc, console, setTimeout: win.setTimeout, clearTimeout: win.clearTimeout,
     setInterval: () => 0, clearInterval() {}, MutationObserver: win.MutationObserver,
     ResizeObserver: win.ResizeObserver, requestAnimationFrame: win.requestAnimationFrame,
     navigator: { userAgent: "iPhone Safari", maxTouchPoints: 5, platform: "iPhone" },
-    location: { href: "https://n.risegao.cn:13443/app/", host: "n.risegao.cn" },
+    location: loc,
     localStorage: win.localStorage, URL, Date, Math, JSON, Object, Array, String, Number, RegExp, Boolean, Promise, Error, isNaN, parseInt, parseFloat,
     HTMLElement: El, // 脚本用 `c instanceof HTMLElement` 过滤 frame 的子列
   });
@@ -170,7 +192,7 @@ function harness({ collapsedAttr = undefined, detailsAttr = undefined, sidebarRe
   ctx.console = dbgConsole;
   ctx.globalThis = ctx;
   ctx.self = win;
-  return { ctx, html, body, frame, sidebar, toggle, win };
+  return { ctx, html, body, frame, sidebar, rightbar, overlay, toggle, win };
 }
 
 const ADAPTER_DEBUG = process.env.DSH_ADAPTER_DEBUG === "1";
@@ -260,48 +282,83 @@ test("运行时：能拿到官方 toggle 时，点遮罩仍走官方 toggle（
   assert.ok(env.toggle._clicked >= 1, "应点击官方 toggle");
 });
 
-// ── 字号档位（2026-09-16 需求：4 档滑块、仅手机端生效） ──────────────────────
+// ── 远程控制悬浮按钮（2026-09-19：字号 + 加密小锁 + 返回设备列表，三合一） ──────
+//
+// 用户要求：「把字体的菜单和加密小锁的菜单合并成一个小悬浮按钮；点击后可以弹菜单调节字体，
+// 也可以返回设备列表，让用户主动返回回去；手机端要有，电脑端也可以有。」
 
-const findFsBtn = (env) => env.body.children.find((c) => c._cls.has("dsh-ma-fsbtn"));
-const findFsPanel = (env) => env.body.children.find((c) => c._cls.has("dsh-ma-fspanel"));
+const findFab = (env) => env.body.children.find((c) => c._cls.has("dsh-ma-fab"));
+const findMenu = (env) => env.body.children.find((c) => c._cls.has("dsh-ma-menu"));
 
-test("字号：菜单/字号按钮与面板都应创建（面板默认收起）", () => {
+test("悬浮菜单：按钮与菜单都创建，菜单默认收起", () => {
   const env = runAdapter(harness({}));
-  const btn = findFsBtn(env);
-  const panel = findFsPanel(env);
-  assert.ok(btn, "应有字号按钮");
-  assert.ok(panel, "应有字号面板");
-  assert.equal(panel.hidden, true, "面板默认收起（点按钮才展开）");
-  assert.ok((panel.querySelector ? panel : {}).querySelector === undefined || true);
+  const fab = findFab(env);
+  const menu = findMenu(env);
+  assert.ok(fab, "应有悬浮按钮");
+  assert.ok(menu, "应有菜单面板");
+  assert.equal(menu.hidden, true, "菜单默认收起（点按钮才展开）");
 });
 
-test("字号：默认档 = 最小（不加缩放属性，保持当前大小）", () => {
+test("悬浮菜单：点按钮开合菜单", () => {
   const env = runAdapter(harness({}));
-  assert.equal(env.html.getAttribute("data-dsh-ma-fs"), null, "默认不应带缩放属性");
-  assert.equal(env.win.localStorage.getItem("dsh-ma-font-scale"), null);
+  const fab = findFab(env);
+  const menu = findMenu(env);
+  fab.dispatch("click");
+  assert.equal(menu.hidden, false, "点按钮应展开菜单");
+  fab.dispatch("click");
+  assert.equal(menu.hidden, true, "再点应收起");
 });
 
-test("字号：滑块改档 → 属性/正文变量/持久化都生效", () => {
+test("悬浮菜单：字号档位仍生效（属性/正文变量/持久化）", () => {
   const env = runAdapter(harness({}));
-  const panel = findFsPanel(env);
-  const range = panel && panel.querySelector && panel.querySelector('input[type="range"]');
-  assert.ok(range, "面板里应有 range 滑块");
-  // 打到「大」(level 2)
+  const menu = findMenu(env);
+  const range = menu.querySelector('input[type="range"]');
+  assert.ok(range, "菜单里应有字号滑块");
   range.value = "2";
   range.dispatch("input");
   assert.equal(env.html.getAttribute("data-dsh-ma-fs"), "2", "应写入缩放属性（CSS 据此放大字号）");
-  assert.equal(env.win.localStorage.getItem("dsh-ma-font-scale"), "2", "应持久化到 localStorage");
-  const contentVar = env.html.style["--dsh-content-font-size"] || env.html._cssVars && env.html._cssVars["--dsh-content-font-size"];
-  assert.ok(contentVar, "应同步官方正文变量 --dsh-content-font-size（聊天正文才会变大）");
+  assert.equal(env.win.localStorage.getItem("dsh-ma-font-scale"), "2", "应持久化");
+  const contentVar = (env.html._cssVars || {})["--dsh-content-font-size"];
+  assert.ok(contentVar, "应同步官方正文变量 --dsh-content-font-size");
+  range.value = "0";
+  range.dispatch("input");
+  assert.equal(env.html.getAttribute("data-dsh-ma-fs"), null, "回到「最小」应移除缩放属性");
 });
 
-test("字号：恢复「最小」时移除缩放属性（回到当前大小）", () => {
+test("悬浮菜单：必须有「返回设备列表」，且回到 /app/（用户在镜像页的唯一主动退路）", () => {
   const env = runAdapter(harness({}));
-  const panel = findFsPanel(env);
-  const range = panel.querySelector('input[type="range"]');
-  range.value = "3"; range.dispatch("input");
-  assert.equal(env.html.getAttribute("data-dsh-ma-fs"), "3");
-  range.value = "0"; range.dispatch("input");
-  assert.equal(env.html.getAttribute("data-dsh-ma-fs"), null, "level 0 = 最小 → 不应留缩放属性");
-  assert.equal(env.win.localStorage.getItem("dsh-ma-font-scale"), "0");
+  const menu = findMenu(env);
+  const back = menu.querySelector(".dsh-ma-menu-back");
+  assert.ok(back, "菜单里必须有返回设备列表按钮");
+  back.dispatch("click");
+  assert.equal(env.ctx.location.href, "/app/", "点击后应跳到 APP 外壳（绝对路径，不能依赖当前镜像路径）");
+});
+
+test("悬浮菜单：E2EE 状态可合并（shim 在场时隐藏独立药丸并读它的状态）", () => {
+  const env = harness({});
+  env.win.__dshE2eeBadge = { state: () => ({ mode: "warn", text: "未加密（刷新后需重新解锁）" }) };
+  runAdapter(env);
+  assert.equal(env.html.getAttribute("data-dsh-ma-merged-e2ee"), "1",
+    "shim 在场时应挂牌合并（CSS 据此隐藏官方那颗独立药丸）");
+});
+
+test("多端适配：悬浮按钮与字号样式的 CSS 必须在 @media(max-width:820px) 之外（电脑端也要有）", () => {
+  const { html } = injectMobileAdapter("<!doctype html><html><head></head><body></body></html>");
+  const css = /<style id="[^"]*-css"[^>]*>([\s\S]*?)<\/style>/.exec(html)[1];
+  // 只保留 @media 之外的规则（做一次括号配平剥离），再断言关键选择器还在
+  let out = "", i = 0, depth = 0, inMedia = false;
+  while (i < css.length) {
+    if (css.startsWith("@media", i)) {
+      const open = css.indexOf("{", i);
+      let d = 1, j = open + 1;
+      while (j < css.length && d > 0) { if (css[j] === "{") d++; else if (css[j] === "}") d--; j++; }
+      i = j;
+      continue;
+    }
+    out += css[i++];
+  }
+  assert.match(out, /button\.dsh-ma-fab\s*\{/, "悬浮按钮样式必须在媒体查询之外（电脑端可见）");
+  assert.match(out, /div\.dsh-ma-menu\s*\{/, "菜单样式必须在媒体查询之外");
+  assert.match(out, /html\[data-dsh-ma-fs="3"\]/, "字号档位样式也应在媒体查询之外（电脑端同样生效）");
+  assert.match(out, /z-index:\s*40[01]/, "悬浮按钮/菜单层级要高于遮罩(290)，遮罩异常时仍是自救出口");
 });

package/dsh-setup.mjs

@@ -257,6 +257,35 @@ const SERVICE_PATH = "/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin:/usr/sbin:/
 const INSTALL_SOURCE = String(process.env.DSH_BRIDGE_INSTALL_SOURCE || "").trim() || "npx";
 const INSTALL_VERSION = String(process.env.DSH_BRIDGE_INSTALL_VERSION || "").trim() || pkgVersion();
 
+/**
+ * 把文件权限收紧到「只有本人可读写」。
+ *
+ * ⚠️ Windows 上 `{ mode: 0o600 }` 是**空操作**（Windows 用 ACL，不是 POSIX mode 位）：
+ * 实测 .dsh-config.json 拿到的是用户目录的默认**继承 ACL**（AreAccessRulesProtected=False），
+ * 也就是说代码里那句 0600 对 Windows 用户完全没效果 —— 而文件里是**明文账号密码**。
+ * 风险不在"同机他人可读"（默认 ACL 下其实读不到），而在**任何按文件复制的场景**
+ * （备份/同步盘/杀软上报/崩溃转储/用户发给作者的支持包）都会连钥匙一起被带走，
+ * 而文档里的"0600 请妥善保护"会让用户误以为 Windows 上已有这层保护。
+ * 这里显式断开继承、只授予当前用户；失败只警告一次，绝不影响主流程。
+ */
+let hardenWarned = false;
+function hardenFile(file) {
+  try { fs.chmodSync(file, 0o600); } catch { /* POSIX 上失败不致命 */ }
+  if (process.platform !== "win32") return;
+  const who = [process.env.USERDOMAIN, process.env.USERNAME].filter(Boolean).join("\\");
+  if (!who) return;
+  let r;
+  try {
+    r = spawnSync("icacls", [file, "/inheritance:r", "/grant:r", `${who}:F`],
+      { windowsHide: true, encoding: "utf8", timeout: 8000 });
+  } catch (e) { r = { status: -1, stderr: e.message }; }
+  if (r.status !== 0 && !hardenWarned) {
+    hardenWarned = true;
+    console.warn(`⚠️ 收紧文件权限失败（${who}）：${String(r.stderr || "").trim() || `icacls 退出码 ${r.status}`}`);
+    console.warn("   配置文件可能仍可被其它账户/备份工具读取，请自行确认其存放位置。");
+  }
+}
+
 // ---------- 配置读写 ----------
 function loadConfig() {
   try { return JSON.parse(fs.readFileSync(CONFIG_PATH, "utf8")); }
@@ -265,6 +294,7 @@ function loadConfig() {
 function saveConfig(cfg) {
   fs.mkdirSync(CONFIG_DIR, { recursive: true });
   fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2), { mode: 0o600 });
+  hardenFile(CONFIG_PATH); // Windows 上 mode 是空操作 → 必须显式收紧 ACL（内含明文账号密码）
 }
 
 // ---------- 公共配置（从服务端取域名，服务商可随时更换） ----------
@@ -754,7 +784,7 @@ await delay(1000);
 try { process.kill(PLAN.pid); } catch (e) {}
 const deadline = Date.now() + 30000;
 while (Date.now() < deadline && alive(PLAN.pid)) await delay(200);
-if (alive(PLAN.pid)) spawnSync("taskkill", ["/PID", String(PLAN.pid), "/T", "/F"], { windowsHide: true });
+if (alive(PLAN.pid)) spawnSync("taskkill", ["/PID", String(PLAN.pid), "/T", "/F"], { windowsHide: true, timeout: 8000 });
 let out = "ignore";
 try { out = openSync(PLAN.log, "a"); } catch (e) {}
 const child = spawn(PLAN.argv[0], PLAN.argv.slice(1), { detached: true, stdio: ["ignore", out, out], windowsHide: true });
@@ -833,11 +863,37 @@ dsh-remote：独立的本地设置页已移除。
 `);
 }
 
+/**
+ * 账号指纹：账号 / 模式 / 设备身份任一变化都意味着"必须用新凭据重新登记"。
+ * 为什么需要：bridge 的 DSH_BRIDGE_PHONE/PASSWORD 是**进程启动时**从环境变量固化的，
+ * 配置改了并不会影响已在跑的进程 —— 这是"切换账号后设备仍留在旧账号"的根因之一。
+ */
+function accountFingerprint(cfg) {
+  const c = cfg || {};
+  return [c.local_key ? "local" : "saas", c.phone || c.email || "", String(c.device_id || ""), String(c.local_key || "")].join("|");
+}
+
+/**
+ * 服务端登录限流的"最早可重试时刻"（bridge 在收到 429 时落盘）。
+ * 为什么需要：限流窗口是 15 分钟，而 watcher 每 10 秒就会重新拉起 bridge ——
+ * 不读这个文件就是 90 次空撞（日志刷屏、还可能拖长窗口）。它只是**退避提示**，绝不阻止正常启动。
+ */
+const LOGIN_RATELIMIT_FILE = ".dsh-login-ratelimited";
+function loginRateLimitUntil() {
+  const f = path.join(CONFIG_DIR, LOGIN_RATELIMIT_FILE);
+  try {
+    const until = Number(String(fs.readFileSync(f, "utf8")).trim());
+    if (Number.isFinite(until) && until > Date.now()) return until;
+    fs.rmSync(f, { force: true }); // 已过期：清掉，恢复正常启动
+  } catch { /* 无文件 = 未限流 */ }
+  return 0;
+}
+
 // ---------- run：前台跑 bridge（带配置 + 自启动 watcher） ----------
 async function runBridge() {
-  // Windows 去重：登录任务（Task Scheduler）与插件半的自愈都可能拉起 watcher，
-  // 两个 bridge 会抢同一个设备登记 → 这里以 pid 文件为准，已有守护在跑就直接退出。
-  if (IS_WIN) {
+  // 去重（所有平台）：自启动服务、登录任务、插件半的脱离进程兜底都可能拉起 watcher，
+  // 两个 bridge 会抢同一个设备登记 → 以 pid 文件为准，已有守护在跑就直接退出。
+  {
     const other = readPidFile(WATCHER_PID_FILE);
     if (other && other !== process.pid && pidAlive(other)) {
       console.log(`[dsh-remote] 已有一个 bridge 守护在运行（pid=${other}），本进程直接退出，避免重复实例。`);
@@ -846,6 +902,10 @@ async function runBridge() {
   }
   let cfg = loadConfig();
   let warnedNoLogin = false;
+  /** 当前 bridge 子进程使用的账号指纹（账号/模式/设备身份任一变化 → 重启子进程）。 */
+  let bridgeAccountFp = "";
+  /** 限流提示只打一次，避免刷屏。 */
+  let warnedRateLimit = false;
 
   // watcher：检测 dsh web（127.0.0.1:3080）存活，存活才启动 bridge
   const checkUpstream = () => new Promise((resolve) => {
@@ -887,6 +947,28 @@ async function runBridge() {
     }
     const apiUrl = saas ? (cfg.api_url || DEFAULT_API) : "";
 
+    // 账号/模式/设备身份变了 → 必须重启 bridge（它的凭据是启动时从环境变量固化的）。
+    // 没有这一条时：面板切了账号、旧 bridge 却继续用旧账号跑，新账号的设备列表里看不到这台机器
+    //（2026-09-19 实测事故）。
+    const fp = accountFingerprint(cfg);
+    if (!childStopped(bridgeProc) && bridgeAccountFp && bridgeAccountFp !== fp) {
+      console.log("[dsh-remote] 账号配置已变化 → 重启 bridge 让新账号生效...");
+      try { bridgeProc.kill(); } catch { /* 已退出 */ }
+      bridgeAccountFp = "";
+      return; // 下一轮（10s 内）用新配置重新拉起
+    }
+
+    // 服务端登录限流窗口内不反复拉起 bridge（凭据没错，改了也没用）
+    const rlUntil = loginRateLimitUntil();
+    if (rlUntil > Date.now()) {
+      if (!warnedRateLimit) {
+        warnedRateLimit = true;
+        console.log(`[dsh-remote] 登录被服务端限流，约 ${Math.ceil((rlUntil - Date.now()) / 1000)} 秒后自动重试（凭据无需修改）。`);
+      }
+      return;
+    }
+    warnedRateLimit = false;
+
     const alive = await checkUpstream();
     if (alive && childStopped(bridgeProc)) {
       starting = true;
@@ -914,7 +996,8 @@ async function runBridge() {
       });
       // Windows：落 pid 文件，供插件半发现进程（Windows 没有 pgrep/ps）。
       // 插件半启动 bridge 走的就是本函数，所以这里写一次两边都覆盖到。
-      if (IS_WIN) writePidFile(BRIDGE_PID_FILE, bridgeProc.pid);
+      writePidFile(BRIDGE_PID_FILE, bridgeProc.pid); // 供插件半发现进程（Windows 无 pgrep；POSIX 用于脱离进程兜底的去重）
+      bridgeAccountFp = fp; // 记下这个子进程用的是哪套凭据，配置一变就重启它
       setTimeout(() => { starting = false; }, 5000);
     } else if (!alive && bridgeProc && bridgeProc.exitCode === null) {
       console.log("[dsh-remote] dsh web 离线，停止 bridge...");
@@ -922,8 +1005,8 @@ async function runBridge() {
     }
   };
 
-  // Windows：watcher 自身的 pid 也要落盘（插件半据此判断"守护在跑"并避免重复拉起）
-  if (IS_WIN) {
+  // watcher 自身的 pid 也要落盘（插件半据此判断"守护在跑"并避免重复拉起）
+  {
     writePidFile(WATCHER_PID_FILE, process.pid);
     const cleanup = () => { removePidFile(WATCHER_PID_FILE); removePidFile(BRIDGE_PID_FILE); };
     process.on("exit", cleanup);
@@ -1328,6 +1411,48 @@ function validatePatchBase(text) {
   return { ok: true, cleaned, insertedIds: ids };
 }
 
+/**
+ * patch 文本是否是「合法的顶层 YAML 数组文档」。
+ *
+ * 为什么必须判：dsh 侧解析 cordis.patch.yml 时**要求顶层是数组**，而
+ * **纯注释文档的 YAML 解析结果是 `null`（不是空数组）**，于是 dsh 直接启动失败：
+ *   `Error: dsh: overlay …/cordis.patch.yml must be a top-level YAML array of loader patch entries`
+ * 官方空 profile 模板（dsh-app-boot）正是「注释 + `[]`」——`[]` 这个占位符不能省。
+ * 现场（2026-09-18 Windows 用户实测）：卸载把插件条目摘掉后只剩顶部注释，dsh web 再也起不来。
+ */
+/** 顶层（无缩进）非注释行 = YAML 的结构行；缩进行属于上一条目。 */
+function patchStructuralLines(text) {
+  return String(text ?? "")
+    .split(/\r?\n/)
+    .map((l) => l.replace(/\s+$/, ""))
+    .filter((l) => l.trim() !== "" && !/^\s*#/.test(l) && !/^[ \t]/.test(l));
+}
+
+/** 是否是合法的顶层数组文档（`[]` 占位，或若干 `-` 开头的顶层条目）。 */
+function isPatchArrayDocument(text) {
+  const roots = patchStructuralLines(text);
+  return roots.length > 0 && roots.every((l) => l === "[]" || l.startsWith("-"));
+}
+
+/** 只有注释/空行 → YAML 解析成 null（不是空数组），必须补 `[]` 占位，否则 dsh 起不来。 */
+function needsArrayPlaceholder(text) {
+  return patchStructuralLines(text).length === 0;
+}
+
+/**
+ * 写回 patch 文档，并**保证结果仍是合法顶层数组**：条目被删光时补回 `[]` 占位。
+ * 卸载、摘 include、回滚都必须走这里 —— 任何一条写路径漏了这步，用户就会拿到
+ * 一个「dsh web 起不来且面板也进不去」的 profile（只能靠 CLI 自救）。
+ */
+function writePatchDocument(patchFile, text) {
+  const body = String(text ?? "").replace(/\s+$/, "") + "\n";
+  // ⚠️ 只在「一个结构行都不剩」时补 —— 不能因为"看起来不像数组"就乱补，
+  //    那会把本来好的文件写坏（把 `[]` 追加到已有 insert 块后面 → YAML 直接报错）。
+  const fixed = needsArrayPlaceholder(body) ? `${body}[]\n` : body;
+  writePatchAtomic(patchFile, fixed);
+  return fixed;
+}
+
 /** 安全写回 patch（原子：先写同目录临时文件再 rename，避免中途被打断留下半截文件）。 */
 function writePatchAtomic(patchFile, text) {
   const tmp = `${patchFile}.dsh-remote.tmp`;
@@ -1384,7 +1509,7 @@ function ensurePatchActivation(patchFile, pluginLocalDir, pkgFile, opts = {}) {
         const merged2 = `${base2.cleaned ? base2.cleaned + "\n" : ""}\n${want}\n`;
         const chk = parsePatchInsertIds(merged2);
         if (!chk.badLines.length && chk.ids.filter((id) => id === PLUGIN_ID).length === 1) {
-          writePatchAtomic(patchFile, merged2);
+          writePatchDocument(patchFile, merged2);
           console.log(`✅ 已同步激活行的 relayDir → ${wantDir}`);
           return { ok: true, changed: true, basePatch: original };
         }
@@ -1407,18 +1532,18 @@ function ensurePatchActivation(patchFile, pluginLocalDir, pkgFile, opts = {}) {
   if (check.badLines.length || check.ids.filter((id) => id === PLUGIN_ID).length !== 1) {
     return { ok: false, reason: "合并后的 patch 校验未通过（未做改动）", changed: false, basePatch: original };
   }
-  writePatchAtomic(patchFile, merged);
+  writePatchDocument(patchFile, merged);
   const after = fs.readFileSync(patchFile, "utf8");
   const verify = parsePatchInsertIds(after);
   if (verify.badLines.length || verify.ids.filter((id) => id === PLUGIN_ID).length !== 1) {
-    writePatchAtomic(patchFile, original); // 回滚
+    writePatchDocument(patchFile, original); // 回滚
     return { ok: false, reason: "写入后校验失败，已回滚", changed: false, basePatch: original };
   }
   removeBundleEntry(pkgFile); // 单一激活点：bundles 里不能再有本插件
   // 双保险：上面那次移除若没生效（并发写 package.json / 解析失败），**回滚本次 patch 行**，
   // 宁可退回 bundles 形态（需重启）也绝不留"两处激活"→ dsh web 启动会 duplicate id 崩掉。
   if (pkgBundles().length) {
-    writePatchAtomic(patchFile, original);
+    writePatchDocument(patchFile, original);
     return { ok: false, reason: "bundles 条目未能移除，已回滚 patch 行以免重复激活", changed: false, bundleOnly: true, basePatch: original };
   }
   return { ok: true, changed: true, basePatch: original };
@@ -1428,7 +1553,7 @@ function ensurePatchActivation(patchFile, pluginLocalDir, pkgFile, opts = {}) {
 function stripIncludeEntries(patchFile, patch, reason) {
   const next = stripPluginEntries(patch);
   if (next === patch) return false;
-  writePatchAtomic(patchFile, next);
+  writePatchDocument(patchFile, next);
   console.log(`✅ 已移除 ${patchFile} 中的冗余 include（${reason}；激活点必须唯一，避免重复 ID 崩溃）`);
   return true;
 }

package/package.json

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

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

@@ -340,8 +340,35 @@ window.__ModuleLoader__.load({
     }
 
     // ── 宿主 API ────────────────────────────────────────────────────────────
-    function api(path, options) {
-      return fetch(path, options).then(function (res) {
+    /**
+     * 默认请求超时（0.6.7-beta.3 新增）。
+     * 背景（用户实测）：node 半一旦被同步子进程调用钉死（卸载时 spawnSync 卡在 schtasks 上），
+     * 请求**永远不会返回**，面板就对着一个永不结束的 spinner —— 用户只能猜。
+     * 现在超时后给出明确报错（并提示"这一步可能已经在后台完成了"），而不是无限转圈。
+     * 30s 足够覆盖最慢的正常路径（relay 6s + Windows 进程扫描 8s）。
+     */
+    var API_TIMEOUT_MS = 30000;
+    function api(path, options, timeoutMs) {
+      var opts = options || {};
+      var timer = null;
+      try {
+        if (typeof AbortController === "function") {
+          var ctrl = new AbortController();
+          var ms = typeof timeoutMs === "number" && timeoutMs > 0 ? timeoutMs : API_TIMEOUT_MS;
+          timer = setTimeout(function () { try { ctrl.abort(); } catch (e) { /* 忽略 */ } }, ms);
+          opts = Object.assign({}, opts, { signal: ctrl.signal });
+        }
+      } catch (e) { /* 无 AbortController 的旧环境：退化为无超时（不阻断使用） */ }
+      var done = function () { if (timer) { clearTimeout(timer); timer = null; } };
+      return fetch(path, opts).catch(function (e) {
+        // AbortError → 换成用户能看懂的话（并说明服务端可能已经做完了）
+        if (e && (e.name === "AbortError" || /abort/i.test(String(e.message || "")))) {
+          var te = new Error("请求超时（面板等不到本机响应）。这一步可能已经在后台完成了 —— 请刷新页面查看；若 dsh web 无响应，重启一次 dsh web 即可。");
+          te.timeout = true;
+          throw te;
+        }
+        throw e;
+      }).finally(done).then(function (res) {
         return res.text().then(function (text) {
           var body = null;
           try { body = JSON.parse(text); } catch (e) { body = null; }
@@ -358,6 +385,10 @@ window.__ModuleLoader__.load({
     var post = function (path, data) {
       return api(path, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(data || {}) });
     };
+    /** 带自定义超时的 POST（用于卸载这类"可能拖住"的操作）。 */
+    var postWithTimeout = function (path, data, timeoutMs) {
+      return api(path, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(data || {}) }, timeoutMs);
+    };
 
     // ── 交流群（二维码由图层面板上传统一配置,node 半经公开配置下发） ─────────
     // 设置面板「加入交流群」按钮与用户反馈页都展示同一张码;未配置(qrcode 为空)→ 不展示任何入口。
@@ -1066,7 +1097,9 @@ window.__ModuleLoader__.load({
         if (!armed) { setArmed(true); return; }
         setUnBusy(true);
         setSelfMsg(null);
-        post("/dsh-remote/self/uninstall", {}).then(function (b) {
+        // 卸载：服务端现在"先卸插件、先回响应、慢活交子进程"，正常应在 1 秒内返回；
+        // 给 20s 上界，超时也要给用户一句能照做的话（而不是永久转圈）。
+        postWithTimeout("/dsh-remote/self/uninstall", {}, 20000).then(function (b) {
           if (b && b.ok) {
             setArmed(false);
             // 优先展示服务端 detail（含 bridge 自启动/配置目录的逐项清理结果与重启提示）；
@@ -1079,7 +1112,7 @@ window.__ModuleLoader__.load({
           }
         }).catch(function (e) {
           setArmed(false);
-          setSelfMsg({ kind: "err", text: "卸载失败：" + e.message });
+          setSelfMsg({ kind: e && e.timeout ? "warn" : "err", text: (e && e.timeout ? "" : "卸载失败：") + e.message });
         }).finally(function () { setUnBusy(false); });
       };
 
@@ -1694,6 +1727,25 @@ window.__ModuleLoader__.load({
       // ---------- 登录(密码/短信) ----------
       var doLogin = function () {
         if (!phone.trim() || !pass) { setMsg("err", "请填写手机号与密码"); return; }
+      /**
+       * 账号落盘（POST /dsh-remote/config）后的统一提示。
+       *
+       * 为什么单独抽出来：这次"换账号后设备不出现"的事故就是**静默失败**造成的 ——
+       * /config 会顺带重启 bridge（让新账号生效），但其返回的 bridgeRestart 前端从来不看，
+       * 于是"服务没重启成功"和"一切正常"在界面上长得一模一样。
+       */
+      function applyAccountSaved(cfg, okText) {
+        setSt(cfg);
+        var br = cfg && cfg.bridgeRestart;
+        if (br && br.ok === false && br.status !== "running" && br.status !== "provisioning" && br.status !== "skipped") {
+          setMsg("warn", okText + "；但后台服务（bridge）未能自动重启："
+            + ((br.detail || br.status) || "未知原因")
+            + " —— 新账号可能收不到这台设备，请点下方「重启服务」或重启一次 dsh web。");
+          return;
+        }
+        setMsg("ok", okText);
+      }
+
         if (!lcap || !lcap.id || !lcapTxt.trim()) { setMsg("err", "请输入图中验证码（点击图片可刷新）"); if (!lcap) loadCaptcha("login"); return; }
         var prevPhone = (st && st.config && st.config.phone) || "";
         setBusy("login");
@@ -1704,8 +1756,8 @@ window.__ModuleLoader__.load({
                 // 切换连接账号（手机号与之前不同）：清除旧账号留下的反馈线程凭据
                 if (prevPhone !== phone.trim()) fbClearThreads();
                 setPwdOpen(false); // 登录成功（可能从「忘记密码」返回）→ 收起重置表单
-                setSt(cfg); setPass(""); setLcapTxt(""); setLcap(null);
-                setMsg("ok", "✅ 登录成功，账号已保存");
+                setPass(""); setLcapTxt(""); setLcap(null);
+                applyAccountSaved(cfg, "✅ 登录成功，账号已保存");
               });
             }
             var relayBody = body.body || {};
@@ -1758,9 +1810,8 @@ window.__ModuleLoader__.load({
             if (body.ok || body.status === 201 || (body.body && body.body.token)) {
               return post("/dsh-remote/config", { phone: rphone.trim(), password: rpass }).then(function (cfg) {
                 setPwdOpen(false);
-                setSt(cfg);
                 setRphone(""); setRpass(""); setRpass2(""); setRsms(""); setRcap(null); setRcapTxt(""); setRInvite("");
-                setMsg("ok", "✅ 注册成功，已自动登录");
+                applyAccountSaved(cfg, "✅ 注册成功，已自动登录");
               });
             }
             var b = body.body || {};