kaixinbaba/dsh-session-activity

dsh-session-activity

面向 DeepSeek Harness Web 侧边栏的活动优先会话组织方式。

功能

- 在空闲时，始终使用现有的 Last updated 时间戳，将可见会话按 Hot、Warm、Cool，然后是 Cold 分组。
- 将每个正在运行 AI 或具有不间断运行子代理的会话保留在 Hot 中，并在每次定期评估时刷新其视图本地的活动时间戳。
- 在每个活动分组内，将现有的 Group by → Workspace / In one list 选择保留为次级布局。
- 在每个关注层级内，保留现有的 Order by → Manual / Last updated 选择。
- 将显式用户交互排在最前，其次是已完成的 AI 回复，再之后是普通空闲会话，最后是正在运行 AI 的会话。
- 添加一个持久的 Focus 按钮，用于隐藏除 Hot 之外的所有分组。
- 在页面保持打开时，默认每分钟重新计算活动分组。
- 隐藏空的活动分组，并临时展开包含当前会话的分组。
- 即使在启用 Focus 时也搜索所有会话。
- 保留会话打开、重命名、分叉、归档、工作区创建、重命名、移除以及新建会话操作。

安装

dsh plugin --profile web add dsh-session-activity

安装后重启正在运行的 dsh web 进程，然后刷新现有页面。该插件通过 DSH 支持的槽位优先级机制遮蔽内置的 Workspace 浏览器；卸载它会重新显示内置浏览器。

配置

打开 Settings → Session Organizer 来编辑并保存这些值。浏览器中的编辑会存储在 $DSH_HOME/session-organizer.json 中，覆盖配置文件默认值，并立即更新已打开的侧边栏。

默认值如下：

config:
hot:
label: Hot
within: 3h
expanded: true
warm:
label: Warm
within: 1d
expanded: false
cool:
label: Cool
within: 2d
expanded: false
cold:
label: Cold
expanded: false
focus:
defaultEnabled: false
refreshEvery: 1m

你也可以在配置文件中配置现有的 dsh-session-activity 插件行；不要第二次插入相同的插件 id。从 Settings 保存的值优先于该组合配置。

时长接受正整数后跟 m、h、d 或 w。阈值必须满足 hot.within < warm.within < cool.within。Cold 始终是无上界的最终分组。refreshEvery 必须至少为 1m。

边界归属在相等时使用较旧的一侧：

- Hot：age < hot.within
- Warm：hot.within ≤ age < warm.within
- Cool：warm.within ≤ age < cool.within
- Cold：age ≥ cool.within

分组名称、初始展开状态和初始 Focus 状态来自配置。在用户更改 Focus 或某个分组的展开状态后，浏览器会在重新加载后保留该选择。当前会话会从折叠的分组中显示，而不会覆盖已保存的折叠偏好。

排序
每个活动和 Workspace 部分内部的主要排序规则是：

1. 有某个问题、审批或其他显式交互正在等待用户。
2. AI 已完成，Session 正在等待用户继续。
3. Session 处于其他空闲状态。
4. AI 或其某个未中断的子代理正在工作。

Last updated 在同一层级内按最新优先排序。Manual 在同一层级内保留账户顺序；Session 操作菜单提供可通过键盘访问的 Move earlier 和 Move later 操作。

聚焦与搜索

聚焦会隐藏 Warm、Cool 和 Cold，包括所选非 Hot Session 的侧边栏行。对话仍保持打开。输入搜索查询会临时搜索所有可见、未归档的 Session；清除查询后会恢复聚焦状态。

添加 Workspace

Add workspace 会打开一个应用内目录浏览器，由 DSH 的公共 browse 能力提供支持。可通过文件夹行、面包屑或绝对路径进行导航；可选择显示隐藏文件夹，然后选择 Use this folder。这适用于不提供原生操作系统目录选择器的 Web 部署。

开发

npm install
npm test
npm run verify:plugin
npm run smoke:install
npm pack --dry-run

npm test 会在运行单元测试和集成测试之前，从 src/client/ 重新构建 client/client.js。

已知限制

- DSH 拥有持久化的 Last updated 字段，并以只读方式将其暴露给客户端插件。当工作正在运行时，此插件会将当前评估时间投射到自己的行中，而不会修改 DSH 的 Session 摘要。
- 子代理子 Session 仍位于顶层列表之外，与内置 Workspace 浏览器一致。

许可证

MIT