dsh-solution-explorer

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.

Configuration

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

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