前言¶
在使用 DeepSeek Harness（DSH）时，工作区列表里往往混杂着不同项目的会话。置顶的会话分散在各个工作区里，要找到最近活跃的会话也很麻烦。dsh-up-session 插件在侧边栏「工作区」列表上方插入两个区域：置顶区和最近区，把分散的会话汇总到一处。
插件定位¶
dsh-up-session 是一个 DeepSeek Harness 侧边栏插件，由维护者 kyrsieger 开发。它不改变 DSH 的原有行为，只是在侧边栏顶部增加两个可折叠的会话列表，把各工作区中的置顶会话按更新时间排序展示，同时把未置顶的最近会话也集中到最近区。
核心功能¶
置顶区¶
置顶区位于工作区列表上方，汇总所有工作区里被置顶的会话，按最近更新时间排序。该区域可以展开或收起。每行悬停时会出现「归档」和「取消置顶」两个按钮。
最近区¶
最近区位于置顶区与工作区之间，按最近更新时间排序显示尚未置顶的会话，默认显示最新的 5 条。样式与置顶区一致，同样可以展开或收起。当会话超过 5 条时，列表底部会出现「展开更多」按钮：
- 每点击一次「展开更多」，再显示 5 条；
- 当全部会话都显示完后，按钮变为「收起」；
- 点击「收起」把列表收回到最新的 5 条。
每行悬停时会出现「归档」和「置顶」两个按钮。已置顶的会话只出现在置顶区，两区不会重复显示同一个会话。
设置¶
「置顶」和「最近」的标题栏右侧各有一个齿轮按钮，鼠标移到标题栏上才出现；点击后打开插件的设置弹窗。也可以从侧边栏「插件 → 已安装插件 → dsh-up-session」进入插件详情页，点击「打开设置」打开同一个设置弹窗。
目前有三项设置：
- 显示置顶（默认开启）：显示或隐藏整个置顶区。
- 显示最近（默认开启）：显示或隐藏整个最近区。两个列表可以同时关闭，之后仍可通过原生插件详情页的「打开设置」重新开启。
- 展开工作区中的原会话（默认开启）：从置顶区或最近区点击会话时，同时展开它在工作区列表中所在的分组，让原生会话行可见。关闭后只打开会话，不改变工作区的展开状态。
状态标记¶
两个区的会话行与工作区里的会话行共用同一份运行状态，所以三处的标记始终一致。同时满足多项时按下面的顺序取第一项：
- 橙点：会话正在等你回应，可能是等待回答、等待审批或计划待审；
- 转圈：会话正在进行，包括它自己的回合，以及它还有正在运行的子智能体；
- 绿点：会话刚完成，而你还没打开看过。
状态标记插在标题左侧，只在需要提示时才出现，空闲的行保持原本的左边缘；归档、置顶等操作按钮在悬停时出现的位置不受影响。
安装与启用¶
Web 端¶
dsh plugin --profile web add dsh-up-session
安装后重启 DSH。如果使用自定义 profile，将命令中的 web 替换为对应名称。
桌面端¶
打开侧边栏「插件」，点击「添加插件」，输入 dsh-up-session，安装完成后点击「立即启用」。
典型用法¶
安装完成后，侧边栏顶部会自动出现「置顶」和「最近」两个区域。进入任意工作区，在会话标题栏上右键选择「置顶」，该会话就会出现在置顶区中。点击「最近」标题栏右侧的齿轮图标，可以关闭最近区，或者关闭「展开工作区中的原会话」开关，从置顶区或最近区点击会话时不再自动展开对应的工作区分组。
适用场景¶
适合需要在多个工作区之间快速切换、频繁查看置顶会话或最近会话的用户。如果你使用 DSH 管理多个项目，这个插件可以把常用的会话集中起来，减少在各个工作区之间切换的时间。
注意事项¶
插件以当前 dsh 进程权限运行。安装前建议查看插件的源码与许可证。项目基于 MIT 许可证授权，发布工作流使用 OIDC 认证，无需配置 NPM_TOKEN。
总结¶
dsh-up-session 通过在侧边栏增加置顶区和最近区，把分散的会话集中展示，减少在不同工作区之间切换的时间。它不改变 DSH 的原有行为，只是提供了额外的展示层。插件本身是开源的，可以自行检查源码与许可证。
