前言¶

在使用 DeepSeek Harness (DSH) 開發或調試時，若遇到 Web UI 界面空白或連接錯誤，通常與 WSL 網絡配置有關。服務綁定在 WSL 中，從 Windows 訪問時可能需要特定的 IP 地址、防火牆規則，或者需要重啓 WSL。本插件通過檢查 hostname -I 和 ss 監聽狀態，診斷端口歸屬並給出 Windows localhost 轉發建議。

是什麼¶

dsh-wsl-port 是 DeepSeek Harness 的聯網工具插件，隸屬於 dsh-wsl-kit 套件。它提供了一個名爲 port_doctor 的診斷工具，用於報告 WSL 的 IP 地址以及 TCP 端口是否處於監聽狀態，並針對 Windows 端的 Localhost 轉發提供操作建議。

核心功能¶

• 診斷 WSL 中哪個進程佔用了特定端口。
• 報告 WSL 的 IP 地址以及 TCP 端口是否處於監聽狀態。
• 提供關於 Windows localhost 轉發的具體建議。
• 檢查 hostname -I 輸出和 ss 的監聽狀態。

安裝與啓用¶

使用 DSH 的插件管理命令安裝：

dsh plugin --profile web add github:173787247/dsh-wsl-port

配置¶

插件支持配置超時時間和默認端口：

- id: dsh-wsl-port
  name: dsh-wsl-port
  config:
    timeoutMs: 15000
    defaultPort: 3080

使用說明¶

• 默認端口：工具默認檢查端口 3080，可通過參數覆蓋。
• 端口區分：DSH Web UI 使用 3080 (WSL 內部) 和 3081 (Windows 轉發，需帶 ?token=)。若 Windows 端訪問 :3080 出現空白或認證錯誤，應檢查 :3081/?token=。
• 運行建議：不要在 Windows 端綁定 dsh web --host 0.0.0.0。推薦在出現問題時先運行套件中的 restart-dsh-web.sh 和 check-dsh-health.sh。

環境要求與注意¶

• 依賴：需要安裝 DSH 版本 ≥ 0.1.2。
• 所屬套件：屬於 dsh-wsl-kit 套件的一部分，推薦使用 KIT_SET=daily、llm 或 full 套件。
• 許可：採用 MIT 許可證。

結語¶

port_doctor 是解決 DSH 在 WSL 環境下端口映射和連接問題的實用工具。更多細節可參考 GitHub 倉庫。