在 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 路径表示法之间手动转换时的错误，并提供了关于文件系统差异的必要说明。
