前言¶
在 DeepSeek Harness（DSH）里，插件和 Skill 会随 profile 演进频繁增减、升级。常见做法是手工改配置或凭记忆对照「上次装过什么」，一旦升级后行为异常，很难说清楚磁盘上实际版本、声明规格与加载状态是否一致，也未必能在更新前留下可核对的证据。
DSH Version Manager 面向正在运行的 profile，提供已安装清单、更新预览、更新前可验证快照，以及仅在可行时才给出的恢复路径。它与「整包备份」或「一键回滚一切」不同：恢复范围有明确边界，Git、tarball 与本地产源还需要重放证据。下文按安装与使用顺序说明其能力与限制。
这是什么¶
DSH Version Manager（npm 包名 dsh-version-manager）是 maintainer Tang Yixiao（GitHub：tangyixiao）维护的 DSH 插件，归类为 admin-security。当前资料中的源版本为 0.1.3（以仓库 package.json 为准），软件许可证为 MIT，通过 npm 与 GitHub Releases 分发。
插件自述目标可以概括为四点：对「实际安装了什么」做诚实的清单；预览一次更新会改什么；在变更前记录可验证的快照；只有在恢复路径确实能工作时才向用户提供该路径。
核心功能¶
真实安装清单¶
界面侧强调三类信息对齐：声明的规格（Declared specs）、磁盘上的版本（disk versions）以及加载状态（load state）。便于在动手升级前，先核对当前 profile 里插件与 Skill 的真实情况，而不是仅看配置里的写法。
更新预览¶
在执行更新前，可先查看从当前状态到目标状态的精确变化（README 中表述为 from → to）。先预览再改，降低「升完才发现依赖或版本不符合预期」的成本。
可验证快照¶
在更新前写入快照，并能读回 SHA-256 等证据链（README 示意图主题为「Snapshot before update: Write and read back SHA-256 evidence」）。目的是让「更新前那一刻」的状态有据可查，而不是依赖口头或零散笔记。
显式恢复边界¶
恢复能力单独说明：已知状态与可用的恢复路径；不能恢复时不会假装可以。README 明确写道：Restore is not a full backup——恢复某一插件版本并不会自动回滚配置、依赖树或 agent presets。对 Git、tarball 和 local sources，还需要 replay evidence。这与「整环境时光机」类产品要区分开。
安装与启用¶
环境要求¶
| 项 | 要求（资料来源） |
|---|---|
| DSH | >=0.2.2-rc.1 |
| Node.js | >=22 |
| 插件版本 | 0.1.3（当前记录） |
Desktop¶
在资料给出的路径下，通过 Extensions → Plugin Management → Add Plugin 安装 release 提供的 .tgz 包。
可控的 Web profile¶
对你明确掌控的 Web profile，使用官方文档中的命令（版本号与包名须与发布一致）：
dsh plugin --profile web add dsh-version-manager@0.1.3
安装到已有的 Desktop 或 Web profile 后，打开 Version manager。若是新建的空 profile，资料还提醒：除本插件外通常还需要 Web app bundle。
更细的用法、配置与排错见仓库内 docs/guide.en.md（英文）。
典型用法（README 级流程）¶
README 给出的入门路径较短，可按下面顺序操作，细节以界面与 guide 为准：
- 按上一节完成安装，进入 Version manager。
- 先审阅 inventory（已安装清单），确认声明规格、磁盘版本与加载状态。
- 若要升级，先查看 from → to 的更新预览，再决定是否执行变更。
- 在真正更新前，利用快照能力留下可回读的证据；若之后需要恢复，仅在插件判定的可行范围内操作，并理解配置与依赖等不会随「插件版本恢复」一并回滚。
仓库 package.json 中 dsh.client 配置为 Web 平台且 immediately: true，表示客户端侧与 Web 侧的集成方式以清单为准，具体交互以运行中的 DSH 版本为准。
适用场景与注意¶
适合谁： 经常在同一 profile 上迭代插件与 Skill、希望在升级前有清单与预览、并需要在变更前留下可核验快照的 DSH 用户；关心 admin-security 类能力、希望对「能恢复什么」有明确预期的维护者。
使用边界： 不要把它当作全量备份或配置/依赖一键回滚工具。对来自 Git、压缩包或本地的来源，恢复叙事与 replay evidence 绑定，使用前应在 guide 中核对术语与步骤。
安全与信任： 插件在当前 DSH 进程权限下运行，能接触 profile 内的插件与 Skill 相关信息。安装前建议阅读 LICENSE、SECURITY.md 与源码；社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，生态遵循 DSH「一切皆插件」的扩展方式，本插件为社区维护的独立组件。
参与开发与质量门禁时，维护者在 README 中给出的本地检查包括：
npm test
node tools/check-repository.mjs
结尾¶
DSH Version Manager 把「看清楚装了什么、升级会改什么、升级前留下可验证快照、只在可行时谈恢复」串成一条可操作的版本管理路径，并坦诚标注恢复不能覆盖配置与依赖等范围。需要进一步了解分类、简介与链接时，可打开社区目录页 tangyixiao/dsh-version-manager；源码、Releases 与 issue 见 GitHub 仓库。
