前言¶
用 DeepSeek Harness（DSH）做智能体或本地工程开发时，经常要在「资源管理器里看到的目录」和「dsh 里的工作区、会话」之间来回切换：复制路径、手动新建工作区、再开会话，步骤多且容易打断思路。社区插件 dsh-explorer-open（维护者 ame-code，分类：客户端）在 Windows 资源管理器右键菜单里增加 「通过 dsh 打开」，点一下即在 dsh 中打开对应文件夹（无工作区则新建），并打开一个新会话；在文件上右键时还会把 @文件名 放进新会话草稿。下面按定位、功能、安装与排查说明用法。
这是什么¶
dsh-explorer-open 是发布在 npm 上的 DSH 插件包（dsh-explorer-open），仓库见 GitHub：ame-code/dsh-explorer-open，插件目录页见 skillhub.cn/plugins/ame-code/dsh-explorer-open。它只做一件事：把 Windows 资源管理器的右键操作桥接到 dsh 的工作区与会话创建流程；Win11 的新式简洁菜单与旧式完整菜单均支持，并带菜单图标。许可证为 MIT；当前 README 标明处于 0.1.x，接口路径、状态目录、环境变量与安装方式仍可能变化。
核心功能¶
根据 README 中的行为表，右键对象与结果如下：
| 在哪儿右键 | 打开的文件夹 | 放进新会话的草稿 |
|---|---|---|
| 文件夹空白处 | 当前文件夹 | 无 |
| 文件夹图标上 | 这个文件夹 | 无 |
| 任意文件上 | 文件所在的文件夹 | @文件名 引用（工作区之外的路径不引用） |
补充约定（均来自官方 README）：
- 每次点击都会新建会话并切换过去；工作区按完整路径复用，不会重复创建。
- dsh 未启动时会先拉起 dsh，请求排队直到页面连上再执行。
- 插件停用或卸载时会自行拆掉菜单（旧式注册表键 + Win11 新式 MSIX 包），避免残留。
- 仅在 Windows 上工作（注册表 + MSIX + 资源管理器）。
安装与启用¶
从 npm 安装（推荐）¶
在 dsh 的插件设置里安装包名 dsh-explorer-open，或由 agent 通过 bundle 安装入口接受 npm 包名完成安装。README 未给出 dsh plugin add github:... 一类命令，此处以资料原文为准。
首次启用时会自动安装 Win11 新式菜单所需的 MSIX 包。因使用自签证书，Windows 可能拒绝安装并提示：
Deployment failed with HRESULT: 0x800B0109
处理方式：以管理员身份运行一次插件目录下的 native/trust-cert.bat（将自签证书 dsh-open-with.cer 导入 LocalMachine\TrustedPeople），然后重启 dsh；通常只需做一次。
若只需要旧式菜单、不想处理证书，可在启动 dsh 前设置环境变量：
DSH_EXPLORER_OPEN_NO_MSIX=1
插件将不会安装 MSIX 包。
从本地目录安装（开发场景）¶
资料中的示例为在 dsh 环境里执行 bundle 安装（路径需换成你的本地克隆目录）：
# 仓库本身就是插件包（package.json 在根目录）
plugin_manager install_bundle E:\work\tools\dsh-open-with
修改代码后需重启 dsh 以重新加载宿主侧插件；客户端 bundle 需刷新页面。
典型用法¶
- 确保 dsh 中已启用 dsh-explorer-open（npm 包名）。
- 在资源管理器中：在目标文件夹空白处、文件夹图标上或任意文件上右键，选择 「通过 dsh 打开」。
- 等待 dsh 窗口前置；插件会创建或复用该路径的工作区，并打开新会话。若在文件上右键，会话草稿中会带有
@文件名引用。
整体链路（便于理解排错）可概括为：右键触发 launch.ps1 → 写入 ~/.dsh/dsh-explorer-open/pending.json → 宿主侧轮询 API → 页面侧创建 workSpace 与会话 → 必要时初始化带 @文件 的草稿。
适用场景与注意¶
适合谁：主要在 Windows 上用 dsh 做本地目录相关开发、希望从资源管理器一键进入对应工作区与会话的用户。
环境与限制（README 已知限制）：
*注册会使菜单出现在所有文件类型上，包括没有关联程序的类型。- 以管理员权限运行的资源管理器不会显示用户级（HKCU）菜单项。
- Win11 新式菜单需要证书受信；向第三方分发时宜使用正式代码签名证书，而非自签。
安全与信任：插件会注册右键菜单、可能安装 MSIX、并通过自定义 HTTP 头与 dsh 插件 API 通信；安装前建议在 GitHub 仓库 查看源码与 MIT 许可证，并确认与当前 dsh 版本兼容。DSH 社区目录（skillhub.cn）为独立站点，与 DeepSeek / 幻方无官方从属关系；生态理念是「一切皆插件」，本插件为社区维护的客户端扩展。
排错提示：若点击菜单后只前置 dsh 窗口而未打开工作区，可先查看 ~/.dsh/dsh-explorer-open/trace.log（宿主与页面 ack 阶段）；必要时检查 pending.json 是否写入。原生组件调试可设 DSH_EXPLORER_OPEN_DEBUG=1 后查看 LOCALAPPDATA%\dsh-explorer-open-command.log。
结尾¶
dsh-explorer-open 把 Windows 资源管理器的右键路径与 dsh 的工作区、会话创建连在一起，减少手工拷贝路径和重复建工作区的步骤。更多信息见 插件目录页 与 GitHub 仓库。
