前言¶
在 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 仓库。