前言¶
在 DeepSeek Harness（DSH）里调试代理任务时，常见需求是查看当前会话 workspace 里的文件，确认代理创建或修改了哪些内容，并对文本文件做少量编辑。已有做法通常是切到终端、文本编辑器或外部 IDE。dsh-explorer-plugin 把这个能力放进 DSH Web GUI：侧边栏出现文件树，点开文件后用 Monaco 编辑器查看和修改，语法高亮使用 VS Code TextMate 语法。
下面介绍它的功能、安装方式和需要注意的限制。
这是什么¶
dsh-explorer-plugin 由 dgadelha1 维护，许可证为 MIT。它给 DSH Web GUI 增加一个 File Explorer 面板，提供 workspace 文件树和 Monaco 编辑器。
已核实的运行环境信息来自 README 测试环境：DeepSeek Harness 0.1.0-rc.7、pnpm 9.15.9、Node.js ≥ 20。资料要求 CLI dsh 与 pnpm 在 PATH 中；如果 pnpm 不在 PATH，资料提到可使用本地 shim 并前缀 PATH。
核心功能¶
文件浏览¶
- 打开、创建、重命名、复制、移动、删除文件和文件夹。
- 文件树支持按需加载。
- 可选显示隐藏文件。
- 面板作为应用网格中的真实列嵌入，可折叠、可调整大小，并可移动到左侧或右侧。
Monaco 编辑器¶
- 提供行号、多标签、撤销 / 重做。
- 支持
Ctrl+S保存，并检测外部冲突。 - 可选换行。
- 支持大文件与二进制文件处理。
- 使用 VS Code TextMate 语法为 28 种语言提供代码高亮。
代理联动¶
- 通过 SSE 实时监听文件变化；当代理创建或编辑文件时，文件树会更新。
- 提供
Analisar和Corrigir快速操作，用于发送代理指令，并在修改前请求确认，不会未经批准修改文件。
多语言与安全¶
- 支持
pt/en/zh，并跟随 GUI locale。 - 所有文件操作限制在会话 workspace。
- 具备 path traversal 与 symlink escape 防护。
- 路径根由服务端验证。
安装与启用¶
先确认 dsh 和 pnpm 可用。如果当前 workspace 使用本地 pnpm shim，可参考资料示例，把本地 shim 目录加入 PATH 后再执行安装命令：
PATH="$PWD/.bin:$PATH" dsh plugin --profile web add -w .
插件仓库中的 vendor assets 已提交。只有在需要更新或重新 vendor 时，再执行：
node scripts/vendor.mjs
这一步需要网络。
在插件 checkout 目录中，使用 README 中的安装命令：
dsh plugin --profile web add -w .
也可以使用绝对路径执行：
dsh plugin --profile web add -w /caminho/absoluto/para/dsh-explorer-plugin
这里的 -w 是必要参数。资料说明安装 pnpm 依赖时必须使用 -w 或 --workspace-root，否则可能触发 ERR_PNPM_ADDING_TO_ROOT。
安装或变更服务端 bundle 后，需要重启 dsh web。例如使用仓库脚本：
scripts/restart-web.sh
如果只有客户端修改，例如 lib/client.js 或 vendor/，资料说明可刷新浏览器页面。
平台脚本可用于安装、校验和移除：
scripts\install.bat
scripts/install.sh
scripts/install-macos.sh
经过上面的步骤后，打开 DSH GUI，例如：
http://127.0.0.1:3080
在侧边栏查看 File Explorer 面板。
典型用法¶
1、打开 DSH Web GUI，在侧边栏找到 File Explorer 面板。
2、查看当前会话 workspace 的文件树，点开文本文件后用 Monaco 编辑器查看或修改。
3、保存文件时可按 Ctrl+S；编辑器会检测外部冲突。
4、对某个文件使用 Analisar 或 Corrigir，发送代理指令；资料说明这类操作在修改前需要确认。
适用场景与注意¶
适合需要在 DSH Web GUI 内查看、管理当前会话 workspace，并对代理生成或修改的文件做快速编辑的开发者。它更适合放在日常 DSH 调试流程里，而不是替代完整的本地 IDE。
安装前需要注意：插件以当前 dsh 进程权限运行，安装前应检查源码和许可证。该项目许可证为 MIT。社区目录只是插件发现站点，不是官方应用商店，也不代表与 DeepSeek / 幻方存在官方从属关系。
链接¶
- GitHub：https://github.com/dgadelha1/dsh-explorer-plugin
- 插件目录页线索：https://www.skillhub.cn/plugins/dgadelha1/dsh-explorer-plugin（该 URL 来自插件线索，未在所抓资料中直接出现）
