前言¶
在使用 DeepSeek Harness Web (dsh web) 时，助手经常会在回复中生成文件，并显示在「产物」/ “Produces” 行中。默认情况下，点击这些文件芯片通常会直接打开文件。dsh-reveal-files 插件修改了这一行为，为每个文件芯片添加了一个紧凑的下拉菜单，提供打开、复制路径、在文件浏览器中显示以及打开终端目录等操作，无需额外配置工具。
插件简介¶
该插件由 yumm007 维护，许可证为 MIT。它主要解决的问题是：在智能体开发中，快速对生成的文件执行常见文件系统操作（如查看、复制路径、在终端中进入目录）的需求。通过在文件芯片上点击，用户可以直接选择操作，而不是直接打开文件。
核心功能¶
- 下拉菜单交互：点击每个文件芯片时，会打开一个紧凑的菜单，而不是直接打开文件。
- 打开文件：使用系统默认应用打开文件。
- 复制文件路径：将文件的绝对路径复制到剪贴板。
- 在文件浏览器中显示：调用系统原生文件管理器定位文件（macOS 使用 Finder，Linux 使用文件管理器，Windows 使用 Explorer）。
- 在终端打开目录：打开系统首选终端，并自动
cd到文件所在目录。 - 本地化支持：菜单标签跟随 UI 语言（简体中文 / 英语）。
- 零运行时依赖：除了 Harness 本身外，无需额外的运行时依赖。
环境要求¶
- DeepSeek Harness Web (
dsh web)。 - Node.js >= 22.6.0。
- 桌面环境（macOS 和 Windows 始终可用；Linux 需要显示服务器或 WSL）。
安装与启用¶
使用以下命令安装插件。安装后需要重启 dsh web 使其生效。
dsh plugin --profile web add github:yumm007/dsh-reveal-files#main
安装完成后，插件会在 Web 服务器启动时加载，并注册相应的路由和前端组件。
典型用法¶
- 让助手生成文件（任何包含
write或edit工具结果的回复）。 - 在回复下方找到「产物」/ “Produces” 行，点击文件芯片。
- 从下拉菜单中选择操作（打开、复制路径、在文件浏览器中显示、在终端打开目录）。
配置说明¶
插件在 cordis.patch.yml 中接受配置。默认情况下，插件已启用。
- insert:
- id: dsh-reveal-files
name: 'dsh-reveal-files'
config:
enabled: true # 注册文件操作路由（默认为 true）
revealTimeoutMs: 10000 # 单个命令超时时间（毫秒，默认 10000）
如果需要覆盖默认配置，可以在 Profile 的 cordis.patch.yml 中进行修改。
注意事项¶
- 插件以当前
dsh进程的权限运行。在 Linux 上，如果当前环境没有显示服务器或未使用 WSL，文件浏览器功能将无法工作。 - 错误信息（例如沙箱拒绝、平台不支持）会显示在打开的菜单中以红色文字呈现。
- 插件在 Host 端仅使用
node:child_process，在客户端仅使用 React，没有额外的运行时依赖。
总结¶
dsh-reveal-files 通过在 DeepSeek Harness 的产物行中引入下拉菜单，简化了与生成文件的交互流程。对于需要在本地查看或进一步编辑文件的开发者来说，这是一个提升效率的工具。
