DSH（DeepSeek Harness）的设计理念是“一切皆插件”，默认的 Web UI 右侧边栏功能较为基础，无法满足开发者对文件浏览、代码编辑和源代码控制的深度需求。dsh-solution-explorer 插件旨在通过 VS Code 风格的界面，接管 DSH Web GUI 的右侧边栏，为智能体开发者提供一个集成了文件资源管理、多标签编辑器和完整 Git 工作流的一站式解决方案。
插件定位¶
该插件由社区开发者 xiaoksio 维护，是一个全功能的右侧边栏替代方案。它将文件列表、源代码控制视图和编辑器集成在一起，通过一个多标签页的编辑器视图统一管理所有文件操作和 Git 状态。
核心功能¶
文件资源管理器¶
插件接管了默认的侧边栏，提供 VS Code 风格的文件树视图。支持展开/折叠目录，显示基于文件类型的图标，并利用 Git 状态标记文件（绿色未跟踪、黄色修改、灰色忽略）。此外，它支持基于 .gitignore 的过滤功能，并会通过颜色标记目录的修改状态。
源代码控制¶
这是该插件的核心功能之一，支持完整的 Git 操作流程：
- 变更管理：支持暂存、取消暂存和丢弃（Discard）文件或补丁。
- 提交与 AI 辅助：提交时支持生成符合 Conventional Commits 规范的 AI 草稿（点击 ✨ 图标）。
- 差异视图：提供并排的文件差异对比，支持在右侧列中直接编辑代码、合并行或暂存补丁。
- 提交图：可视化的 Git 历史视图，显示分支分叉线和合并线，支持点击查看具体提交的文件变更和详情。
- 同步与分支：支持 fetch、pull、push、sync（拉取并推送），以及分支切换、创建、重命名、删除和合并操作。支持多仓库切换。
- 冲突处理：自动检测并列出合并冲突状态。
编辑器与预览¶
- 多标签编辑器：在编辑器视图中支持打开多个文件，涵盖 15 种编程语言的语法高亮，且支持输入时的实时重新高亮。
- 文件预览：支持图片、Markdown、HTML 和 PDF 的实时渲染预览，支持缩放和平移操作。
- 保存：支持通过按钮或快捷键
Ctrl+S保存文件修改。
终端与操作¶
- 多标签终端：提供基于 ConPTY 的多标签终端，支持拖拽调整大小，并在标签页关闭或连接断开时自动清理进程。
- 可折叠图标栏：支持将面板折叠为窄图标栏，点击图标即可切换打开对应的面板（资源管理器、搜索、源代码控制、终端）。
- 右键菜单：提供文件和文件夹的上下文菜单，支持新建、删除、复制、剪切、粘贴、复制路径和“在资源管理器中显示”等操作。
安装与启用¶
安装该插件需要在具备 Web UI 侧边栏的会话环境中进行。
- 安装插件
使用 DSH 命令行工具安装：
dsh plugin --profile web add dsh-solution-explorer
- 激活
安装完成后，在 DSH Web UI 中重新加载页面，插件面板将作为独立的右侧栏出现。当会话激活工作区时，面板会自动展开。
典型用法¶
- 编辑与保存：在文件资源管理器中打开文件，进行修改后按
Ctrl+S保存。 - AI 生成提交信息：在源代码控制的变更列表中，点击提交框旁边的 ✨ 图标，根据暂存的差异内容生成 AI 提交草稿。
- 快速预览：双击图片或 PDF 文件，即可在编辑器视图中进行缩放和平移查看。
适用场景与注意事项¶
该插件适合需要频繁进行文件读写、代码编辑和 Git 操作的智能体开发场景，能够显著提升在 Web 界面下的开发体验。
重要提示：
- 这是一个第三方社区插件，代码会在本地机器上以当前 DSH 进程的权限运行。
- 插件拥有读取、修改和删除文件的能力，并且可以执行破坏性的 Git 操作（如丢弃变更、删除文件）。
- 建议在使用前审查源代码，并对重要工作做好备份。
- 使用 dsh plugin add github:xiaoksio/dsh-solution-explorer 安装时，插件会自动在目标机器上构建 lib/ 目录，无需手动操作。
总结¶
DSH Solution Explorer 通过复刻 VS Code 的核心体验，解决了 DSH Web GUI 在本地文件管理和版本控制方面的不足。它将文件浏览、编辑和 Git 工具无缝集成，为开发者提供了一个轻量级但功能完备的本地化开发环境。
