dsh-plugin-version-management

Readme

# dsh-plugin-version-management

DSH 插件版本快照与快速回滚工具：一键快照所有已安装插件（JSON + 人读 TXT + 离线恢复脚本），上传快照即可恢复整个插件环境。

## 功能

- **版本快照**：记录全部已装第三方插件的名称、要求版本、实际安装版本，保存为一个文件夹（含 `dsh-plugin-snapshot.json` / `dsh-plugin-snapshot.txt` / 离线恢复脚本）
- **一键恢复**：上传或选择快照 → 勾选插件逐步确认，或一键全部恢复（写回 `package.json` + 自动 `pnpm install`）
- **设置页 UI**：设置 → 「插件版本恢复」（当前插件清单 / 生成快照 / 历史快照 / 上传恢复）
- **对话工具**：`dsh_plugin_snapshot`（生成快照）、`dsh_plugin_restore`（恢复，支持指定快照/指定插件）
- **路径自动探测**：无硬编码机器路径，自动发现 DSH profile 目录与可写工作区，任何机器可用

## 安装

### 从 GitHub 安装

```bash
dsh plugin --profile web add github:lw-storm/dsh-plugin-version-management
```

### 本地目录安装（开发调试）

```bash
dsh plugin --profile web add "/path/to/dsh-plugin-version-management/pkg"
```

安装完成后**重启 DSH** 生效（设置页刷新浏览器即可看到新分区）。

## 使用

### 设置页操作

1. DSH 设置 → 「插件版本恢复」
2. 查看当前已安装插件清单
3. 点击「生成版本快照」
4. 快照保存在工作区 `dsh-plugin-version-management/snapshot-<时间>/` 文件夹内
5. 恢复：选择历史快照或上传 JSON → 预览变更 → 恢复所选 / 一键全部恢复
6. 重启 DSH 生效

### 对话中使用

- 「帮我拍个插件版本快照」→ 调用 `dsh_plugin_snapshot`
- 「恢复到上一个快照」→ 调用 `dsh_plugin_restore`

## 灾难恢复（所有插件被清空、DSH 无法启动后）

1. 先修好 DSH 启动问题（删掉问题插件 / 清空插件列表）
2. 装回本插件（一条命令，见上）
3. DSH 设置 → 「插件版本恢复」→ 选择快照 → 一键恢复 → 重启

**或**不用本插件：直接运行快照文件夹里的离线脚本：

```powershell
powershell -NoProfile -ExecutionPolicy Bypass -File "<快照文件夹>/dsh-plugin-restore.ps1"
```

## 注意事项

- 快照只覆盖**第三方安装插件**（bundles 中非 `@deepseek-ai/*` 的条目）；官方基础包保持现状
- 恢复会修改 `%DSH_HOME%/profiles/<profile>/package.json` 并执行 `pnpm install`（网络或 pnpm 缓存）
- 包为纯 JavaScript，无构建步骤；安装后本插件自身也会进入快照清单，形成闭环

## License

MIT