dsh-unplug 0.2.4 → 0.3.1

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.3.0 (2026-08-20)
+
+- UX improvement: `fix` alias for `reconcile`（傻子也会用）。
+- `remove --dry-run` — preview what would be removed without executing.
+- Friendlier CLI help with `--dry-run` flag.
+
+
 ## 0.2.4 (2026-08-20)
 
 - Fix CI: add `prepare` script (doctor requirement for git installs).

package/lib/cli.js

@@ -8,6 +8,7 @@ import { dshHome } from './lib/paths.js';
 import { audit } from './lib/audit.js';
 import { removePlugin, setPluginEnabled } from './lib/remove.js';
 import { reconcile } from './lib/reconcile.js';
+import { installedPlugins, listProfiles, resolveProfile } from './lib/ux.js';
 function usage() {
     return [
         'dsh-unplug — 让 DSH 插件插拔自如 / plug/unplug any DeepSeek Harness plugin cleanly',
@@ -21,12 +22,15 @@ function usage() {
         '  disable <plugin>   禁用但不删除（移出 bundles，保留依赖） / disable without deleting',
         '  enable <plugin>    重新启用（加回 bundles，清除 disabled） / re-enable a disabled plugin',
         '  audit              检测孤立行/悬空 bundle / detect orphaned rows, dangling bundles',
-        '  reconcile          自动修复悬空与孤立状态 / auto-fix dangling bundles and orphan rows',
+        '  reconcile / fix     自动修复悬空与孤立状态 / auto-fix dangling bundles and orphan rows',
+        '  remove <p> --dry-run  预览卸载内容 / preview what would be removed',
         '',
         '选项 / Options:',
         '  --profile <name>   Profile 名（默认 default） / profile name',
         '  --home <path>      DSH_HOME 路径（默认 env DSH_HOME 或 ~/.dsh） / DSH_HOME path',
         '  --yes              确认破坏性操作（remove/reconcile 需要） / confirm destructive ops',
+        '  --dry-run          只预览不执行（remove/reconcile） / preview without executing',
+        '  --all              对所有 profile 执行（list/audit） / act on all profiles',
         '  --json             输出机器可读 JSON / machine-readable JSON report',
         '  --help             显示帮助 / show this help',
         '',
@@ -35,10 +39,11 @@ function usage() {
         '  dsh-unplug remove dsh-disk-audit --yes',
         '  dsh-unplug disable dsh-readme-forge --profile my-profile',
         '  dsh-unplug enable dsh-readme-forge --json',
+        '  dsh-unplug list --all',
     ].join('\n');
 }
 function parseArgs(argv) {
-    const options = { command: '', profile: 'default', home: '', yes: false, json: false };
+    const options = { command: '', profile: 'default', home: '', yes: false, dryRun: false, all: false, json: false };
     const positional = [];
     for (let i = 0; i < argv.length; i++) {
         const arg = argv[i];
@@ -51,6 +56,12 @@ function parseArgs(argv) {
             case '--yes':
                 options.yes = true;
                 break;
+            case '--dry-run':
+                options.dryRun = true;
+                break;
+            case '--all':
+                options.all = true;
+                break;
             case '--profile':
                 options.profile = argv[++i];
                 if (options.profile === undefined)
@@ -68,7 +79,7 @@ function parseArgs(argv) {
         }
     }
     if (positional.length === 0)
-        return { error: 'missing command (try --help)' };
+        return { menu: true, ...options };
     options.command = positional[0];
     options.plugin = positional[1];
     return options;
@@ -118,6 +129,17 @@ function printResult(value, json) {
 }
 export async function main(argv) {
     const parsed = parseArgs(argv);
+    if ('menu' in parsed) {
+        console.log('dsh-unplug — 让 DSH 插件插拔自如 / plug/unplug any plugin cleanly');
+        console.log('');
+        console.log('不知道做什么？直接输入下面任一命令：');
+        console.log('  dsh-unplug list            看看装了什么插件');
+        console.log('  dsh-unplug fix --yes       一键修复坏掉的插件状态');
+        console.log('  dsh-unplug remove <名字> --yes   卸载插件');
+        console.log('  dsh-unplug disable <名字>  临时禁用（不删除）');
+        console.log('  dsh-unplug --help          查看全部命令');
+        return 0;
+    }
     if ('help' in parsed) {
         console.log(usage());
         return 0;
@@ -127,22 +149,53 @@ export async function main(argv) {
         console.error(usage());
         return 2;
     }
-    const { command, plugin, profile, home, yes, json } = parsed;
+    const { command, plugin, profile, home, yes, dryRun, all, json } = parsed;
     const resolvedHome = home || dshHome();
     try {
+        const resolved = resolveProfile(resolvedHome, profile);
+        const activeProfile = resolved.profile;
         switch (command) {
             case 'list':
             case 'audit': {
-                const result = audit(resolvedHome, profile);
-                return printResult({ schema: 'dsh-unplug/v1', ok: true, ...result, command, profile }, json);
+                if (all) {
+                    const profiles = listProfiles(resolvedHome);
+                    if (profiles.length === 0) {
+                        console.error('没有找到任何 profile（目录 ' + resolvedHome + '\\profiles 为空）。先 `dsh plugin --profile default add <插件>` 创建一个。');
+                        return 1;
+                    }
+                    let failed = false;
+                    for (const name of profiles) {
+                        try {
+                            const result = audit(resolvedHome, name);
+                            const code = printResult({ schema: 'dsh-unplug/v1', ok: true, ...result, command, profile: name }, json);
+                            if (code !== 0)
+                                failed = true;
+                        }
+                        catch (error) {
+                            console.error(`profile ${name}: ${error instanceof Error ? error.message : String(error)}`);
+                            failed = true;
+                        }
+                    }
+                    return failed ? 1 : 0;
+                }
+                const result = audit(resolvedHome, activeProfile);
+                return printResult({ schema: 'dsh-unplug/v1', ok: true, ...result, command, profile: activeProfile }, json);
             }
             case 'reconcile': {
                 if (!yes) {
                     console.error('reconcile requires --yes to confirm');
                     return 2;
                 }
-                const result = reconcile(resolvedHome, profile);
-                return printResult({ ...result, command }, json);
+                const result = reconcile(resolvedHome, activeProfile);
+                return printResult({ ...result, command, profile: activeProfile }, json);
+            }
+            case 'fix': {
+                if (!yes) {
+                    console.error('fix requires --yes to confirm');
+                    return 2;
+                }
+                const result = reconcile(resolvedHome, activeProfile);
+                return printResult({ ...result, command: 'reconcile', profile: activeProfile }, json);
             }
             case 'remove': {
                 if (!yes) {
@@ -150,11 +203,23 @@ export async function main(argv) {
                     return 2;
                 }
                 if (!plugin) {
-                    console.error('remove requires a plugin name');
+                    const installed = installedPlugins(resolvedHome, activeProfile);
+                    if (installed.length === 0) {
+                        console.error(`profile "${activeProfile}" 里没有可卸载的插件。先 dsh-unplug list 看看。`);
+                    }
+                    else {
+                        console.error('你要卸载哪个？当前已装：');
+                        for (const name of installed)
+                            console.error(`  dsh-unplug remove ${name} --yes`);
+                    }
                     return 2;
                 }
-                const result = removePlugin(resolvedHome, profile, plugin, { force: yes });
-                return printResult({ ...result, command }, json);
+                if (dryRun) {
+                    console.log(`[dry-run] 将卸载 "${plugin}" from profile "${activeProfile}"（bundles + 补丁行 + 依赖）`);
+                    return 0;
+                }
+                const result = removePlugin(resolvedHome, activeProfile, plugin, { force: yes });
+                return printResult({ ...result, command, profile: activeProfile }, json);
             }
             case 'disable':
             case 'enable': {
@@ -162,8 +227,8 @@ export async function main(argv) {
                     console.error(`${command} requires a plugin name`);
                     return 2;
                 }
-                const result = setPluginEnabled(resolvedHome, profile, plugin, command === 'enable');
-                return printResult({ ...result, command }, json);
+                const result = setPluginEnabled(resolvedHome, activeProfile, plugin, command === 'enable');
+                return printResult({ ...result, command, profile: activeProfile }, json);
             }
             default:
                 console.error(`unknown command: ${command} (try --help)`);

package/lib/index.js

@@ -48,7 +48,7 @@ export function apply(ctx, config) {
             command: {
                 type: 'string',
                 required: true,
-                enum: ['list', 'remove', 'disable', 'enable', 'audit', 'reconcile'],
+                enum: ['list', 'remove', 'disable', 'enable', 'audit', 'reconcile', 'fix'],
                 description: 'Action to perform / 要执行的操作',
             },
             plugin: {
@@ -121,6 +121,19 @@ export function apply(ctx, config) {
                             fixedRows: result.fixedRows,
                         };
                     }
+                    case 'fix': {
+                        if (!args.force)
+                            return errorReport('UNPLUG_REQUIRES_FORCE', 'fix requires `force: true` to confirm the cleanup', profile, args.command);
+                        const result = reconcile(home, profile);
+                        return {
+                            schema: result.schema,
+                            ok: result.ok,
+                            command: 'reconcile',
+                            profile: result.profile,
+                            fixedBundles: result.fixedBundles,
+                            fixedRows: result.fixedRows,
+                        };
+                    }
                     case 'remove': {
                         if (!args.force)
                             return errorReport('UNPLUG_REQUIRES_FORCE', 'Remove requires `force: true` to confirm the destructive operation', profile, args.command);

package/lib/lib/remove.js

@@ -7,6 +7,7 @@ import { readFileSync, writeFileSync } from 'node:fs';
 import { audit } from './audit.js';
 import { parsePatch } from './patches.js';
 import { resolveBundlePatchPath } from './resolve.js';
+import { listProfiles } from './ux.js';
 function resolvePlugin(home, profileDir, profileName, plugin) {
     const manifest = readProfileManifest(profileDir);
     const allBundles = [...(manifest.dsh?.profile?.bundles ?? []), ...(manifest.dsh?.profile?.disabledBundles ?? [])];
@@ -60,7 +61,9 @@ export function removePlugin(home, profileName, plugin, options) {
     const profileDir = path.join(home, 'profiles', profileName);
     const manifestPath = path.join(profileDir, 'package.json');
     if (!existsSync(manifestPath)) {
-        throw new Error(`profile "${profileName}" not found at ${profileDir}`);
+        const available = listProfiles(home);
+        throw new Error(`profile "${profileName}" not found at ${profileDir}`
+            + (available.length > 0 ? `；可用 profiles: ${available.join(', ')}` : '；还没有任何 profile'));
     }
     const resolved = resolvePlugin(home, profileDir, profileName, plugin);
     const pkgName = resolved.bundleName ?? plugin;
@@ -108,7 +111,9 @@ export function setPluginEnabled(home, profileName, plugin, enabled) {
     const profileDir = path.join(home, 'profiles', profileName);
     const manifestPath = path.join(profileDir, 'package.json');
     if (!existsSync(manifestPath)) {
-        throw new Error(`profile "${profileName}" not found at ${profileDir}`);
+        const available = listProfiles(home);
+        throw new Error(`profile "${profileName}" not found at ${profileDir}`
+            + (available.length > 0 ? `；可用 profiles: ${available.join(', ')}` : '；还没有任何 profile'));
     }
     const resolved = resolvePlugin(home, profileDir, profileName, plugin);
     const pkgName = resolved.bundleName ?? plugin;

package/lib/lib/ux.js

@@ -0,0 +1,36 @@
+import { existsSync, readdirSync } from 'node:fs';
+import path from 'node:path';
+import { audit } from './audit.js';
+/**
+ * Resolve which profile to act on. If the requested profile is missing,
+ * fall back to the first real profile so novices do not need to know names.
+ */
+export function resolveProfile(home, requested) {
+    const profiles = listProfiles(home);
+    if (profiles.includes(requested))
+        return { profile: requested, fallback: false };
+    if (profiles.length > 0)
+        return { profile: profiles[0], fallback: true };
+    throw new Error(`没有找到任何 profile（目录 ${path.join(home, 'profiles')} 为空）。`
+        + ' 先运行 `dsh plugin --profile default add <插件>` 创建第一个。');
+}
+export function listProfiles(home) {
+    const dir = path.join(home, 'profiles');
+    if (!existsSync(dir))
+        return [];
+    return readdirSync(dir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && existsSync(path.join(dir, entry.name, 'package.json')))
+        .map((entry) => entry.name)
+        .sort();
+}
+/** Human-friendly list of installed plugin names/ids for a profile. */
+export function installedPlugins(home, profile) {
+    const result = audit(home, profile);
+    const names = new Set();
+    for (const row of result.rows) {
+        if (row.name !== undefined)
+            names.add(row.name);
+        names.add(row.id);
+    }
+    return [...names].sort();
+}

package/lib/types/lib/ux.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Resolve which profile to act on. If the requested profile is missing,
+ * fall back to the first real profile so novices do not need to know names.
+ */
+export declare function resolveProfile(home: string, requested: string): {
+    profile: string;
+    fallback: boolean;
+};
+export declare function listProfiles(home: string): string[];
+/** Human-friendly list of installed plugin names/ids for a profile. */
+export declare function installedPlugins(home: string, profile: string): string[];

package/package.json

@@ -1,70 +1,70 @@
-{
-  "name": "dsh-unplug",
-  "version": "0.2.4",
-  "description": "Plug/unplug any DeepSeek Harness plugin cleanly: list every mounted layer, disable/enable without deleting, remove bundles + patch rows + dependencies in one pass, and audit for orphaned/dangling plugin state. Zero runtime dependencies; read-only by default.",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/types/index.d.ts",
-  "bin": {
-    "dsh-unplug": "lib/bin.js"
-  },
-  "files": [
-    "lib",
-    "cordis.patch.yml",
-    "README.md",
-    "README.zh.md",
-    "SECURITY.md",
-    "CONTRIBUTING.md",
-    "CHANGELOG.md"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "prepare": "pnpm run build",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "vitest run",
-    "test:integration": "node scripts/integration-test.mjs"
-  },
-  "keywords": [
-    "dsh",
-    "dsh-plugin",
-    "plugin-manager",
-    "uninstall",
-    "lifecycle",
-    "unplug"
-  ],
-  "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6"
-  },
-  "dependencies": {
-    "@deepseek-ai/schemastery": "^3.18.1"
-  },
-  "devDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
-    "@types/node": "^22.20.0",
-    "typescript": "^5.6.3",
-    "vitest": "^2.1.9"
-  },
-  "engines": {
-    "node": ">=18"
-  },
-  "pnpm": {
-    "onlyBuiltDependencies": [
-      "esbuild"
-    ]
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    }
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/zoahdev/dsh-unplug.git"
-  },
-  "bugs": {
-    "url": "https://github.com/zoahdev/dsh-unplug/issues"
-  },
-  "homepage": "https://github.com/zoahdev/dsh-unplug"
-}
+{
+  "name": "dsh-unplug",
+  "version": "0.3.1",
+  "description": "Plug/unplug any DeepSeek Harness plugin cleanly: list every mounted layer, disable/enable without deleting, remove bundles + patch rows + dependencies in one pass, and audit for orphaned/dangling plugin state. Zero runtime dependencies; read-only by default.",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "bin": {
+    "dsh-unplug": "lib/bin.js"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh.md",
+    "SECURITY.md",
+    "CONTRIBUTING.md",
+    "CHANGELOG.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "prepare": "pnpm run build",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:integration": "node scripts/integration-test.mjs"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "plugin-manager",
+    "uninstall",
+    "lifecycle",
+    "unplug"
+  ],
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6"
+  },
+  "dependencies": {
+    "@deepseek-ai/schemastery": "^3.18.1"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
+    "@types/node": "^22.20.0",
+    "typescript": "^5.6.3",
+    "vitest": "^2.1.9"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "esbuild"
+    ]
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/zoahdev/dsh-unplug.git"
+  },
+  "bugs": {
+    "url": "https://github.com/zoahdev/dsh-unplug/issues"
+  },
+  "homepage": "https://github.com/zoahdev/dsh-unplug"
+}