前言¶
DeepSeek Harness（DSH）的理念是「一切皆插件」。对以纯文本为主交互的 Agent 来说，如果界面只有对话区，查看工作区文件、编辑文本、把文件路径带入消息会需要额外操作。
dsh-file-explorer 是 cxzrdxy 维护的一个 MIT 许可插件，给 DSH 的纯文本 Agent 装上一个「文件浏览器」：在右下角打开当前工作区目录树，并提供与「对话」「轨迹」平级的「预览/编辑」页签，让文件查看、文本编辑和路径引用留在对话界面内完成。
这是什么¶
一句话定位：给 DeepSeek Harness 的纯文本 Agent 提供一个文件浏览器。
它面向使用 DSH Web profile 的开发者，解决的是在对话过程中快速查看工作区文件、预览文本和图片、编辑文本、新建或删除文件，以及把文件路径插入消息的问题。
核心功能¶
文件树¶
- 通过右下角按钮打开当前工作区目录树，可逐层展开。
- 文件树根路径跟随当前会话 cwd，切换工作区后刷新。
- 当前工作区本身，也就是树根目录，不可删除。
预览与编辑¶
- 「预览/编辑」页签与「对话」「轨迹」平级。
- 点击文件后自动切到「预览/编辑」页签。
- 文本文件可在预览页签中编辑，支持保存 Ctrl+S、撤销 Ctrl+Z、重做 Ctrl+Y。
- 在文件树中双击文件可直接进入编辑模式。
- 可预览文本文件和图片；文本文件上限为 512 KB，图片上限为 8 MB。
- 其他二进制文件只显示大小提示，不预览内容。
拖拽插入消息¶
- 支持把文件树中的文件或目录拖到消息输入框，并自动插入文件路径。
- 拖拽进消息框仅支持从文件树节点拖出；浏览器无法获取操作系统文件管理器中文件的绝对路径。
新建与删除¶
- 支持在工作区根目录新建文件。
- 支持悬停目录行后在该目录内新建文件。
- 支持删除文件或文件夹；文件夹删除使用 DSH 原生风格确认弹窗并递归删除。
- 服务端始终拒绝删除文件系统根路径。
- 未带递归标志时拒绝非空目录。
- 新建文件拒绝重名覆盖，并返回 409。
安全限制¶
插件提供同源校验、路径规范化、条目/字节上限等安全限制。删除和新建操作也遵循上述限制，避免误删、误覆盖和越权访问。
安装与启用¶
需要 DeepSeek Harness 的 Web profile 和 pnpm。下面列出的是资料中给出的本地路径安装方式：
git clone https://github.com/cxzrdxy/dsh-file-explorer.git
cd dsh-file-explorer
dsh plugin --profile web add file:.
安装完成后，重启 Web profile。包内已提交编译好的 lib/，从 checkout 安装不需要消费端构建。
典型用法¶
- 打开文件树：点击右下角按钮。
- 查看文件：点击某个文件后，自动切到「预览/编辑」页签查看内容。
- 编辑文本：点击「编辑」按钮，或在文件树里双击该文件直接进入编辑模式。
- 保存文件：编辑完成后点击「保存」或按 Ctrl+S。
- 引用文件路径：把文件树里的文件拖到消息输入框，松开后文件路径自动插入消息文本。
- 在工作区根目录新建文件：点击面板头部加号，输入文件名后回车。
- 在指定目录新建文件：悬停某个目录行后，点击该行右侧加号，在该目录内新建文件。
- 删除文件：悬停文件行后点击删除按钮，确认后删除该文件。
- 删除文件夹：悬停目录行，树根除外，点击删除按钮，勾选确认后递归删除该文件夹。
适用场景与注意¶
适合以下情况：
- 使用 DSH Web profile，希望在对话界面内直接查看工作区文件。
- 需要快速预览文本、图片，并编辑文本文件。
- 需要把文件路径快速插入消息，减少手动输入路径。
- 需要在当前工作区内做轻量的新建、删除操作。
需要注意：
- 插件以当前 dsh 进程权限运行，能够访问工作区文件并执行新建、删除等操作。安装前建议检查源码与许可证。
- 拖拽插入消息仅支持从文件树节点拖出，不能从操作系统文件管理器拖入文件。
- 当前工作区本身不可删除；服务端始终拒绝删除文件系统根路径。
- 未带递归标志时，删除操作会拒绝非空目录。
- 新建文件会拒绝重名覆盖，并返回 409。
- 文本预览上限为 512 KB，图片预览上限为 8 MB；其他二进制文件只显示大小提示。
相关链接¶
- GitHub：https://github.com/cxzrdxy/dsh-file-explorer
- 目录页（插件线索地址）：https://www.skillhub.cn/plugins/cxzrdxy/dsh-file-explorer
