资源管理器选目录liell/dsh-workspace-explorer-picker

dsh-workspace-explorer-picker

License: MIT
Platform
Target
npm version

一个 DeepSeek Harness Desktop 插件，在你添加工作区时直接打开原生的 Windows 资源管理器文件夹选择器——不再使用应用内的目录浏览器。

在 DeepSeek Harness Desktop 中点击 Add workspace 通常会打开一个在 Web GUI 内渲染的目录浏览器。此插件完全跳过该对话框，并立即打开真正的 Windows 资源管理器文件夹选择器——与 shell 已用于其“Choose with Windows”操作相同的原生对话框。

功能特性

- 直接从“Add workspace”打开 原生 Windows 资源管理器文件夹对话框
（包括对话主界面和侧边栏）。
- 无渲染客户端插件——自身没有需要维护的 UI。
- 使用桌面 shell 自带的选取器（Electron dialog.showOpenDialog）——完整的
资源管理器体验（快速访问、面包屑导航、搜索、新建文件夹）。
- 在 DSH Desktop 更新后依然可用：安装在 $DSH_HOME（用户配置文件）下，
绝不在 Program Files 内。
- 幂等安装程序（install.ps1），可在任何机器上快速设置。
- 无卷限制：可选择任何可访问的文件夹，包括 exFAT/FAT32
和网络卷。
- 可上架市场：声明了 dsh.bundle.patch，因此可以从
DSH Community Market / npm 安装。

目录

- 要求
- 安装
- 市场与 npm
- 工作原理
- 卸载
- 故障排除
- 开发
- 发布
- 许可证

要求

| 要求 | 详情 |
| --- | --- |
| 操作系统 | Windows（资源管理器选择器是仅限 Windows 的 shell 功能） |
| 应用 | DeepSeek Harness Desktop（Electron 桌面应用） |
| GUI 入口 | 应用窗口，或应用打开的浏览器标签页（桌面选取器桥接必须存在） |

在桌面 shell 之外，插件会回退到宿主目录选取器接缝。

安装

自动（推荐）

需要 PowerShell。从仓库根目录运行：

powershell -ExecutionPolicy Bypass -File .\install.ps1

它执行的操作：

1. 将插件复制到 $DSH_HOME\profiles\node_modules\dsh-workspace-explorer-picker\
（$DSH_HOME 默认为 ~/.dsh）。
2. 将激活行追加到 $DSH_HOME\profiles\desktop\cordis.patch.yml。
3. 打印确认信息——然后重启 DeepSeek Harness Desktop。

该脚本是幂等的：重新运行是安全的。

手动

1. 将 lib 文件夹、cordis.patch.yml 和 package.json 复制到
$DSH_HOME\profiles\node_modules\dsh-workspace-explorer-picker\。
2. 追加到 $DSH_HOME\profiles\desktop\cordis.patch.yml：

- id: directory-picker
disabled: true
- insert:
- id: directory-picker-explorer
name: 'dsh-workspace-explorer-picker'

3. 重启 DeepSeek Harness Desktop。

验证

重启后，点击 Add workspace —— Windows 资源管理器文件夹对话框应立即打开。如果没有任何反应，请查看 %APPDATA%\DSH Desktop\logs\ 下的日志（参见故障排除）。

市场与 npm

当包声明了 dsh.bundle.patch 时（本插件已声明 —— 参见 cordis.patch.yml），DeepSeek Harness Desktop 的社区市场会从 npm 安装插件。该 bundle patch 会禁用内置的自适应选择器并插入本插件，因此当插件作为 bundle 安装时，上述手动 profile patch 不再需要。

1. 发布到 npm，以便市场能够解析安装目标：

npm login
npm publish

2. 在目录中登记（例如 dshfind）：按照其提交流程在 https://dshfind.com 提交你的包。该目录会在接受结构化安装证据之前验证仓库反向链接（package.json 中的 repository 指向你的 GitHub 仓库）。

3. 用户安装：从市场安装（DSH Desktop 设置中的 Plugins / Market）：Host 会运行 pnpm add dsh-workspace-explorer-picker，应用 bundle patch，并将其添加到 profile bundles 中。

工作原理

DeepSeek Harness Desktop 通过 Cordis bundles 组合其 Web GUI，并从 $DSH_HOME/profiles//cordis.patch.yml 应用用户 patch 层。内置的“添加工作区”流程会用应用内目录浏览器填充一个 UI 槽位。

本插件是一个无渲染的客户端插件，它占用相同的目录流程槽位（conversation.hero.workspace.directoryFlow 和 sidebar.workspaces.directoryFlow），并在每次打开时选择一个文件夹：

1. window.__DSH_DESKTOP_PICK_DIRECTORY__ —— DSH Desktop shell 桥接（Electron 的 dialog.showOpenDialog，使用 openDirectory）—— Windows 资源管理器文件夹对话框。
2. 回退方案：宿主 workspaces.pickDirectory() 目录选择器接缝。

patch 行 directory-picker（内置的自适应选择器）被禁用，因此应用内浏览器永远不会出现。

由于所有内容都位于 $DSH_HOME 下，对 DSH Desktop 的更新（会替换 Program Files）永远不会影响该插件。

卸载

1. 从 cordis.patch.yml 中移除 patch 行（参见手动安装）。
2. 删除 $DSH_HOME\profiles\node_modules\dsh-workspace-explorer-picker。
3. 重启 DeepSeek Harness Desktop。

故障排除

| 症状 | 原因 / 修复 |
| --- | --- |
| “Add workspace”仍然打开应用内浏览器 | 应用未重启，或 patch 未应用。重新运行 install.ps1 并重启 DSH Desktop。 |
| 点击“Add workspace”时没有任何反应 | 插件激活失败。请检查 %APPDATA%\DSH Desktop\logs\，并确认包文件夹存在于 profiles\node_modules 下。 |
| 选择器打开了，但工作区被拒绝 | 工作区服务会在服务端验证路径；请选择一个你有读写权限的目录。 |
| 选择意外回退到宿主接缝 | GUI 是在没有桌面桥接的情况下打开的（例如手动输入的 URL）。请通过应用打开 GUI。 |

开发

加载器只需要 package.json（带有 dsh.client 和
dsh.bundle.patch 声明）以及 lib/。没有构建步骤：
lib/client.js 是一个 window.__ModuleLoader__.load 包，其结构镜像了
官方 @deepseek-ai/dsh-client-ui-directory-picker-native
插件的结构。

dsh-workspace-explorer-picker/
|-- lib/
|   |-- index.js        # 宿主部分（空操作；该插件仅客户端）
|   |-- client.js       # 浏览器部分：无渲染的目录流占用者
|   -- types/          # TypeScript 声明
|-- cordis.patch.yml    # 包补丁（dsh.bundle.patch）- 激活插件
|-- install.ps1         # 用于配置文件的幂等安装程序
|-- package.json        # dsh.client + dsh.bundle.patch 声明
|-- README.md
-- LICENSE

发布

npm

npm login
npm pack          # 生成 .tgz（验证内容）
npm publish
git tag v1.0.0

GitHub

git remote add origin https://github.com/liell/dsh-workspace-explorer-picker.git
git push -u origin main

许可证

MIT - 参见 LICENSE。