@mrrisega/dsh-remote 0.4.3 → 0.4.5

package/README.md

@@ -79,6 +79,12 @@ npx @mrrisega/dsh-remote setup --server wss://<你的域名>:端口 --key <访
 其他命令：`settings`（设置页）、`status`（查看状态）、`run`（前台调试）、
 `plugin`（重装/卸载 dsh web 插件）。运行 `npx @mrrisega/dsh-remote --help` 查看完整说明。
 
+> **版本与更新 / 卸载**：dsh 官方插件市场目前不提供更新按钮，也不会改写用户补丁（因此市场
+> 卸载会提示「仍通过 insert 引用 dsh-remote-ui」而拒绝）。插件设置面板里已内置管理入口
+> （dsh web → 设置 → 「远程控制」→「🔄 版本与更新」卡片）：显示当前版本、自动检测 npm 新版、
+> **一键在线更新**（后台补运行环境并重启 bridge，完成后重启 dsh web 生效）、以及**彻底卸载**
+> （移除补丁 include / 依赖 / bundle 与本地文件，之后市场卸载或直接重启均可完成卸载）。
+
 源码安装（开发 / 自建服务器）：`git clone https://github.com/mrRisega/dsh-remote.git`
 并 `npm install`，见下文各组件说明。
 

package/dsh-setup.mjs

@@ -41,6 +41,63 @@ const DEFAULT_API = "https://n.risegao.cn:13443/relay-api";
 const DEFAULT_APP_URL = "https://n.risegao.cn:13443/app/";
 const REPO_URL = "https://github.com/mrRisega/dsh-remote";
 
+// ---------- 运行时自物化（npm/npx 安装 → 固化到配置目录，脱离 npx 缓存） ----------
+// npx 每次安装的缓存目录（~/.npm/_npx/<hash>）不固定：缓存一旦清理，指向它的自启动服务
+// 就会像“找不到模块”一样崩溃。因此 npm 形态安装时把 dsh-setup.mjs + clients + 依赖(ws)
+// 固化到 CONFIG_DIR（~/.dsh-remote），自启动服务只指向这个稳定路径。
+// 插件（dsh-remote-ui）的“运行环境已就绪”判断同样以 CONFIG_DIR/dsh-setup.mjs 为准。
+
+function pkgVersion() {
+  try {
+    return JSON.parse(fs.readFileSync(path.join(THIS_DIR, "package.json"), "utf8")).version || "";
+  } catch { return ""; }
+}
+
+/** 向上查找依赖树里的 ws（npx 布局通常提升到缓存根 node_modules，npm 布局则内嵌）。 */
+function findDepWs(startDir) {
+  let d = startDir;
+  while (true) {
+    const cand = path.join(d, "node_modules", "ws");
+    if (fs.existsSync(cand)) return cand;
+    const parent = path.dirname(d);
+    if (parent === d) break;
+    d = parent;
+  }
+  return null;
+}
+
+function ensureRuntimeCopy() {
+  if (!IS_NPM_INSTALL) return; // 仓库开发形态：原地使用
+  fs.mkdirSync(CONFIG_DIR, { recursive: true });
+  const ver = pkgVersion();
+  const setupTarget = path.join(CONFIG_DIR, "dsh-setup.mjs");
+  if (setupTarget === path.join(THIS_DIR, "dsh-setup.mjs")) return; // 已在配置目录内执行
+  const verFile = path.join(CONFIG_DIR, ".dsh-setup-version");
+  let cur = "";
+  try { cur = fs.readFileSync(verFile, "utf8").trim(); } catch { /* 首次 */ }
+  if (fs.existsSync(setupTarget) && cur === ver) return; // 同版本幂等跳过
+  fs.cpSync(path.join(THIS_DIR, "dsh-setup.mjs"), setupTarget);
+  fs.cpSync(path.join(THIS_DIR, "clients"), path.join(CONFIG_DIR, "clients"), { recursive: true, force: true });
+  const wsSrc = findDepWs(THIS_DIR);
+  if (wsSrc) {
+    fs.mkdirSync(path.join(CONFIG_DIR, "node_modules"), { recursive: true });
+    fs.cpSync(wsSrc, path.join(CONFIG_DIR, "node_modules", "ws"), { recursive: true, force: true });
+  }
+  fs.writeFileSync(verFile, ver);
+  console.log(`✅ 运行时已固化到 ${CONFIG_DIR}（自启动指向稳定路径，不再依赖 npx 缓存）`);
+}
+try { ensureRuntimeCopy(); } catch (e) { console.warn(`⚠️ 运行时固化跳过: ${e.message}`); }
+
+/** 自启动服务应指向的 dsh-setup.mjs：优先配置目录内的固化副本，否则当前执行文件。 */
+function runtimeSetupPath() {
+  const local = path.join(CONFIG_DIR, "dsh-setup.mjs");
+  try {
+    fs.accessSync(local, fs.constants.R_OK);
+    return local;
+  } catch { /* 未固化（如仓库开发）→ 用当前文件 */ }
+  return fileURLToPath(import.meta.url);
+}
+
 // ---------- 工具 ----------
 
 function sh(cmd, timeoutMs = 15000, cwd = undefined) {
@@ -137,7 +194,7 @@ function autostartFilePath() {
 }
 
 function writeAutostartFile() {
-  const runCmd = `"${NODE_BIN}" "${fileURLToPath(import.meta.url)}" run`;
+  const runCmd = `"${NODE_BIN}" "${runtimeSetupPath()}" run`;
   if (process.platform === "darwin") {
     const plistPath = autostartFilePath();
     const plist = `<?xml version="1.0" encoding="UTF-8"?>
@@ -145,7 +202,7 @@ function writeAutostartFile() {
 <plist version="1.0"><dict>
   <key>Label</key><string>com.dshremote.bridge</string>
   <key>ProgramArguments</key>
-  <array><string>${NODE_BIN}</string><string>${fileURLToPath(import.meta.url)}</string><string>run</string></array>
+  <array><string>${NODE_BIN}</string><string>${runtimeSetupPath()}</string><string>run</string></array>
   <key>RunAtLoad</key><true/>
   <key>KeepAlive</key><true/>
   <key>StandardOutPath</key><string>${path.join(CONFIG_DIR, ".dsh-bridge.log")}</string>
@@ -601,6 +658,91 @@ function declarePluginDep(pkgFile) {
   fs.writeFileSync(pkgFile, JSON.stringify(pkg, null, 2) + "\n");
 }
 
+/** 把 dsh-remote-ui 加入 dsh.profile.bundles（幂等）。返回是否发生变更。 */
+function ensureBundleEntry(pkgFile) {
+  const pkg = JSON.parse(fs.readFileSync(pkgFile, "utf8"));
+  const bundles = pkg.dsh && pkg.dsh.profile && Array.isArray(pkg.dsh.profile.bundles)
+    ? pkg.dsh.profile.bundles
+    : null;
+  if (bundles && bundles.includes("dsh-remote-ui")) return false;
+  pkg.dsh = pkg.dsh || {};
+  pkg.dsh.profile = pkg.dsh.profile || {};
+  pkg.dsh.profile.bundles = bundles || [];
+  pkg.dsh.profile.bundles.push("dsh-remote-ui");
+  fs.writeFileSync(pkgFile, JSON.stringify(pkg, null, 2) + "\n");
+  return true;
+}
+
+/** 从 dsh.profile.bundles 移除 dsh-remote-ui（幂等）。返回是否发生变更。 */
+function removeBundleEntry(pkgFile) {
+  const pkg = JSON.parse(fs.readFileSync(pkgFile, "utf8"));
+  const bundles = pkg.dsh && pkg.dsh.profile && Array.isArray(pkg.dsh.profile.bundles)
+    ? pkg.dsh.profile.bundles
+    : null;
+  if (!bundles || !bundles.includes("dsh-remote-ui")) return false;
+  pkg.dsh.profile.bundles = bundles.filter((b) => b !== "dsh-remote-ui");
+  fs.writeFileSync(pkgFile, JSON.stringify(pkg, null, 2) + "\n");
+  return true;
+}
+
+/**
+ * 插件安装(pluginCmd 非卸载分支)收敛策略 —— 2026-09-06「重复 ID 崩溃」根治：
+ * dsh-remote-ui 是带 dsh.bundle.patch 的 bundle：package.json 的 dsh.profile.bundles
+ * 声明它后，加载器会自动应用插件自带的 cordis.patch.yml（节点半+浏览器半的唯一激活点）。
+ * 若用户级 cordis.patch.yml 再手工 insert 同一个 id，dsh web 启动即报“重复 ID”崩溃。
+ * 因此本命令【绝不写用户 include】，只负责：让插件以 bundle 形态可解析，
+ * 并清理历史遗留的 include 块。市场形态(github:/npm 依赖)则完全交由市场管理，只清理 include。
+ */
+function convergePluginActivation(profileDir, pkgFile, patchFile, pluginDir, patch) {
+  const pkg = JSON.parse(fs.readFileSync(pkgFile, "utf8"));
+  const dep = pkg.dependencies && pkg.dependencies["dsh-remote-ui"];
+  const inBundles = !!(pkg.dsh && pkg.dsh.profile && Array.isArray(pkg.dsh.profile.bundles)
+    && pkg.dsh.profile.bundles.includes("dsh-remote-ui"));
+  const marketManaged = dep && !String(dep).startsWith("file:"); // github:/npm: 等由市场/包管理器管源码
+  const managedByUs = !dep || String(dep).startsWith("file:");   // 无依赖或 file: 拷贝 → 我们管
+
+  const stripInclude = (reason) => {
+    const newPatch = stripPluginEntries(patch);
+    if (newPatch !== patch) {
+      fs.writeFileSync(patchFile, newPatch);
+      console.log(`✅ 已移除 ${patchFile} 中的冗余 include（${reason}；激活统一走插件自带 bundle patch，避免重复 ID 崩溃）`);
+    }
+  };
+
+  if (marketManaged && inBundles) {
+    // 插件市场安装形态：依赖与源码归市场管，我们只清历史 include（若旧版曾写过）
+    stripInclude("插件市场安装形态无需用户 include");
+    console.log("ℹ 插件市场安装形态（bundles+dependency）：已保持市场管理的源码不变。");
+    return;
+  }
+
+  if (managedByUs) {
+    const pluginLocalDir = copyPluginIntoProfile(profileDir, pluginDir);
+    const entryFile = path.join(pluginLocalDir, "lib", "index.js");
+    if (!fs.existsSync(entryFile)) {
+      console.error(`❌ 插件入口缺失：${entryFile}（本包不完整？请用官方源重装：npx --registry=https://registry.npmjs.org @mrrisega/dsh-remote@latest）`);
+      process.exit(1);
+    }
+    console.log(`✅ 插件已拷贝到 ${pluginLocalDir}`);
+    declarePluginDep(pkgFile);                      // file: 依赖(包管理器 install 不误删)
+    const addedBundle = ensureBundleEntry(pkgFile); // bundles 声明 → 插件自带 patch 自动激活
+    const linked = ensurePluginLinked(profileDir, pluginLocalDir); // 自建 node_modules 链接
+    stripInclude("bundle patch 已是唯一激活点");     // 清历史 include
+    console.log(addedBundle
+      ? "✅ 已加入 dsh.profile.bundles（dsh-remote-ui 自带 patch 自动生效）"
+      : "ℹ dsh.profile.bundles 已含 dsh-remote-ui");
+    console.log(linked
+      ? `✅ 已建立 node_modules/dsh-remote-ui → ${pluginLocalDir}（免包管理器即可解析）`
+      : "✅ node_modules/dsh-remote-ui 已就绪");
+    console.log(`✅ 插件安装完成（bundle 形态，无用户 include）。配置目录: ${CONFIG_DIR}`);
+    return;
+  }
+
+  // 异常形态：有非 file: 依赖但不在 bundles（无法靠 bundle patch 激活）
+  console.log(`ℹ 检测到依赖 dsh-remote-ui(${dep}) 但未声明在 dsh.profile.bundles——插件不会激活。`);
+  console.log("   请在 dsh 插件市场重新添加该插件，或先执行 `dsh-remote plugin --uninstall` 再一键安装。");
+}
+
 async function pluginCmd(argv) {
   const uninstall = hasFlag(argv, "--uninstall");
   const profileIdx = argv.indexOf("--profile");
@@ -639,35 +781,17 @@ async function pluginCmd(argv) {
       if (pkg.dependencies) delete pkg.dependencies["dsh-remote-ui"];
       fs.writeFileSync(pkgFile, JSON.stringify(pkg, null, 2) + "\n");
     } catch { /* ignore */ }
+    // 同步移除 bundles 声明，避免“bundles 引用已删除包 → dsh web 启动报错”
+    try {
+      if (removeBundleEntry(pkgFile)) console.log("✅ 已从 dsh.profile.bundles 移除 dsh-remote-ui");
+    } catch { /* ignore */ }
     console.log("✅ 卸载完成。重启 dsh web 生效。");
     return;
   }
 
-  // 安装 = 拷贝完整插件目录 + 写裸名 include + 自建 node_modules 链接 + 声明 file: 依赖。
-  // 全程不跑 pnpm/npm；但链接与依赖双保险，任何包管理器之后 install 也不会破坏它。
-  const pluginLocalDir = copyPluginIntoProfile(profileDir, pluginDir);
-  const entryFile = path.join(pluginLocalDir, "lib", "index.js");
-  if (!fs.existsSync(entryFile)) {
-    console.error(`❌ 插件入口缺失：${entryFile}（本包不完整？请用官方源重装：npx --registry=https://registry.npmjs.org @mrrisega/dsh-remote@latest）`);
-    process.exit(1);
-  }
-  console.log(`✅ 插件已拷贝到 ${pluginLocalDir}`);
-
-  // 先清掉旧条目（含旧版无标记条目），再写入带标记的新块，保证不重复。
-  // 关键：先清除默认的 [] 空文档占位行，否则拼接出的 YAML 非法，dsh web 启动即崩。
-  const stripped = stripPluginEntries(patch);
-  const base = normalizePatchBase(stripped);
-  const block = pluginBlock(CONFIG_DIR);
-  fs.writeFileSync(patchFile, (base ? base + "\n" : "") + block + "\n");
-  console.log(`✅ 已写入 ${patchFile}（裸名 include：dsh-remote-ui → 节点半 + 浏览器半均生效）`);
-
-  declarePluginDep(pkgFile); // package.json 声明 file: 依赖(后端各类 install 不误删)
-  const linked = ensurePluginLinked(profileDir, pluginLocalDir); // 自建 node_modules 链接
-  console.log(linked
-    ? `✅ 已建立 node_modules/dsh-remote-ui → ${pluginLocalDir}（免包管理器即可解析）`
-    : "✅ node_modules/dsh-remote-ui 已就绪");
-
-  console.log(`✅ 插件安装完成。配置目录: ${CONFIG_DIR}`);
+  // 安装：收敛到“恰好一处激活”（bundle patch 唯一激活点），绝不与市场/历史 include 并存
+  convergePluginActivation(profileDir, pkgFile, patchFile, pluginDir, patch);
+
   console.log("   打开 dsh web → 设置 → 「远程控制」，注册/登录手机号即可（无需任何命令）。");
   console.log("   若从 DeepSeek App/插件市场 安装：请完全退出并重开 App 让插件生效。");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.4.3",
+  "version": "0.4.5",
   "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-ui/lib/index.js

@@ -64,6 +64,89 @@ function preferredNode() {
 
 const NODE_BIN = preferredNode();
 
+/**
+ * 解析 npx 绝对路径。DeepSeek App 拉起 dsh web 时 PATH 只有 /usr/bin:/bin:/usr/sbin:/sbin
+ * （没有 /opt/homebrew/bin 等），裸 `npx` 会 spawn ENOENT 而静默失败——必须按绝对路径找，
+ * 且子进程 env 的 PATH 要把当前 node 所在目录补在最前（npx 的 #!/usr/bin/env node 依赖它）。
+ */
+function npxCommand() {
+  const name = process.platform === "win32" ? "npx.cmd" : "npx";
+  const dirs = [
+    dirname(process.execPath),           // 与当前 node 同目录（homebrew/usr/local 均可覆盖）
+    process.env.DSH_SETUP_NPX_DIR || "",
+    "/opt/homebrew/bin",
+    "/usr/local/bin",
+    "/opt/homebrew/opt/node@20/bin",
+    "/usr/local/opt/node@20/bin",
+    "/usr/bin",
+  ].filter(Boolean);
+  for (const d of dirs) {
+    const real = resolveExecutable(join(d, name));
+    if (real) return real;
+  }
+  return name; // 全找不到 → 退回裸名（普通 shell 场景仍可用）
+}
+
+/** 子进程环境：把 node 目录补进 PATH（npx 及其 shebang 需要），可附加额外变量。 */
+function spawnEnv(extra) {
+  const nodeDir = dirname(process.execPath);
+  const base = process.env.PATH || "";
+  const PATH = [nodeDir, base, "/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin"].filter(Boolean).join(":");
+  return { ...process.env, PATH, ...(extra || {}) };
+}
+
+// ---------- 后台子进程标记（防重入 + 宿主重启自愈） ----------
+// marker 内容 = JSON {pid, at}：pid 供“宿主重启后立即清理死进程残留”判断；
+// 兼容旧格式（纯时间戳数字 → 只按超时清理）。
+
+function readMarkerInfo(filePath) {
+  try {
+    const raw = readFileSync(filePath, "utf8").trim();
+    const j = JSON.parse(raw);
+    if (Number.isInteger(j?.pid) || Number.isInteger(j?.at)) return j;
+  } catch { /* 非 JSON → 数字时间戳或空 */ }
+  const t = Number(raw || "0");
+  return Number.isFinite(t) && t > 0 ? { pid: null, at: t } : null;
+}
+
+function writeMarker(filePath, pid) {
+  mkdirSync(dirname(filePath), { recursive: true });
+  writeFileSync(filePath, JSON.stringify({ pid: pid ?? null, at: Date.now() }), { mode: 0o600 });
+}
+
+/** pid 是否存活（ESRCH=已死）。 */
+function pidAlive(pid) {
+  if (!Number.isInteger(pid) || pid <= 0) return null; // 未知 → 由超时规则兜底
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (e) {
+    return e.code === "EPERM" ? true : false; // EPERM=存在但无权限
+  }
+}
+
+/**
+ * 清理残留标记：宿主 dsh web 在后台安装/更新期间被重启/强杀时，子进程清理回调随之丢失，
+ * 若只按“30 分钟超时”清理，用户会在这半小时内反复遇到“已有更新进行中/正在安装”。
+ * 现在：记录 pid → 重启后立刻清掉已死进程的标记；pid 不可读的旧标记仍按超时兜底。
+ */
+function sweepStaleMarkers(relayDir) {
+  const now = Date.now();
+  for (const name of [PROVISION_MARKER, UPDATE_MARKER]) {
+    const p = join(relayDir, name);
+    let info;
+    try { info = readMarkerInfo(p); } catch { continue; }
+    if (!info) continue;
+    const dead = pidAlive(info.pid);
+    const expired = now - info.at > STALE_MARKER_MS;
+    if (dead === false || (dead === null && expired)) {
+      try { rmSync(p, { force: true }); } catch { /* ignore */ }
+      appendLogLine(relayDir, AUTO_INSTALL_LOG,
+        `[dsh-remote-ui] 清理残留标记 ${name}（pid=${info.pid ?? "?"}, at=${new Date(info.at).toISOString()}${dead === false ? ", 进程已死" : ", 已超时"}）`);
+    }
+  }
+}
+
 /** 读取 JSON body。 */
 async function readJsonBody(req) {
   let raw = "";
@@ -274,23 +357,8 @@ function appendLogLine(relayDir, name, line) {
 }
 
 /**
- * 清理“进程残留”标记：dsh web 在后台安装/更新期间被重启/强杀时，
- * 子进程的清理回调会随宿主进程一起丢失，marker 会永久卡住后续安装/更新。
- * 插件每次启动时把超时的 marker 清掉（内容=创建时间戳）。
+ * 清理“进程残留”标记的实现见上方小工具区 sweepStaleMarkers（pid 存活 + 超时双保险）。
  */
-function sweepStaleMarkers(relayDir) {
-  const now = Date.now();
-  for (const name of [PROVISION_MARKER, UPDATE_MARKER]) {
-    const p = join(relayDir, name);
-    try {
-      const t = Number((readFileSync(p, "utf8") || "0").trim());
-      if (Number.isFinite(t) && t > 0 && now - t > STALE_MARKER_MS) {
-        rmSync(p, { force: true });
-        appendLogLine(relayDir, AUTO_INSTALL_LOG, `[dsh-remote-ui] 清理残留标记 ${name}（${new Date(t).toISOString()} 创建，已超时）`);
-      }
-    } catch { /* 无文件等 → 忽略 */ }
-  }
-}
 
 /** 插件市场只装了 UI 插件;若桌面缺 dsh-remote 运行环境(dsh-setup.mjs=bridge/自启动),
  * 由插件在后台自动执行一次 `npx @mrrisega/dsh-remote` 补齐,用户无需手动跑命令。
@@ -301,18 +369,23 @@ function ensureRuntime(relayDir) {
   if (existsSync(marker)) return false; // 正在安装中
   try {
     mkdirSync(relayDir, { recursive: true });
-    writeFileSync(marker, String(Date.now()), { mode: 0o600 });
     const log = join(relayDir, AUTO_INSTALL_LOG);
-    const npx = process.platform === "win32" ? "npx.cmd" : "npx";
-    const child = spawn(npx, ["--yes", "@mrrisega/dsh-remote"], {
+    const child = spawn(npxCommand(), ["--yes", "@mrrisega/dsh-remote"], {
       detached: true,
+      env: spawnEnv(),
       stdio: ["ignore", openSync(log, "a"), openSync(log, "a")]
     });
+    writeMarker(marker, child.pid); // 记 pid：宿主重启后可立即清理死进程残留
+    const clear = () => { try { rmSync(marker, { force: true }); } catch { /* ignore */ } };
     child.on("exit", (code) => {
-      // 安装结束即移除 marker（无论成败，失败由下一轮 scheduleRuntime 重试）
-      try { rmSync(marker, { force: true }); } catch { /* ignore */ }
+      clear();
       appendLogLine(relayDir, AUTO_INSTALL_LOG, `[auto-install] npx 退出 code=${code ?? "?"}`);
     });
+    child.on("error", (e) => {
+      clear();
+      appendLogLine(relayDir, AUTO_INSTALL_LOG, `[auto-install] 启动失败: ${e.message}`);
+      console.warn(`[dsh-remote-ui] 自动安装子进程启动失败: ${e.message}`);
+    });
     child.unref();
     console.log(`[dsh-remote-ui] 检测到缺少桌面运行环境,已在后台自动安装(日志: ${log}),完成后将自动启动 bridge`);
     return false;
@@ -373,14 +446,15 @@ function scheduleRuntime(relayDir) {
       const cfg = loadConfig(relayDir);
       const hasAcct = Boolean((cfg.phone || cfg.email) && cfg.password) || Boolean(cfg.local_key);
       if (!hasAcct) return;
+      // 先看服务是否已在运行（runtime 可能位于 npx 缓存/固化目录，不必重复安装）
+      const st = launchdStatus();
+      if (st.running) { done = true; clearInterval(iv); return; }
       const setupUrl = join(relayDir, "dsh-setup.mjs");
       if (!existsSync(setupUrl)) {
-        ensureRuntime(relayDir);
+        ensureRuntime(relayDir); // 什么环境都没有 → 后台 npx 安装一次
         return;
       }
-      const st = launchdStatus();
-      if (st.running) { done = true; clearInterval(iv); return; }
-      startBridge(relayDir);
+      startBridge(relayDir); // 环境在但服务没起 → 拉起
     } catch { /* 下一轮再试 */ }
   }, 12_000);
   iv.unref?.();
@@ -637,7 +711,7 @@ async function proxyFeedback(relayDir, req, res, pathname) {
 // ---------- 自管理：版本 / 在线更新 / 彻底卸载（面板内“版本与更新”卡片） ----------
 
 /** 插件自身发布版本（与 dsh-remote 根包同步递增）。 */
-const PLUGIN_VERSION = "0.4.3";
+const PLUGIN_VERSION = "0.4.5";
 const UPDATE_LOG = ".dsh-update.log";
 const UPDATE_MARKER = ".dsh-update-running";
 
@@ -657,11 +731,10 @@ async function npmLatestVersion() {
 /** 以 detached 子进程执行 `npx --yes @mrrisega/dsh-remote@latest`（env 可覆盖 npm 源）。 */
 function spawnUpdater(relayDir, extraEnv) {
   const log = join(relayDir, UPDATE_LOG);
-  const npx = process.platform === "win32" ? "npx.cmd" : "npx";
-  return spawn(npx, ["--yes", "@mrrisega/dsh-remote@latest"], {
+  return spawn(npxCommand(), ["--yes", "@mrrisega/dsh-remote@latest"], {
     detached: true,
     cwd: homedir(),
-    env: { ...process.env, ...(extraEnv || {}) },
+    env: spawnEnv(extraEnv), // PATH 补 node 目录：App 最小 PATH 下也能跑 npx
     stdio: ["ignore", openSync(log, "a"), openSync(log, "a")]
   });
 }
@@ -669,20 +742,22 @@ function spawnUpdater(relayDir, extraEnv) {
 /**
  * 后台执行在线一键更新：npx @mrrisega/dsh-remote@latest（幂等自愈：补运行环境/更新 bridge/重写 include）。
  * 稳健性：
+ *   - npx 用绝对路径 + PATH 补全解析（App 拉起的 dsh web PATH 最小化时不再 ENOENT 静默失败）；
  *   - 默认 npx 源（国内常为 npmmirror）未同步到最新版导致失败时，自动用官方 npm 源重试一次；
- *   - marker 由子进程退出回调清理；若宿主 dsh web 在更新期间被重启，残留 marker 由启动时的 sweepStaleMarkers 兜底。
+ *   - marker 记录 pid，子进程退出/出错即清理；宿主重启后由 sweepStaleMarkers 立即清掉死进程残留。
  */
 function runOnlineUpdate(relayDir) {
   try {
     mkdirSync(relayDir, { recursive: true });
     const marker = join(relayDir, UPDATE_MARKER);
     if (existsSync(marker)) return { ok: false, detail: "已有更新在进行中，请稍候" };
-    writeFileSync(marker, String(Date.now()), { mode: 0o600 });
     appendLogLine(relayDir, UPDATE_LOG, `[update] 开始在线更新 @mrrisega/dsh-remote@latest (${new Date().toISOString()})`);
 
     let retried = false;
+    const clear = () => { try { rmSync(marker, { force: true }); } catch { /* ignore */ } };
     const run = () => {
       const child = spawnUpdater(relayDir, retried ? { npm_config_registry: "https://registry.npmjs.org" } : {});
+      writeMarker(marker, child.pid);
       child.on("exit", (code) => {
         if (!retried && code !== 0) {
           retried = true;
@@ -691,7 +766,11 @@ function runOnlineUpdate(relayDir) {
           return;
         }
         appendLogLine(relayDir, UPDATE_LOG, `[update] npx 退出 code=${code ?? "?"}（默认源${retried ? "/官方源" : ""}）`);
-        try { rmSync(marker, { force: true }); } catch { /* ignore */ }
+        clear();
+      });
+      child.on("error", (e) => {
+        appendLogLine(relayDir, UPDATE_LOG, `[update] 子进程启动失败: ${e.message}`);
+        clear();
       });
       child.unref();
       return child;

package/packages/dsh-remote-ui/test/self-manage.test.mjs

@@ -5,8 +5,8 @@
 //   3) 版本可见 + 新版本检测 + 稳健更新（含残留 marker 清理兜底逻辑在 apply 时执行）。
 import assert from "node:assert/strict";
 import http from "node:http";
+import { existsSync, mkdtempSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import { mkdtemp, mkdir, rm, writeFile, readFile } from "node:fs/promises";
-import { readFileSync } from "node:fs";
 import os from "node:os";
 import path from "node:path";
 import test from "node:test";
@@ -66,24 +66,24 @@ test("self 路由：版本可见 + 运行环境状态（无 npx 环境时不谎
   }
 });
 
-test("update-check 路由：从 npm 检测新版本（dist-tags.latest 0.4.4 > 当前）", async () => {
+test("update-check 路由：从 npm 检测新版本（dist-tags.latest 9.9.9 > 当前）", async () => {
   const tempDir = await mkdtemp(path.join(os.tmpdir(), "dsh-ui-upchk-"));
   const origFetch = globalThis.fetch;
   try {
     const routes = boot(null, tempDir);
     const { host, base } = await serve(routes);
-    // 假 npm 源：registry 请求回 0.4.4，其余请求（本测试自身的 HTTP 调用）走真实 fetch
+    // 假 npm 源：registry 请求回 9.9.9，其余请求（本测试自身的 HTTP 调用）走真实 fetch
     globalThis.fetch = async (url, init) => {
       if (String(url).startsWith("https://registry.")) {
-        return { ok: true, status: 200, json: async () => ({ "dist-tags": { latest: "0.4.4" } }) };
+        return { ok: true, status: 200, json: async () => ({ "dist-tags": { latest: "9.9.9" } }) };
       }
       return origFetch(url, init);
     };
     try {
       const r = await (await fetch(`${base}/dsh-remote/self/update-check`)).json();
       assert.equal(r.ok, true);
-      assert.equal(r.latest, "0.4.4");
-      assert.equal(r.outdated, true, "0.4.4 > 当前版本 → outdated 应为 true");
+      assert.equal(r.latest, "9.9.9");
+      assert.equal(r.outdated, true, "9.9.9 > 当前版本 → outdated 应为 true");
       assert.notEqual(r.current, r.latest);
     } finally {
       host.close();
@@ -139,6 +139,22 @@ test("update 路由：已有更新进行中时拒绝重复触发（防重入）"
   }
 });
 
+test("残留 marker 自愈：记录进程已死的 marker 在插件启动时立即清理（不等 30 分钟超时）", () => {
+  const tempDir = mkdtempSync(path.join(os.tmpdir(), "dsh-ui-sweep-"));
+  try {
+    // 模拟“宿主在更新途中被重启”：更新子进程已死，但清理回调随旧宿主丢失
+    const deadPid = 2147483647; // 不可能存在的 pid
+    writeFileSync(path.join(tempDir, ".dsh-setup-installing"), JSON.stringify({ pid: deadPid, at: Date.now() }));
+    writeFileSync(path.join(tempDir, ".dsh-update-running"), JSON.stringify({ pid: deadPid, at: Date.now() }));
+    writeFileSync(path.join(tempDir, ".dsh-config.json"), "{}");
+    boot(null, tempDir); // apply() → sweepStaleMarkers
+    assert.equal(existsSync(path.join(tempDir, ".dsh-setup-installing")), false, "死进程的安装 marker 应被立即清理");
+    assert.equal(existsSync(path.join(tempDir, ".dsh-update-running")), false, "死进程的更新 marker 应被立即清理");
+  } finally {
+    rmSync(tempDir, { recursive: true, force: true });
+  }
+});
+
 test("uninstall 路由：移除 include 块 + package.json 依赖/bundle + 本地目录（解锁市场卸载）", async () => {
   const tempHome = await mkdtemp(path.join(os.tmpdir(), "dsh-ui-home-"));
   const relayDir = path.join(tempHome, "relay");