@xiaoyuyu6420/dsh-backup 0.12.1 → 0.13.0

package/lib/index.js

@@ -272,6 +272,16 @@ function detectHostTrain() {
  * 吃的都是同一语法的字符串，直接写常量在两个列车上行为等价。 */
 const NS = 'dsh-backup';
 
+/** 本插件自身名称与版本（package.json）：更新检查的"当前版本"基准。 */
+const SELF_META = (() => {
+  try {
+    const pkg = JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8'));
+    return { name: pkg.name, version: pkg.version };
+  } catch {
+    return { name: '@xiaoyuyu6420/dsh-backup', version: 'unknown' };
+  }
+})();
+
 /**
  * 设置默认值。SCHEMA 的 .default() 与 resolveBase 的初始值都引用这里，
  * 避免同一字面量散落多处导致迁移逻辑漏改。
@@ -281,6 +291,7 @@ const DEFAULTS = Object.freeze({
   exclude: [],
   redact: [...SENSITIVE_DEFAULTS],
   githubRepo: '',
+  updateCheck: false,
 });
 
 /**
@@ -294,9 +305,10 @@ const SCHEMA = z.object({
   exclude: z.array(z.string()).default(DEFAULTS.exclude),
   redact: z.union([z.array(z.string()), 'off']).default(DEFAULTS.redact),
   githubRepo: z.string().default(DEFAULTS.githubRepo),
+  updateCheck: z.boolean().default(DEFAULTS.updateCheck),
 });
 
-const SETTINGS_FIELDS = ['destination', 'keep', 'exclude', 'redact', 'githubRepo'];
+const SETTINGS_FIELDS = ['destination', 'keep', 'exclude', 'redact', 'githubRepo', 'updateCheck'];
 
 /** 校验并归一化单个字段到 `out`；非法值忽略。 */
 function normalizeField(out, field, value) {
@@ -313,6 +325,8 @@ function normalizeField(out, field, value) {
     else if (Array.isArray(value)) out.redact = value.filter((v) => typeof v === 'string');
   } else if (field === 'githubRepo') {
     if (typeof value === 'string') out.githubRepo = value;
+  } else if (field === 'updateCheck') {
+    if (typeof value === 'boolean') out.updateCheck = value;
   }
 }
 
@@ -398,6 +412,8 @@ const PANEL_INVOCATIONS = Object.freeze([
   panelDescriptor('doctorRepair', ['selector'], true),
   panelDescriptor('migrateCheck', [], true),
   panelDescriptor('setGithubToken', ['token']),
+  panelDescriptor('checkUpdate', [], true),
+  panelDescriptor('update', [], true),
 ]);
 
 /**
@@ -481,6 +497,16 @@ class BackupPanelService extends TypertRemoteService {
   setGithubToken(token) {
     return this.ops.setGithubToken(token);
   }
+
+  /** 检查 npm 是否有新版本（只读，不写任何文件）。 */
+  checkUpdate(signal) {
+    return this.ops.checkUpdate(signal);
+  }
+
+  /** 一键更新：先留升级前快照，再走官方 dsh plugin update（完成后需重启生效）。 */
+  update(signal) {
+    return this.ops.update(signal);
+  }
 }
 
 export function apply(ctx, pluginConfig) {
@@ -633,7 +659,10 @@ export function apply(ctx, pluginConfig) {
     const toFwd = (p) => (p.includes('\\') ? p.split('\\').join('/') : p);
     const homeRaw = env?.get('HOME')?.value || env?.get('USERPROFILE')?.value;
     const home = homeRaw ? toFwd(homeRaw.replace(/\/+$/, '')) : undefined;
-    const dshHome = env?.get('DSH_HOME')?.value || (home ? `${home}/.dsh` : undefined);
+    // DSH_HOME 与 HOME 一样去尾斜杠（#88）：'D:/dsh_data/' 会让 base 变空串、
+    // parent 退化为源目录本身，tar 位置参数成空串，产出 0 字节坏归档。
+    const dshHomeRaw = env?.get('DSH_HOME')?.value || (home ? `${home}/.dsh` : undefined);
+    const dshHome = dshHomeRaw ? toFwd(dshHomeRaw).replace(/\/+$/, '') || '/' : undefined;
     if (!home || !dshHome) throw new Error('无法解析 HOME/USERPROFILE 或 DSH_HOME（launchEnvironment 缺失）');
     const cfg = resolvedConfig();
     const raw = typeof cfg.destination === 'string' && cfg.destination.trim()
@@ -643,6 +672,106 @@ export function apply(ctx, pluginConfig) {
     return { home, dshHome: toFwd(dshHome), root };
   }
 
+  // #88：parent 由字符串截取求得，DSH_HOME 直接挂在盘符根时退化为 'D:'——
+  // bsdtar/GNU tar 都把裸盘符解析为"该盘符当前目录"，-C D: 必然失败并留下
+  // 空壳归档。tar 的 -C 一律传补过分隔符的值；fs 侧继续用原 parent
+  // （'D:' + '/' + name 仍是合法路径，renameBeside 等不受影响）。
+  const parentTar = (p) => (p.endsWith('/') ? p : `${p}/`);
+
+  /** semver 比较（常见形态，含 prerelease）：a > b 才返回 true；解析失败保守降为 false。 */
+  function semverGt(a, b) {
+    const parse = (s) => {
+      const m = /^v?(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?/.exec(String(s));
+      if (!m) return null;
+      return { n: [Number(m[1]), Number(m[2]), Number(m[3])], pre: m[4] ?? null };
+    };
+    const A = parse(a);
+    const B = parse(b);
+    if (!A || !B) return false;
+    for (let i = 0; i < 3; i += 1) {
+      if (A.n[i] !== B.n[i]) return A.n[i] > B.n[i];
+    }
+    if (A.pre === B.pre) return false;
+    return A.pre === null; // 无 prerelease 视为 release：同元组下 release > prerelease
+  }
+
+  /**
+   * 检查 npm 最新版（更新感知，A）。纯只读，失败静默——返回 error 文案交给
+   * 调用方，插件正常运行绝不因网络问题阻断。fetch 为 Node >=20 全局。
+   */
+  async function checkUpdate(signal) {
+    const ctrl = new AbortController();
+    const timer = setTimeout(() => ctrl.abort(), 8000);
+    const onHostAbort = () => ctrl.abort();
+    signal?.addEventListener('abort', onHostAbort, { once: true });
+    try {
+      const res = await fetch(`https://registry.npmjs.org/${encodeURIComponent(SELF_META.name)}`, {
+        signal: ctrl.signal,
+        headers: { accept: 'application/vnd.npm.install-v1+json' },
+      });
+      if (!res.ok) return { error: `npm registry 返回 ${res.status}` };
+      const meta = await res.json();
+      const latest = meta?.['dist-tags']?.latest;
+      if (typeof latest !== 'string' || !latest) return { error: 'registry 响应缺少 dist-tags.latest' };
+      return { current: SELF_META.version, latest, update: semverGt(latest, SELF_META.version) };
+    } catch (err) {
+      if (err && err.name === 'AbortError') return { error: '检查超时（8 秒）' };
+      return { error: String(err && err.message ? err.message : err) };
+    } finally {
+      clearTimeout(timer);
+      signal?.removeEventListener('abort', onHostAbort);
+    }
+  }
+
+  /**
+   * 一键更新（B）：先拍升级前快照（未过期的退路），再走官方 `dsh plugin
+   * --profile <p> update <pkg>`（pnpm 语义——profile 是 pnpm 项目，插件绝不
+   * 自己覆写依赖文件，否则 lockfile 失配）。完成后提示重启生效：宿主在启动
+   * 时结算 Loader 树，Node 半不可在运行中热替换。
+   */
+  async function runUpdate(signal, profileArg) {
+    const profile = profileArg || 'web';
+    const chk = await checkUpdate(signal);
+    if (chk.error) {
+      return { ok: false, updated: false, summary: `检查更新失败：${chk.error}\n可手动执行: dsh plugin --profile ${profile} update ${SELF_META.name}` };
+    }
+    if (!chk.update) {
+      return { ok: true, updated: false, current: chk.current, latest: chk.latest, summary: `已是最新版本 ${chk.current}` };
+    }
+    // 更新前快照：与启动钩子的升级前快照同一语义（不阻断更新，失败如实提示）
+    let snap = null;
+    try {
+      const s = await doBackup(undefined, signal, { namePrefix: 'dsh-pre-upgrade-' });
+      prunePrefixedSnapshots('dsh-pre-upgrade-', 2, s.name).catch(() => {});
+      snap = s.name;
+    } catch { /* 快照失败不阻断更新 */ }
+    // 解析 dsh CLI：优先 PATH（resolveExecutable），兜底用当前宿主入口（与
+    // detectHostTrain 同款定位——`node <入口> plugin ...` 与运行中的宿主同源）
+    let argv = null;
+    try {
+      argv = [await ctx.subprocess.resolveExecutable('dsh'), 'plugin', '--profile', profile, 'update', SELF_META.name];
+    } catch {
+      try {
+        argv = [process.execPath, realpathSync(process.argv[1]), 'plugin', '--profile', profile, 'update', SELF_META.name];
+      } catch {
+        return { ok: false, updated: false, summary: `找不到 dsh 命令，请手动执行: dsh plugin --profile ${profile} update ${SELF_META.name}${snap ? `\n更新前快照已留: ${snap}` : ''}` };
+      }
+    }
+    try {
+      const { root } = paths();
+      await spawnRun(argv, root, signal);
+    } catch (err) {
+      return { ok: false, updated: false, summary: `更新失败：${friendlyReason(err)}${snap ? `\n已有升级前快照 ${snap}，可 /backup restore ${snap} 回滚。` : ''}` };
+    }
+    return {
+      ok: true,
+      updated: true,
+      current: chk.latest,
+      latest: chk.latest,
+      summary: `已更新到 ${chk.latest}。${snap ? `\n更新前已留升级前快照 ${snap}（想回退：/backup restore ${snap}）。` : '\n更新前快照未生成（不影响本次更新）。'}\n请重启 dsh web 使新版本生效。`,
+    };
+  }
+
   function defaultKeep() {
     const cfg = resolvedConfig();
     const k = Number(cfg.keep);
@@ -1008,7 +1137,14 @@ export function apply(ctx, pluginConfig) {
     const redacted = skipVault ? await existingSensitive(dshHome) : await refreshVault(dshHome, home, signal);
     const tar = await ctx.subprocess.resolveExecutable('tar');
     const redactFlags = isTyped ? [] : redactExcludeFlags(base);
-    await spawnRun([tar, '--exclude=*node_modules*', '--exclude=.system', ...quarantineFlags, ...redactFlags, ...extraExcludes(), '-czf', name, '-C', parent, ...(isTyped ? typePaths : [base])], root, signal);
+    try {
+      await spawnRun([tar, '--exclude=*node_modules*', '--exclude=.system', ...quarantineFlags, ...redactFlags, ...extraExcludes(), '-czf', name, '-C', parentTar(parent), ...(isTyped ? typePaths : [base])], root, signal);
+    } catch (err) {
+      // tar 失败前已创建 -f 目标——空壳归档留在备份目录会被面板当正常备份
+      // 列出来（#88：29 字节静默空包）。删掉空壳再抛，让失败可见。
+      await rm(out, { force: true }).catch(() => {});
+      throw err;
+    }
 
     const shaText = await sha256File(out, home, signal);
     await writeOwned(`${out}.sha256`, `${shaText}  ${out}\n`);
@@ -1683,7 +1819,7 @@ export function apply(ctx, pluginConfig) {
       }
       try {
         const tar = await ctx.subprocess.resolveExecutable('tar');
-        await spawnRun([tar, '-xzf', picked.name, '-C', parent, ...fileTargets], root, signal);
+        await spawnRun([tar, '-xzf', picked.name, '-C', parentTar(parent), ...fileTargets], root, signal);
       } catch (err) {
         // 对齐 #28 / doctorRepair 回滚：从留档还原每个被覆盖项；连还原都失败
         // 时把留档路径交代清楚，绝不静默停在半截状态。
@@ -1751,7 +1887,7 @@ export function apply(ctx, pluginConfig) {
     }
     try {
       const tar = await ctx.subprocess.resolveExecutable('tar');
-      await spawnRun([tar, '-xzf', picked.name, '-C', parent], root, signal);
+      await spawnRun([tar, '-xzf', picked.name, '-C', parentTar(parent)], root, signal);
     } catch (err) {
       // 挪旁之后解压失败会让 .dsh 处于空位——这是恢复流程里用户最容易慌
       // 的时刻。尽力自动回滚：清掉半截解压产物、把原数据改回原名；连回滚
@@ -2420,7 +2556,7 @@ export function apply(ctx, pluginConfig) {
     // 交代清楚，绝不静默停在最糟的中间态。
     try {
       const tar = await ctx.subprocess.resolveExecutable('tar');
-      await spawnRun([tar, '-xzf', picked.name, '-C', parent, ...targets.map((t) => t.entry)], root, signal);
+      await spawnRun([tar, '-xzf', picked.name, '-C', parentTar(parent), ...targets.map((t) => t.entry)], root, signal);
     } catch (err) {
       const restored = new Set();
       for (let i = 0; i < targets.length; i++) {
@@ -2600,7 +2736,7 @@ export function apply(ctx, pluginConfig) {
   // ---------- /backup 命令 ----------
   ctx.commands.register({
     name: 'backup',
-    description: '备份/恢复 DSH 数据；子命令: list | verify [前缀|all] | restore <前缀|latest> [--dry-run] [--sync-deps] | doctor [--repair <前缀|latest>] | migrate-check | auto [N小时|off] | github status|sync|pull|repo|token <token|off> | [--keep N]',
+    description: '备份/恢复 DSH 数据；子命令: list | verify [前缀|all] | restore <前缀|latest> [--dry-run] [--sync-deps] | doctor [--repair <前缀|latest>] | migrate-check | auto [N小时|off] | github status|sync|pull|repo|token <token|off> | check-update | update [--profile <名>] | [--keep N]',
     handler: async (invocation) => {
       const input = invocation.rawInput.trim();
       try {
@@ -2664,6 +2800,25 @@ export function apply(ctx, pluginConfig) {
           return { kind: r.failCount || !r.env.hardlink || r.env.credentialsFlat ? 'error' : 'success', text: r.summary };
         }
 
+        if (head === 'check-update' || head === 'update') {
+          const profileIdx = parts.indexOf('--profile');
+          const profile = profileIdx >= 0 && parts[profileIdx + 1] && !parts[profileIdx + 1].startsWith('--')
+            ? parts[profileIdx + 1]
+            : 'web';
+          if (head === 'check-update') {
+            const u = await checkUpdate(invocation.signal);
+            if (u.error) return { kind: 'error', text: `检查更新失败：${u.error}` };
+            return {
+              kind: 'success',
+              text: u.update
+                ? `发现新版本：${u.current} → ${u.latest}\n输入 /backup update 一键更新（更新前自动留升级前快照）`
+                : `已是最新版本：${u.current}`,
+            };
+          }
+          const r = await runUpdate(invocation.signal, profile);
+          return { kind: r.ok ? 'success' : 'error', text: r.summary };
+        }
+
         if (head === 'github') {
           const arg = parts[1] || 'status';
           if (arg === 'repo') {
@@ -3093,6 +3248,22 @@ export function apply(ctx, pluginConfig) {
       await writeStoredGithubToken(raw);
       return { ok: true, tokenSet: true, summary: 'GitHub token 已保存：存在本机备份目录（0600），不进归档、不进 GitHub 同步。' };
     },
+    checkUpdate: async (signal) => {
+      const u = await checkUpdate(signal);
+      if (u.error) return { ok: false, current: SELF_META.version, latest: null, update: false, error: u.error, summary: `检查更新失败：${u.error}` };
+      return {
+        ok: true,
+        current: u.current,
+        latest: u.latest,
+        update: u.update,
+        error: null,
+        summary: u.update ? `发现新版本：${u.current} → ${u.latest}` : `已是最新版本：${u.current}`,
+      };
+    },
+    update: async (signal) => {
+      const r = await runUpdate(signal, 'web');
+      return { ok: r.ok, updated: r.updated, current: r.current ?? null, latest: r.latest ?? null, summary: r.summary };
+    },
   };
 
   // 仅在装配了 Typert registry 的 profile（Web）里挂载面板服务；其余 profile 安静跳过。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xiaoyuyu6420/dsh-backup",
-  "version": "0.12.1",
+  "version": "0.13.0",
   "description": "一键备份与恢复 DeepSeek Harness（dsh）的全部用户数据（~/.dsh）：定时自动备份、升级快照、会话日志体检修复、迁移预检、宿主起不来也能用的救援通道、凭据脱敏、GitHub 同步跨机迁移，附可视化面板。 One command to back up & restore all of ~/.dsh: /backup, scheduled auto-backup, upgrade snapshots, session doctor & repair, migrate precheck, out-of-process rescue console, credential redaction, GitHub sync.",
   "type": "module",
   "packageManager": "pnpm@11.24.0",

package/rescue/rescue.mjs

@@ -84,6 +84,10 @@ function run(argv, cwd) {
   return r.stdout.toString('utf8');
 }
 
+// #88：同 lib/index.js——parent 由字符串截取求得，DSH_HOME 挂盘符根时退化
+// 为 'D:'，裸盘符作 tar -C 会失败。-C 一律传补过分隔符的值。
+const parentTar = (p) => (p.endsWith('/') ? p : `${p}/`);
+
 async function sha256File(absPath) {
   const info = await fs.stat(absPath);
   if (info.size > HASH_MAX_BYTES) throw new Error(`文件 ${Math.floor(info.size / 1048576)}MB 超过哈希上限`);
@@ -420,7 +424,7 @@ async function doctorRepair(root, dshHome, selector) {
     kept.push(keep);
   }
   try {
-    run(['tar', '-xzf', picked.name, '-C', parent, ...targets.map((t) => t.entry)], root);
+    run(['tar', '-xzf', picked.name, '-C', parentTar(parent), ...targets.map((t) => t.entry)], root);
   } catch (err) {
     const reason = err && err.message ? err.message : String(err);
     const restored = new Set();
@@ -493,7 +497,13 @@ async function restoreArchive(root, selector, apply) {
     const sensitiveNow = new Set(SENSITIVE_DEFAULTS);
     if (Array.isArray(redactedFiles)) for (const rel of redactedFiles) sensitiveNow.add(rel);
     const redactFlags = [...sensitiveNow].flatMap((rel) => [`--exclude=${base}/${rel}`, `--exclude=*/${rel}`]);
-    run(['tar', '--exclude=*node_modules*', '--exclude=.system', ...redactFlags, '-czf', snapshotName, '-C', parent, base], root);
+    try {
+      run(['tar', '--exclude=*node_modules*', '--exclude=.system', ...redactFlags, '-czf', snapshotName, '-C', parentTar(parent), base], root);
+    } catch (err) {
+      // tar 失败留下的空壳快照不能留在恢复点列表里冒充可用备份（#88）
+      await fs.rm(`${root}/${snapshotName}`, { force: true }).catch(() => {});
+      throw err;
+    }
     // 清掉上一次的 pre-restore 快照（只保留本次），防累积
     for (const name of await fs.readdir(root)) {
       if (name.startsWith('dsh-pre-restore-') && name !== snapshotName) {
@@ -510,7 +520,7 @@ async function restoreArchive(root, selector, apply) {
     aside = `${parent}/${asideName}`;
   }
   try {
-    run(['tar', '-xzf', picked.name, '-C', parent], root);
+    run(['tar', '-xzf', picked.name, '-C', parentTar(parent)], root);
   } catch (err) {
     const reason = err && err.message ? err.message : String(err);
     let rolledBack = false;