
Zalpha263/dsh-file-explorer
30最近提交 2026年8月15日
dsh-file-explorer DSH 插件
dsh-file-explorer 是 DeepSeek Harness(DSH)的插件,为 Web UI 添加文件浏览面板。提供懒加载目录树、文件预览与内联编辑、IDE 式右键菜单、拖放移动和实时刷新。面板支持三种停靠模式并记忆用户偏好。
如何安装 dsh-file-explorer DSH 插件
dsh plugin --profile web add github:Zalpha263/dsh-file-explorer复制不会执行命令。安装 dsh-file-explorer DSH 插件前请核对仓库和版本。
dsh-file-explorer DSH 插件数据来源
dsh-file-explorer DSH 插件快照日期:2026年8月16日
discovered
dsh-file-explorer DSH 插件能做什么
- 懒加载目录树,显示文件大小,默认隐藏 node_modules 和 .git
- 文件预览与内联编辑,支持 Ctrl+S 保存、磁盘冲突检测、大文件自动截断
- IDE 式右键菜单:新建文件/文件夹、重命名、复制、粘贴、复制绝对/相对路径、删除到回收站
- 拖放移动文件/文件夹到其他目录,跨设备自动复制+删除回退
- 新建、重命名、粘贴、保存、删除、移动后实时刷新目录树
- 跨平台回收站:Windows 回收站、macOS 废纸篓、Linux XDG 回收站,内置回收站兜底
dsh-file-explorer DSH 插件适合哪些场景
- 不离开聊天界面浏览和预览工作区文件
- 快速编辑文本文件并保存,带版本冲突检测
- 管理文件:新建、重命名、复制、粘贴、删除到回收站
- 通过拖放移动文件/文件夹,甚至跨不同驱动器
- 切换会话时自动跟随工作区目录变化
dsh-file-explorer DSH 插件适合谁
- 需要直接在聊天界面管理工作区文件的 DSH 用户
- 希望在 DSH Web UI 中拥有 IDE 式文件管理体验的开发者
dsh-file-explorer DSH 插件的限制
- 需要 DSH 0.1.0-rc.6,虽然支持跨平台,但路径处理以 Windows 为习惯
- 写操作(编辑、新建、重命名、复制、移动、删除)绕过 DSH 的只读和工作区写入策略,不建议在不可信环境下使用
- 大目录(如 node_modules)复制或跨设备移动可能较慢
- 部分 CSS 选择器针对 DSH 0.1.0-rc.6 的特定客户端产物编写,DSH 大版本升级后可能需要复核
dsh-file-explorer DSH 插件的仓库 README 摘录
以下文字摘自 dsh-file-explorer DSH 插件的上游仓库 Zalpha263/dsh-file-explorer 的 README,版权归原作者,仅作引用。
> 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
阅读完整 README仓库许可: MIT
dsh-file-explorer DSH 插件常见问题
点击 📁 文件按钮后没有出现面板怎么办?
这通常是页面缓存或渲染问题。先尝试硬刷新(Ctrl+F5)。如果问题依旧,请重启 DSH。插件会在全新启动后正确加载。
如何保存编辑后的文件?
编辑文本文件时,按 Ctrl+S(或点击 💾 保存按钮)即可保存。如果文件在编辑期间被其他程序修改,你会看到“文件已改变”的提示,需要重新加载文件后再保存。
删除的文件去了哪里?
文件会被移到系统回收站(Windows 回收站、macOS 废纸篓或 Linux XDG 回收站)。如果系统回收站不可用,则移到插件内置回收站 ~/.dsh-file-explorer-trash/。内置回收站会自动清理超过 30 天或超过 200 条的项目。
可以跨不同驱动器移动文件吗?
可以。你可以将文件拖放到不同盘符或挂载点的目录,插件会自动执行“复制+删除”操作来模拟移动。大文件时可能会较慢。
树里显示红色错误行是什么原因?
红色错误行表示该路径当前不可读(例如权限问题或文件已被删除)。点击 ↻ 刷新按钮重新加载目录。如果问题依旧,请检查文件权限。