dsh-explorer: A Native Workspace File Explorer for DeepSeek Harness

What Does It Do?

wwwroot/dsh-explorer is a DSH plugin for DeepSeek Harness that brings a native workspace file explorer into the harness interface. It solves the friction of switching windows and copying paths by hand when referencing files in an AI conversation, letting you browse, search, open, and cite files in one place. The plugin adds precision drag-and-drop chat insertion, editor tab opening, Git status badges, compact folder chaining, motion collapse, and density scaling, and is maintained by author wwwroot in JavaScript.

Core Features

• Precision drag-and-drop referencing: dropping a file or folder into the DSH chat composer inserts an /file` chip at the exact cursor position without clobbering existing text; holding Alt or Shift embeds the file's full source as a syntax-highlighted code block.
• Tab opening and instant search: double-click any file to open it in a new DSH editor tab, or use the context menu; the top search bar filters files and folders by path in real time.
• Git status badges: automatically detects repositories at the workspace root and in nested sub-repositories, marking modified, untracked, and deleted states with M/U/D pills that bubble up to parent folders so changes are visible without expanding every level.
• Compact folders and motion collapse: single-child directory chains such as src/client/ui collapse into one line, and folders expand and collapse with smooth CSS grid animations, both toggleable in the options modal.
• Density and zoom controls: choose Compact, Normal, or Relaxed row heights and zoom the whole tree from 75% to 135%, adjusting row heights, font sizes, icons, and indent guides, with preferences saved locally.
• Full file management and keyboard navigation: hover actions for copying relative paths, renaming (F2), and deleting, plus arrow-key navigation and Enter to mention, with a WebSocket file watcher keeping the tree live.

How to Use This Plugin?

After enabling it in DSH, the workspace tree appears with the full directory structure; type a path fragment into the top search bar to locate files quickly. To reference a file, drag it to the cursor position in the chat composer, click the @ icon on a row, or choose insert mention from the context menu; to embed source code instead, hold Alt or Shift while dropping. Double-clicking a file opens it in an editor tab, and the context menu offers the same action. Expand folders to inspect Git badges, or open the options modal to adjust density, zoom, animations, and Git visibility; these settings persist and are restored automatically.

How to Troubleshoot This Plugin?

If the tree does not refresh when files change externally, verify that the DSH WebSocket service is running and that the workspace path points to the correct directory. If Git badges do not appear, confirm the workspace or its subdirectories are actually Git repositories and check that the Git status switch in the options modal is enabled. If drag-and-drop inserts at the wrong spot or source embedding fails, make sure the pointer is inside the composer and the modifier key is held, and re-enable the plugin per the official instructions if needed.