前言¶
在 DeepSeek Harness（DSH）里，对话区会出现文件链接、行内路径、网页 URL 和工作区附件；右侧 Sidebar 还有文件树，左侧有工作区列表。若只能手动复制路径、再切到系统资源管理器或浏览器操作，步骤多且容易出错。社区插件 dsh-file-context-menu（维护者 Dusty-Dustin55）在这些位置提供统一的右键菜单：引用到输入框、复制名称或路径、内部预览、用默认或指定应用打开、定位文件夹、另存副本等。下面介绍它的能力边界、安装方式与使用注意。
这是什么¶
dsh-file-context-menu 是发布在 npm 的 DSH 客户端插件（当前版本 0.4.0，许可证 MIT）。它在对话区、Sidebar「文件」树和左侧工作区列表上监听右键，根据命中对象弹出对应菜单；路径解析复用 DSH 的 remote.session、remote.workspaceFiles 和 workspaces 服务，本机打开文件、浏览器等动作由宿主提供的 /file-actions/* 路由完成。插件不上传用户数据；诊断默认关闭，仅在本机开启诊断开关时才会把命中信息写入本机内存接口。
可在社区目录页查看条目：dsh-file-context-menu。源码与说明见 GitHub 仓库。
支持的右键位置¶
安装并重启 DSH 后，下列位置会出现定制菜单（具体项随对象类型变化）：
| 位置 | 右键对象 | 菜单类型 |
|---|---|---|
| 对话区 | 文件链接 / 交付卡片 / 行内代码路径 | 完整文件菜单 |
| 对话区 | 目录路径（如 证据库/全文/） |
目录菜单 |
| 对话区 | 无扩展名路径 | 自动判断文件或目录 |
| 对话区 | http(s) 网页链接 | 链接菜单 |
| 对话区（自己发送的消息） | 纯文本 http(s) 链接 | 链接菜单 |
| 对话区（自己发送的消息） | 文件附件卡片 | 仅「复制名称」 |
| 对话区 | 任意文字或选中文字 | 文字菜单 |
| 右侧 Sidebar「文件」树 | 文件夹 | 文件夹菜单 |
| 左侧工作区列表 | 工作区分组行 | 工作区菜单 |
识别范围包括 dsh-resource://file/...、交付卡片上的路径、路径式 href、行内代码中的路径（如 `工作底稿/设计.md`），以及约 230 种扩展名（含大写扩展名、UNC、中文与全角符号、含空格文件名等）。普通正文里未格式化的路径、不带斜杠的裸目录名、代码表达式不会被当作可右键对象；目录建议写成 工作底稿/ 形式。
菜单能力概览¶
文件¶
| 菜单项 | 作用 |
|---|---|
| 引用该文件 | 向输入框插入 @路径 文件引用 |
| 复制名称 | 复制文件名（含扩展名） |
| 复制路径 | 复制绝对路径；解析失败时退回显示路径 |
| 打开（内部） | 在右侧 Sidebar 预览 |
| 打开（默认应用） | 用系统默认程序打开 |
| 选择应用打开… | Windows「打开方式」；macOS 应用选择器；其他系统退回应用列表 |
| 打开所在文件夹 | 打开父目录并选中该文件 |
| 另存为… | 复制到自选位置（优先 showSaveFilePicker，不可用时回退下载） |
目录 / 文件夹¶
- 复制名称、复制路径、打开文件夹（直接打开该目录；与文件的「打开所在文件夹」不同）。
网页链接¶
- 引用链接（URL 插入输入框）、复制名称、复制链接、打开（内部 Sidebar 浏览器页签）、打开（默认浏览器）、选择浏览器打开…（列出 Edge、Chrome、Firefox、Brave、Vivaldi 等）。
工作区与文字¶
- 工作区：复制名称、复制路径、打开所在文件夹（在父目录定位工作区文件夹）。
- 文字：复制文字；引用到对话框（以 Markdown 引用块
> ...插入输入框）。
安装与启用¶
在 DSH 插件页安装，或在终端执行：
dsh plugin --profile desktop add dsh-file-context-menu
安装后需要完全退出并重新启动 DSH，客户端模块在启动时加载。
更新到最新版：
dsh plugin --profile desktop add dsh-file-context-menu@latest
卸载：
dsh plugin --profile desktop remove dsh-file-context-menu
要求 DSH 0.2.1-rc.1 及以上（package.json 中 engines.dsh 已声明）；README 写明当前适配 DSH 0.2.1-rc.5。
典型用法¶
- 在对话里对行内路径或文件链接右键，选「引用该文件」，输入框会出现
@路径，便于继续 @ 引用工作区文件。 - 对 http(s) 链接右键，选「打开（内部）」在 Sidebar 浏览器页签查看，或选「打开（默认浏览器）」交给系统浏览器。
- 在 Sidebar 文件树对文件夹右键，用「打开文件夹」在本机资源管理器中打开该目录。
- 选中一段说明文字右键，选「引用到对话框」，以引用块形式插入输入框，方便在回复里指向原文。
链接的「引用链接」插入的是 URL 文本；输入框的 @ 引用仅支持工作区文件，这是 DSH 侧能力边界，不是插件单独限制。
适用场景与注意¶
适合经常在 DSH 对话里点路径、链接和工作区、又不想反复手工复制与切换外部应用的用户。插件以当前 DSH 进程权限调用本机打开、另存为等能力，安装前建议浏览 源码仓库 与 MIT 许可证，确认符合你的环境策略。
已知限制（来自 README）：
- 链接「打开（内部）」依赖 Sidebar Browser 页签；Web profile 默认禁用时会提示无法打开。
- 「另存为」受
/api/file字节上限约束（当前约 10 MB）。 - 相对路径无法解析为绝对路径时，菜单可能只剩「打开（内部）」和「引用」。
- Sidebar 文件树目前只接管文件夹行右键，文件行尚未接管。
- 用户消息里的附件卡片只有文件名、无真实路径，因此只有「复制名称」。
- 依赖 DSH 0.2.x 的客户端服务名；DSH 大版本升级后需复核兼容性。
问题反馈：GitHub Issues；变更见仓库内 CHANGELOG.md。
结尾¶
dsh-file-context-menu 把 DSH 里常见的文件、目录、链接与工作区入口收成一套右键操作，减少复制路径和在系统里找文件的重复劳动。社区目录：SkillHub 插件页；源码与完整说明：github.com/Dusty-Dustin55/dsh-file-context-menu。
