前言¶
DeepSeek Harness (DSH) 提供了基於 Web 的交互界面來管理工作區和智能體。在實際開發中,開發者經常需要從 Web 界面直接跳轉到本地開發環境,比如在編輯器中打開項目目錄,或在終端中進入該目錄。
dsh-open-in 插件解決了這個痛點。它不需要在 DSH 端構建任何工具,而是作爲一層集成,將你本地已安裝的啓動器(如 VS Code、Windows Terminal、文件資源管理器)通過 Web 界面調用起來。
是什麼¶
dsh-open-in 是一個 DSH 插件,由維護者 NevermindZZT 開發。
它不提供新的智能體能力或工具,其唯一職責是:當你已經通過 DSH Web 界面打開了一個工作區時,允許你從該界面的側邊欄菜單中,直接以你配置的命令行參數啓動外部程序,將當前工作區目錄傳遞給這些程序。
核心功能¶
該插件具備以下能力:
- 可配置的目標
你可以在設置中添加、編輯或刪除目標。每個目標包含唯一標識符、顯示標籤、執行命令、參數列表以及運行平臺限制。配置可以保存在持久化的用戶設置文檔中,也可以通過cordis.yml進行部署級別的覆蓋。 - 菜單集成
插件會自動向 DSH Web 界面中每一個真實的“工作區”行添加溢出菜單。菜單中會根據你配置的目標生成對應的條目(例如“Open in VS Code”、“Open in File Explorer”)。 - 平臺自動適配
內置的目標(如explorer、terminal)會自動適配宿主機平臺。例如,在 Windows 上可能調用wt -d,在 macOS 上調用open -a Terminal。你也可以手動覆蓋默認行爲。 - 宿主程序啓動
插件會在宿主機上以 detached(分離)模式啓動你配置的可執行文件。它只負責發送目標 ID 和目錄路徑,由宿主程序決定如何處理該路徑。 - 無需構建
插件包含預編譯的庫文件,安裝後無需任何構建步驟。
安裝與啓用¶
安裝該插件需要 DSH 版本 0.1.2-rc.1 或更新,並且必須使用 Web Profile。
執行以下命令將插件添加到你的 Web Profile:
dsh plugin --profile web add dsh-open-in
安裝完成後,刷新 Web 界面,插件會作爲 dsh-open-in 掛載。你可以通過以下命令驗證插件是否正確加載:
dsh --profile web --dump-config | grep dsh-open-in
典型用法¶
配置插件後,使用流程如下:
- 在 Web 界面的側邊欄找到已打開的工作區。
- 點擊該工作區行右側的
…溢出菜單。 - 選擇你配置好的目標(例如“Open in VS Code”)。
- 宿主程序會立即啓動,並將該工作區目錄作爲工作目錄打開。
在設置界面中配置目標:
* 進入 Settings → Plugins。
* 找到 “Open In” 卡片。
* 在卡片中添加、修改或刪除目標行,點擊 Save 即可生效。
適用場景與注意¶
- 工具依賴:你必須在系統中安裝並配置好你要調用的工具,且它們的可執行文件(如 VS Code CLI 的
code命令、Windows Terminal 的wt命令)必須處於系統 PATH 中。 - 路徑限制:插件拒絕相對路徑,只接受絕對路徑。
- 權限與安全:該插件只運行你明確配置好的命令。它不提供任何工具、技能或模型可見面。它僅作爲宿主進程的啓動器,直接響應你在 Web 界面的點擊操作(無需二次審批)。
- 配置覆蓋:在設置界面中進行的修改會覆蓋
cordis.yml中的默認配置。
結語¶
dsh-open-in 體現了 DSH “一切皆插件”的理念。它通過極簡的方式,將 Web 界面與本地開發環境無縫連接,減少了路徑複製和手動打開應用的繁瑣操作。
更多信息可參考 DeepSeek Harness 插件目錄 或 GitHub 倉庫。