前言¶
DeepSeek Harness (DSH) 提供了完整的会话、工具、轨迹和 Goal 管理功能，但在文件管理和交互体验上略显基础。默认侧栏不支持文件预览，长目标条会被截断，且无法直观看到模型推理的实时速率。dsh-soup 是一个插件，旨在通过增强 UI 来改善 DSH 的使用体验，无需修改 DSH 本身。
是什么¶
- 名称：dsh-soup
- 定位：DeepSeek Harness UI 增强
- 维护者：lyhue1991
- 许可证：MIT
核心功能¶
该插件提供四项主要增强：
- 右侧文件树：提供 JupyterLab 风格的文件浏览界面。默认宽度 300px，支持拖拽调整。文件树会跟随当前会话的工作目录变化。支持文件上传、下载、删除、预览、重命名等操作，文件类型通过图标区分。
- 会话内文件预览：在会话区域新增“预览”标签页。支持 Markdown、HTML、PDF、代码、图片等多种格式的预览。部分文本文件（如 Markdown、代码）支持直接编辑，编辑后停止输入 5 秒会自动保存。
- 多行 GoalBar：将原生单行截断的 GoalBar 改为多行显示，支持完整编辑。数据与操作逻辑复用 DSH 原生接口。
- 实时 Token 流速徽标：在会话头部显示模型的实时生成速率（t/s），通过颜色区分速度等级（青/绿/黄/红）。
安装与启用¶
安装前需确认已安装 DSH Desktop 或支持 dsh plugin add 命令的 DSH 安装版本。
dsh plugin add @lyhue1991/dsh-soup
安装完成后需重启 DSH 以使插件生效。
典型用法¶
- 打开文件树：点击 Session log 右侧的 📁 图标，或在空白新会话的输入框上方右端点击 📁。
- 预览文件：在文件树中双击文件，或在文件树右键菜单中选择“预览”。预览内容会以标签页形式出现在会话顶部。
- 查看速率：向任意会话发送消息，顶部状态栏会出现实时 Token 流速徽标。
- 多行 GoalBar：创建 goal 后，顶部状态栏会自动以多行形式完整显示目标内容。
注意事项¶
- 权限限制：文件操作受沙箱限制，仅限于工作区与会话目录。
- 文件大小限制：PDF 预览限制为 20MB 以内，图片预览限制为 8MB 以内。
- 编辑行为：编辑文本文件时默认覆盖磁盘更改，工具栏不显示“取消”按钮。
- 自动保存：停止输入 5 秒后自动保存，退出编辑时也会触发保存。
总结¶
dsh-soup 通过右侧文件树、会话内预览、多行 GoalBar 和实时速率徽标四个维度增强了 DSH 的 UI 交互体验。它适合需要频繁处理文件、关注模型推理速度以及需要清晰管理开发目标的用户。更多细节可参考插件目录或源码仓库。
