前言¶
在 DSH 的 Web GUI 裏,側邊欄會話通常按工作區分組展示。常用會話如果不置頂,跨工作區查找時需要反覆滾動或切換。dsh-pin 給會話行增加兩個懸停按鈕:📌 工作區內置頂,⌃⌃ 全局置頂區,用於把常用會話放到更醒目的位置。
這是什麼¶
dsh-pin 是 Yu-tao-Li 維護的 DSH 插件,許可證爲 MIT。它給 DeepSeek Harness 側邊欄會話增加兩級置頂:工作區內置頂或全局置頂區,並支持多會話置頂與取消後精確還原。
它是純客戶端插件,零運行時依賴,不改 DSH 本體,僅 Web GUI 可用。
核心功能¶
下面介紹幾個可落地的能力:
1、懸停會話行時,顯示 📌 工作區內置頂和 ⌃⌃ 全局置頂按鈕。按鈕出現在側邊欄會話行的懸停菜單裏(⋯ 左側)。
2、支持同時置頂多個會話。
3、支持在 📌 與 ⌃⌃ 之間切換置頂級別。
4、取消置頂時,精確還原會話被置頂前的位置。
5、全局置頂爲純顯示級置頂,不動任何持久順序,取消即還原。
6、工作區內置頂走宿主官方順序 API,並持久化到 DSH 工作區註冊表。
7、「未分組」會話支持全局置頂,但不支持工作區內置頂。
8、平鋪列表(“In one list”)沒有手動順序,按鈕自動隱藏。
安裝與啓用¶
先執行安裝命令,把插件裝入 web profile:
dsh plugin --profile web add github:Yu-tao-Li/dsh-pin
安裝後重啓 dsh web 生效。也可以在 DSH 設置的插件市場(dshmarket)搜索 dsh-pin。
該命令中的 --profile web 與“僅 Web GUI 可用”的限制一致。倉庫 package.json 聲明需要 Node >=22。
典型用法¶
1、懸停任意會話,點擊 📌,將會話置頂到本工作區。
2、點擊 ⌃⌃,將會話置頂到所有工作區最上面的全局置頂區。
3、點擊置頂區裏的行,直接打開該會話。
4、再點一次按鈕,或點擊置頂區的 ✕ 取消置頂,並精確還原原位置。
適用場景與注意¶
適合使用 DSH Web GUI、需要頻繁打開若干工作區中的常用會話的人。DSH 插件生態強調“一切皆插件”,插件市場(dshmarket)等目錄是社區目錄,不等同於 DeepSeek 官方應用商店。
使用或安裝前注意以下幾點:
- 僅 Web GUI 可用;TUI/Headless 沒有側邊欄。
- 全局置頂按瀏覽器本地生效;工作區內置頂全局持久。
- 只寫宿主工作區/會話順序和瀏覽器本地記錄,不碰會話內容、憑據,不新增網絡端點。
- 工作區內置頂的還原依賴原相鄰會話仍存在;相鄰會話缺失時按回退規則放置。
- 依賴應用內部結構(React fiber 行身份、視圖存儲鍵名
dsh.workspace.view.v5);DSH 大版本升級後,若結構變化,按鈕可能失效。 - 存儲損壞自動降級爲空;RPC 失敗有紅色反饋。
- DSH 插件以當前 dsh 進程權限運行;安裝前應檢查源碼與許可證。
結尾¶
dsh-pin 的價值在於不改 DSH 本體,只給 Web 側邊欄增加兩級會話置頂:工作區內置頂適合持久順序,全局置頂區適合跨工作區快速打開,取消後可以還原原位置。
GitHub 倉庫:https://github.com/Yu-tao-Li/dsh-pin