dsh-review-checkout：DeepSeek Harness 會話文件修改審查插件

前言¶

DeepSeek Harness (DSH) 的插件生態允許開發者擴展會話處理流程。在處理文件操作時，Agent 的 write 或 edit 結果通常只作爲文本輸出，缺乏可視化的歷史追蹤與回滾手段。dsh-review-checkout 插件用於捕獲這些操作，將每一輪的修改轉化爲類似官方「已編輯」卡片的展示，並提供一個支持語法高亮、真實行號和還原操作的審查視圖。

核心功能¶

該插件主要提供以下能力：

每輪「已編輯」卡片：復刻官方卡片樣式（16px 圓角、圖標塊、+N −M 統計），支持 撤銷（按輪生成 diff 序列）和 審覈（跳轉審查 tab）操作。
審查視圖：支持拖動分割線調整文件列表與 diff 寬度，支持雙視圖（列表/詳情）切換，提供語法高亮與真實行號。
三級打開鏈路：點擊文件行可喚起選定的編輯器並定位行號，或使用系統默認應用打開，最後回退至內置預覽。
運行時小膠囊：在輸入框上方顯示當前會話的文件變更統計。
主題與配色：卡片與膠囊跟隨 DSH 主題，Diff 配色支持自定義。

安裝與啓用¶

在終端執行安裝命令：

dsh plugin add dsh-review-checkout

安裝後，需在 DSH 的 profile 配置中註冊 bundle patch 才能生效。編輯 ~/.dsh/profiles/<profile>/cordis.patch.yml，添加以下內容：

- insert:
    - id: diff-review
      name: 'dsh-review-checkout'

使用說明¶

查看變更：在會話流中，每一輪的文件修改會生成一張「已編輯」卡片。懸停卡片上的某一行，可查看該行附近的 diff 上下文。
審查 tab：點擊卡片上的「審覈」或點某一行，進入審查 tab。在此處可查看所有輪次的文件變更，或還原單文件。
撤銷操作：卡片上的「撤銷」按鈕會生成倒序的 diff_review_revert 工具調用序列填入輸入框；審查視圖頭部也有單文件還原按鈕。
打開文件：審查視圖中的每一行左側有「在編輯器中打開該行」按鈕，支持 VS Code、JetBrains 系等編輯器定位。

工作原理與注意事項¶

插件通過監聽 tools/result 事件記錄 write/edit 的操作快照，並按會話追加寫入 ~/.dsh/profiles/<profile>/diff-review-state/<session>.jsonl。客戶端每 5 秒輪詢重建視圖。
* 權限與重啓：Host 端（lib/index.js）改動需重啓 dsh web 或 Desktop；純客戶端改動刷新頁面即可。
* 佔用記錄：本會話在磁盤上的記錄佔用（分片與快照）顯示在審查 tab 工具條右側，點擊「清空」可刪除該會話記錄並回收孤兒快照。
* 官方卡片：默認隱藏官方的「已編輯」卡片，可在設置中關閉接管。
* 行號定位：優先使用未截斷快照的 lineHint，其次使用存檔快照，最後使用磁盤當前文件。
* 路徑安全：打開文件僅接受宿主能驗證的絕對路徑（本會話工作區或文件所在目錄）。

兼容性¶

dsh web：支持 0.1.6-alpha.2 及以上版本。
DSH Desktop：支持全部功能。
舊宿主：支持 ≤0.1.5 版本（兼容 turnTail 語義）。

總結¶

該插件通過在本地維護操作快照與審查視圖，彌補了官方 DSH 在文件回滾與歷史追蹤上的空白。適合需要在長時間會話中頻繁進行文件操作並需要精確控制變更回滾的開發者使用。

插件目錄：DeepSeek Harness 插件市場
源代碼：GitHub