在終端或 TUI 環境中,手動切換上下文打開文件或瀏覽器鏈接通常需要額外的操作。dsh-open-path 插件通過擴展 /open 命令,將文件系統訪問和網絡鏈接處理整合到 dsh-TUI 的操作流中,直接調用系統的默認程序。
dsh-open-path 是一個 dsh-TUI 生態插件,由 VviLliAm-qwq 維護。它解決了在 TUI 界面中直接訪問文件系統和 HTTP(S) 網絡資源的需求,支持 Windows、macOS、Linux(含 WSL)以及模糊搜索工作區內容。
核心功能¶
該插件提供以下操作能力:
- 打開工作目錄:輸入
/open無參數,直接打開當前會話的工作目錄。 - HTTP(S) 鏈接:支持不區分大小寫的 HTTP(S) 鏈接,直接調用默認瀏覽器打開。
- 裸域名處理:對於
github.com這樣的裸域名,會自動填充https://協議前綴。 - 文件與路徑:支持相對路徑、絕對路徑以及
~(home) 目錄的展開。 - 模糊搜索:在當前工作區中進行模糊匹配,輸入
/open readme即可快速定位文件或文件夾。
安裝與啓用¶
通過插件管理器安裝該插件:
dsh plugin --profile dsh-tui add dsh-open-path
安裝完成後,需要在 TUI 界面中運行 /restart 或重新打開窗口,插件才能生效。
典型用法¶
/open # 打開當前工作目錄
/open https://example.com # 打開網頁
/open src/index.ts # 打開文件
/open readme # 模糊搜索工作區
/open ~/docs # 打開 home 目錄
配置與注意¶
- 依賴環境:要求
@deepseek-harness-tui/dsh-tui版本不低於0.10.0-beta.5。 - 日誌記錄:操作日誌寫入
~/.dsh-tui/dsh-open-path.log。 - 配置項:
maxCandidates默認爲 0,表示不限制模糊搜索的候選數量。 - 語言支持:提示文本和錯誤信息會跟隨 dsh-TUI 的語言設置(
DSH_TUI_LANG),支持中文、英文或系統本地化語言。 - 許可證:MIT。
該插件遵循 MIT 許可證。在使用前,請確保已安裝滿足版本要求的 dsh-TUI,並根據需要檢查源碼。