前言¶

在 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