前言¶
在 DeepSeek Harness（DSH）里同时开着多个会话时，待审批、刚跑完还没点开、正在跑的任务往往分散在侧栏里，需要逐个找状态点才能判断优先级。侧栏能看全列表，但切换频繁时不够直观。dsh-session-float 是面向 DSH Web 界面的客户端插件，在页面上提供一块可拖动的「灵动岛」胶囊：收纳时汇总活动会话数量，展开后按状态分组列表并支持一键跳转，底部还可列出最近空闲的历史会话。下面介绍它的能力、安装方式与典型用法。
这是什么¶
dsh-session-float 由社区维护者 MorzerChimes 发布（仓库 MorzerChimes/dsh-session-float），归类为 DSH 客户端插件，通过 Cordis patch 注入 Web 前端。它不替代侧栏会话列表，而是在任意会话相关页面上浮层展示「当前有多少活动在等你处理」，并与侧栏状态含义对齐。
状态与侧边栏会话状态点一致：
| 状态 | 含义 |
|---|---|
| 待处理 | 会话在等你审批、审阅计划或回答问题 |
| 已完成 | 会话运行结束，你还没打开查看 |
| 进行中 | 会话正在运行 |
核心功能¶
收纳态一览¶
收纳时显示活动会话总数，以及待处理、已完成、进行中各自的数量；某项为 0 时不显示该状态。可选两种收纳样式：详细（图标 + 数字 + 文字）或简略（数字写在状态图标中心）。详细模式下，若有进行中的会话，「活动」圆点会播放心跳动画（v0.2.0）。
展开列表与跳转¶
点击胶囊展开面板。会话按 待处理 → 已完成 → 进行中 分组，组内按最近活动排序；当前打开的会话带竖条标记。点击列表中的会话即可直接切换过去。
历史会话¶
面板底部列出最近活动过、当前空闲的会话，不计入活动数。有活动会话时历史分组默认收拢，没有活动时默认展开；先显示 5 条，可「查看更多」，最多 15 条。
位置与展开方向¶
按住拖动可放到页面任意位置，位置会被记住。停靠在左侧时向右展开、向左收拢；在右侧时向左展开、向右收拢。
外观与收起¶
外观可选浅色、深色（比 DSH 深色亮一级，便于区分）、或跟随 DSH 当前主题（系统）。收起方式包括 Esc、收起按钮、点击会话项；也可选「点击空白处收起」。展开、收起与数字变化带过渡动画，并遵循系统的「减少动态效果」设置。
仅在会话页显示¶
可在设置中开启「仅在会话页中显示」。开启后，在插件、自动化任务等非会话页隐藏灵动岛（v0.2.0 新增）。
安装与启用¶
需要 DeepSeek Harness 0.2.1-rc.2 及以上（与 package.json 中 engines.dsh 一致）。
安装当前最新发布版：
dsh plugin --profile web add github:MorzerChimes/dsh-session-float
安装指定版本（示例为 v0.2.0）：
dsh plugin --profile web add github:MorzerChimes/dsh-session-float#v0.2.0
所有版本见仓库 Tags。安装后刷新 DSH Web 页面；若未出现灵动岛，可重启 dsh web。
设置入口有两处：展开面板头部的齿轮，以及侧栏 插件 → dsh-session-float 详情页。
卸载：
dsh plugin --profile web remove dsh-session-float
典型用法¶
- 完成上述
dsh plugin --profile web add并刷新或重启 Web 后，在会话页看到浮动胶囊。 - 看收纳态数字判断待处理、已完成、进行中的规模；需要处理时点击展开，从待处理组选会话跳转。
- 把胶囊拖到顺手的一角；在右侧停靠时面板会向左侧展开，避免挡住主内容。
- 在设置里切换详细/简略收纳、主题、点击空白收起、以及是否仅在会话页显示。
- 活动数归零时展开历史会话，通过「查看更多」回到最近用过的空闲会话。
界面支持中英文（首个版本 v0.1.0 已说明）。
适用场景与注意¶
适合经常在 DSH Web 里并行多个智能体会话、需要快速扫一眼「谁在等我」并跳转的开发者。它不跑服务端逻辑，依赖注入的 DSH 客户端 UI 模块（会话、工作区、主题、插件管理等）获取状态。
DSH 生态主张「一切皆插件」；社区目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系。客户端插件随当前 dsh 进程在浏览器侧执行，安装前建议阅读仓库源码与 MIT 许可（© Merlin Hermes）。勿在未审阅的情况下在生产环境盲目添加第三方插件。
结尾¶
dsh-session-float 把活动会话的汇总、分组列表、历史回看和一键切换收进一块可拖动的 Web 灵动岛，与侧栏状态语义一致。需要安装命令与更新记录时，以 GitHub README 与 CHANGELOG.md 为准。
