前言¶
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 交互體驗。它適合需要頻繁處理文件、關注模型推理速度以及需要清晰管理開發目標的用戶。更多細節可參考插件目錄或源碼倉庫。
