前言¶
DeepSeek Harness（DSH）采用“一切皆插件”的架构。随着使用时间增长，会话数据会不断积累，手动筛选和管理变得低效。这个插件提供了一套结构化的会话管理方案，旨在解决会话堆积带来的查找困难问题。
插件简介¶
dsh-session-manager 是由 duo-stack 维护的 DSH 客户端插件。它将现有的会话列表按工作区进行分组展示，并提供归档、取消归档、删除以及批量清理归档会话的能力，不改变宿主原有的行为逻辑。
安装与启用¶
通过官方 CLI 将插件安装到指定的 profile 中：
dsh plugin --profile <profile> add @duo-stack/dsh-session-manager
安装完成后，使用该 profile 启动 DSH 即可加载插件。
使用方法¶
启动 DSH 并打开 设置，左侧导航栏会出现名为 「会话管理」 的分区，这是插件的唯一界面入口。
- 未归档页签：显示当前未归档的会话。在此页签中，可以对单个会话进行 归档 或 删除 操作。
- 归档页签：显示已归档的会话。在此页签中，可以将会话 取消归档、删除，或者按工作区/全部进行 批量删除。
功能细节¶
- 按工作区分组展示：会话列表以工作区为单位分组，每个工作区对应一张卡片。
- 实时刷新与无需重启：所有操作（归档、取消归档、删除）通过 registry 机制同步更新内存态与磁盘，触发
domain/changed事件，左栏会话列表及页面即时刷新。 - 自动清理幽灵会话：插件启动时会自动清理因早期删除失败而残留的“有记账、无目录”的幽灵会话，只列出磁盘上仍有内容目录的会话。
- 双页签设计：界面分为「未归档」与「归档」两个页签，操作逻辑清晰。
注意事项¶
- 数据修改风险：归档、取消归档、删除操作会直接修改真实会话数据，请务必在测试环境中确认操作逻辑后再在生产环境使用。
- 构建限制：该插件的客户端 bundle 不能使用 DSH 官方 preset 构建，项目采用手动复刻官方懒加载工厂格式的方案。
