前言¶
DeepSeek Harness (DSH) Web 界面默認提供了基礎的會話和文件視圖。對於需要頻繁管理臨時草稿、切換工作目錄的開發者來說,原生的按鈕佈局和列表展示可能不夠高效。dsh-plugin-pi-ui 插件旨在通過重構側邊欄,提供更緊湊的會話管理和文件瀏覽體驗。
插件介紹¶
這是一個受 pi-web 啓發的側邊欄增強組件,由 ice-ai-lab 維護。它通過 --dsw-* 設計令牌跟隨主題,解決了以下問題:將左側邊欄重塑爲邏輯分塊的結構,頂部展示臨時會話,下方通過選擇器展示特定工作目錄的會話列表,並提供一個僅在發送後才生效的草稿編輯器,同時接管右側列的文件選項卡。
核心功能¶
- 側邊欄分塊重塑:將左側欄分爲臨時會話區、工作目錄選擇器與會話列表區。
- 臨時會話管理:頂部展示最近 5 個臨時會話,支持點擊
+創建草稿,點擊🗑清理未使用的目錄。 - 工作目錄與會話綁定:通過下拉菜單選擇工作目錄,下方的會話列表僅顯示該目錄下的會話。
- 草稿機制:所有“新建”操作(點擊
+)僅打開草稿編輯器,不創建任何文件或會話,直到發送消息。 - 右側文件資源管理器:在右側列的 Files 選項卡位置顯示緊湊的文件瀏覽器。
安裝與啓用¶
使用以下命令安裝插件:
dsh plugin --profile web add dsh-plugin-pi-ui
安裝後,必須重啓 dsh web 才能生效。由於瀏覽器端代碼在啓動時組裝,新添加的客戶端插件在已運行的服務器上不會立即顯示,需要刷新頁面。
典型用法¶
- 創建臨時會話:點擊左側欄頂部的
+按鈕,輸入內容併發送。此時纔會生成對應的臨時目錄。 - 清理臨時目錄:點擊頂部的
🗑按鈕,可以刪除不再使用的臨時目錄。 - 切換工作目錄:點擊“工作區”行與
+按鈕之間的下拉菜單,選擇目標目錄。下方的會話列表將只顯示該目錄的內容。 - 管理文件資源管理器:進入設置中的“通用”選項,可以開啓或關閉右側列的文件資源管理器功能。
注意事項¶
插件以當前 dsh 進程的權限運行。插件內的設置(如文件資源管理器開關、工作目錄切換器)是內存級的,刷新頁面後會重置。臨時會話對應的目錄會保留在磁盤上,如果不再需要,可以手動刪除 <DSH_HOME>/scratch/ 目錄。
後續¶
該插件採用 MIT 許可證,源代碼託管在 GitHub。更多細節可參考 SkillHub 目錄。