DeepSeek Harness (DSH) 的核心設計理念是“一切皆插件”。在實際使用中,開發者常需要在側邊欄快速管理會話,或者在對話時跳過特定工作區的綁定。dsh-ui-enhancements 旨在解決這些問題,提供一系列針對性的 UI 改進。
這是一個由 Unintendedz 維護的小型、聚焦的 UI 增強插件。它不改變 DSH 的核心邏輯,而是通過擴展 UI 層面,讓會話管理和工作區切換更加直觀和高效。
無工作區對話¶
插件新增了“無工作區”對話模式。默認情況下,點擊側邊欄的“新建會話”即可創建一個無工作區對話。這些對話獨立於現有工作區,擁有獨立的存儲目錄。
- 獨立存儲:每個無工作區對話擁有獨立的真實工作目錄,路徑爲
<DSH_HOME>/projectless/session-projectless-<uuid>。 - 功能保留:儘管沒有綁定工作區,這些對話保留了 DSH 的原生功能,包括模型選擇器、附件上傳、工具調用、歷史記錄、搜索、分支、歸檔和刪除操作。
- 草稿與附件:在發送前,通過鼠標懸停或點擊工作區選擇器中的“×”按鈕,可以切換回“無工作區”並保留草稿和附件。切換行爲通過 DSH 原生的草稿轉移機制實現。
- 歸檔與恢復:歸檔和恢復操作會保留原有的目錄結構。
工作區活動順序¶
側邊欄中的工作區分組默認按“最後更新”排序。排序規則基於可見對話的最後更新時間。摺疊的工作區組遵循相同的規則。
- 自動排序:活動、歸檔、恢復、刪除以及成員變更等操作會更新排序,無需刷新會話列表。
- 手動排序:通過“視圖選項”切換到“手動”模式,可以禁用自動排序並啓用工作區組的拖拽排序功能。
配置文件插件開關¶
插件提供了全局的插件開關控制。在設置菜單中可以管理當前配置文件下安裝的所有插件。
- 啓用/禁用:打開
Settings -> Plugins -> Plugin list,可以啓用或禁用每個插件包。 - 持久化:更改會立即應用到主機加載器,並隨 DSH 重啓而保留。狀態保存在配置文件的
cordis.patch.yml中。 - 鎖定機制:
dsh-ui-enhancements的開關默認保持可見且鎖定開啓,防止恢復控制將其意外關閉。 - 系統保護:DSH 內置的運行時條目保持只讀,因爲禁用核心服務可能導致 Web UI 或插件管理器不可用。
會話快速操作¶
在側邊欄的會話列表中,懸停在有內容的會話行上,即可快速訪問操作按鈕,無需打開原生菜單。
- 操作項:顯示“固定/取消固定”、“歸檔”和“立即刪除”。
- 固定:固定後的會話會顯示在工作區組的頂部或扁平列表的頂部。
- 歸檔:複用 DSH 原生的歸檔功能。
- 立即刪除:打開一個確認對話框,確認後停止會話、移除日誌和記錄,但不刪除生成的文件、分支和共享附件。
已存檔對話管理¶
插件在設置中增加了對已存檔對話的管理入口。
- 入口位置:打開
Settings -> Conversations -> Archived conversations -> Manage。即使會話列表爲空,此入口也可用。 - 列表展示:顯示標題、工作區名稱(或“無工作區”)和創建日期。支持搜索標題和工作區路徑。
- 操作:懸停或鍵盤聚焦可顯示“恢復對話”和“立即刪除”。恢復會話會移除歸檔標誌並保留原始狀態。
- 性能優化:初始列表加載時,直接使用 DSH 頭部和標題檢查點,不讀取對話日誌。後續在後臺批量解析缺失標題,並在 1 分鐘後驗證日誌修訂。
安裝與依賴¶
該插件依賴 DSH 的特定版本和後端架構。
- DSH 版本:需要 DSH
0.1.5-rc.1及其 JSONL session backend。 - 安裝後操作:安裝後必須重啓 DSH,以便插件能夠跟蹤每個對話的原生生命週期。
生態背景¶
DeepSeek Harness 是一個開放的插件生態。本插件由社區維護,與 DeepSeek 或幻方 AI 無官方從屬關係。插件源碼與許可證可在 GitHub 查看。