前言¶
在 DeepSeek Harness (DSH) Desktop 的使用中，智能體執行 edit、write 或 str_replace_editor 操作後，輸出通常只是一行文本。開發者很難在純文本日誌中快速確認具體改動了哪些文件，以及變更的具體內容。下面介紹 dsh-diff-card 插件，它爲每個對話輪次提供了一張可視化的文件變更卡片。
插件定位¶
該插件用於 DSH Desktop，旨在爲智能體執行文件變更操作時提供 Codex 風格的展示。插件由 WongYuYe 維護，採用 MIT 許可證。它覆蓋了 edit、write、str_replace_editor 和 Code Dispatch 子調用，使得每個輪次的變更都能以卡片形式呈現。
核心功能¶
- 變更行展示：工具行顯示新增/刪除行數，如
+N −M。輪末卡片會列出本輪修改的文件，默認預覽 3 條，標題中包含合計數據。 - Diff 展開與收起：點擊某一行可以展開或收起該文件的 diff。點擊“查看更改”按鈕可展開本輪全部文件並打開 diff，再次點擊收起。
- 審覈模式：提供“審覈”功能，可直接展開本輪全部 diff 進行查看。
- 撤銷與恢復：
- 點擊“撤銷”可將本輪文件恢復到改動之前。如果文件已被其他進程修改，插件會拒絕操作。
- 撤銷成功後，按鈕變爲“恢復”，再次點擊可將撤銷的改動寫回。
- 撤銷和恢復操作均會彈出輕量確認。
- 文件快速操作：每一行右側有一個下拉符號
▾。點擊它可以使用系統應用打開文件、在文件夾中顯示、調用 VS Code 打開，或複製文件的絕對/相對路徑。 - 語言適配：界面文案會跟隨 DSH 的界面語言（中文或英文）自動切換。
安裝與啓用¶
安裝前請確保你的 DeepSeek Harness 版本滿足 >= 0.1.2-rc.1。
在終端執行以下命令安裝：
dsh plugin --profile desktop add dsh-diff-card
安裝完成後，刷新 Web GUI 或重啓 DSH Desktop 即可生效。
典型用法¶
- 查看變更：智能體執行代碼修改後，工具行會出現
+N −M標識，輪末出現“已編輯 N 個文件”的卡片。 - 檢查 Diff：點擊卡片中的文件行，展開具體的 diff 內容，確認變更是否正確。
- 文件跳轉：如果需要直接打開文件進行二次修改，點擊文件行右側的
▾，選擇“VS Code”或系統默認應用。 - 回滾操作：如果發現本輪修改有誤，點擊“撤銷”按鈕即可恢復原狀；確認無誤後可點擊“恢復”將改動重新應用。
適用場景與注意¶
該插件適合需要精細控制文件變更流程、進行代碼審覈或需要頻繁回滾操作的 DSH 開發者。由於插件以當前 DSH 進程的權限運行，安裝前建議檢查源碼與許可證。
結尾¶
dsh-diff-card 通過可視化的卡片和交互操作，解決了智能體輸出日誌中文件變更信息不直觀的問題。更多詳情與源碼可參考：
* GitHub：https://github.com/WongYuYe/dsh-diff-card
* 生態目錄：https://www.skillhub.cn/plugins/WongYuYe/dsh-diff-card
