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