在 DeepSeek Harness (DSH) 对话中，AI 输出的文件或目录路径通常是纯文本。要打开这些路径，用户通常需要选中、复制，再粘贴到系统文件管理器中。dsh-file-opener 插件将这类文本转换为可交互的元素，点击即可在右侧侧边栏预览，或调用系统默认程序打开。
插件介绍¶
该插件由用户 sailoumili 开发，版本 1.4.0，采用 MIT 许可证。它支持 DSH 0.1.7-alpha.1 及以上版本，且零第三方运行时依赖。
安装¶
Web 版：
在终端执行以下命令：
dsh plugin --profile web add dsh-file-opener
桌面版：
1. 打开 DSH 桌面版，点击左侧栏「插件」。
2. 点击「添加插件」。
3. 输入包名 dsh-file-opener，点击「安装」。
4. 安装完成后点击「立即启用」，并确认其开关为打开状态。
核心功能¶
插件会自动识别对话中的路径文本，并将其转换为可点击的按钮。
- 点击文件路径：如果文件支持预览（例如 Markdown、图片、代码文件等），则在右侧侧边栏显示；否则调用系统默认程序打开。
- 点击目录路径：在 Windows 上使用资源管理器打开；其他平台则通过侧边栏处理。
- Shift + 点击文件路径：强制调用系统默认程序，忽略预览逻辑。
- 点击路径后的文件夹图标：点击文件路径后的文件夹图标，可打开其所在目录；如果是目录，则打开该目录本身。
- 点击不存在的路径：不报错，而是打开其所在的那一级真实目录。
- 路径识别范围：支持绝对路径、
~/...（展开为当前用户主目录）、./与../（按会话工作目录解析）。 - 行内代码识别：即使未附带官方按钮，只要内容是路径的行内代码，同样可点击并带有文件夹图标。
- 错误处理：打开失败时会给出可见提示，不会静默失败。
使用建议¶
为了让 AI 回复中的文件路径可点击，建议在 agent 指令文件（如 AGENTS.md）中明确要求 AI 使用反引号包裹完整绝对路径。例如：
回复中提到的每个文件或目录，都必须用反引号包裹完整绝对路径，例如
C:\work\报告.md。
注意事项¶
由于插件以当前 DSH 进程的权限运行，使用时需注意以下限制：
- 平台差异：目录打开仅支持 Windows；其他平台会退回到侧边栏打开。
- 安全过滤：UNC 网络路径（如
\\server\share）与 Windows 保留设备名（CON、PRN、AUX、NUL、COM1-COM9、LPT1-LPT9）不予打开。 - 相对路径限制：相对路径无绝对路径可用时，仅能通过侧边栏打开；Shift 强制系统程序对其无效。
- 工作区外访问：工作区外的路径交给侧边栏预览时，可能因宿主访问策略返回 403，或文件过大返回 413。此时按住 Shift 点击用系统程序打开。
- 权限问题：权限不足的路径会被视为不存在，表现为打开其上级目录。
- 特殊字符：文件名以单引号或反引号结尾时，该字符会被当作标点去掉。
结语¶
该插件通过将路径交互化，降低了 DSH 对话中文件管理的操作成本。如需查看源码或反馈问题，可访问其 GitHub 仓库。
