DSH 插件 path-click：悬停即开文件或网址

前言¶

DeepSeek Harness (DSH) 的 Web 界面主要用于查看智能体的运行日志与工具调用结果。在对话记录中，文件路径和网址通常以普通文本形式存在。直接点击这些文本无法达到“打开文件”或“访问链接”的效果，用户往往需要手动复制粘贴。

path-click 插件通过监听鼠标悬停事件，解决了这一交互痛点。它能在用户将鼠标移至文件路径或网址时，直接弹出气泡菜单，提供“在资源管理器显示”或“用浏览器打开”的操作选项。

插件定位¶

这是一款 DSH Web 界面插件，由开发者 whw19761006 维护。其核心价值在于将静态文本路径转化为可交互的操作入口，简化了本地文件管理与网页跳转的流程。

核心功能¶

插件主要提供以下能力：

• 悬停检测与气泡菜单：当鼠标悬停在文件路径或网址上时，会显示一个纵向布局的气泡菜单。
• 资源管理器操作：支持一键在 Windows 资源管理器中显示文件或文件夹。
• 浏览器打开：利用默认浏览器打开任何文件类型（如 HTML、JS、图片、日志等），效果等同于在浏览器地址栏输入 file:// 路径。
• 网址自动打开：悬停 http/https/file/mailto 链接会自动触发浏览器打开动作。
• 工具调用卡片支持：工具调用卡片中包含的文件路径同样支持悬停操作。
• 安全限制：为防止环境变量展开问题，当路径包含 % 字符时，拒绝通过浏览器打开。

安装¶

在安装前，请确保已安装 DSH 以及 pnpm。

通过命令行安装插件：

dsh plugin --profile web add github:harmony520/path-click

安装完成后，需要关闭并重新启动 DSH，然后在浏览器页面按 F5 刷新以加载插件。

使用¶

1. 打开 DSH Web 界面。
2. 将鼠标悬停在任意文件路径或网址上。
3. 点击气泡菜单中的按钮执行操作（如“在资源管理器显示”或“用浏览器打开”）。

注意事项¶

• 平台限制：该插件主要针对 Windows 平台开发。macOS/Linux 的分支代码存在但未经验证。
• 依赖关联：打开文件依赖浏览器的默认文件关联。如果系统无法读取注册表，插件会回退到系统默认的打开方式。
• 路径解析：相对路径（如工具卡片中的路径）按宿主进程的 cwd 解析。默认部署下 cwd 为工作区根目录；若宿主启动目录非工作区根，相对路径可能解析错误。
• 格式处理：路径尾部的反斜杠会被自动剥离，以避免破坏命令行参数。
• 安全设计：
  • 路由不在 /api 前缀下，仅接受 POST 请求和 JSON 数据。
  • Origin 必须匹配 http://<Host>，且 Host 必须是回环地址（127.0.0.1, localhost, ::1）。
  • 仅允许 http、https、file、mailto 协议。
• 文本匹配：在“思考过程”等大段纯文本中嵌入的路径不支持悬停，插件仅识别“内容恰好是路径”的文本。