前言¶
DeepSeek Harness (DSH) 提供了 Chat 和 Work 两种核心工作模式。Chat 模式专注于对话交互，而 Work 模式则要求开发者具备文件浏览和命令行执行能力。在标准的 DSH Work 模式界面中，这两项功能均处于缺失状态。插件化是 DSH 的核心架构理念，omdsh-sidepanel 旨在为 Work 模式补充这两个必要的界面元素，使其具备轻量级的文件管理和终端运行能力。
插件简介¶
omdsh-sidepanel 是一个为 DeepSeek Harness Web GUI 设计的插件，由社区开发者 omdsh-plugins 维护。它为 Work 模式提供了右侧的文件面板（支持预览）和底部的终端面板。这两个面板在 Chat 模式下不会出现，因为 Chat 模式没有对应的项目目录。
核心功能¶
- 文件面板：位于界面右侧，显示当前会话目录的文件树，并支持文件预览。
- 终端面板：位于对话列下方，提供 Shell 访问能力。
- 控制开关：通过会话标题工具栏中的开关控制面板的显示与隐藏。
- 命令接口：提供
panel.files和panel.terminal两条命令，具体绑定按键由omdsh-shortcuts插件管理。 - 交互操作：
- 调整大小：拖动手柄调整面板宽度，双击手柄可重置默认大小（320px）。
- 复制路径：点击面板标题栏的复制按钮，或右键点击文件/文件夹行以复制路径。
- 布局定位：面板固定定位在
shell.overlay层，通过调整#root和[data-slot="conversation"]的边距来避免遮挡主界面。 - 设置存储：面板大小保存在
localStorage的omdsh-sidepanel.panels键下。
安装与启用¶
该插件通过 DeepSeek Harness 的插件中心或 GitHub 仓库安装。安装后，面板仅在 Work 模式下出现。
典型用法¶
- 开启面板：在会话标题栏的工具行中找到对应的开关（文件面板或终端面板）并开启。
- 快捷命令：通过
omdsh-shortcuts配置的快捷键（如CmdOrCtrl+Shift+E等）快速唤起面板。 - 调整面板：鼠标拖动面板边缘的手柄改变宽度，双击手柄恢复默认。
- 获取路径：在文件树中右键点击目标项，选择复制路径；或点击面板顶部的复制按钮。
- 终端默认状态：终端面板默认关闭。如果同时安装了
omdsh-codemode，终端默认会开启。
适用场景与注意¶
- 模式限制：插件仅对 Work 模式有效，Chat 模式下不会渲染任何面板。
- 依赖关系：依赖
omdsh-shortcuts（处理快捷键）、omdsh-chatmode、omdsh-basemode和omdsh-codemode。 - 功能边界：面板不包含编辑器、Git 界面、浏览器或选项卡条，专注于轻量级的文件查看和终端运行。
- 安全提示：插件以当前 DSH 进程权限运行，安装前应检查源码与许可证（MIT）。
短结尾¶
omdsh-sidepanel 为 DSH Work 模式补全了文件浏览和终端功能，通过简洁的侧边栏设计避免了界面臃肿。对于需要在 Harness 中直接管理文件和执行命令的开发者，这是一个实用的补充。
资源链接：
* 插件目录：https://www.skillhub.cn/plugins/omdsh-plugins/omdsh-sidepanel
* GitHub 仓库：https://github.com/omdsh-plugins/omdsh-sidepanel
