dsh-wsl-launch：從 WSL 啓動受控的 Windows 應用

智能體在 WSL 環境下工作，但有時需要調用 Windows 原生應用（如瀏覽器、VS Code、文件資源管理器）。直接執行任意 .exe 存在安全風險，且難以管理。dsh-wsl-launch 提供了一個受控的入口，只允許啓動預定義的 Windows 應用。

簡介¶

這是 DeepSeek Harness (DSH) 的一個插件，由用戶 173787247 維護。它屬於 dsh-wsl-kit 套件的一部分，旨在解決智能體如何在 WSL 中安全地啓動 Windows 程序的問題。

該插件不運行任意可執行文件，僅通過白名單機制允許特定的 Windows 應用程序在 WSL 環境中被調用。

核心功能¶

白名單啓動：僅允許啓動配置文件中定義的 Windows 應用程序。
默認支持：內置了常用的開發與瀏覽工具的啓動能力。
自定義擴展：支持通過配置文件自定義允許啓動的應用列表。

安裝與依賴¶

安裝前，請確保環境滿足以下依賴條件：

已安裝 DSH，版本需 >= 0.1.2。
集成了 dsh-wsl-kit 套件，建議使用 KIT_SET=daily 進行安裝。

執行以下命令安裝插件：

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

配置¶

安裝後，需要在 DSH 的配置文件中添加該插件的聲明，並定義允許列表。

允許列表¶

默認允許列表包含以下應用：

code, code.cmd
explorer.exe
notepad.exe
wt.exe
windows terminal
msedge.exe
chrome.exe
firefox.exe

如果需要自定義允許列表，可以在配置中指定應用名稱、路徑後綴或使用通配符（如 msedge*）。

配置示例¶

- id: dsh-wsl-launch
  name: dsh-wsl-launch
  config:
    timeoutMs: 20000
    # 自定義允許列表
    allowlist: ["code", "explorer.exe", "msedge*", "notepad.exe"]

使用方法¶

該插件對應的 DSH 工具名爲 win_launch。

參數說明¶

參數名	必需	說明
`target`	是	Windows 可執行文件名或路徑，必須在允許列表中
`args`	否	傳遞給目標應用的參數字符串

調用示例¶

在 WSL 環境中調用 VS Code：

win_launch target="code" args="--wait"

在 WSL 環境中啓動文件資源管理器：

win_launch target="explorer.exe"

注意事項¶

安全限制：插件嚴格限制只能啓動白名單中的應用。嘗試啓動未授權的 exe 會導致失敗。
依賴套件：務必確保已安裝 dsh-wsl-kit 套件，否則插件無法正常工作。
版本兼容：檢查當前 DSH 版本是否滿足 0.1.2 及以上要求。
許可證：本項目採用 MIT 許可證開源，安裝前請查閱源碼確認合規性。

結語¶

dsh-wsl-launch 是構建安全、可控的 Windows-WSL 交互環境的關鍵組件。通過白名單機制，它讓智能體能夠執行必要的 Windows 操作，同時避免了執行任意代碼的風險。

更多技術細節與故障排查，可查閱 GitHub 倉庫：https://github.com/173787247/dsh-wsl-launch