前言¶
在 DeepSeek Harness(DSH)里,助手回复里经常出现本地文件超链接、文件引用标签(Chip)或代码块中的路径。默认浏览器式右键往往只有复制链接,无法用「用某应用打开」「在资源管理器中显示」这类桌面习惯操作工作区文件。下面介绍社区插件 dsh-file-context-menu(npm 包名 @dengsixue/dsh-file-menu),它在 DSH Desktop 对话区域为这些元素注入上下文菜单,行为接近操作系统原生文件菜单。
这是什么¶
dsh-file-context-menu 由维护者 dengsixue-stack 发布,分类为 客户端 插件:通过 Cordis patch 与客户端注入(依赖 @deepseek-ai/dsh-client-ui-conversation),在 Web 端对话 UI 中拦截文件相关元素的右键事件。项目采用 MIT 许可证,当前 package 版本为 1.0.1(以仓库 package.json 为准)。
社区目录页:dsh-file-context-menu。源码与说明:GitHub - dengsixue-stack/dsh-file-context-menu。SkillHub 为独立社区目录,与 DeepSeek / 幻方无官方从属关系;DSH 生态遵循「一切皆插件」,可按需从 npm 或本地包安装。
核心功能¶
以下能力均来自项目 README 与 package.json 描述,按使用场景归纳。
打开与「打开方式」¶
- 菜单顶部会记忆上次用来打开该类型文件的应用,便于一键再次用同一应用打开。
- Windows:从注册表(
HKCU/HKLM)解析关联应用与OpenWithList,并通过 PowerShell 批量提取应用图标;README 说明已处理 Electron 环境下外部应用继承ELECTRON_RUN_AS_NODE导致唤起失败的问题。 - macOS:通过 LaunchServices 解析与 Finder 一致的应用列表与图标。
部分 Windows UWP 沙盒应用(如系统简易照片)不会出现在传统打开方式列表中,属平台限制。
保存、复制与定位¶
- 另存为…:调用系统原生保存对话框,将工作区文件保存到任意目录。
- 快速复制:可复制文件名/链接文本、绝对路径、文件内容(文本文件,5MB 以内)。
- 在资源管理器 / Finder 中显示:打开父目录并高亮选中该文件。
交互细节¶
- 子菜单采用悬停缓冲与约 280ms 延时,减少斜向移动时子菜单意外关闭。
- 按住 Shift 再右键,可穿透到操作系统或浏览器原生菜单,不替代原生行为。
平台兼容性¶
| 平台 | 打开方式 | 图标 | 状态(README) |
|---|---|---|---|
| Windows | 注册表关联应用 | PowerShell 批量提取 | 已适配 |
| macOS | LaunchServices | 系统原生映射 | 支持 |
安装与启用¶
推荐通过 npm 包安装,命令须带 --profile desktop(客户端插件面向 DSH Desktop):
dsh plugin --profile desktop add @dengsixue/dsh-file-menu
也可从 GitHub Releases 下载 .tgz,在 DSH Desktop「插件」页安装,或:
dsh plugin --profile desktop add .\dengsixue-dsh-file-menu-1.0.0.tgz
本地开发调试时,可将源码目录直接加入(路径按本机修改):
dsh plugin --profile desktop add "C:\Users\Administrator\Documents\dsh-file-context-menu"
安装、更新或修改客户端注入代码后,必须完全退出并重新打开 DSH Desktop(重启主进程)。仅在界面按 Ctrl + R 刷新无法重新加载底层客户端扩展。
典型用法¶
- 在 DSH Desktop 中完成上述安装并重启应用。
- 在对话里找到指向工作区本地文件的链接、Chip 或代码块中的文件路径。
- 在该元素上右键,使用「打开方式」「另存为」「复制路径/内容」「在 Finder/Explorer 中显示」等项。
- 若需要浏览器或系统自带右键菜单,按住 Shift 再右键。
插件不提供单独配置文件字段;行为由注入的客户端脚本与宿主提供的文件路径解析能力决定。
适用场景与注意¶
适合谁:经常在 DSH 对话里点击、复制、用外部编辑器打开工作区文件的 Desktop 用户;在 Windows 或 macOS 上希望右键菜单与系统习惯一致的场景。
权限与安全:客户端插件在 当前 DSH 进程权限 下运行,可触发打开外部程序、读写路径与文件内容(复制内容受 5MB 限制)。安装前应阅读 源码仓库 与 MIT 许可证,确认符合你的安全策略。
环境:需 DSH Desktop 与 Cordis 插件体系(peerDependencies 含 @deepseek-ai/cordis ^4.0.1)。非 Desktop 或未注入对话 UI 的环境可能不会加载该客户端扩展。
结尾¶
dsh-file-context-menu 把 DSH 聊天里的文件链接从「只能复制 URL」扩展为桌面级右键操作:打开方式、另存为、复制路径与内容、在 Finder/Explorer 中定位,并保留 Shift+右键原生菜单穿透。
- 目录页:https://www.skillhub.cn/plugins/dengsixue-stack/dsh-file-context-menu
- GitHub:https://github.com/dengsixue-stack/dsh-file-context-menu