xiaoksio/dsh-solution-explorer

🗂️ Solution Explorer for DSH

A drop-in replacement for the DSH Web GUI's right sidebar — VS Code-style file explorer, a multi-tab editor with in-place previews, and full source control.

English · 简体中文

Features

• Takes over the sidebar — every file opened from the conversation, the

sidebar's own file list or source control lands in this plugin's editor view: as long as this plugin can read a file, the shipped preview panel never takes it over.

• File Explorer — browse the current session workspace as a directory tree

with expand/collapse, VS Code-style file-type icons (TS/JS/Vue/JSON/image/ archive/script and 30+ more extensions), git status markers (M/A/D/R/?), names color-coded by status (green untracked / yellow modified / grey ignored), .gitignore-excluded files and folders shown grey, and directory "modified" indicators.

• Source Control — staged / unstaged / untracked change lists with

stage / unstage / discard (per-file or all), commit with a message, and a branch info bar. AI commit message: pick a host-configured model in Settings and tap the ✨-icon beside the commit box to generate a Conventional Commits draft from the staged diff (optionally guided by the repo's AGENTS.md). Diff view: full-file side-by-side compare with an editable right column (Enter splits lines, backspace/delete merges, NBSP placeholders), a middle gutter to stage (⤒) or revert (↩) individual hunks, Ctrl+S to save. Commit Graph: an SVG history view with branch lanes and merge lines; click a commit to expand its changed files (with file-type icons and status letters M/A/D/R) below the row, hover for a tooltip with the full message, stats, and a GitHub link; plus checkout. Sync: fetch / pull / push / sync (pull + push) with ahead/behind counts, each remote-write confirmed. Branches: switch / create / rename / delete / merge / publish. Remotes: add / remove / set URL. Git Init: initialize a repository from a plain directory. Merge changes: pull/merge conflicts (UU/AA/DD/…) are detected and listed for manual resolution. Multi-repo support: auto-discovers git repositories under the workspace and lets you switch between them; the SCM panel follows the selected repo. Split panes: drag the divider between changes and repository to resize, history fills the bottom. Bulk actions live in the section headers; discard all asks for confirmation.

• Syntax highlighting — editor and diff views colorize 15 languages

(TS/JS/Python/JSON/Markdown/...) with a GitHub Dark theme; the editor re-highlights live while typing, lightweight.

• File Search — live name search across the workspace.
• File Editor — a multi-tab editor in the conversation view's "Editor" tab:

open any text file, edit, and save (button or Ctrl+S). Images open in an in-editor preview with zoom/pan; .md/.markdown and .html open in rendered previews with a preview/source toggle; .pdf renders in place. Other binary files are detected and refused instead of corrupted.

• Collapsible rail — collapse the whole panel into a narrow icon rail

(expand panel, explorer, search, source control, terminal). The source-control icon shows a live change-count badge; clicking an icon reopens the panel on that tab, matching the native sidebar's look.

• Multi-tab terminal — a bottom terminal panel opened from the rail

(native ConPTY, PowerShell/cmd by default); multiple tabs, drag to resize, and auto cleanup of processes when a tab closes or the connection drops.

• File operations — context menu with new file/folder, delete (confirm

dialog), copy / cut / paste, copy relative / absolute path; drag files within the tree, drag files in from the OS, multi-select bulk actions.

• i18n — English and Chinese, follows the browser language.
• Dark theme — matches the DSH Web UI tokens.

Screenshots

File Explorer · Source Control · Diff · ·

Installation

[!WARNING]

This is a third-party community plugin. Installing it runs its code on your

machine with your own permissions. It can read, modify, and delete files and

run git operations (including destructive ones such as discard and delete)

inside your session workspace. Review the source before use and back up

important work first. You are responsible for what this plugin does with your

repositories.

From dsh-market (GUI)

Open the marketplace in the DSH Web UI, search for "solution-explorer", and click install.

From npm

dsh plugin --profile web add dsh-solution-explorer

From a local checkout

dsh plugin --profile web add /path/to/dsh-solution-explorer

After installing, reload the Web UI. The explorer panel appears as its own right column once a session with a workspace is active.

Compatibility

• DSH 0.1.x / 0.2.x — the declared peer range is

>=0.1.0-rc.1 <0.3.0-0 (tested from 0.1.5-rc.1, including 0.2.0-rc.2).

• Minimum plugin version per DSH release:
• DSH ≥ 0.1.7: 1.0.1 — from 0.1.7 the Session-list snapshot no longer carries

current (the main-view Session is the one retained by mainView), and an older plugin hides the whole right column because of it (#2).

• DSH ≥ 0.2.0: 1.0.2 — 0.2 renamed the official icon exports from

IconXxx16/IconXxx14 to IconXxxRegular/IconXxxMedium; the old names resolve to undefined, React throws #130, and the panel renders as an empty column (#3).

• DSH validates these peer ranges before installing or activating a plugin, so a

plugin older than the installed DSH is refused at install time rather than failing at runtime. After upgrading DSH, check this plugin's version in the settings page before assuming the panel broke.

Configuration

The plugin accepts an optional config in the bundle row (cordis.patch.yml):

Field · Type · Default · Description defaultWidth · number · 280 · Panel width in px, clamped to 264–560. autoOpen · boolean · true · Auto-open the panel when a session activates. filterPatterns · string[] · [] · Name patterns to hide from the file tree. showHidden · boolean · false · Show dot-prefixed (hidden) files in the tree.

Development

pnpm install
pnpm build    # tsc declarations + tsdown bundles (lib/index.js, lib/client.js)
pnpm watch    # rebuild on change

See CONTRIBUTING.md for development conventions.

pnpm install also runs the prepare script, so a git-based install (dsh plugin add github:xiaoksio/dsh-solution-explorer) builds lib/ on the target machine without manual steps.

How it works

The plugin is a single npm package with two halves, both declared in package.json under the dsh key:

• Host half (src/index.ts, exports . → lib/index.js): runs in the

dsh host process and serves the workspace-gated filesystem and git API over HTTP routes under /solution-explorer/* (tree, read, write, delete, search, git-repos, git-status, git-diff, git-log, git-stage, git-unstage, git-discard, git-commit, paste, move, upload, create). All routes resolve paths strictly inside the session workspace root. It also announces itself in the system prompt so the agent knows what the panel can do.

• Browser half (src/client/index.ts, exports ./client →

lib/client.js): loaded by the Web GUI's __ModuleLoader__ as a closure-factory bundle. It appends the explorer column to the frame grid ([data-dsh-frame]), follows the active session's cwd, and mounts the file editor into the conversation.view slot. A sidebarRightTabs registration claims every dsh-resource://file/** address, so a file opened anywhere in the GUI is handed to that editor view instead of the shipped preview panel.

License

MIT