前言¶
在使用 DeepSeek Harness (DSH) 进行智能体开发或日常交互时，随着会话数量的积累，侧边栏工作区的管理效率往往成为瓶颈。缺乏直观的会话统计、归档功能受限以及跨工作区会话流转不便，是常见的痛点。dsh-session-xc 插件旨在通过扩展侧边栏的交互能力，解决这些问题。
插件介绍¶
这是一个为 DSH 侧边栏工作区提供会话管理增强的插件。插件由开发者 xchannel1987 维护，采用 MIT 许可证。
核心价值在于对现有工作区列表的补充：它不再只是简单的列表展示，而是增加了统计维度、归档与恢复机制、跨工作区的拖拽流转能力，以及针对新会话的自动化命名辅助。
核心功能¶
插件提供以下已核实的功能：
- 会话数统计展示：在工作区名称旁显示会话数量。支持两种格式：
(3)表示 3 个活跃会话；(2/3)表示 2 个未读完成会话 / 3 个活跃会话（绿色数字）。 - 归档会话管理：在侧边栏工作区操作区提供归档入口。用户可以在归档面板中查看已归档会话，并支持恢复或删除操作。
- 跨工作区移动：支持通过拖拽将会话移动到其他工作区。移动时会自动更新会话归属，且在特定条件下（如常驻排队会话）会自动排队持久化，并在重启后自动完成。移动操作支持标题保留。
- 只看活跃会话筛选：提供筛选开关，可仅显示当天（最后操作时间）有活跃记录的会话，帮助快速聚焦当前工作流。
- 新会话首轮自动起名：在新会话完成第一轮对话后，插件会尝试调用模型为会话生成一个有意义的标题。此功能仅针对非官方模型路由（非
deepseek-official）生效。
安装与配置¶
安装
通过 DSH CLI 安装：
dsh plugin --profile web add dsh-session-xc
安装完成后需重启 DSH 以加载插件。
配置项
插件在设置页面提供了以下可配置项（默认值均为 true）：
| 配置项 | 说明 |
|---|---|
showSessionCount |
显示工作区旁的会话数统计 |
showArchiveEntry |
工作区操作区显示归档按钮 |
enableSessionMove |
启用拖拽移动会话功能 |
showActiveFilterEntry |
搜索按钮左侧显示“只看活跃会话”开关 |
autoTitleFirstRound |
开启新会话首轮自动起名（仅非官方路由生效） |
使用示例¶
查看会话统计
在工作区列表中，工作区名称旁边会直接显示当前工作区的会话数量。展开工作区后，可以看到更详细的统计信息。
恢复与删除归档会话
- 点击工作区旁的归档按钮（通常为文件夹图标）。
- 在弹出的归档面板中找到目标会话。
- 恢复：点击「恢复」按钮（PC 端）或点击整行（移动端）。
- 删除：在归档面板中，PC 端点击红色「删除」按钮，移动端则需左滑后点击「删除」。确认后会话文件将被永久移除。
移动会话到其他工作区
- 长按会话行开始拖拽。
- 将其拖拽到目标工作区或目标工作区下的会话上。
- 当目标高亮显示时释放鼠标/手指。
- 在确认对话框中确认移动。若提示“已排队”，说明该会话在当前进程内处于常驻激活状态，需重启 DSH 后才会完成移动。
筛选活跃会话
点击抽屉头部搜索按钮左侧的开关按钮（开启后呈主题蓝色按压态），列表将仅显示今天有操作记录的会话及其所在工作区。再次点击即可恢复完整列表。
新会话自动起名
- 开启一个新会话并完成第一轮对话。
- 约 1.5 秒后，插件会使用该会话自身的模型生成标题。
- 侧边栏或标签页的标题会自动更新。注意，此功能仅在非官方模型路由下生效。
注意事项¶
- 版本要求：插件需要 DSH 版本
0.1.7或更高版本。设置入口位于新版插件页，旧版设置入口已移除。 - 路由限制：新会话首轮自动起名功能仅在非官方 DeepSeek 模型路由（
provider非deepseek-official）下生效。官方路由下已有内置起名机制，插件不会重复调用。 - 移动端操作：在移动端删除归档会话时，必须使用左滑手势操作。
- 重启机制：对于常驻激活的会话（例如在 DSH 进程中被打开过的会话），拖拽移动后可能需要重启 DSH 才能完成实际的文件流转。
结尾¶
dsh-session-xc 通过引入统计、归档、移动和筛选等机制，显著提升了 DSH 在多工作区场景下的管理效率。对于需要精细化管理会话的开发者或用户而言，这是一个实用的增强工具。
