No-PRM/dsh-explorer
DSH plugin: VS Code-style file-tree explorer (git decorations, preview, diff, drag-to-reference); install via dsh plugin --profile web add.
Listed
5
Git
Bundle verified
What it does
Git-first file-tree sidebar for the DSH web GUI: VS Code-style indent guides, M/A/U/D/R git decorations, HEAD-vs-worktree diff preview, media preview, and drag-to-reference (files/folders/selected code with line numbers) — pure plugin.
Best for
- Developers navigating Git-heavy workspaces from the DSH Web GUI
- Code-review workflows needing HEAD-versus-worktree diffs and Git status decorations
- Users who drag files, folders, or line-numbered code selections into chat as references
Not ideal for
- Workflows requiring file editing or mutation from the sidebar, because its host routes are read-only
- Non-Web DSH usage where a graphical file-tree drawer provides no benefit
- Deployments unwilling to install and maintain both the host and browser packages
README
dsh-explorer
A file-tree sidebar for the DeepSeek Harness web UI. A blue round button on the right edge opens a drawer with the current workspace’s files — lazy-loaded and virtualized, so even big directories stay responsive.
The plugins only add UI and a few read-only routes. Nothing in the shipped dsh packages is touched, so dsh updates shouldn’t break anything.
Install (two commands — monorepo)
dsh plugin --profile web add "github:No-PRM/dsh-explorer#main&path:/dsh-plugins/dsh-explorer"
dsh plugin --profile web add "github:No-PRM/dsh-explorer#main&path:/dsh-plugins/dsh-client-ui-explorer"
# restart dsh

What you get
- A right-side drawer (drag the edge to resize) with a floating blue toggle; open state and width are remembered
- VS Code-style indent guides, hover highlights the active line
- Git status at a glance: M/A/U/D/R letters in a right-aligned column, tinted filenames, dirty dots on folders, struck-through rows for deleted files, gitignored entries dimmed
- Modified files get a git diff view (HEAD vs working tree, side-by-side) right in the preview
- Click a file to preview it — text opens in CodeMirror (Ctrl+F gives a VS Code-like find bar), images/video/audio/PDF play inline
- Drag any file/folder (or selected code from the preview) into the chat input — inserts an XML-tagged reference (
<reference path="…" lines="…" />) and shows a removable chip above the composer - Search (skips .git and node_modules), expand/collapse-all, auto-refresh every 1.2 s
Two packages
| package | what it does |
|---|---|
dsh-explorer |
Host side (Node). Serves the read-only /filetree/* API: directory listing, file read, search, git status, raw media streaming. No dependencies. |
dsh-client-ui-explorer |
Browser side (TS/TSX). The toggle, the drawer, and everything you see. |
Both follow the official dsh plugin contract. Wiring and deployment details live in dsh-plugins/README.md.
Install
You need both halves. Bundle install (monorepo — one command per package):
dsh plugin --profile web add "github:No-PRM/dsh-explorer#main&path:/dsh-plugins/dsh-explorer"
dsh plugin --profile web add "github:No-PRM/dsh-explorer#main&path:/dsh-plugins/dsh-client-ui-explorer"
# restart dsh
(Dev machine: keep the junction + cordis.patch.yml insert-row setup — don’t run the bundle commands in the same profile.)
Manual (dev, no restart): copy the two packages into the profile’s node_modules and add them to its cordis.patch.yml:
- insert:
- id: filetree
name: dsh-explorer-v1
- id: ui-filetree
name: dsh-client-ui-explorer
Restart dsh — or bump the host package name (v8, v9…) to avoid the restart. The browser bundle is self-contained; no npm install needed to run it. Full steps: dsh-plugins/README.md.
Development
cd dsh-plugins/dsh-client-ui-explorer
npm run dev # watch + sync into the running profile
npm run bundle # one-shot minified build
npm run types # generate lib/types/*.d.ts
npm run typecheck
Host changes go into dsh-plugins/dsh-explorer/lib/index.js; copy it into the profile under a bumped package name to reload without restarting.
Docs
- dsh-plugins — architecture, install, deploy (中文: README.zh-CN.md)
- dsh-client-ui-explorer (中文: README.zh-CN.md)
- dsh-explorer (中文: README.zh-CN.md)
MIT
Frequently Asked QuestionsFAQ
Use the verified command dsh plugin --profile default add github:No-PRM/dsh-explorer in a DSH-enabled shell. The command resolves the public package metadata and keeps the plugin attached to the catalog identity shown on this page.
Compatibility follows the bundle and profile status shown above. If a profile is not detected, keep the plugin disabled there and check the repository documentation before enabling it in production.
The GitHub link and activity metadata are the source of truth for releases and maintenance. Revisit this page after a new release to confirm the catalog has observed the latest version.