dsh-file-explorer DSH plugin

dsh-file-explorer is a plugin for DeepSeek Harness (DSH) that adds a file browser panel to the web UI. It provides a lazy-loaded directory tree, file preview with inline editing, IDE-style context menu, drag-and-drop move, and real-time refresh. The panel supports three docking modes and remembers user preferences.

developer-tools ui-productivity

How to install the dsh-file-explorer DSH plugin

dsh plugin --profile web add github:Zalpha263/dsh-file-explorer

Copying does not run this command. Review the repository and version before installing the dsh-file-explorer DSH plugin.

dsh-file-explorer DSH plugin data source

dsh-file-explorer DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-file-explorer DSH plugin can do

Lazy-loaded directory tree with file sizes, hidden by default for node_modules and .git
File preview with inline editing, Ctrl+S save, disk conflict detection, and auto-truncation for large files
IDE-style right-click menu: new file/folder, rename, copy, paste, copy absolute/relative path, delete to recycle bin
Drag-and-drop move files/folders between directories, with cross-device copy+delete fallback
Real-time tree refresh after create, rename, paste, save, delete, or move operations
Cross-platform recycle bin: Windows Recycle Bin, macOS Trash, Linux XDG trash, with built-in fallback trash

Where the dsh-file-explorer DSH plugin fits

Browse and preview workspace files without leaving the DSH chat interface
Quickly edit text files and save with version conflict detection
Manage files: create new files/folders, rename, copy, paste, delete with recycle bin support
Move files between directories via drag-and-drop, even across different drives
Automatically follow workspace changes when switching sessions

Who the dsh-file-explorer DSH plugin is for

DSH users who need to manage workspace files directly from the chat interface
Developers who prefer an IDE-like file management experience within the DSH web UI

dsh-file-explorer DSH plugin limitations

Requires DSH 0.1.0-rc.6 and is designed for Windows path handling, though cross-platform support is present
Write operations (edit, create, rename, copy, move, delete) bypass DSH's read-only and workspace-write policy; not recommended for untrusted environments
Large directory copies (e.g., node_modules) or cross-device moves can be slow
Some CSS selectors target the specific client build of DSH 0.1.0-rc.6 and may need review after major DSH upgrades

dsh-file-explorer DSH plugin: from the repository README

Quoted from the Zalpha263/dsh-file-explorer README, the upstream source of the dsh-file-explorer DSH plugin. Copyright remains with the original authors.

> DeepSeek Harness（DSH）Web UI 的侧边文件浏览器：不离开聊天界面就能浏览工作区文件、预览内容，面板可停靠、可浮动。 ## ✨ 功能特性 - **懒加载目录树**：按需展开工作区目录，目录在前、文件带大小；默认隐藏 `node_modules`、`.git` 等（可切换显示） - **文件预览 + 内联编辑**：点击文件在面板内预览；文本文件可进入编辑模式（Ctrl+S 保存，带磁盘冲突检测）；超大文件自动截断、二进制文件自动识别；预览区高度可拖动 - **IDE 式右键菜单**：树中右键即可——新建文件（txt / py / md / json / js / ts / html / css 等模板）、新建文件夹、重命名、复制、粘贴（同名自动加 ` (1)` 后缀）、复制绝对路径 / 相对路径、删除（移入系统回收站） - **拖放移动**：直接把文件 / 文件夹拖到其它目录行（或树空白区）即可移动，跨设备自动复制+删除回退；目标行高亮提示 - **实时刷新**：新建 / 重命名 / 粘贴 / 保存 / 删除 / 移动后树即时更新，无需手动刷新 - **跨平台回收站**：Windows 系统回收站 / macOS 废纸篓 / Linux XDG 回收站，均带内置回收站兜底（`~/.dsh-file-explorer-trash/`） - **工作区自动跟随**：切换会话/工作区后约 1 秒内自动切换到对应目录 - **三种停靠模式**：右侧（挤压对话栏，不遮挡）/ 中间 / 浮动（自由拖动 + 四边四角缩放） - **悬浮球**：侧边可拖动入口，可随时开关 - **偏好记忆**：面板位置/尺寸/停靠模式/预览高度/悬浮球开关全部本地记忆 ## 安装 ### 前置要求 - DSH `0.1.0-rc.6`，Windows（路径处理按 Windows 习惯） - 官方安装方式需要 [pnpm](https://pnpm.io/zh/)（`npm install -g pnpm`） ### 官方方式（推荐） ```bash dsh plugin --profile web add github:Zalpha263/dsh-file-explorer ``` - 发布到 npm 后可直接：`dsh plugin --profile web add dsh-file-explorer` - 装完**重启 DSH**，会话标题栏右侧会出现「📁 文件」按钮 - 升级 / 卸载：`dsh plugin --profile web update/remove dsh-file-explorer` <details> <summary>旧版手动安装（仅 v1.2 之前使用，已不推荐）</summary> DSH 旧版本没有 `dsh

Read the full READMERepository license: MIT

dsh-file-explorer DSH plugin questions

Why can't I see the file explorer panel when I click the 📁 button?

This is often due to page cache or rendering issues. Try a hard refresh (Ctrl+F5). If that doesn't work, restart DSH completely. The plugin should load correctly after a fresh start.

How do I save an edited file?

While editing a text file, press Ctrl+S (or click the 💾 Save button) to save changes. If the file was modified externally during editing, you'll see a 'file changed' warning and need to reload the file before saving again.

What happens when I delete a file?

Files are moved to the system recycle bin (Windows Recycle Bin, macOS Trash, or Linux XDG trash). If the system recycle bin is unavailable, the file is moved to the plugin's built-in trash at ~/.dsh-file-explorer-trash/. The built-in trash automatically cleans items older than 30 days or when the count exceeds 200.

Can I move files across different drives?

Yes, you can drag and drop files to a directory on a different drive or mount point. The plugin will automatically perform a copy+delete operation to simulate the move. This may take longer for large files.

Why does the tree show a red error line?

A red error line indicates that the path is currently inaccessible (e.g., permission issue or the file was deleted). Click the ↻ refresh button to reload the directory. If the issue persists, check the file permissions.