DeepSeek Harness (DSH) 採用插件化架構,開發者在使用過程中常需要查看當前會話的文件結構,或在編輯器中打開某個文件。手動查找路徑並 cd 既繁瑣又容易出錯。dsh-reveal-explorer 插件通過在會話頭部添加操作按鈕,解決了這個問題。
插件簡介¶
dsh-reveal-explorer 是一個 DeepSeek Harness (DSH) 插件,由 EasyTZ 維護,採用 MIT 許可證。它爲 DSH 添加了一個功能:在會話頭部的工具區添加一個按鈕,用於調用系統默認的文件管理器打開當前工作區目錄。
安裝與啓用¶
安裝前請確保環境滿足以下條件:
* DSH 版本 >= 0.1.1-rc.2
* 系統中可用 pnpm
* 安裝命令必須指定 profile name(例如 web 或 tui)
執行以下命令安裝:
dsh plugin --profile <name> add @easytz/dsh-reveal-explorer
安裝完成後,需要重啓 DSH 才能生效。插件自帶 dsh.bundle 層,無需手動編寫 patch。
使用方法¶
點擊會話頭部工具區的“在資源管理器中打開”按鈕,系統將使用默認的文件管理器打開當前會話的工作區目錄。
根據操作系統不同,調用的工具如下:
* Windows:調用 explorer.exe
* macOS:調用 open
* Linux:調用默認文件管理器(通常爲 xdg-open)
切換到不同的會話後,再次點擊按鈕,打開的目錄會自動更新爲該會話綁定的目錄。
功能與限制¶
- 目錄檢測:如果當前會話的工作區目錄在註冊後被移動或刪除,插件會在調用前檢測並提示錯誤,而不是假裝操作成功。
- Windows 兼容性:Windows 平臺上
explorer.exe可能會返回非零退出碼,插件已對此做了容錯處理(僅當進程無法啓動時纔算失敗)。