前言¶
DeepSeek Harness (DSH) 的插件生態旨在通過標準化的 Agent 工具和側邊欄擴展提升開發效率。對於使用 Subversion 的團隊，直接在 Agent 中調用 svn 命令或查看複雜的版本差異往往需要額外的腳本或外部工具。dsh-svn-tools 插件旨在解決這一問題，它爲 Agent 提供了一整套 svn_* 工具，併爲用戶提供了可視化的 SVN 面板。
插件簡介¶
dsh-svn-tools 是一個爲 DeepSeek Harness 設計的 Subversion 工具集。它包含 33 個 svn_* Agent 工具，支持 UTF-8 中文提交日誌；同時提供一個 SVN 面板，可在 DSH 自帶右側欄或 dsh-better-sidebar 中渲染。該插件由 zengweicheng666 維護，遵循 MIT 協議。
核心功能¶
Agent 工具 (33 個)¶
插件提供完整的 svn_* 工具集，覆蓋以下分類：
* 狀態 / 信息：svn_status、svn_info
* 差異 / 歷史：svn_diff、svn_log、svn_blame
* 倉庫瀏覽：svn_list、svn_cat
* 變更操作：svn_add、svn_delete、svn_mkdir、svn_copy、svn_move、svn_revert
* 提交：svn_commit（支持 UTF-8 日誌）
* 更新 / 檢出：svn_update、svn_checkout、svn_switch
* 衝突 / 清理：svn_resolve、svn_cleanup
* 屬性：svn_propget、svn_propset、svn_proplist
* 分支 / 合併：svn_merge、svn_mergeinfo
* 鎖定：svn_lock、svn_unlock
* 分組：svn_changelist
* 其他：svn_import、svn_export、svn_patch
側邊欄面板¶
- 雙載體支持：面板可渲染在 DSH 自帶右側欄（
kind: svn分頁）或 dsh-better-sidebar 中。載體類型在設置中配置，支持auto（默認）、native、better-sidebar或off（不註冊面板）。 - 可視化對比：提供左右版本對比視圖，支持差異塊導航及直接修改工作副本的操作（採用左側/右側/都保留）。
- 主要分頁：
- 變更：查看文件狀態、批量操作。
- 提交：勾選文件、填寫日誌（支持 AI 生成日誌）、提交前自動整理。
- 歷史：查看版本列表、回退/還原操作、只讀對比。
模式與兼容性¶
- 離線/只讀模式：服務不可達時，歷史記錄可從本地日誌緩存或工作副本元數據讀取，且支持只讀操作。
- 提交前自動整理：未版本化文件自動
add，缺失文件自動delete，結果如實回報。 - DSH 兼容：兼容 DSH 0.1.0-rc.6 及以上版本（0.2.x 適配配置表單，0.1.x 適配卡片）。
安裝與啓用¶
在終端中執行以下命令安裝插件：
dsh plugin --profile web add github:zengweicheng666/dsh-svn-tools
安裝後必須重啓 dsh 以完成設置註冊和麪板掛載。
前置條件：
1. 系統中需安裝 svn 命令行客戶端（Windows 爲 svn.exe）。
2. 若需使用側邊欄面板，DSH 版本需 >= 0.1.0-rc.6（自帶右側欄），或安裝 dsh-better-sidebar。
典型用法¶
- 查看改動：重啓 dsh 後，打開右側欄的 SVN 分頁，查看當前工作目錄的改動。
- Agent 操作：在對話中讓 Agent 使用工具，例如
svn_status查看改動，隨後svn_commit提交。 - 差異操作：在變更頁懸停差異塊，可選擇「採用左側」或「採用右側」直接修改工作副本文件。
注意事項¶
- 無前置依賴：面板載體可獨立配置，也可完全不註冊（僅使用 Agent 工具）。
- 環境要求：中文 Windows 控制台輸出優先 UTF-8，失敗時回退 GBK。
- 面板載體：面板需要一個載體（DSH 0.1.0-rc.6+ 自帶右側欄或 dsh-better-sidebar）。若兩者均不可用，面板不註冊，但 Agent 工具不受影響。
總結¶
dsh-svn-tools 通過統一的 Agent 工具和可視化的側邊欄面板，填補了 DeepSeek Harness 在 Subversion 版本控制集成上的空白。它不僅讓 Agent 能夠執行完整的 SVN 操作，也爲人提供了一個直觀的版本管理界面。
