dsh-wsl-open:在 Windows 中打开 WSL 路径

前言

在 DeepSeek Harness (DSH) 的对话中,助手经常会输出 Linux 路径,例如 /home/user/project.pptx。如果没有工具,这些路径无法直接点击操作。通用的“打开路径”插件通常调用 Linux 的 xdg-open,这无法启动 Windows 的 Office 或 WPS 等应用。

dsh-wsl-open 插件解决了这个问题。它运行在 Windows 环境中,利用 CSS Highlight 识别文本中的绝对 Linux 路径,通过 wslpath 转换为 Windows 路径,并调用 Windows 原生命令打开文件或文件夹。

核心功能

该插件主要提供以下能力:

  1. 路径高亮:使用 CSS Highlight 技术在助手文本中标记绝对 Linux 路径,而不重写 React DOM。
  2. 路径映射:使用 wslpath -w 将 Linux 路径转换为 Windows 可识别的路径(如 \\wsl$\distro\... 或 C:\...)。
  3. 文件打开:通过 cmd.exe /c start 调用系统默认应用打开文件。
  4. 文件夹打开:通过 explorer.exe 打开对应文件夹。
  5. 访问限制:仅允许打开以下路径:home 目录、session workspace、/mnt/c/Users 和 /mnt/d/Users。非 WSL 主机会跳过打开操作。

安装与启用

使用官方安装命令添加插件:

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

安装后,重启 dsh web 服务并刷新页面即可使用。

典型用法

  1. 在聊天中向 Agent 提示:请写一个文件到 /home/<you>/...(例如 .pptx 文件)。
  2. 等待助手返回包含该路径的回复。
  3. 在回复文本中,找到带有 dotted-underline(点状下划线)的路径。
  4. 点击该路径。
  5. 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 仓库。

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜