dsh-plugin-pack 1.0.15 → 1.0.16

package/lib/import.js

@@ -17,6 +17,7 @@ import { dshHome as resolveDshHome, profileDir as resolveProfileDir, profileName
 import { readJson, readText, writeJson, writeText, ensureDir, isDir, isFile, realOrSelf, copyTree, removeTree } from './util.js';
 import { existingIds, rowId, appendInsertBlock, splitTopLevel, yamlScalar } from './patch-text.js';
 import { isAbsoluteSpec, clearScanCache } from './scan.js';
+import { repairProfile } from './repair.js';
 
 export const PACK_FORMAT = 'dsh-plugin-pack@2';
 /** 兼容旧的散文件布局。 */
@@ -836,6 +837,18 @@ export function rollbackImport(options = {}) {
   // （早先这行写在 return 之后，成功路径根本执行不到）
   clearScanCache();
 
+  /* 回滚后对账：恢复回来的 package.json 可能声明了某个插件，
+   * 而它的 node_modules 链接/目录已经被更早的回滚删了。
+   * 不修的话 dsh 启动会报
+   *   cannot resolve profile bundle "xxx" ... run 'dsh plugin install'
+   * 而点「卸载」又会触发 pnpm（可能 store 版本不匹配直接失败）。 */
+  let repair = null;
+  try {
+    repair = repairProfile({ profileDir: profile });
+  } catch (error) {
+    repair = { ok: false, error: String(error?.message ?? error) };
+  }
+
   /* 标记该备份已消费：重命名加 .done，之后「最新备份」指向更早的、还没回滚过的那次。
    * 注意：pre-rollback 快照在备份目录里，重命名后它跟着一起搬到 .done 里，
    * 仍然可以取出来反悔。 */
@@ -859,6 +872,8 @@ export function rollbackImport(options = {}) {
     // 回滚前把当时的配置另存了一份，路径给出来方便反悔
     preRollbackDir: preRollbackFiles.length ? preRollbackDir : null,
     preRollbackFiles,
+    // 回滚后自动对账结果（补了哪些链接、清了哪些僵尸声明）
+    repair,
     restartRequired: true,
   };
 }

package/lib/repair.js

@@ -0,0 +1,146 @@
+/**
+ * 修复 profile 里「配置说有、磁盘上没有」的插件。
+ *
+ * 为什么需要：回滚会把 package.json 恢复成某份快照，那份快照可能声明了
+ * 某个插件，而它的 node_modules 链接（甚至目录）已经在更早的回滚里被删掉。
+ * 结果 dsh 启动时报：
+ *
+ *   cannot resolve profile bundle "dsh-pet" ... run 'dsh plugin install'
+ *
+ * 而点「卸载」又会触发 pnpm 安装（可能因为 store 版本不匹配直接失败）。
+ *
+ * 这里做的是把两边对齐：
+ *   目录在、链接缺        → 补链接（插件能正常用）
+ *   目录和链接都缺        → 从 dependencies / bundles 里移除（不留僵尸条目）
+ *   官方包（@deepseek-ai/*）→ 从 dsh 安装目录解析，永远跳过
+ *
+ * @module dsh-plugin-pack/lib/repair
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+
+import { readJson, writeJson, ensureDir, isDir } from './util.js';
+import { clearScanCache } from './scan.js';
+
+/** 这个包是不是宿主自带（从 dsh 安装目录解析）。 */
+function isOfficial(name) {
+  return String(name).startsWith('@deepseek-ai/');
+}
+
+/** 把 `link:./local-plugins/xxx` 里的目录段取出来；不是这种写法返回 null。 */
+function localSegment(spec) {
+  const text = String(spec ?? '');
+  if (!text.startsWith('link:')) return null;
+  const rel = text.slice('link:'.length).replace(/\\/g, '/');
+  const match = /(?:^|\/)local-plugins\/([^/]+)\/?$/.exec(rel);
+  return match ? match[1] : null;
+}
+
+/** node_modules 里这个包名的路径（scoped 要分两级）。 */
+function linkPathOf(profileDir, name) {
+  return path.join(profileDir, 'node_modules', ...String(name).split('/'));
+}
+
+/** 指向目标目录建一个 junction / symlink。 */
+function makeLink(linkPath, target) {
+  ensureDir(path.dirname(linkPath));
+  try {
+    fs.symlinkSync(target, linkPath, 'junction');
+    return true;
+  } catch {
+    try {
+      fs.symlinkSync(target, linkPath, process.platform === 'win32' ? 'junction' : 'dir');
+      return true;
+    } catch {
+      return false;
+    }
+  }
+}
+
+/**
+ * 对齐 profile 的声明与实际磁盘。
+ *
+ * @param {object} options
+ * @param {string} options.profileDir
+ * @param {boolean} [options.dryRun] 只算不改
+ * @returns {{ ok: boolean, linked: string[], removed: string[], unlinked: string[], warnings: string[] }}
+ */
+export function repairProfile({ profileDir, dryRun = false }) {
+  const profile = path.resolve(profileDir);
+  const pkgFile = path.join(profile, 'package.json');
+  const pkg = readJson(pkgFile, null);
+  if (!pkg || typeof pkg !== 'object') {
+    const error = new Error(`profile 里没有 package.json: ${pkgFile}`);
+    error.code = 'BAD_PROFILE';
+    throw error;
+  }
+
+  pkg.dependencies = pkg.dependencies && typeof pkg.dependencies === 'object' ? pkg.dependencies : {};
+  pkg.dsh = pkg.dsh && typeof pkg.dsh === 'object' ? pkg.dsh : {};
+  pkg.dsh.profile = pkg.dsh.profile && typeof pkg.dsh.profile === 'object' ? pkg.dsh.profile : {};
+  const bundles = Array.isArray(pkg.dsh.profile.bundles) ? pkg.dsh.profile.bundles : [];
+
+  const linked = [];
+  const removed = [];
+  const unlinked = [];
+  const warnings = [];
+
+  const dropNames = new Set();
+
+  for (const [name, spec] of Object.entries(pkg.dependencies)) {
+    if (isOfficial(name)) continue; // 宿主自带，不碰
+    const seg = localSegment(spec);
+    if (!seg) continue; // 只处理本工具自己写的那种 link
+
+    const dir = path.join(profile, 'local-plugins', seg);
+    const linkPath = linkPathOf(profile, name);
+    const dirOk = isDir(dir);
+    const linkOk = fs.existsSync(linkPath);
+
+    if (dirOk && !linkOk) {
+      // 目录在、链接缺 → 补上，插件恢复可用
+      if (!dryRun && makeLink(linkPath, dir)) linked.push(name);
+      else if (dryRun) linked.push(name);
+      else warnings.push(`补链接失败: ${name}`);
+      continue;
+    }
+
+    if (!dirOk) {
+      // 目录没了 → 不论链接在不在，这条声明都是僵尸
+      if (linkOk) {
+        if (!dryRun) {
+          try {
+            fs.unlinkSync(linkPath);
+            unlinked.push(name);
+          } catch {
+            try {
+              fs.rmSync(linkPath, { recursive: true, force: true });
+              unlinked.push(name);
+            } catch {
+              /* 删不掉就留着，至少别写进删名单 */
+            }
+          }
+        } else {
+          unlinked.push(name);
+        }
+      }
+      dropNames.add(name);
+    }
+  }
+
+  if (dropNames.size) {
+    for (const name of dropNames) {
+      delete pkg.dependencies[name];
+      removed.push(name);
+    }
+    pkg.dsh.profile.bundles = bundles.filter((name) => !dropNames.has(name));
+  }
+
+  if (!dryRun && (linked.length || removed.length)) {
+    writeJson(pkgFile, pkg);
+    // 配置和磁盘刚对齐，扫描缓存必须失效
+    clearScanCache();
+  }
+
+  return { ok: true, linked, removed, unlinked: unlinked, warnings };
+}

package/lib/server.js

@@ -40,6 +40,7 @@ import {
 import { runJob, listJobs, getJob, runningJobs, clearFinished, openWaiting, getWaiting, listWaiting, cancelWaiting } from './jobs.js';
 import { fetchBundleFrom, parseSource } from './fetch-bundle.js';
 import { setPluginsEnabled, getEnabledState } from './enable.js';
+import { repairProfile } from './repair.js';
 import { dshHome as resolveDshHome, profileDir as resolveProfileDir, profileName as resolveProfileName, humanBytes } from './home.js';
 import { readJson, writeJson, isDir, isFile } from './util.js';
 
@@ -737,6 +738,35 @@ export function mountRoutes(ctx, config = {}) {
         'plugin-pack: enable',
       );
 
+      /* 对账修复：把 package.json 与实际磁盘对齐。
+       *   POST /plugin-pack/repair { dryRun }
+       *
+       * 解决"配置里有、磁盘上没有"导致 dsh 报
+       * cannot resolve profile bundle "xxx" 的情况：
+       *   - 目录在、链接缺 → 补链接（插件恢复可用）
+       *   - 目录和链接都缺 → 从 dependencies/bundles 移除（清僵尸条目）
+       */
+      register(
+        {
+          kind: 'exact',
+          path: `${PREFIX}/repair`,
+          handler: async (request, response) => {
+            if (request.method !== 'POST') {
+              sendJson(response, 405, { ok: false, error: '只支持 POST' });
+              return;
+            }
+            const body = await readJsonBody(request).catch(() => ({}));
+            const local = contextOf(config);
+            const result = repairProfile({
+              profileDir: local.profileDir,
+              dryRun: Boolean(body.dryRun),
+            });
+            sendJson(response, 200, result);
+          },
+        },
+        'plugin-pack: repair',
+      );
+
       /* 待决策任务：导入遇到重名时登记，界面切走再回来靠它捡回弹窗。
        *   GET  /plugin-pack/waiting            列出待决策任务（含冲突列表）
        *   POST /plugin-pack/waiting/cancel     取消（用户切走/关页面/点取消）

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-pack",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "description": "DeepSeek Harness 插件整合包：一键把当前 profile 的第三方插件连依赖和配置导出成 zip（内部每个插件是标准 npm tgz），换机/换 profile 拖进去就能还原。",
   "type": "module",
   "main": "lib/index.js",