置顶会话聚合 kyrsieger/dsh-up-session

dsh-up-session

一个简单的 DeepSeek Harness 侧边栏插件：在「工作区」列表顶部插入「置顶」和「最近」两个分组，把分散在各个工作区里的置顶会话汇总到一处，也把最近的会话收拢到一处。

安装与兼容

DSH 兼容版本声明为 >=0.2.1-rc.2，允许 0.2.1-rc.2、同版本号下更新的预发布版，以及更高的正式版安装；具体功能仍需与所用 DSH 版本验证。

Web 端

dsh plugin --profile web add dsh-up-session

安装后重启 DSH。如果使用自定义 profile，将命令中的 web 替换为对应名称。

桌面端

打开侧边栏「插件」，点击「添加插件」，输入 dsh-up-session，安装完成后点击「立即启用」。

置顶区

汇总所有工作区里被置顶的会话，按最近更新时间排序，可展开收起。每行悬停时出现归档和取消置顶两个按钮。

置顶区和最近区都位于「工作区」列表顶部，是该列表的前两个分组，会和下方的工作区分组一起滚动；使用「工作区」的搜索功能时，两个区暂时隐藏，把列表让给搜索结果。

最近区

位于置顶区与工作区列表之间，按最近更新时间排序显示尚未置顶的会话，默认显示最新的 5 条，样式与置顶区一致，同样可以展开收起。会话超过 5 条时，列表底部出现「展开更多」：

- 每点一次「展开更多」再显示 5 条；
- 全部会话都显示完后，按钮变为「收起」；
- 点击「收起」把列表收回到最新的 5 条。

每行悬停时出现归档和置顶两个按钮。已置顶的会话只出现在置顶区，两区不会重复显示同一个会话。

设置

「置顶」和「最近」的标题栏右侧各有一个齿轮按钮，鼠标移到标题栏上才出现；点击后打开本插件的设置弹窗，样式沿用 DSH 原生设置页。

也可以从侧边栏「插件 → 已安装插件 → dsh-up-session」进入插件详情页，点击「打开设置」打开同一个设置弹窗。

目前有三项设置：

- 显示置顶（默认开启）：显示或隐藏整个置顶区。
- 显示最近（默认开启）：显示或隐藏整个最近区。两个列表可以同时关闭，之后仍可通过原生插件详情页的「打开设置」重新开启。
- 展开工作区中的原会话（默认开启）：从置顶区或最近区点击会话时，同时展开它在工作区列表中所在的分组，让原生会话行可见。关闭后只打开会话，不改变工作区的展开状态。

状态标记

两个区的会话行与工作区里的会话行共用同一份运行状态，所以三处的标记始终一致。同时满足多项时按下面的顺序取第一项：

- 橙点：会话正在等你回应，可能是等待回答、等待审批或计划待审；
- 转圈：会话正在进行，包括它自己的回合，以及它还有正在运行的子智能体；
- 绿点：会话刚完成，而你还没打开看过。

状态标记插在标题左侧，只在需要提示时才出现，空闲的行保持原本的左边缘；归档、置顶等操作按钮在悬停时出现的位置不受影响。

发布

发布 GitHub Release 后，发布工作流 会自动将该 tag 对应的包发布到 npm。tag 必须与 package.json 的版本一致，例如 v1.0.1 或 1.0.1。正式版使用 npm 的 latest 标签；预发布版使用 next，且 GitHub Release 必须标记为预发布。仅保存草稿或推送 tag 不会触发发布。

首次使用前，在 npm 的 dsh-up-session 包设置中添加 GitHub Actions 可信发布者（npm 官方说明）：

- Organization or user：kyrsieger
- Repository：dsh-up-session
- Workflow filename：publish.yml
- Environment name：留空
- Allowed actions：允许直接执行 npm publish

工作流使用 OIDC 认证，无需配置 NPM_TOKEN。先将工作流、版本号和更新日志提交并推送，再为该提交创建 tag 和发布 Release。发布失败时，可在 GitHub Actions 中重跑失败的任务；已成功发布的 npm 版本不能重复发布。

许可

本项目基于 MIT 许可证 授权。