前言¶

DSH 的理念是“一切皆插件”。dsh-change-center 處理的是 agent 工具產生文件變更後的統一處理問題：捕獲 write、edit、bash 結果，形成變更會話，並提供審查、回滾、恢復和塊級操作入口。下面按已覈實資料介紹它的功能、接入方式和可用命令。

這是什麼¶

dsh-change-center 是 DeepSeek Harness 插件，維護者爲 Chance-Wu，許可證爲 MIT。

一句話定位：文件變更的捕獲 → 審查 → 回滾 / 恢復 / 塊級操作中心。

資料說明，5.x 已移除審批(approve)與拒絕(reject)，並移除了應用/全部應用按鈕與端點。其主路徑是 capture 即登記：文件變更直接 applied，並建立 before 快照。

核心功能¶

捕獲與登記¶

插件捕獲 tools/result 中的 write、edit、bash 結果，並記錄爲文件變更或命令記錄。

它按 agent turn 自動分組爲變更會話。同一會話內對同一路徑的多次寫入會合併爲一條記錄。

capture 即登記表示文件變更被捕獲後直接標記爲 applied，並建立 before 快照，使回滾能力隨之可用。

回滾與恢復¶

狀態機中的可用狀態如下：

• applied：可回滾。
• rolled_back：可恢復。
• pending / failed：歷史狀態。

回滾用於恢復捕獲前版本；恢復用於撤銷回滾，寫回 agent 版本。

塊級操作¶

插件支持塊級操作：應用或撤銷單個 hunk，以及在塊內編輯並保存該塊。

Diff 視圖與變更樹¶

Diff 視圖支持統一、並排、編輯三種模式，所有模式顯示行號。

變更樹支持目錄樹或按擴展名分組，並支持大倉模式下的搜索、過濾和窗口化渲染。

審查輔助與後臺任務¶

插件提供 AI 審查、風險、驗證、Git、歷史、修復等輔助能力。

後臺任務可以提交併通過 JobHandle 等待或取消；/events SSE 用於推送事件。

安裝與啓用¶

資料只給出接入方式：將本包加入 profile 的 dsh.profile.bundles，作爲 profile bundle 接入。

dsh.profile.bundles

將 dsh-change-center 加入該配置項。

接入前，建議確認依賴滿足 peerDependencies：

{
  "peerDependencies": {
    "@deepseek-ai/cordis": ">=4.0.0",
    "@deepseek-ai/dsh-agent": "^0.1.0-rc.5",
    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.5",
    "@deepseek-ai/dsh-session": "^0.1.0-rc.5",
    "@deepseek-ai/dsh-tools": "^0.1.0-rc.5"
  }
}

典型用法¶

界面快捷鍵¶

J / K 或 ↑ / ↓：切換文件
U / Z：回滾
Esc：收起爲 Focus

HTTP 接口¶

回滾單個變更：

POST /api/change-center/changes/:id/rollback

回滾會話內全部變更：

POST /api/change-center/sessions/:id/rollback-all

獲取 SSE 事件流：

GET /api/change-center/events

本地開發¶

在倉庫中執行：

pnpm install
pnpm typecheck
pnpm test
pnpm build

已覈實資料給出的測試基線爲：189 個用例 / 24 個文件。

適用場景與注意¶

dsh-change-center 適合需要在 DSH 中統一查看 agent 文件變更、審查差異、回滾或恢復變更，並對單個 hunk 做應用、撤銷或編輯的場景。

使用前注意：

• 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
• 許可證爲 MIT。
• 沙箱策略：插件狀態寫入使用 danger-full-access，工作區寫回使用 workspace-write。
• 寫盤路徑帶 diskBaseline 外部修改守衛，衝突時會提示查看差異或強制寫入。
• 持久化變更、會話、快照、策略、審查/風險結果到 $DSH_HOME/change-center；資料列出的路徑包括 $DSH_HOME/change-center/store/*.jsonl、history/、policies.json、snapshots/、review/、risk/。

鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/Chance-Wu/dsh-change-center
• GitHub：https://github.com/Chance-Wu/dsh-change-center