dsh-env-switcher：Windows 與 WSL2 DSH 實例切換插件

在本地開發 DeepSeek Harness (DSH) 時，同時維護 Windows 和 WSL2 兩個環境下的實例是常見場景。通常需要在兩個終端窗口間手動切換 URL，或複製粘貼端口地址，操作繁瑣且容易出錯。下面介紹 dsh-env-switcher 插件，它可以在 Web UI 中直接在兩個運行中的 DSH 實例間切換，無需關閉任何一個。

核心功能¶

共存模式：Windows 和 WSL2 的 DSH 服務器同時運行，互不干擾。默認端口分別爲 3080 和 3081。
Web UI 入口：Web UI 新增「環境」標籤頁，側邊欄主列（中間列）出現「運行環境」入口，顯示當前可切換的 Windows 或 WSL 選項。
摺疊感知：側邊欄摺疊時，該入口自動隱藏；展開時重新出現。
會話隔離：每個環境維護獨立的會話歷史記錄。

安裝與啓用¶

使用官方命令安裝：

dsh plugin --profile web add dsh-env-switcher

如果從本地檢出源碼，使用：

dsh plugin --profile web add file:/path/to/dsh-env-switcher

安裝後重啓服務器，並在瀏覽器中強制刷新（Ctrl+F5 或 Cmd+Shift+R）。

配置說明¶

所有配置項均爲可選。默認值適用於典型的 Windows + WSL2 環境。在 cordis.patch.yml 中配置示例如下：

- insert:
    - id: dsh-env-switcher
      name: dsh-env-switcher
      config:
        winPort: 3080        # Windows DSH 端口
        wslPort: 3081        # WSL DSH 端口
        wslDistro: Ubuntu-24.04
        wslNodeBin: /home/fsc/node-v24.17.0-linux-x64/bin
        wslLog: /home/fsc/dsh-web.log
        winLog: D:\deepseek-harness\logs\dsh-web-win.log
        winWorkingDir: C:\Users\61468

環境要求¶

操作系統：Windows 10/11 + WSL2 + Linux 發行版（如 Ubuntu 24.04）。
DSH 安裝：Windows 環境和 WSL 環境內均需安裝 DSH。
服務啓動：WSL 實例必須使用 dsh web --port 3081 命令啓動。

使用方法¶

在 Web UI 側邊欄的「運行環境」區域點擊目標環境（Windows 或 WSL）。系統會確保對應服務器正在運行，隨後當前標籤頁將自動導航至該環境的 URL。

總結¶

dsh-env-switcher 通過 Web UI 集成了 Windows 與 WSL2 環境的切換能力，配合摺疊感知和獨立會話歷史，提升了跨環境開發體驗。源碼與更新記錄可在 GitHub 查看。