前言¶

在 DeepSeek Harness（DSH）里，智能体行为往往由 AGENTS.md、CLAUDE.md、Skill 文件等「指令面」共同决定。这些文件会随迭代、插件注入或模型改写而变动；若只靠编辑器历史或手工备份，很难回答「谁在什么时候改了哪一段」「能否安全撤销」。下面介绍社区插件 dsh-prompt-vcs（目录标识 hj01857655/dsh-prompt-vcs）：在本地对指令相关文件的每次变更做 diff 记录，并提供时间线、查看差异与回滚能力。

DSH 生态采用「一切皆插件」的扩展方式；SkillHub 等社区目录独立于 DeepSeek / 幻方，并非官方应用商店。安装第三方插件前，应自行审阅源码与许可证。

这是什么¶

dsh-prompt-vcs 由维护者 hj01857655 发布，npm 包名为 dsh-prompt-vcs（MIT 许可证）。一句话定位：对塑造智能体行为的文件做变更追踪，每次修改写入带 unified diff 与归因的历史，并支持按变更回滚。

SkillHub 目录页标注该条目 [已归档]，源码已并入 monorepo hj01857655/dsh-plugins；独立仓库 github.com/hj01857655/dsh-prompt-vcs 当前已不可用。截至 2026-10-20，monorepo 工作区已收缩，dsh-prompt-vcs 等包从仓库中移除，但 npm 上仍可安装，安装方式不变（见 monorepo README 说明）。

核心功能¶

以下能力来自 npm 包 README（与包内文档一致）：

1. 监听指令面文件
   覆盖 AGENTS.md、CLAUDE.md、Skill 文件等会影响智能体行为的文件。

2. 变更快照
   文件变化时生成 unified diff，并记录归因（user / plugin / agent），追加写入 .promptvcs/history.jsonl（仅追加）。

3. 时间线
   promptvcs log（CLI 中为 dsh-prompt-vcs log）列出每次变更的时间、目标文件、操作者与增删行数。

4. 查看 diff
   promptvcs diff <hash> 展示某次变更的 unified diff。

5. 回滚
   promptvcs rollback <hash> 将文件恢复到该次变更之前的状态；回滚本身也会作为新记录写入，时间线保持完整。

6. 文件统计
   按文件统计变更频率与变更规模随时间的变化。

7. 设置面板
   在 Settings 中提供 Prompt VCS 页面：内联 diff 时间线、按文件统计、归因与回滚按钮。宿主注册 GET /api/prompt-vcs.panel，每次请求从历史日志重建数据；无 Web 界面的 headless 宿主可跳过该路由。

安装与启用¶

官方 README 给出的安装方式如下（使用 npm 包名，而非凭目录名拼接 GitHub 路径）：

dsh plugin --profile web add dsh-prompt-vcs

若从源码安装（独立 GitHub 仓库已归档时，需以你实际可用的源码地址为准；README 原文为）：

dsh plugin --profile web add github:hj01857655/dsh-prompt-vcs

SkillHub 亦支持通过对话让 DSH 读取后端安装计划后安装，例如在 Harness 中说明：「请安装 DSH 插件 hj01857655/dsh-prompt-vcs。先读取安装计划。」具体步骤以 Harness 与目录页当时展示为准。

npm 上最新版本为 0.6.1（SkillHub 目录页曾展示 v0.5.1，以你安装时解析到的版本为准）。peer 依赖 @deepseek-ai/cordis（约 ~4.0.4）。

典型用法¶

CLI¶

在已安装插件的前提下，可用下列命令操作历史（命令前缀以包内 bin 为准）：

dsh-prompt-vcs log               # 查看变更历史
dsh-prompt-vcs diff <hash>       # 查看某次变更的 diff
dsh-prompt-vcs rollback <hash>   # 撤销某次变更

设置面板¶

启用 --profile web 的安装配置后，在 DSH Settings 中打开 Prompt VCS 页面，可浏览时间线、查看内联 diff、查看归因并触发回滚，无需逐条手敲 hash。

本地开发（维护者流程）¶

若需从包源码构建与测试，README 建议：

npm ci
npm run typecheck
npm run build
npm test

适用场景与注意¶

适合谁

• 频繁改 AGENTS.md、项目 Skill 或 Claude 风格指令文件的 DSH 用户。
• 需要区分「用户 / 插件 / 智能体」谁改动了指令、并偶尔回滚的团队或个人。

务必注意

1. 权限：插件以当前 dsh 进程权限 运行，可读写工作区内的指令文件与 .promptvcs/ 历史；安装前请阅读 npm 包或源码，确认行为符合预期。
2. 仓库与归档：目录页与 monorepo 均说明历史合并与收缩；长期维护以 npm 包 dsh-prompt-vcs 与 dsh-plugins 文档为准。
3. 历史文件：历史位于项目下的 .promptvcs/history.jsonl，纳入版本控制或备份策略时需自行决定（是否提交、是否忽略）。

结尾¶

dsh-prompt-vcs 把「指令面」当成需要审计的版本化资产：变更有 diff、有归因、可回滚，并可选 Web 面板浏览。若你在 DSH 中依赖 Markdown 与 Skill 驱动行为，值得在审阅源码与许可证后试用。

• SkillHub 目录：https://www.skillhub.cn/plugins/hj01857655/dsh-prompt-vcs
• npm / 文档：https://www.npmjs.com/package/dsh-prompt-vcs
• 相关 monorepo：https://github.com/hj01857655/dsh-plugins