dsh-workspace-explorer-picker
DeepSeek Harness Desktop 插件：添加工作区时直接打开原生 Windows Explorer 文件夹选择器，替代应用内目录浏览器。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:liell/dsh-workspace-explorer-picker#31b506be2bff1e181e72ad435023ec6c7716f5aeWorkspace Explorer Picker 以 dsh-workspace-explorer-picker 发布，当前版本为 1.0.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A DeepSeek Harness Desktop plugin that opens the native Windows Explorer folder picker directly when you add a workspace - no more in-app directory browser.
Clicking Add workspace in DeepSeek Harness Desktop normally opens a directory browser rendered inside the web GUI. This plugin skips that dialog entirely and opens the real Windows Explorer folder chooser immediately - the same native dialog the shell already uses for its "Choose with Windows" action.
dialog.showOpenDialog) - full
Explorer experience (Quick Access, breadcrumbs, search, New folder).$DSH_HOME (user profile),
never inside Program Files.install.ps1) for quick setup on any machine.dsh.bundle.patch, so it can be installed from the
DSH Community Market / npm.| Requirement | Detail |
|---|---|
| OS | Windows (the Explorer chooser is a Windows-only shell feature) |
| App | DeepSeek Harness Desktop (the Electron desktop app) |
| GUI entry | The app window, or the browser tab the app opens (the desktop picker bridge must be present) |
Outside the desktop shell, the plugin falls back to the host directory-picker seam.
Requires PowerShell. From the repository root:
powershell -ExecutionPolicy Bypass -File .\install.ps1
What it does:
$DSH_HOME\profiles\node_modules\dsh-workspace-explorer-picker\
($DSH_HOME defaults to ~/.dsh).$DSH_HOME\profiles\desktop\cordis.patch.yml.The script is idempotent: re-running it is safe.
lib folder, cordis.patch.yml and package.json to
$DSH_HOME\profiles\node_modules\dsh-workspace-explorer-picker\.$DSH_HOME\profiles\desktop\cordis.patch.yml:- id: directory-picker
disabled: true
- insert:
- id: directory-picker-explorer
name: 'dsh-workspace-explorer-picker'
After restarting, click Add workspace - the Windows Explorer folder dialog
should open immediately. If nothing happens, check the logs under
%APPDATA%\DSH Desktop\logs\ (see Troubleshooting).
DeepSeek Harness Desktop's Community Market installs plugins from npm when the
package declares a dsh.bundle.patch (this plugin does - see
cordis.patch.yml). The bundle patch disables the stock adaptive picker and
inserts this plugin, so the manual profile patch above is not needed when the
plugin is installed as a bundle.
Publish to npm so the market can resolve an install target:
npm login
npm publish
Get listed in a catalog (e.g. dshfind): submit your package at
https://dshfind.com following their submission flow. The catalog verifies
the repository backlink (repository in package.json points to your
GitHub repo) before accepting structured install evidence.
Users install it from the market (Plugins / Market in DSH Desktop
settings): the Host runs pnpm add dsh-workspace-explorer-picker, applies
the bundle patch, and adds it to the profile bundles.
DeepSeek Harness Desktop composes its web GUI from Cordis bundles and applies a
user patch layer from $DSH_HOME/profiles/<profile>/cordis.patch.yml. The stock
"add workspace" flow fills a UI slot with the in-app directory browser.
This plugin is a renderless client plugin that occupies the same directory-flow
slots (conversation.hero.workspace.directoryFlow and
sidebar.workspaces.directoryFlow) and, on each open, picks a folder:
window.__DSH_DESKTOP_PICK_DIRECTORY__ - the DSH Desktop shell bridge
(Electron dialog.showOpenDialog with openDirectory) - the Windows Explorer
folder dialog.workspaces.pickDirectory() directory-picker seam.The patch row directory-picker (the stock adaptive picker) is disabled so the
in-app browser never appears.
Because everything lives under $DSH_HOME, updates to DSH Desktop (which replace
Program Files) never touch the plugin.
cordis.patch.yml (see Manual install).$DSH_HOME\profiles\node_modules\dsh-workspace-explorer-picker.| Symptom | Cause / Fix |
|---|---|
| "Add workspace" still opens the in-app browser | The app was not restarted, or the patch was not applied. Re-run install.ps1 and restart DSH Desktop. |
| Nothing happens when clicking "Add workspace" | The plugin failed to activate. Check %APPDATA%\DSH Desktop\logs\ and confirm the package folder exists under profiles\node_modules. |
| The picker opens but the workspace is rejected | The workspace service validates the path server-side; pick a directory you can read and write. |
| Pick falls back to the host seam unexpectedly | The GUI was opened without the desktop bridge (e.g. a manually typed URL). Open the GUI through the app instead. |
The loader only needs package.json (with the dsh.client and
dsh.bundle.patch declarations) and lib/. There is no build step:
lib/client.js is a window.__ModuleLoader__.load bundle mirroring the
structure of the official @deepseek-ai/dsh-client-ui-directory-picker-native
plugin.
dsh-workspace-explorer-picker/
|-- lib/
| |-- index.js # host half (no-op; the plugin is client-only)
| |-- client.js # browser half: renderless directory-flow occupant
| `-- types/ # TypeScript declarations
|-- cordis.patch.yml # bundle patch (dsh.bundle.patch) - activates the plugin
|-- install.ps1 # idempotent installer for the profile
|-- package.json # dsh.client + dsh.bundle.patch declarations
|-- README.md
`-- LICENSE
npm login
npm pack # produce the .tgz (verify the contents)
npm publish
git tag v1.0.0
git remote add origin https://github.com/liell/dsh-workspace-explorer-picker.git
git push -u origin main
MIT - see LICENSE.