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

package/README.md

@@ -30,6 +30,12 @@ dsh-remote 是一个轻量的**隧道模式**远程控制方案：电脑端运
 
 ## 0.6.7 速览（Windows 可用版）
 
+> **预发中**：先以 `0.6.7-beta.x` 发布在 npm `beta` 通道（`latest` 仍是 0.6.6），
+> 待 Windows 真机验证通过后转正式版。安装预发版：
+> `npx @mrrisega/dsh-remote@0.6.7-beta.3`；若 dsh web 已起不来，用
+> `npx @mrrisega/dsh-remote@0.6.7-beta.3 repair`（只修 profile，不联网）。
+
+
 0.6.6 及更早的插件半整套「服务状态 / 启停 / 重启」是按 macOS/Linux 写死的
 （launchctl / systemd / pgrep / ps / /bin/sh），**在 Windows 上安装一切正常、运行期必死**：
 面板红字「读取状态失败: process.getuid is not a function」、状态永远停在「查询中…」、
@@ -154,8 +160,16 @@ npx @mrrisega/dsh-remote setup --server wss://<你的域名>:端口 --key <访
   校验值用于登录，与加密密钥域分离（详见 [docs/e2ee-protocol.md](docs/e2ee-protocol.md)）。
 - 请**牢记账号密码**：修改/重置密码会使全部旧设备会话失效，且服务端不保存你的内容、
   无法代为解密旧会话；改密后需在电脑端面板重新登录并重启 bridge，手机端重新解锁。
-- 电脑端本机配置（`.dsh-config.json`，0600）会保存账号密码用于自动登录，等于该账号
+- 电脑端本机配置（`.dsh-config.json`）会保存账号密码用于自动登录，等于该账号
   内容的“解密权”，请妥善保护电脑；电脑被他人使用期间请退出登录。
+  - macOS / Linux：文件权限 **0600**（仅本人可读写）。
+  - Windows：**`0600` 在 Windows 上无效**（Windows 用 ACL，不是 POSIX 权限位）——
+    早期版本只写了 `mode: 0o600`，实测该文件拿到的仍是用户目录的**默认继承 ACL**，
+    等于没有这层保护。0.6.7-beta.3 起安装器/插件/bridge 都会显式收紧：`icacls` 断开继承、
+    只授予当前用户。若收紧失败（无 icacls / 权限异常），安装日志会明确告警，不会假装成功。
+  - 无论哪个平台：**不要把 `.dsh-remote` 目录交给备份/同步盘/他人排查**——
+    里面的 `.dsh-config.json`（明文账号密码）与 `.harness-cookie.json`（dsh web 会话 Cookie，
+    等于该会话的完整访问权）被复制走就等于把钥匙一起给了对方。发支持包前请先删除这两项。
 
 **边界与建议（如实告知）**
 

package/clients/dsh-remote/dsh-bridge.mjs

@@ -65,7 +65,7 @@ import WebSocket from "ws";
 import fs from "node:fs";
 import os from "node:os";
 import path from "node:path";
-import { execSync } from "node:child_process";
+import { execSync, spawnSync } from "node:child_process";
 import { randomBytes, generateKeyPairSync, createHash } from "node:crypto";
 import { pathToFileURL, fileURLToPath } from "node:url";
 import { promisify } from "node:util";
@@ -200,10 +200,40 @@ function loadLocalConfig() {
   try { return JSON.parse(fs.readFileSync(CONFIG_PATH, "utf8")); } catch { return {}; }
 }
 
+/**
+ * 把文件权限收紧到「只有本人可读写」。
+ *
+ * ⚠️ 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 saveLocalConfig(cfg) {
   try {
     fs.mkdirSync(path.dirname(CONFIG_PATH), { recursive: true });
     fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2), { mode: 0o600 });
+    hardenFile(CONFIG_PATH); // Windows 上 mode 是空操作 → 显式收紧 ACL（内含明文账号密码）
   } catch (e) {
     console.warn(`[bridge] 无法写配置 ${CONFIG_PATH}: ${e.message}`);
   }

package/dsh-setup.mjs

@@ -161,6 +161,7 @@ function printHelp() {
   dsh-remote run          前台运行 bridge（调试）
   dsh-remote status       查看配置与服务状态
   dsh-remote plugin       手动安装 dsh web 远程控制插件（--uninstall 卸载）
+  dsh-remote repair       修复插件挂载（dsh web 起不来时用；只碰 profile，不联网）
   dsh-remote --help       显示本用法（等同 dsh-remote help）
 
 自建模式（可选）:
@@ -256,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")); }
@@ -264,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（内含明文账号密码）
 }
 
 // ---------- 公共配置（从服务端取域名，服务商可随时更换） ----------
@@ -753,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 });
@@ -1327,6 +1358,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`;
@@ -1383,7 +1456,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 };
         }
@@ -1406,18 +1479,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 };
@@ -1427,7 +1500,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;
 }
@@ -1473,34 +1546,143 @@ function copyPluginIntoProfile(profileDir, pluginDir) {
 }
 
 /** 把插件挂到 <profile>/node_modules/<PLUGIN_ID>(裸包名解析需要),指向拷贝目录;缺失/指错时重建。 */
+/**
+ * 判定 `node_modules/<PLUGIN_ID>` 是否**真的可用**。
+ *
+ * 判据绝不是"函数有没有抛错" —— 这是 0.6.7-beta.1 在 Windows 上翻车的根因：
+ * 非特权进程 + 开发者模式关闭时，`fs.symlinkSync(target, path, "dir")` 会**既不抛错也产不出可用链接**
+ * （实测：用户目录下留下一个空目录；%TEMP% 下什么都不留；同一位置两次运行一次报成功一次抛 UNKNOWN）。
+ * 于是"用 try/catch 探测能力"这个前提在 Windows 上根本不成立，写在其 catch 里的 junction 兜底永不执行。
+ *
+ * 这里只认 dsh 自己那条解析路径能不能走通：
+ *   ① 读得到 package.json 且 name 正确（cordis 加载器 + @deepseek-ai/dsh-client-modules 靠它读 dsh.client）；
+ *   ② 读得到 lib/index.js（节点半入口）；
+ *   ③ 要么 realpath 指回本地拷贝目录（链接形态），要么入口内容与本地拷贝逐字节一致（整目录拷贝形态）。
+ */
+function pluginLinkUsable(nmPlugin, pluginLocalDir) {
+  try {
+    const pkg = JSON.parse(fs.readFileSync(path.join(nmPlugin, "package.json"), "utf8"));
+    if (pkg.name !== PLUGIN_ID) return false;
+    if (!fs.existsSync(path.join(nmPlugin, "lib", "index.js"))) return false;
+  } catch { return false; }
+
+  let real = "";
+  try { real = fs.realpathSync(nmPlugin); } catch { /* 悬空链接 */ }
+  if (real) {
+    try { if (real === fs.realpathSync(pluginLocalDir)) return true; } catch { /* 本地目录不在 → 看内容 */ }
+  }
+  try {
+    return fs.readFileSync(path.join(nmPlugin, "lib", "index.js"), "utf8")
+      === fs.readFileSync(path.join(pluginLocalDir, "lib", "index.js"), "utf8");
+  } catch { return false; }
+}
+
+/**
+ * 把插件挂到 `<profile>/node_modules/<PLUGIN_ID>`。
+ *
+ * 规格：已就绪返回 false（幂等）、重建成功返回 true、**任何情况下都没能挂好就抛错**。
+ * 抛错是刻意的 —— 调用方必须据此中止安装：写进 patch 的激活行会让 dsh web 按裸包名解析这个目录，
+ * 解析不到就 `Cannot find package '...\node_modules\dsh-remote-web\index.js'`，
+ * 而 cordis 的插件树加载失败 = **整个 dsh web 起不来**（用户连面板都打不开，没有自助修复入口）。
+ * 宁可不装，也不能写出一个起不来的 profile。
+ */
 function ensurePluginLinked(profileDir, pluginLocalDir) {
   const nmDir = path.join(profileDir, "node_modules");
   const nmPlugin = path.join(nmDir, PLUGIN_ID);
+  if (!fs.existsSync(path.join(pluginLocalDir, "package.json"))) {
+    throw new Error(`本地插件拷贝缺失或不完整：${pluginLocalDir}（应含 package.json）`);
+  }
   fs.mkdirSync(nmDir, { recursive: true });
   // 清理历史名链接（node_modules/dsh-remote-ui），避免解析到旧拷贝
   for (const id of PLUGIN_LEGACY_IDS) {
     try { fs.rmSync(path.join(nmDir, id), { recursive: true, force: true }); } catch { /* ignore */ }
   }
+  if (pluginLinkUsable(nmPlugin, pluginLocalDir)) return false; // 已就绪（拷贝形态也算就绪）
+
+  // ⚠️ Windows 上**不要用 symlinkSync(...,'dir')**：非特权进程下它产不出可用链接，
+  //    而且抛不抛错不确定、失败时还会留下空目录残留 —— 兜底链会因此整条失效（实测）。
+  //    junction（目录联接）免特权、realpath 正确、require.resolve 与 ESM 裸包名解析都正常。
+  const attempts = process.platform === "win32"
+    ? [
+        ["junction", () => fs.symlinkSync(path.resolve(pluginLocalDir), nmPlugin, "junction")], // junction 只接受绝对路径
+        ["copy", () => fs.cpSync(pluginLocalDir, nmPlugin, { recursive: true })],
+      ]
+    : [
+        ["dir", () => fs.symlinkSync(pluginLocalDir, nmPlugin, "dir")],
+        ["copy", () => fs.cpSync(pluginLocalDir, nmPlugin, { recursive: true })],
+      ];
+
+  const failures = [];
+  for (const [how, run] of attempts) {
+    // 每支开始前先清残留：上一支"没抛错但留了个空目录"时，不清就会让下一支撞 EEXIST 而失败
+    //（这正是原实现三级兜底退化成一级的原因）。
+    try { fs.rmSync(nmPlugin, { recursive: true, force: true }); } catch { /* ignore */ }
+    let err = null;
+    try { run(); } catch (e) { err = e; }
+    if (pluginLinkUsable(nmPlugin, pluginLocalDir)) return true;
+    failures.push(`${how}: ${err ? err.message : "未抛错但落盘结果不可用（读不到 package.json / lib/index.js）"}`);
+  }
+  throw new Error(`插件挂载失败：${nmPlugin}\n   ${failures.join("\n   ")}`);
+}
+
+
+/**
+ * 独立验收：复刻 dsh 客户端模块系统的真实动作 —— 从 profile 目录按**裸包名**解析到本插件。
+ *
+ * 与 pluginLinkUsable 是两道独立的闸门：前者看文件在不在、是不是真指向目标；
+ * 这条走 Node 的解析器（exports 字段、symlink 跟随、pnpm 布局），是"面板能不能被注入"的前提
+ * （@deepseek-ai/dsh-client-modules 就是 require.resolve('<name>/package.json') 读 dsh.client）。
+ */
+function probePluginResolve(profileDir) {
+  const base = path.join(profileDir, "__dsh_resolve_probe.cjs");
+  // 必须**另起一个 node 进程**做这次解析，不能在本进程里 require.resolve：
+  // 实测（Node 25 / macOS）：本进程里只要先失败过一次裸包名解析（例如"修复前诊断"那次），
+  // 链接随后修好了，同一个进程里的裸包名解析**仍会持续失败**（子路径却正常）——
+  // 进程内的解析缓存会把假阴性一直带下去，让"修复后验收"误判成没修好、拒绝恢复激活。
+  // 另起进程同时也更忠实：dsh 启动时就是在一个全新进程里解析这些裸包名的。
+  const script = [
+    'const { createRequire } = require("node:module");',
+    `const req = createRequire(${JSON.stringify(base)});`,
+    "process.stdout.write(JSON.stringify({",
+    `  pkgPath: req.resolve(${JSON.stringify(`${PLUGIN_ID}/package.json`)}),`,
+    `  entry: req.resolve(${JSON.stringify(PLUGIN_ID)})`,
+    "}));",
+  ].join("\n");
   try {
-    if (fs.realpathSync(nmPlugin) === pluginLocalDir) return false;
-  } catch { /* 缺失/悬空 → 重建 */ }
-  try { fs.rmSync(nmPlugin, { recursive: true, force: true }); } catch { /* ignore */ }
-  try {
-    fs.symlinkSync(pluginLocalDir, nmPlugin, "dir");
-  } catch {
-    // Windows：普通目录符号链接需要管理员或"开发者模式"，非管理员时直接 EPERM。
-    // junction（目录联接）**不需要任何特权**，且 realpath 同样解析到目标，
-    // 所以放在符号链接与整目录拷贝之间——能让 Windows 用户也拿到"链接"语义（改一处即生效）。
-    let linked = false;
-    if (process.platform === "win32") {
-      try {
-        fs.symlinkSync(path.resolve(pluginLocalDir), nmPlugin, "junction"); // junction 只接受绝对路径
-        linked = true;
-      } catch { /* 退化到拷贝 */ }
+    const r = spawnSync(process.execPath, ["-e", script], { encoding: "utf8", timeout: 30_000, windowsHide: true });
+    if (r.error) return { ok: false, reason: `无法启动解析探测进程：${r.error.message}` };
+    if (r.status !== 0) {
+      const line = String(r.stderr || "").split("\n").find((l) => /MODULE_NOT_FOUND|ERR_|Error/.test(l)) || "解析失败";
+      return { ok: false, reason: line.trim().slice(0, 200) };
     }
-    if (!linked) fs.cpSync(pluginLocalDir, nmPlugin, { recursive: true });
+    const out = JSON.parse(String(r.stdout || "{}"));
+    const pkg = JSON.parse(fs.readFileSync(out.pkgPath, "utf8"));
+    return {
+      ok: true,
+      pkgPath: out.pkgPath,
+      entry: out.entry,
+      name: pkg.name,
+      clientPlatform: (pkg.dsh && pkg.dsh.client && pkg.dsh.client.platform) || "",
+    };
+  } catch (e) {
+    return { ok: false, reason: `${e.code || e.name}: ${e.message}` };
   }
-  try { return fs.realpathSync(nmPlugin) === pluginLocalDir; } catch { return false; }
+}
+
+/**
+ * 描述插件在 profile 里的挂载形态（供 status / repair 输出）。
+ * 用户报障时这三行就能区分"链接坏了"与"别的毛病"——不必再靠猜。
+ * @returns {{localExists:boolean, exists:boolean, usable:boolean, kind:"missing"|"broken"|"linked"|"copy"|"no-local-copy"}}
+ */
+function describePluginLink(profileDir) {
+  const nmPlugin = path.join(profileDir, "node_modules", PLUGIN_ID);
+  const localDir = path.join(profileDir, PLUGIN_LOCAL_DIR);
+  const localExists = fs.existsSync(path.join(localDir, "package.json"));
+  if (!fs.existsSync(nmPlugin)) return { localExists, exists: false, usable: false, kind: localExists ? "missing" : "no-local-copy" };
+  const usable = pluginLinkUsable(nmPlugin, localDir);
+  let isLink = false;
+  try { isLink = fs.lstatSync(nmPlugin).isSymbolicLink(); } catch { /* ignore */ }
+  return { localExists, exists: true, usable, kind: usable ? (isLink ? "linked" : "copy") : "broken" };
 }
 
 /** package.json 写入 file: 依赖(让后续任何 pnpm/npm install 也认可该插件,不会删链接)。 */
@@ -1564,8 +1746,26 @@ function activateLocalCopy(profileDir, pkgFile, patchFile, pluginDir, patch, pkg
     console.error(`❌ 插件入口缺失：${entryFile}（本包不完整？请用官方源重装：npx --registry=https://registry.npmjs.org @mrrisega/dsh-remote@latest）`);
     process.exit(1);
   }
+  // ⚠️ 顺序与"失败即中止"都是刻意的（0.6.7-beta.1 Windows 实测事故）：
+  //   老代码把 ensurePluginLinked 的返回值丢掉、patch 照写、还打印「✅ 插件已就绪」，
+  //   于是用户拿到的是**起不来的 dsh web**（cordis 按裸包名解析到空目录 → plugin tree failed to load，
+  //   整个 dsh web 启动失败，而面板/插件市场都在那个进程里 → 用户没有任何自助修复入口）。
+  //   现在：先挂载 → 独立验收 → 才写依赖与激活行；任何一步不过就中止，绝不留下坏 profile。
+  try {
+    ensurePluginLinked(profileDir, pluginLocalDir);   // node_modules 链接(name 才能被解析)
+  } catch (e) {
+    console.error(`❌ ${e.message}`);
+    console.error("   已中止安装：继续写 patch 会让 dsh web 因插件树加载失败而完全无法启动。");
+    console.error("   请把上面的错误整段反馈给作者（含平台 / 是否管理员 / 开发者模式是否开启）。");
+    process.exit(1);
+  }
+  const probe = probePluginResolve(profileDir);
+  if (!probe.ok) {
+    console.error(`❌ 验收失败：dsh 无法从 profile 按裸包名解析 ${PLUGIN_ID}（${probe.reason}）`);
+    console.error("   已中止安装（未写 patch）：否则 dsh web 会因插件树加载失败而完全无法启动。");
+    process.exit(1);
+  }
   declarePluginDep(pkgFile);                        // file: 依赖(包管理器 install 不误删)
-  ensurePluginLinked(profileDir, pluginLocalDir);    // node_modules 链接(name 才能被解析)
   const r = ensurePatchActivation(patchFile, pluginLocalDir, pkgFile, { forcePatch: !!opts.forcePatch });
   if (r.ok) {
     console.log(`✅ 插件已就绪: ${pluginLocalDir}${opts.forcePatch ? "（激活点已转为 patch 行，装完即热加载）" : ""}`);
@@ -1602,6 +1802,34 @@ function readInstalledPluginVersion(profileDir, name) {
   } catch { return null; }
 }
 
+/**
+ * 识别 profile 用哪个包管理器（市场装法「一键更新」要用它改源码）。
+ *
+ * ⚠️ 不能用 `sh("command -v pnpm && echo pnpm || echo npm")`：`sh()` 走 execSync，
+ * Windows 下是 cmd.exe，而 `command` 是 POSIX 内建 → 永远命中 `||` 分支，
+ * **Windows 上永远选 npm**。而 dsh profile 是 pnpm 管理的（pnpm-workspace.yaml + 虚拟 store），
+ * 用 npm 去改同一个 node_modules 会写出与 pnpm 不同的布局（污染/冲突风险）。
+ * 现在：先用**声明文件**判断（最可靠、零子进程），再用 where/which 探测可执行文件；
+ * 兜底选 pnpm 而不是 npm —— dsh profile 默认就是 pnpm，选错方向的代价不对称。
+ */
+function detectPackageManager(profileDir) {
+  try {
+    if (fs.existsSync(path.join(profileDir, "pnpm-lock.yaml"))
+      || fs.existsSync(path.join(profileDir, "pnpm-workspace.yaml"))) return "pnpm";
+    if (fs.existsSync(path.join(profileDir, "package-lock.json"))) return "npm";
+  } catch { /* 读不到就往下探测 */ }
+  const has = (bin) => {
+    try {
+      return process.platform === "win32"
+        ? spawnSync("where", [bin], { stdio: "ignore", windowsHide: true }).status === 0
+        : spawnSync("sh", ["-c", `command -v ${bin}`], { stdio: "ignore" }).status === 0;
+    } catch { return false; }
+  };
+  if (has("pnpm")) return "pnpm";
+  if (has("npm")) return "npm";
+  return "pnpm";
+}
+
 /**
  * 市场装法下把插件包升到最新。
  *
@@ -1615,7 +1843,7 @@ function readInstalledPluginVersion(profileDir, name) {
 function upgradeMarketManagedPlugin(profileDir, name, dep) {
   const spec = String(dep ?? "").trim();
   const isRegistryRange = /^[\^~><=v\d]/.test(spec);
-  const pm = sh("command -v pnpm >/dev/null 2>&1 && echo pnpm || echo npm").stdout.trim() || "npm";
+  const pm = detectPackageManager(profileDir);
   const args = isRegistryRange ? `add ${name}@latest` : `update ${name}`;
   const cmd = `${pm} ${args}`;
   const r = sh(cmd, 180000, profileDir);
@@ -1734,6 +1962,83 @@ async function pluginCmd(argv) {
   // 引导语只在 setup 汇总里打印一次(这里不再重复;单独跑 `dsh-remote plugin` 也无需引导)
 }
 
+/**
+ * 打印插件挂载诊断三行（供 status / repair 共用）。
+ * 用户报障时这三行就能区分「链接坏了」与「别的毛病」，不必靠猜：
+ *   link = 有没有真挂上（junction / 符号链接 / 整目录拷贝 / BROKEN）
+ *   resolve = dsh 的裸包名解析能不能走通（浏览器半注入面板就靠它）
+ *   client = dsh.client.platform 声明在不在
+ */
+function printPluginDiagnostics(profileDir) {
+  const nmPlugin = path.join(profileDir, "node_modules", PLUGIN_ID);
+  const link = describePluginLink(profileDir);
+  const probe = probePluginResolve(profileDir);
+  const kindText = { linked: "已挂载（链接）", copy: "已挂载（整目录拷贝）", broken: "BROKEN（存在但读不到内容）", missing: "缺失", "no-local-copy": "缺失（本地插件目录也没有）" }[link.kind] || link.kind;
+  console.log(`   [link]    ${nmPlugin}\n             → ${kindText}`);
+  console.log(`   [resolve] ${PLUGIN_ID}/package.json → ${probe.ok ? probe.pkgPath : `失败（${probe.reason}）`}`);
+  console.log(`   [client]  dsh.client.platform = ${probe.ok ? (probe.clientPlatform || "缺失") : "（解析失败，无法确认）"}`);
+  return { link, probe };
+}
+
+/**
+ * `dsh-remote repair` —— 只修 profile 里的插件挂载，不碰运行环境 / 不联网 / 不碰自启动。
+ *
+ * 为什么需要这个独立入口：插件挂载坏掉时 dsh web **整个起不来**（cordis 插件树加载失败），
+ * 而设置面板与插件市场都在那个进程里 —— 用户没有任何自助修复入口，只剩命令行。
+ * 执行顺序刻意是"先保命、再修复、最后恢复激活"：
+ *   ① patch 里引用了本插件但挂载不可用 → **先把 include 摘掉**（profile 立刻恢复可启动）；
+ *   ② 再重建挂载（失败会抛错，但①的结果保留 → 用户至少能打开 dsh web）；
+ *   ③ 只有①②都成功，才把激活行写回去。
+ */
+function repairProfile(argv = []) {
+  const profileDir = resolveProfileDir(argv);
+  const pkgFile = path.join(profileDir, "package.json");
+  const patchFile = path.join(profileDir, "cordis.patch.yml");
+  const localDir = path.join(profileDir, PLUGIN_LOCAL_DIR);
+  if (!fs.existsSync(pkgFile) || !fs.existsSync(patchFile)) {
+    console.error(`❌ 未找到 dsh web profile（${profileDir}）。`);
+    console.error("   先确认 dsh web 装好并初始化过 profile，或用 --profile <目录> 指定。");
+    process.exit(1);
+  }
+  console.log(`dsh-remote repair — ${profileDir}`);
+  const before = printPluginDiagnostics(profileDir);
+  if (!before.link.localExists) {
+    console.error(`❌ 本地插件目录缺失（${localDir}）：无法就地修复。`);
+    console.error("   请重新安装：npx @mrrisega/dsh-remote@latest");
+    process.exit(1);
+  }
+
+  const patch = fs.readFileSync(patchFile, "utf8");
+  const referenced = parsePatchInsertIds(patch).ids.some((id) => PLUGIN_ALL_IDS.includes(id));
+  if (referenced && !before.link.usable) {
+    // 保命动作：先摘掉激活行，让 dsh web 至少能启动（此时插件不可用，但用户进得去、能重装）
+    stripIncludeEntries(patchFile, patch, "挂载不可用，先摘掉 include 保命");
+    try { removeBundleEntry(pkgFile); } catch { /* ignore */ }
+    console.log("🛟 挂载不可用 → 已先摘掉插件激活行（dsh web 现在应该能启动了）。");
+  }
+
+  try {
+    ensurePluginLinked(profileDir, localDir);
+  } catch (e) {
+    console.error(`❌ 重建挂载失败：${e.message}`);
+    console.error("   profile 已处于「能启动、插件未激活」状态；请把上面错误反馈给作者。");
+    process.exit(1);
+  }
+  const after = printPluginDiagnostics(profileDir);
+  if (!after.probe.ok) {
+    console.error("❌ 挂载已重建，但 dsh 仍解析不到本插件 —— 请把上面的输出反馈给作者。");
+    process.exit(1);
+  }
+  const srcPluginDir = path.join(THIS_DIR, "packages", PLUGIN_ID);
+  if (!fs.existsSync(srcPluginDir)) {
+    console.error(`❌ 本包缺少 packages/${PLUGIN_ID}，无法就地恢复激活行。`);
+    console.error("   请重新安装：npx @mrrisega/dsh-remote@latest");
+    process.exit(1);
+  }
+  convergePluginActivation(profileDir, pkgFile, patchFile, srcPluginDir, fs.readFileSync(patchFile, "utf8"));
+  console.log("✅ 挂载与激活已修复 —— 重启一次 dsh web 生效。");
+}
+
 // ---------- main ----------
 // 无命令名（或首个参数以 - 开头）时默认执行 setup —— 这样 `dsh-remote --no-autostart`
 // 这类「只给 flag」的用法才能装上去。
@@ -1748,6 +2053,7 @@ if (cmd === "setup" || cmd === "install") await setup(args);
 else if (cmd === "settings") settingsHint();
 else if (cmd === "run") await runBridge();
 else if (cmd === "plugin") await pluginCmd(process.argv.slice(3));
+else if (cmd === "repair") repairProfile(process.argv.slice(3));
 else if (cmd === "status") {
   const cfg = loadConfig();
   const local = Boolean(cfg.local_key);
@@ -1755,6 +2061,14 @@ else if (cmd === "status") {
   console.log("连接模式:", local ? `自建服务（${cfg.tunnel_url || "未设置服务器地址"}）` : `SaaS 云端服务（${cfg.phone || "未配置账号"}）`);
   console.log("API:", cfg.api_url || (local ? "（自建模式无需账号 API）" : DEFAULT_API));
   console.log("远程地址/登录: 打开 dsh web → 设置 → 「远程控制」查看与操作");
+  // 插件挂载诊断：报障时一眼看出是"链接坏了"还是"别的毛病"
+  const profileDir = resolveProfileDir([]);
+  if (fs.existsSync(path.join(profileDir, "package.json"))) {
+    console.log("插件挂载:");
+    printPluginDiagnostics(profileDir);
+  } else {
+    console.log(`插件挂载: 未找到 profile（${profileDir}）`);
+  }
 } else {
   printHelp();
   process.exit(1);

package/package.json

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

@@ -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); });
       };