前言¶
DeepSeek Harness 的设计理念是“一切皆插件”。在开发智能体或调试代码时，仅依赖对话窗口往往不够，需要直接对工作区文件进行浏览和编辑。现有的操作流程可能较为繁琐，缺乏统一的文件管理入口。
这是什么¶
@supanexus/dsh-plugin-file-explorer 是一个由 SupaNexus 维护的客户端插件（MIT 许可）。它将文件浏览与编辑能力集成到 DeepSeek Harness 中。界面布局保持左侧为官方对话列表，中间区域新增目录树与多标签编辑器，用于固定当前会话的工作目录。
核心功能¶
- 文件 Tab 与布局：在会话顶部增加“文件”标签页，显示目录树与编辑器分栏，当前会话工作目录固定。
- 多标签编辑：支持多标签打开文件，未保存的文件会标记为 dirty，使用
Ctrl/Cmd+S保存。 - Markdown 支持：支持在源码模式与预览模式间切换。
- 文件操作：支持新建、重命名、删除文件（非空目录无法删除）。
- 链接集成：对话中的文件路径链接可直接在编辑器中打开。
- 代码编辑：优先使用 Monaco 编辑器（通过 jsDelivr CDN 加载），若加载失败或超时，会自动降级为纯文本框。
安装与启用¶
- 执行安装命令：
dsh plugin --profile web add github:supanexus/dsh-plugin-file-explorer#v0.1.0
- 安装后必须完全重启
dsh web（或 Desktop Host），然后使用打印的?token=地址打开。
典型用法¶
- 打开或新建一个会话。
- 点击顶部“文件”标签页。
- 在左侧目录树中浏览文件，双击文件即可在右侧编辑器打开。
- 修改内容后，按
Ctrl/Cmd+S保存。 - 右键点击树节点，可进行新建、重命名或删除操作。
注意事项与适用场景¶
- 外观调整：编辑器工具栏中支持调整背景色、字号和方案。
- 配置项：可在设置 → 插件 → SupaNexus 文件浏览 中进行配置。例如设置浏览根目录（默认为当前进程工作目录）或控制对话内文件链接是否在编辑器打开。
- 权限与安全：插件以当前 dsh 进程的权限运行，请确保在安装前检查源码与许可证（MIT）。
- 适用场景：适合需要在对话中直接管理项目文件、调试代码或维护多文件智能体的开发者。
该插件通过集成目录树与多标签编辑器，简化了 DeepSeek Harness 中的文件操作流程。更多细节请参考目录页或GitHub 仓库。
