@mrrisega/dsh-remote 0.4.3 → 0.4.4

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>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mrrisega/dsh-remote",
-  "version": "0.4.3",
+  "version": "0.4.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-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.4";
 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");