dsh-unplug 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.2.2 (2026-08-20)
+
+- 中文本地化：CLI 帮助与输出、agent 工具描述双语；新增 README.zh.md。
+- 中文用户开箱即用。
+
+## 0.2.1 (2026-08-20)
+
+- Fix: 0.2.0 was published with a stale build (typecheck gate had failed).
+  This release ships the actual `reconcile` implementation.
+
 ## 0.2.0 (2026-08-20)
 
 - New `reconcile` command: auto-fix dangling bundles and orphaned patch rows

package/README.zh.md

@@ -0,0 +1,56 @@
+# dsh-unplug
+
+让 DeepSeek Harness（dsh）的插件**装得容易、拔得干净**。
+
+**为什么需要它？** 官方 `dsh plugin remove` 只处理 profile 里 `dsh.profile.bundles` 列表中的 bundle：
+
+- 不会清理 profile/home 的 `cordis.patch.yml` 里残留的插件行
+- 没有"禁用但保留配置"的能力（插拔自如）
+- 没有审计接口，拔完也不知道有没有残留
+
+`dsh-unplug` 补上这三个缺口。
+
+## 快速开始
+
+```sh
+dsh plugin add dsh-unplug
+```
+
+## 命令行
+
+```sh
+dsh-unplug list                         # 列出所有已挂载插件（bundles + 补丁行）
+dsh-unplug remove <插件> --yes          # 完整卸载（bundle + 补丁行 + 依赖）
+dsh-unplug disable <插件>               # 禁用但不删除（保留依赖，可随时启用）
+dsh-unplug enable <插件>                # 重新启用
+dsh-unplug audit                        # 检测孤立行 / 悬空 bundle
+dsh-unplug reconcile --yes              # 一键自动修复悬空与孤立状态
+```
+
+选项：`--profile <名>`（默认 `default`）、`--home <路径>`、`--json`、`--yes`。
+
+## Agent 可调用工具
+
+安装后 agent 获得 `unplug` 工具：
+
+- `list` / `audit` — 只读，任何时候可用
+- `remove` / `reconcile` — 需要 `force: true` 显式确认
+- `disable` / `enable` — 可逆操作，无需确认
+
+返回 `dsh-unplug/v1` 报告。
+
+## 工作原理
+
+- bundle 列表（`dsh.profile.bundles`）— 移出列表 + pnpm remove
+- 禁用列表（`dsh.profile.disabledBundles`）— 在 bundles/disabled 之间移动
+- profile 的 `cordis.patch.yml` — 删除插件行或切换 `disabled: true`
+- home 的 `cordis.patch.yml` — 同上
+- 孤立/悬空状态 — audit 发现，reconcile 修复
+
+## 安全
+
+默认只读；`remove` / `reconcile` 需要显式 `--yes`（CLI）或 `force: true`（工具）。
+
+## License
+
+MIT

package/lib/cli.js

@@ -10,27 +10,27 @@ import { removePlugin, setPluginEnabled } from './lib/remove.js';
 import { reconcile } from './lib/reconcile.js';
 function usage() {
     return [
-        'dsh-unplug — plug/unplug any DeepSeek Harness plugin cleanly',
+        'dsh-unplug — 让 DSH 插件插拔自如 / plug/unplug any DeepSeek Harness plugin cleanly',
         '',
-        'Usage:',
+        '用法 / Usage:',
         '  dsh-unplug <command> [options]',
         '',
-        'Commands:',
-        '  list               List all mounted plugin rows across bundles and patches',
-        '  remove <plugin>    Fully unplug a plugin (bundles + patch rows + dependencies)',
-        '  disable <plugin>   Disable without deleting (removes from bundles, keeps deps)',
-        '  enable <plugin>    Re-enable a disabled plugin (re-adds to bundles, clears disabled flag)',
-        '  audit              Detect orphaned rows, dangling bundles, missing patch files',
-        '  reconcile          Auto-fix dangling bundles and orphaned rows',
+        '命令 / Commands:',
+        '  list               列出所有已挂载插件（bundles + 补丁行） / list every mounted plugin row',
+        '  remove <plugin>    完整卸载（bundle + 补丁行 + 依赖） / fully unplug a plugin',
+        '  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',
         '',
-        'Options:',
-        '  --profile <name>   Profile name (default: default)',
-        '  --home <path>      DSH_HOME path (default: env DSH_HOME or ~/.dsh)',
-        '  --yes              Confirm destructive operations (remove)',
-        '  --json             Output machine-readable JSON report',
-        '  --help             Show this help',
+        '选项 / Options:',
+        '  --profile <name>   Profile 名（默认 default） / profile name',
+        '  --home <path>      DSH_HOME 路径（默认 env DSH_HOME 或 ~/.dsh） / DSH_HOME path',
+        '  --yes              确认破坏性操作（remove/reconcile 需要） / confirm destructive ops',
+        '  --json             输出机器可读 JSON / machine-readable JSON report',
+        '  --help             显示帮助 / show this help',
         '',
-        'Examples:',
+        '示例 / Examples:',
         '  dsh-unplug list',
         '  dsh-unplug remove dsh-disk-audit --yes',
         '  dsh-unplug disable dsh-readme-forge --profile my-profile',
@@ -88,27 +88,30 @@ function printResult(value, json) {
         case 'list':
         case 'audit':
             console.log(`Profile: ${report.profile ?? 'default'}`);
-            console.log(`Bundles (${(report.bundles ?? []).length}): ${(report.bundles ?? []).join(', ') || '(none)'}`);
-            console.log(`Disabled (${(report.disabledBundles ?? []).length}): ${(report.disabledBundles ?? []).join(', ') || '(none)'}`);
-            console.log(`Rows (${(report.rows ?? []).length})`);
+            console.log(`Bundles/已装 (${(report.bundles ?? []).length}): ${(report.bundles ?? []).join(', ') || '(无/none)'}`);
+            console.log(`Disabled/已禁用 (${(report.disabledBundles ?? []).length}): ${(report.disabledBundles ?? []).join(', ') || '(无/none)'}`);
+            console.log(`Rows/插件行 (${(report.rows ?? []).length})`);
             for (const row of (report.rows ?? [])) {
                 console.log(`  ${row.disabled ? '🔴' : '🟢'} ${row.id} (${row.name ?? ''}) [${row.layer}]`);
             }
             if ((report.issues ?? []).length > 0) {
-                console.log(`Issues (${report.issues.length}):`);
+                console.log(`Issues/问题 (${report.issues.length}):`);
                 for (const issue of report.issues) {
                     console.log(`  ⚠ ${issue.detail}`);
                 }
             }
             break;
         case 'remove':
-            console.log(`Removed: bundle=${report.removedBundle} patchRows=${report.patchRowsRemoved} pnpm=${report.pnpmRemoved}`);
+            console.log(`已卸载/Removed: bundle=${report.removedBundle} patchRows=${report.patchRowsRemoved} pnpm=${report.pnpmRemoved}`);
             if (report.note)
-                console.log(`Note: ${report.note}`);
+                console.log(`备注/Note: ${report.note}`);
             break;
         case 'disable':
         case 'enable':
-            console.log(`${report.enabled ? 'Enabled' : 'Disabled'}: bundleMoved=${report.bundleMoved} patchChanged=${report.patchChanged}`);
+            console.log(`${report.enabled ? '已启用/Enabled' : '已禁用/Disabled'}: bundleMoved=${report.bundleMoved} patchChanged=${report.patchChanged}`);
+            break;
+        case 'reconcile':
+            console.log(`已修复/Reconciled: fixedBundles=${(report.fixedBundles ?? []).length} fixedRows=${report.fixedRows}`);
             break;
     }
     return 0;

package/lib/index.js

@@ -40,32 +40,32 @@ export function apply(ctx, config) {
     assertPeerCompatible();
     ctx.tools.register(defineTool({
         name: 'unplug',
-        description: 'Manage plugins: list every mounted layer, remove a plugin cleanly (bundles + patch rows + dependencies), '
-            + 'disable/enable without deleting, and audit for orphaned/dangling plugin state. '
-            + 'Read-only commands (list, audit) are always allowed. Destructive commands (remove) require `force: true`. '
-            + 'Returns a dsh-unplug/v1 report.',
+        description: 'Manage DSH plugins / 插件生命周期管理: list every mounted layer, remove cleanly '
+            + '(bundles + patch rows + dependencies), disable/enable without deleting, audit and reconcile '
+            + 'orphaned/dangling state. Read-only commands (list, audit) are always allowed; destructive '
+            + 'commands (remove, reconcile) require `force: true`. Returns a dsh-unplug/v1 report.',
         parameters: {
             command: {
                 type: 'string',
                 required: true,
                 enum: ['list', 'remove', 'disable', 'enable', 'audit', 'reconcile'],
-                description: 'Action to perform',
+                description: 'Action to perform / 要执行的操作',
             },
             plugin: {
                 type: 'string',
-                description: 'Plugin id or package name to target (required for remove/disable/enable)',
+                description: 'Plugin id or package name / 插件 id 或包名 (required for remove/disable/enable)',
             },
             profile: {
                 type: 'string',
-                description: 'Profile name (defaults to the configured defaultProfile)',
+                description: 'Profile name / Profile 名 (defaults to the configured defaultProfile)',
             },
             force: {
                 type: 'boolean',
-                description: 'Required for remove: confirm the destructive operation',
+                description: 'Required for remove/reconcile: confirm the destructive operation / 确认破坏性操作',
             },
             home: {
                 type: 'string',
-                description: 'DSH_HOME path (defaults to env DSH_HOME or ~/.dsh)',
+                description: 'DSH_HOME path / DSH_HOME 路径 (defaults to env DSH_HOME or ~/.dsh)',
             },
         },
         output: {
@@ -92,6 +92,8 @@ export function apply(ctx, config) {
                     },
                     bundles: { type: 'array' },
                     disabledBundles: { type: 'array' },
+                    fixedBundles: { type: 'array' },
+                    fixedRows: { type: 'number' },
                 },
             },
             render: (_args, value) => [{ type: 'text', text: JSON.stringify(value, null, 2) }],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-unplug",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "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",
@@ -12,6 +12,7 @@
     "lib",
     "cordis.patch.yml",
     "README.md",
+    "README.zh.md",
     "SECURITY.md",
     "CONTRIBUTING.md",
     "CHANGELOG.md"