前言¶
在 DeepSeek Harness (DSH) 的對話中，助手經常會輸出 Linux 路徑，例如 /home/user/project.pptx。如果沒有工具，這些路徑無法直接點擊操作。通用的“打開路徑”插件通常調用 Linux 的 xdg-open，這無法啓動 Windows 的 Office 或 WPS 等應用。
dsh-wsl-open 插件解決了這個問題。它運行在 Windows 環境中，利用 CSS Highlight 識別文本中的絕對 Linux 路徑，通過 wslpath 轉換爲 Windows 路徑，並調用 Windows 原生命令打開文件或文件夾。
核心功能¶
該插件主要提供以下能力：
- 路徑高亮：使用 CSS Highlight 技術在助手文本中標記絕對 Linux 路徑，而不重寫 React DOM。
- 路徑映射：使用
wslpath -w將 Linux 路徑轉換爲 Windows 可識別的路徑（如\\wsl$\distro\...或C:\...）。 - 文件打開：通過
cmd.exe /c start調用系統默認應用打開文件。 - 文件夾打開：通過
explorer.exe打開對應文件夾。 - 訪問限制：僅允許打開以下路徑：home 目錄、session workspace、
/mnt/c/Users和/mnt/d/Users。非 WSL 主機會跳過打開操作。
安裝與啓用¶
使用官方安裝命令添加插件：
dsh plugin --profile web add github:173787247/dsh-wsl-open
安裝後，重啓 dsh web 服務並刷新頁面即可使用。
典型用法¶
- 在聊天中向 Agent 提示：請寫一個文件到
/home/<you>/...（例如.pptx文件）。 - 等待助手返回包含該路徑的回覆。
- 在回覆文本中，找到帶有 dotted-underline（點狀下劃線）的路徑。
- 點擊該路徑。
- Windows 系統會調用默認應用打開該文件。
適用場景與限制¶
- 版本要求：DeepSeek Harness (dsh) 版本需 ≥ 0.1.2。
- 適用對象：WSL（Windows Subsystem for Linux）環境。
- 路徑限制：出於安全考慮，插件僅開放特定目錄。如果路徑不在允許列表中，插件不會執行任何操作。
- 生態定位：該插件是
dsh-wsl-kit套件的一部分。 - 功能區分：
- 優先用於打開文件或文件夾。
- 如果需要啓動 Linux 應用，請使用
dsh-wsl-launch。 - 如果需要打開 HTTP(S) URL，請使用
dsh-wsl-browser。
- 環境配置：目前未針對 Cloud Flash 或 Agent Teams 進行配置。
結語¶
dsh-wsl-open 是在 Windows 端直接操作 WSL 文件系統的實用工具。它通過瀏覽器交互讓路徑訪問變得直觀。更多細節與源碼請訪問 GitHub 倉庫。
