前言¶
在 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
