前言¶
在 DSH Web UI 中使用智能体时，经常需要查看工作区里的源码、配置或生成物。如果必须切换到终端、文件管理器或编辑器，就会离开当前会话上下文。dsh-file-explorer 是面向 DSH Web UI 的文件浏览器插件，可以在聊天界面旁浏览工作区文件、预览内容，并对文本文件做内联编辑。下面介绍它的定位、功能、安装方式和注意事项。
这是什么¶
dsh-file-explorer 是一个 DSH Web UI 插件，采用 MIT 许可证。仓库地址为：
https://github.com/Zalpha263/dsh-file-explorer
插件目录页为：
https://www.skillhub.cn/plugins/Zalpha263/dsh-file-explorer
它主要解决 DSH Web UI 中的轻量文件操作需求：查看当前工作区文件结构、打开文本文件、预览内容、保存修改，并进行新建、重命名、复制、粘贴、移动、删除等基础文件管理。
核心功能¶
- 懒加载目录树：按需展开工作区目录。
- 预览与内联编辑：点击文件可预览；文本文件可编辑，
Ctrl+S保存，Esc退出；保存带版本检测。 - IDE 式右键菜单：支持新建文件、新建文件夹、重命名、复制、粘贴、复制绝对路径或相对路径、删除到回收站。
- 拖放移动：将文件或文件夹拖到目标目录行或目录树空白区域后松开即可移动；拖到自身或子目录会被拒绝。
- 实时刷新：新建、重命名、粘贴、保存、删除、移动后目录树更新。
- 跨平台回收站：删除时优先使用系统回收站；不可用时写入内置回收站
~/.dsh-file-explorer-trash/，保留 30 天、最多 200 条。 - 工作区自动跟随：切换会话或工作区后，文件浏览目标跟随当前工作区。
- 停靠与浮动：面板可停靠或浮动；安装 ui-beautify 后，由插件面板统一管理。
- 偏好记忆：面板位置、尺寸、停靠模式和预览高度可本地记忆。
安装与启用¶
先确认 DSH 版本。已核实资料中同时出现两种版本表述：前置要求为 DSH 0.1.1-rc.2（或兼容的 0.1.x 系列），兼容性目标版本为 DSH 0.1.0-rc.7。由于资料中的最低兼容版本表述不完全一致，安装前建议核对当前 DSH 版本与官方说明。
官方安装方式需要 pnpm。执行下面的命令安装插件：
dsh plugin --profile web add github:Zalpha263/dsh-file-explorer
安装完成后重启 DSH。重启后，会话标题栏右侧会出现文件入口；如果已安装 ui-beautify，入口会归入插件面板统一管理。
升级插件时执行：
dsh plugin --profile web update dsh-file-explorer
卸载插件时执行：
dsh plugin --profile web remove dsh-file-explorer
典型用法¶
预览和编辑¶
打开文件入口后，点击目录展开，点击文件进入预览。文本文件可进入编辑模式；输入改动后使用 Ctrl+S 保存，按 Esc 退出编辑。保存操作带版本检测。
文件管理¶
右键文件行或文件夹行，可使用以下能力：
- 新建文件
- 新建文件夹
- 重命名
- 复制
- 粘贴
- 复制绝对路径
- 复制相对路径
- 删除到回收站
拖放移动时，按住文件或文件夹行，拖到目标目录行或目录树空白区域后松开即可移动。拖到自身或子目录会被拒绝。
面板形态¶
未安装 ui-beautify 时，可通过自带入口打开文件面板，并使用停靠或浮动形态。安装 ui-beautify 后，由插件面板统一管理。
安全与限制¶
- 写操作限制在当前工作区根目录内；工作区外的写、删、改名、移动会被拒绝。只读浏览和预览不受限。
- 该限制是插件自身的操作边界，不等同于 DSH 的
read-only/workspace-write策略。插件的 Host 半区会在当前 DSH 进程内执行文件操作，因此它使用当前 DSH 进程可获得的文件系统权限。请勿在不可信环境中安装或启用。 - 预览有 512KB 截断限制；二进制文件会自动识别；二进制文件和已截断文件不可编辑。
- 删除优先使用系统回收站；系统回收站不可用时，会落入内置回收站
~/.dsh-file-explorer-trash/。 - 插件依赖 dsh 自带的
@deepseek-ai/dsh-typert-protocolpeer 依赖，不要单独安装该包的独立副本。 - 部分 CSS 选择器针对指定 DSH 客户端产物编写；DSH 大版本升级后可能需要复核。
适用场景¶
dsh-file-explorer 适合在 DSH Web UI 中处理轻量文件任务，例如查看智能体生成的文件、检查配置、修改短文本、整理工作区目录。如果需要完整 IDE 能力、复杂代码导航、批量处理或严格权限隔离，仍应使用专用编辑器或文件管理工具。
安装前建议检查源码、许可证和 DSH 版本兼容说明。
参考¶
- 插件目录页：
https://www.skillhub.cn/plugins/Zalpha263/dsh-file-explorer - GitHub 仓库：
https://github.com/Zalpha263/dsh-file-explorer
