@xiaoyuyu6420/dsh-backup 0.12.2 → 0.13.1

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) {
@@ -652,6 +678,100 @@ export function apply(ctx, pluginConfig) {
   // （'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);
@@ -2616,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 {
@@ -2680,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') {
@@ -3109,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.2",
+  "version": "0.13.1",
   "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",
@@ -53,12 +53,12 @@
   ],
   "peerDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-commands": "^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-fs": "^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-subprocess": "^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.5-rc.1",
-    "@deepseek-ai/dsh-typert-protocol": "^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.5-rc.1",
+    "@deepseek-ai/dsh-commands": "^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.5-rc.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-fs": "^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.5-rc.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-settings": "^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.5-rc.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-subprocess": "^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.5-rc.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-tools": "^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.5-rc.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1",
+    "@deepseek-ai/dsh-typert-protocol": "^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.5-rc.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
   "devDependencies": {
@@ -69,7 +69,7 @@
   },
   "engines": {
     "node": ">=20",
-    "dsh": "^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.5-rc.1"
+    "dsh": "^0.1.1-rc.2 || ^0.1.2-rc.1 || ^0.1.5-rc.1 || ^0.1.6-alpha.1 || ^0.1.7-alpha.1"
   },
   "license": "MIT",
   "repository": {