DeepSeek Harness 的核心理念是插件化。在構建智能體或進行復雜開發任務時，基礎的文件操作和 Shell 環境往往需要更穩定的支持。dsh-tool-plus 是一個基礎工具增強插件，旨在通過持久化 bash、結構化讀取和多模式編輯等功能，補齊這些短板。
核心功能¶
該插件覆蓋了從基礎 Shell 到高級文件操作的多個層面：
- 持久 bash：Shell 會話在調用間保持狀態（
cd、export等變量不丟失）；自動處理長日誌（壓縮）、後臺任務（超長輸出自動後臺）；可攔截cat、grep、find、sed-i等命令，引導使用專用工具。 - 安全刪除：默認的
rm命令會將文件移入系統回收站而非永久刪除。如需真刪，請使用command rm。 - 結構化 read：支持按行區間讀取（
:N-M）、原始內容（:raw）；大文件默認返回結構摘要，細節按需展開。支持讀取 zip、tar、SQLite、notebook、PDF、圖像及網頁內容。 - 原子 write：寫入操作返回 diff；支持補丁式寫入 zip、tar 歸檔成員與 SQLite 數據庫。
- 多模式 edit：默認爲 replace 模式，另支持 patch、hashline、apply-patch 三種補丁格式。
- grep / glob：提供全文搜索與文件名匹配功能，支持 mtime 排序、上下文行及忽略規則配置。
- 可選 AST 工具：提供基於語法樹的結構化搜索與重寫能力（ast_grep / ast_edit）。
- agent 預設：隨插件內置兩套預設——Tool Plus 標準增強版和 PTC（Code Mode），安裝後即可在預設列表中選擇。
安裝與啓用¶
安裝前需確保已全局安裝 dsh CLI 並安裝了 Node.js（版本 >= 22.19 或 >= 24）。
Web 端安裝¶
dsh plugin --profile web add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus
注：Web 端安裝需要 pnpm >= 10.4。若版本較低報錯，需在 ~/.dsh/profiles/web/pnpm-workspace.yaml 中允許構建，或執行 pnpm approve-builds --all。
桌面端安裝¶
進入桌面端 profile 專屬目錄進行安裝：
cd ~/.dsh/profiles/desktop
pnpm add --allow-build=@xiaoso/dsh-tool-plus --allow-build=koffi @xiaoso/dsh-tool-plus
本地開發¶
使用本地鏈接進行開發調試：
dsh plugin --profile web add link:<本倉庫路徑>
典型用法¶
安裝完成後，插件會自動接管官方的 bash / pwsh / 文件 / 搜索工具。
- 讀取特定行：使用
:N-M語法指定行區間。 - 讀取原始內容：使用
:raw獲取文件原始內容。 - 真刪文件：在
rm前加上command前綴。 - 編輯補丁：使用
edit patch指定補丁模式。 - 選擇預設：在工具設置中選擇 “Tool Plus 標準增強版” 或 “PTC”。
注意事項¶
- 權限模式：建議在
danger-full-access模式下使用，避免沙箱模式因權限問題誤攔文件寫入。 - Shell 統一性：插件不提供單獨的
pwsh工具，所有 shell 場景由持久bash統一承擔。 - 安全刪除機制：
rm刪除的文件進入系統回收站，但各平臺的落點與可見性不同（Windows/macOS/Linux 均有差異，如 Linux 下文件名通常變爲 UUID）。 - 版本升級：0.1.9 或更早版本升級的用戶，可安全刪除
~/.dsh/.agent-presets/目錄。
總結¶
dsh-tool-plus 通過一個插件集成了持久化 Shell、結構化文件讀寫、安全刪除及多模式編輯能力，能夠顯著提升 DeepSeek Harness 環境下的開發與調試效率。如需查看更多細節或提交反饋，可訪問插件目錄或GitHub 倉庫。
