前言¶
在 DeepSeek Harness（DSH）里，对话正文里的文件链接、行内路径、右侧文件树里的条目，普通左键点击都会进右侧 Sidebar 预览。对习惯在 IDE 或 Office 里改文档的人来说，多一步「先进预览再打开」往往多余；小屏上侧栏还要和主对话抢宽度，长 Markdown、PDF、表格在窄面板里也不顺手。DSH 生态里客户端能力可以插件化扩展。下面介绍社区插件 dsh-skip-preview（维护者 finalrgy）：在不改掉原有预览的前提下，给文件打开加一条并行出口——按住修饰键再点链接，跳过预览，交给系统默认应用处理。
这是什么¶
dsh-skip-preview 是 DSH 客户端插件（分类：客户端）。它包装宿主服务 sidebarRight.openResource——会话正文里文件进入右侧面板的统一入口——在检测到特定修饰键组合时，改为调用系统默认打开方式，而不是打开侧栏预览。普通点击行为与未装插件时一致。插件 MIT 许可，源码与说明见 GitHub：finalrgy/dsh-skip-preview；社区目录页：skillhub.cn/plugins/finalrgy/dsh-skip-preview。社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
-
并行出口，不替换预览
左键点击仍为 DSH 原有侧栏预览；只有带指定修饰键的点击才会走「系统默认应用」路径。 -
平台修饰键
- macOS：⌘ + 左键（认metaKey）。
- Windows / Linux：Ctrl + 左键（认ctrlKey）。
- 若同时带 Shift、Alt 等其它修饰键，一律仍走预览，插件不拦截。
- macOS 上 Ctrl+点击多为系统右键菜单，仍按预览处理。 -
覆盖的入口（均经
openResource）
- 正文 Markdown 链接，例如[report.md](report.md)。
- 行内代码里的路径，例如`docs/spec.md`。
- 右侧文件树中点击文件。
不覆盖：present交付卡片（走ui-deliverables自有路由）。 -
打开失败时回退
路径不在工作区、文件不存在等导致宿主拒绝打开时，会自动退回侧栏预览，并在 Console 记录原因，避免「点了没反应」。 -
具体用哪个应用
由操作系统文件关联决定；插件不指定、也不修改默认程序。 -
启动自检
若 DSH 变更了sidebarRight.openResource等方法名，Console 会打印[dsh-skip-preview] 启动自检失败并说明受影响行为，而不是静默失效。
安装与启用¶
官方安装命令（来自 README）：
dsh plugin --profile desktop add dsh-skip-preview
从 GitHub 源码安装：
dsh plugin --profile desktop add github:finalrgy/dsh-skip-preview
装完后需要完全退出并重启 DSH；仅刷新页面不足以重载客户端 bundle。
兼容性（见 package.json 的 dsh.engines.dsh）：需要 DSH >= 0.2.1-rc.5。当前插件版本在资料中为 0.1.4。
安装前建议自行查看仓库源码与 MIT 许可证。客户端插件随 DSH 桌面进程运行，打开文件使用的是当前用户对系统的访问权限，请只在信任的来源安装。
典型用法¶
| 操作 | macOS | Windows / Linux |
|---|---|---|
| 左键点击文件链接 | 侧栏预览（原行为） | 侧栏预览（原行为） |
| ⌘ + 左键 | 系统默认应用打开 | — |
| Ctrl + 左键 | 预览（Ctrl+点击多为右键） | 系统默认应用打开 |
| 带 Shift / Alt 等其它修饰键 | 一律预览 | 一律预览 |
| 打开失败 | 回退预览，Console 记原因 | 同左 |
在会话里找到 Agent 提到的文件链接或路径，按住对应平台的修饰键再左键点击即可。界面无额外提示，需自行记住手势。
适用场景与注意¶
适合谁
- 小屏笔记本上不想在窄侧栏里读长文档，希望用全屏编辑器或 PDF 阅读器打开。
- 点击链接的本意就是在外部编辑器里修改，不想多经过预览。
- 希望
.xlsx、.pdf等由 Excel / WPS、系统预览器等关联程序处理。
已知限制（README 原文）
- 依赖
sidebarRight.openResource方法名；DSH 大版本升级后可能需要插件更新。 - 修饰键手势在模块内为全局单例快照，任意点击会覆盖，有 1 秒 TTL，极端并发点击理论上可能误判。
- 触发键写死在代码中（
TRIGGER_IS_META附近），无配置项。 - Windows/Linux 上
ctrlKey分支有测试覆盖，维护者注明未在真实 Windows 环境实测。 - 交付卡片不支持。
插件在服务层包装、不直接改 DOM；除上述单一修饰键组合外，不接管其它点击，全部交回 DSH 与浏览器。
结尾¶
dsh-skip-preview 给 DSH 会话里的文件链接增加「预览 / 系统默认应用」双路径：默认仍是侧栏预览，⌘ 或 Ctrl 加左键则跳过预览直接打开。若你在桌面版 DSH 里频繁从对话跳进本地文件，可按上文命令安装并重启后再试手势。
- 目录页：https://www.skillhub.cn/plugins/finalrgy/dsh-skip-preview
- GitHub：https://github.com/finalrgy/dsh-skip-preview
