dsh-open-with：在本地編輯器中打開 DeepSeek Harness 工作區

前言¶

在 DeepSeek Harness (DSH) 中進行智能體開發時，工作區是核心載體。Web 界面雖然方便，但在需要深度編輯代碼或查看本地文件結構時，往往受限於瀏覽器權限。dsh-open-with 插件通過宿主代理機制，將 Web 界面與本地開發環境連接起來，讓你能夠直接在檢測到的本地編輯器中打開已註冊的工作區。

是什麼¶

這是一個 DSH 客戶端插件，由維護者 ChuanTianML 開發。它的核心作用是從 Web GUI 中啓動本地編輯器，打開當前已註冊的 DeepSeek Harness 工作區目錄。

核心功能¶

編輯器檢測：自動檢測多種本地編輯器，包括 VS Code、Cursor、Windsurf、Zed、JetBrains 系列 IDE 等。
配置化管理：支持通過配置文件添加自定義編輯器，或覆蓋內置的檢測規則。
動態刷新：點擊“刷新編輯器”可重複執行宿主發現，更新啓動器，無需重啓 DSH 服務。
安全邊界：瀏覽器只接收編輯器 ID、標籤和可用性狀態，命令和參數不會跨網絡傳輸到瀏覽器。
兼容性適配：支持使用 sidebar.workspaces.row-menu 或兼容性適配器以適配舊版客戶端。

安裝與啓用¶

該插件需要 DSH 0.1.0-rc.5 或更高版本。

添加插件到 Web 配置文件：

    dsh plugin --profile web add https://github.com/ChuanTianML/dsh-open-with/archive/refs/tags/v0.2.1.tar.gz

重啓 DSH Web 服務器。
- Linux / macOS：使用 SIGTERM 終止進程，等待其完全退出後再刷新頁面。
- Windows：使用 SIGTERM 終止進程，嚴禁使用 kill -9，否則可能中斷 Session 的 zstd 寫入。
驗證安裝版本：

    dsh plugin --profile web list dsh-open-with --depth 0

典型用法¶

在 DSH 的 Web 配置文件中添加插件配置。配置項分爲 autoDetect（自動檢測）、editors（自定義編輯器列表）和 defaultEditor（默認編輯器 ID）。

設置默認編輯器：

    - id: dsh-open-with
      name: dsh-open-with
      config:
        defaultEditor: cursor

添加自定義編輯器：

    - id: dsh-open-with
      name: dsh-open-with
      config:
        editors:
          - id: fleet
            label: Fleet
            command: fleet
            args: []

適用場景與注意¶

適用場景：需要在本地編輯器中直接調試代碼、查看工作區文件結構的智能體開發場景。
權限與安全：編輯器進程在啓動後會獨立運行，生命週期長於 DSH Web 服務器。插件僅在本地操作，不會讀取、上傳或同步文件。
注意事項：
- 配置更改需要重啓 DSH 服務才能生效。
- 偏好設置保存在瀏覽器本地狀態中，不同瀏覽器可以有不同的默認編輯器。
- 僅能打開當前已註冊且目錄存在的工作區。

短結尾¶

該插件通過安全邊界的設計，解決了 Web 界面與本地開發環境割裂的問題。更多細節及源碼，請訪問其 GitHub 倉庫。