前言¶
在 DeepSeek Harness（DSH）的 Web GUI 中，會話列表會隨着運行時間變長。當會話數量較多時，最新完成的會話和未讀結果很容易被埋在長列表底部，需要滾動多次才能找到。
dsh-session-top-new 是一個給 DSH Web GUI 用的會話總覽懸浮欄插件。它把所有會話的運行狀態和未讀情況聚合在一個懸浮面板裏，點一下就能跳轉，會話結束時還會響一聲提示。
這是什麼¶
dsh-session-top-new 是 cuijiajun 維護的一個 DSH 插件，分類爲「記憶」。它向 DSH 的客戶端運行時服務註冊一個全局懸浮組件，在當前會話窗口上方顯示一個圓形按鈕。按鈕展開後是一個會話列表面板，展示每個會話的運行狀態、更新時間和未讀數量。
核心功能¶
-
全局狀態概覽
面板顯示所有會話的運行狀態，而不是隻看當前會話。你在任意會話中打開面板，都能看到其它會話的情況。 -
狀態可視化
- 運行中的會話顯示綠色脈衝點
- 未查看結果的會話顯示琥珀點，標題加粗
- 圓形按鈕右上角有紅色角標，顯示未讀總數 -
N 天曆史
面板頭部顯示「近 N 天」的會話，默認爲當天。可以在面板頭部直接修改 N 值，範圍 1–365 天。 -
點擊跳轉
點擊任意會話行，主視圖直接切換到該會話，面板保持展開狀態。 -
層級摺疊
子代理會話嵌套在其父會話下，默認摺疊。展開父會話時，子會話纔會顯示，不會平鋪成一行。 -
完成提示音
會話結束時，使用 Web Audio 合成兩聲提示音。面板右上角有靜音開關，可關閉。 -
拖拽與自適應
圓形按鈕可拖拽到任意位置。位置按窗口比例保存，窗口縮放時相對位置保持不變。面板靠近屏幕邊緣時，會自動翻轉方向。 -
忽略行
鼠標懸停在會話行上，行尾出現 × 按鈕。點擊可隱藏該行。當該會話產生新結果時，行會自動重新出現。隱藏父會話時，其當前顯示的子會話行也會一併隱藏。 -
主題反色
面板顏色反色於頁面主題：淺色頁面用深色面板，深色頁面用淺色面板。跟隨 DSH 的主題開關自動切換，無需額外配置。 -
可摺疊
默認展開，點擊圓形按鈕可摺疊回單按鈕狀態。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add github:cuijiajun/dsh-session-top-new
安裝完成後，重啓 Web GUI。DSH 客戶端在啓動時掃描緩存中的插件判定結果，新安裝的插件不會立即生效，必須重啓。
典型用法¶
- 打開 Web GUI，安裝並重啓後，屏幕右下角會出現一個圓形按鈕。
- 將按鈕拖拽到合適的位置，比如右下角或側邊欄附近。
- 點擊按鈕，面板展開，顯示當前近 1 天內的會話列表。
- 看到運行中的會話，綠色脈衝點表示還在跑；琥珀點表示有結果未查看。
- 點擊有未讀的會話，視圖直接跳轉到該會話。
- 等待會話結束，會聽到兩聲提示音。
- 如果某個會話不再需要關注，懸停在該行上，點擊 × 隱藏。
適用場景與注意¶
這個插件適合需要頻繁查看多個會話運行狀態、又不想在長列表中翻找的場景，比如批量任務調度、長時間運行的代理鏈、需要同時追蹤多個會話進度的開發工作流。
插件依賴 DSH 的客戶端運行時服務：sessions.list 和 uiSession.sessionStatus。這些是官方 UI 使用的接口，但不是凍結的公共 API。當 DSH 升級導致接口變更時，插件可能暫時失去跳轉或狀態標記功能。如果某個控制不響應，檢查瀏覽器控制台是否有 [dsh-session-top-new] 警告。
插件以當前 dsh 進程的權限運行，安裝前建議查看源碼和許可證（MIT）。
結語¶
dsh-session-top-new 用一個懸浮面板把會話狀態集中展示，配合點擊跳轉和提示音，讓最新和未讀的會話不再被長列表埋掉。如果你在 DSH 中同時跑多個會話，這個插件可以減少切換視圖和翻找的時間。
目錄頁：https://www.skillhub.cn/plugins/cuijiajun/dsh-session-top-new
GitHub：https://github.com/cuijiajun/dsh-session-top-new
