前言¶
在 DSH 側欄中,當分組收起時,會話的狀態也會隨之隱藏。這使得進行中、待審批、等待評審等狀態對整體概覽不可見。dsh-group-status 插件解決了這個問題,在摺疊的文件夾行上顯示聚合徽標:黃點待審批、轉圈進行中,再掛上定時任務與等待評審兩個圖標,帶數字、懸停看明細。
核心功能¶
插件提供以下能力:
- 聚合徽標顯示:收起分組時,在文件夾行顯示聚合狀態圖標(進行中、待審批、已完成、定時任務、等待評審)。
- 懸停明細:懸停文件夾行時,查看聚合狀態明細行。
- 跨插件聚合:支持跨插件狀態聚合,消費
dsh-later(定時任務)和dsh-gitea-dispatch(等待評審)的狀態摘要。 - 視覺一致性:與行內狀態顏色和文案同源,使用相同的
StateDot組件。 - 多語言與無障礙:支持中文/English,提供
role="img"和aria-label支持。
安裝與啓用¶
通過 DSH 命令行工具安裝:
dsh plugin --profile web add dsh-group-status
安裝後重啓 DSH Web 即可生效。
使用方法¶
- 查看聚合:收起任意有活會話的分組,文件夾名後會出現聚合徽標(如數字、轉圈圖標等)。
- 查看明細:將鼠標懸停在摺疊的文件夾行上,會顯示聚合狀態明細行。
- 狀態回退:展開分組後,聚合徽標消失,子行顯示自身狀態。
注意事項¶
- 上游維護:上游換代必須手工 rebase,插件 vendored 了上游源碼,使用非穩定公共 API。
- 依賴來源:狀態圖標完全依賴
dsh-later/dsh-gitea-dispatch,不自己輪詢;若未安裝這兩個插件,對應的圖標不會出現。 - 計數規則:定時任務圖標按“組內有定時任務的會話數”計,不按任務條數累計。
- 功能範圍:僅覆蓋側欄摺疊態,不改動會話狀態機、不改動行內 badge 的判據。
生態與參考¶
該插件由 dsh-plugin-collection 維護。
- 插件目錄:https://www.skillhub.cn/plugins/dsh-plugin-collection/dsh-group-status
- 源碼倉庫:https://github.com/dsh-plugin-collection/dsh-group-status