dsh-direct-open: Enable opening files in DSH replies with the default system application via left click

前言

在 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 手动安装:

  1. 从 Releases 下载 dsh-direct-open.tgz。
  2. 执行:
dsh plugin --profile desktop add ./dsh-direct-open.tgz

典型用法

  1. 安装并刷新页面,打开 设置 → 打开方式,确认总开关开启且环境显示系统打开能力可用。
  2. 在回复里点击交付文件卡片预览按钮或改动卡中的文件行:默认会用系统默认程序打开;需要侧边栏预览时按住 Shift 再点(默认放行键)。
  3. 在文件行上右键,选择「在文件管理器中定位」或「复制相对路径」等;若与 DSH 原生右键冲突,可在设置里关闭不需要的菜单项或关闭自定义右键菜单。
  4. 换浏览器或清站点数据前,用设置页导出 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。

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

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

Xiaoye