前言¶
在 DeepSeek Harness(DSH)里,默认侧栏先按 Workspace 分组再展开 Session。Workspace 和 Session 数量上来之后,「在哪个项目、哪次对话」往往要靠记忆或逐层点开才能对上。第三方插件 dsh-session-hub 提供另一条路径:在同一页列出所有 Workspace 下的 Session,默认按本地日期分组,并支持标题与路径搜索,以及运行中、归档等筛选。它不替换 DSH 自带界面,只在主栏注册 session-hub 面板,并在侧栏增加同 id 的入口。
这是什么¶
dsh-session-hub 是维护者 20zxknk 发布的 DSH 客户端插件(分类:客户端)。它读取框架已有的 sessions.list 与 workspaces.list 快照,在一条可搜索、可切换排序的时间线里展示全部 Session;打开某行会通过 uiWorkspace.openSession 进入对应 Session,且无需先选中或激活该 Session。插件无需配置项,也不注册设置行。
- 目录页:https://www.skillhub.cn/plugins/20zxknk/dsh-session-hub
- 源码:https://github.com/20zxknk/dsh-session-hub(MIT,package 版本 1.0.0)
核心功能¶
排序与分组¶
页头除 Session 总数、所属 Workspace 数量外,提供四种排序(页面唯一的模式切换):
- By day(默认):按本地日期分 sticky 标题(Today、Yesterday,跨年后显示年份),组内按最后 prompt 的本地时钟时间,新者在前。
- Recent activity:扁平列表,按最近活动。
- By workspace:按 Workspace 标题分组,路径作副标题;无 Workspace 的 Session 归入
No workspace。 - By title:按 Session 标题排序,同名再按时间;无标题会话排在末尾。
搜索与筛选¶
搜索框对 Session 标题、Workspace 标题、Workspace 存储路径做不区分大小写的子串匹配;输入目录名可收窄到该 Workspace。Session id 不参与匹配。按 Escape 可清空非空查询且不关闭页面。
两个 chip:Running 仅保留有运行中任务的 Session;Include archived 显示归档 Session(默认隐藏)。归档行变暗并带 Archived 标签;固定 Session 带 Pinned 标签,在各排序下保持固定语义而非一律置顶。
排序与两个筛选会写入浏览器本地存储键 dsh.session-hub.view,刷新后恢复;搜索词不写入本地存储,避免过期查询把列表滤空。
行展示与分页¶
每行包含 Workspace 色条与圆点(由 Workspace id 稳定哈希着色)、标题、Workspace 标题、轮次(来自 sessionStats,无或为 0 时不显示)。无标题显示本地化斜体 Untitled;悬停显示绝对时间与 Workspace 路径。origin: 'subagent' 且未打开的空白 Session 不出现在列表中。
页面一次最多渲染 200 行,底部 Show more 追加下一批;切换排序、筛选或搜索时会重置分页深度。
界面文案通过 Client locale 的 sessionhub 命名空间提供完整 en / zh 词典。
安装与启用¶
将插件安装到 profile 并启用 bundle 后,侧栏在 Automation tasks 旁多一个图标,点击后在主栏打开 Session Hub,且不改变当前 Session 的选中状态。
dsh plugin --profile desktop add github:20zxknk/dsh-session-hub
安装后无需额外配置文件或环境变量。
典型用法¶
- 启用插件 bundle,从侧栏新图标进入 Session Hub。
- 默认 By day 浏览:用日期标题与左侧时钟列回忆「周二下午在某个项目的那次对话」。
- 记得项目路径或标题片段时,在搜索框输入子串,可同时匹配 Session 与 Workspace 字段。
- 需要只看仍在跑的任务时打开 Running;要查历史归档时打开 Include archived。
- 点击任意行进入该 Session;若列表很长,用 Show more 加载更多行。
适用场景与注意¶
适合在同一 DSH 安装里维护多个 Workspace、Session 数量已超出侧栏分组一眼扫完的范围,且更习惯按时间或关键词定位对话的开发者。
插件以当前 DSH 进程的权限运行,数据来自与侧栏相同的框架快照,不自建存储或轮询;安装前建议在 GitHub 阅读源码与 MIT 许可证,并自行评估是否纳入 profile。社区目录站点 skillhub.cn 为独立生态索引,与 DeepSeek / 幻方无官方从属关系。
已知限制以仓库 README 中「Known Limitations and Deferred Work」为准;实现细节(Host/Client 注册、cordis.patch.yml、错误边界等)见 README「Understand the implementation」。
结尾¶
dsh-session-hub 用一页可搜索、可按日分组的全局 Session 列表,补全「先找 Workspace 再找 Session」之外的检索路径,且不替换 DSH 自带侧栏行为。
- 插件目录:https://www.skillhub.cn/plugins/20zxknk/dsh-session-hub
- GitHub:https://github.com/20zxknk/dsh-session-hub