前言¶
在 DeepSeek Harness(DSH)里同时跑多个会话时,默认侧边栏是按工作区、项目或时间平铺的会话列表。你要自己扫一遍:哪些还在跑、哪些在等审批或回复、哪些刚结束但你没在看。会话一多,这种「全量列表 + 人工分拣」很容易漏掉需要处理的项。
下面介绍社区插件 dsh-activity-view(维护者 vec715)。它在 Web 侧边栏会话区头部加一颗铃铛,一键把列表换成按活动状态分组的视图,把「需要关注 / 进行中 / 今天有动静」的会话拎到前面。
这是什么¶
dsh-activity-view 是面向 DSH Web 客户端的插件(分类:客户端)。一句话:在会话列表头部增加铃铛开关,打开后用 Needs attention、Working、Today 三组替代默认列表。
插件通过 Cordis patch 注入 @deepseek-ai/dsh-client-ui-sidebar,不替换整套会话浏览器,而是在现有头部和列表区域上做 DOM 挂载与显隐切换。当前 package 版本为 0.1.0,要求 DSH >=0.2.0-rc.2,许可证 MIT。插件在 SkillHub 目录 收录;SkillHub 是社区插件目录,与 DeepSeek / 幻方无官方从属关系。
核心功能¶
铃铛与视图切换¶
铃铛位于 shipped 会话头部的 headerActions 行,在视图选项与「添加项目」按钮之间,样式与相邻图标按钮一致。点击后在默认会话列表与活动视图之间切换;铃铛是唯一的开关。
选择保存在浏览器 localStorage,键名为 dsh-activity-view.v2。
三个分组¶
活动视图下,会话按 README 中的规则落入三组:
| 分组 | 会话出现在此处的条件 |
|---|---|
| Needs attention | 在你看别处时结束(未读),或等待审批、计划审阅或回答 |
| Working | 正在运行 |
| Today | 最后一次活动发生在今天(本地日历日) |
空白会话、子 agent 会话和已归档会话不会出现在活动视图中。
行内状态指示¶
- 未读行:绿色圆点
- 等待行:橙色圆点
- 运行中行:宿主自带的 spinner
铃铛本身在有任何项需要关注时也会显示圆点,即使用户当前仍停留在默认列表(视图关闭时亦然)。
安装与启用¶
安装前请自行查看 GitHub 仓库 源码与 MIT 许可证。DSH 插件与宿主在同一进程权限下运行,只安装你信任的来源。
官方安装命令(Web profile):
dsh plugin --profile web add github:vec715/dsh-activity-view
安装后重启 DSH 服务,再刷新浏览器页面。
卸载:
dsh plugin --profile web remove dsh-activity-view
本地开发时,README 允许用 checkout 路径添加(需自行 clone 仓库,本文不展开开发流程)。
典型用法¶
- 按上文命令安装并重启、刷新页面。
- 打开 DSH Web 侧边栏的会话区域,在头部找到铃铛图标。
- 点击铃铛:列表切换为 Needs attention / Working / Today 三组;再点一次回到默认会话列表。
- 优先处理 Needs attention 中带绿点或橙点的行;Working 查看仍在跑的会话;Today 回顾当天有活动的会话。
- 若铃铛上有圆点而你在默认列表,说明仍有待关注项,可点开活动视图处理。
README 提供了默认列表与活动视图的对比截图(docs/default-view.png、docs/activity-view.png),可在仓库中对照 UI 位置。
实现要点(了解即可)¶
插件不整体替换 shipped 的 sidebar.workspaces(否则会连带搜索、视图选项、添加项目)。做法是:
- 将铃铛 append 到
headerActions; - 活动视图开启时隐藏 shipped 的
listArea,在旁边挂载 React 根节点渲染活动列表; - 用 MutationObserver 在 shell 重渲染时把节点放回原位;
- 行高与样式 token 从 shipped 会话行复制,以保持视觉一致。
客户端入口为无构建步骤的 client/client.js,由宿主以经典脚本方式加载。
适用场景与注意¶
适合谁: 经常在 DSH Web 里并行多个 agent 会话、需要快速看到「该点进去」和「还在跑」的开发者。
已知限制(来自 README Known limits):
- 未读状态是 DSH 进程内本地的。刷新页面、开第二个标签、或页面关闭期间结束的会话,不会保留未读标记。
- 实现依赖 shipped 的
headerActions、listArea等 CSS Module 类名;DSH 若重命名或大幅改侧边栏结构,铃铛或列表可能失效。 - 行尺寸是手工对照 shipped CSS 复制的,DSH 若重绘会话列表样式,可能需要插件跟进。
- 界面文案为英文 only。
安装与使用前请确认 DSH 版本满足 >=0.2.0-rc.2,并在 SkillHub / GitHub 核对插件说明是否有更新。
结尾¶
dsh-activity-view 用一颗铃铛把 Web 侧边栏从「全量会话列表」切成按活动分组的视图,减少在多会话场景下漏看待审批、待回复或刚结束会话的情况。若你的日常工作流以 DSH Web 为主,值得一试。