前言¶
在 DeepSeek Harness(DSH)里看智能体交付的文件时,默认习惯往往是左键点进侧边栏预览。若你更想直接用 VS Code、系统编辑器或文件管理器处理路径,就要多一步操作。dsh-direct-open 是纯客户端插件:接管回复里若干「文件入口」的点击行为,左键可改为系统默认打开或定位,并附带可配置的右键菜单;不启动额外进程,也不改 Host 配置。下面介绍它的定位、能力与安装方式。
这是什么¶
dsh-direct-open(npm 包名同插件仓库名)由维护者 likaileave 发布,分类为客户端插件,许可证 MIT。它通过 DSH 提供的 remote.session.openWorkspacePath({ path }) 在桌面端调用系统打开能力;Web 端没有该能力时插件会显示不可用且不接管点击。
核心功能¶
左键与放行修饰键¶
默认左键动作为「用系统默认程序打开」,也可在设置里改为「在文件管理器中定位」或「在 DSH 侧边栏中查看」(交回 DSH 原有预览)。默认按住 Shift 时不接管左键,仍走 DSH 原逻辑;放行键可改为 Ctrl、Alt 或关闭。
支持的入口¶
| 入口 | 说明 |
|---|---|
| 交付文件卡片 | 回复末尾 data-presented-file 卡片上的预览按钮 |
| 改动卡片(单文件) | 单文件标题行 |
| 改动卡片(多文件) | 列表中每一文件行(不接管「已编辑 N 个文件」卡片头) |
| 正文文件提及 | 行内代码提及与显式文件链接 |
不会接管:多文件卡片整体标题行、review 页面、普通行内代码(非文件提及)。
右键菜单¶
启用自定义菜单后,右键上述入口可出现五项操作(可逐项关闭):用默认程序打开、在文件管理器中定位、在 DSH 侧边栏中查看、复制绝对路径、复制相对路径。菜单支持方向键、Enter、Escape;关闭「启用自定义右键菜单」则右键完全交回 DSH。
设置与快捷键¶
设置页位于 设置 → 打开方式,含总开关、各入口的左键/右键开关、左键动作、放行修饰键、菜单项、诊断选项,以及导入/导出 JSON 与恢复默认。配置保存在浏览器 localStorage 的 dsh-direct-open:settings:v1,修改后在同浏览器多标签页同步。
桌面端默认快捷键 Ctrl/Cmd + Alt + Shift + O 用于暂停或恢复直接打开;Web 端无默认快捷键。
安装与启用¶
需要 DSH 0.2.0-rc.2 或更高,且运行在提供 remote.session.openWorkspacePath 的桌面端。安装或更新后刷新 Web 页面。
npm:
dsh plugin --profile desktop add dsh-direct-open
将 desktop 换成你实际使用的 profile。
dsh-market: 在市场中搜索 dsh-direct-open 安装。
GitHub Release 手动安装:
- 从 Releases 下载
dsh-direct-open.tgz。 - 执行:
dsh plugin --profile desktop add ./dsh-direct-open.tgz
典型用法¶
- 安装并刷新页面,打开 设置 → 打开方式,确认总开关开启且环境显示系统打开能力可用。
- 在回复里点击交付文件卡片预览按钮或改动卡中的文件行:默认会用系统默认程序打开;需要侧边栏预览时按住
Shift再点(默认放行键)。 - 在文件行上右键,选择「在文件管理器中定位」或「复制相对路径」等;若与 DSH 原生右键冲突,可在设置里关闭不需要的菜单项或关闭自定义右键菜单。
- 换浏览器或清站点数据前,用设置页导出 JSON,在新环境导入以免丢失偏好。
左键三种动作与 API 对应关系如下(资料原文):
| 设置 | 行为 |
|---|---|
| 用系统默认程序打开 | openWorkspacePath({ path }) |
| 在文件管理器中定位 | openWorkspacePath({ path, action: "reveal" }) |
| 在 DSH 侧边栏中查看 | 触发入口元素原有点击 |
适用场景与注意¶
适合经常在 DSH 桌面端处理智能体产出文件、希望少点一次侧边栏的开发者。插件依赖 DSH DOM 标记(如 data-presented-file、data-changed-files、fileMention),大版本 UI 变更可能需要插件同步更新;正文相对路径依赖当前会话 cwd,无活动会话时可能不接管并在控制台记录原因。插件以当前 DSH 客户端权限运行,安装前可在 GitHub 查看源码与 MIT 许可证。不支持指定某一应用打开,只有系统默认打开与文件管理器定位;设置不跨设备同步。
社区插件目录 SkillHub 上的 dsh-direct-open 页 与 GitHub 仓库并列存在,与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-direct-open 把交付卡、改动行和正文文件提及从「只能侧边栏预览」扩展为可配置的左键打开与右键菜单,改动范围限于浏览器端 Cordis bundle。进一步了解实现与限制见仓库 README。