前言¶
DeepSeek Harness (DSH) 的侧边栏通常只回答“哪个会话在哪”，不直接展示当前会话状态的负载。开发者常需手动翻阅列表来确认剩余任务。dsh-session-watch 解决这个问题，它作为仪表盘，在侧边栏底部实时展示六种会话状态的数量，帮助开发者一眼看清工作负载。
简介¶
这是 DeepSeek Harness 的一个插件，专注于会话状态的可视化。由维护者 d0ublecl1ck 开发，类别为“记忆”。
核心功能¶
- 状态计数：在侧边栏底部显示六种会话状态的计数：运行中、未读、待处理、闲置、未归档、已归档。
- 版式切换：提供“胶囊”和“比例条”两种版式，可根据偏好选择。
- 灵活配置：可在设置页逐项开关显示项，并调整阈值。
- 安全边界：只读官方 shell 已发布的三个快照（
useSessions、useSessionStatus、useWorkspaces），不归档、不删除、不落盘、不联网，不依赖任何其它插件。
安装与启用¶
通过官方命令安装：
dsh plugin --profile web add dsh-session-watch
安装后刷新窗口即可生效。
典型用法¶
1. 语音指令调整¶
在对话中直接对 Agent 下达指令，例如：
现在有几个会话在跑？把「闲置」关掉，只留运行中、未读、待处理。
Agent 会根据当前设置调整侧边栏的显示项。
2. 手动配置¶
偏好设置也可以直接写在 profile 的 cordis.patch.yml 中。注意 row id 即为设置命名空间：
- id: session-watch
name: dsh-session-watch
config:
threshold: 20
variant: meter
showIdle: false
技术细节¶
- 数据来源：插件只读取官方 shell 发布的三个快照，不写入任何会话或归档状态。
- 解耦设计：与卸载解耦，Host 没有服务本插件的配置命名空间时，设置行不注册。
- 计算逻辑：闲置状态由前几项派生，四个活动项之和恒等于未归档数。
总结¶
dsh-session-watch 为 DSH 用户提供了一个轻量级的状态监控工具，通过侧边栏的直观展示，减少了对列表的频繁翻阅。所有功能均在本地计算，不涉及网络交互或文件写入，适合需要精细管理会话状态的场景。
