在 WSL（Windows Subsystem for Linux）環境中，智能體和人類開發者經常混淆 Linux 路徑（如 /mnt/c/Users/...）與 Windows 路徑（如 C:\Users\...），或者需要生成 \\wsl$\... 格式的 UNC 路徑供 Windows 應用訪問。爲了解決這類路徑混用帶來的問題，下面介紹 dsh-wsl-path 插件。
插件定位¶
dsh-wsl-path 是 DeepSeek Harness (DSH) 生態中的一個插件，隸屬於 dsh-wsl-kit 工具集。它提供 path_convert 工具，旨在在 Linux 和 Windows 路徑格式之間進行轉換，並解釋相關的技術權衡。
核心功能¶
該插件主要處理以下路徑相關的問題：
- 路徑互轉：支持將 Linux 格式路徑（如
/home/user、/mnt/c/Windows）轉換爲 Windows 格式（如C:\、\\wsl$\），反之亦然。 - 標籤處理：專門處理 WSL 掛載點相關的
/mnt標籤。 - 技術說明：解釋 Windows drvfs 掛載與原生 Linux 文件系統在文件屬性（如換行符 CRLF）、權限和 Git 配置上的差異。
安裝與啓用¶
安裝此插件前，請確保你的環境滿足以下依賴要求：
- DSH 版本 >= 0.1.2
- Node.js 版本 >= 18
在終端中執行以下命令安裝插件：
dsh plugin --profile web add github:173787247/dsh-wsl-path
安裝完成後，插件會隨 DSH 進程啓動。
典型用法¶
path_convert 工具需要兩個參數：
path（必填）：絕對路徑，可以是 Linux 格式或 Windows 格式。direction（可選）：轉換方向，默認爲auto（自動識別源路徑格式並轉換），也可指定爲toWindows或toLinux。
根據文檔示例，在測試環境中可使用：
npm test
適用場景與注意事項¶
- 工具集依賴：該插件作爲
dsh-wsl-kit的一部分維護，建議關注該套件的兼容性說明。 - 運行權限：插件以當前 DSH 進程的權限運行，使用前請檢查源碼與許可證。
- MIT 許可證：插件基於 MIT 協議開源，可自由使用和修改。
總結¶
dsh-wsl-path 解決了 WSL 環境下路徑格式統一的問題。通過提供 path_convert 工具，它幫助開發者避免在 Linux 和 Windows 路徑表示法之間手動轉換時的錯誤，並提供了關於文件系統差異的必要說明。
