前言¶
DSH Web 长期使用后，会话记录会越攒越多。官方入口通常可以做归档，但归档更多是把会话从侧边栏隐藏；已经归档的会话如果缺少恢复入口，后续查找会比较麻烦；导出会话时，如果只能逐个操作，历史记录一多就很耗时。
dsh-session-management 是 DeepSeek Harness（DSH）Web 的会话管理插件，由 cokiscarazo-rgb 维护，许可证为 MIT。它主要用于补足 DSH Web 官方会话管理的缺失能力，让归档、取消归档、真正删除本地聊天记录和批量导出会话数据可以在「设置」面板里集中完成。
这是什么¶
dsh-session-management 通过 DSH 插件机制挂载到 web profile 下。安装并重启 dsh web 后，会在「设置」里提供「会话管理」入口。
它主要解决三类问题：
- 会话归档后还能恢复；
- 本地会话记录可以真正删除；
- 会话数据可以批量导出。
核心功能¶
归档与取消归档¶
插件支持归档会话，并支持一键全量归档。归档后，会话记录仍然保留，只是从侧边栏列表中隐藏。
与单纯归档不同，插件也提供取消归档能力，支持：
- 单个会话取消归档；
- 按工作区批量取消归档；
- 按月份批量取消归档。
真正删除本地聊天记录¶
插件提供删除本地聊天记录的能力，会删除磁盘上的会话日志文件：
session.jsonl
session.jsonl.zstd
以及对偶文件。
执行“删除所有聊天”时，运行中的会话会自动跳过，避免会话仍在活跃状态下日志被重新写回。
批量导出会话数据¶
插件支持一键批量导出会话数据，会逐个生成与官方格式一致的 ZIP 归档：
dsh-session-<id>.zip
这适合在删除前做备份，也适合把历史会话整理后迁移到其他位置。
查看已归档聊天¶
打开管理窗口后，可以按工作区或月份分组查看已归档聊天。
支持以下操作：
- 按创建日期排序，可升序或降序；
- 按更新日期排序，可升序或降序；
- 分组折叠与一键展开；
- 按组批量取消归档；
- 按组批量删除该组已归档的聊天。
界面语言¶
插件界面为中英双语，并随 DSH 的语言设置即时切换。
安装与启用¶
前置要求¶
- Node.js，含 npm；
dsh plugin依赖 pnpm。
DSH 插件通过 profile 挂载，dsh web 对应 web profile。安装完成后，需要重启 dsh web 才能看到新入口。
全局安装 dsh 时¶
如果本机已经可以直接使用 dsh 命令，执行：
dsh plugin --profile web add dsh-session-management
通过 npx 运行 dsh 时¶
如果平时通过 npx @deepseek-ai/dsh 启动 DSH，执行：
npx -y @deepseek-ai/dsh plugin --profile web add dsh-session-management
安装完成后，重启：
dsh web
打开「设置」，看到「会话管理」入口，说明插件已生效。
版本问题¶
如果安装后仍提示旧版本相关问题，例如出现 declares no dsh.bundle，可以先查询 npm 上该包的最新版本号，再显式指定版本重装。全局安装 DSH 时可以用类似命令：
dsh plugin --profile web add dsh-session-management@<版本号>
通过 npx 运行 DSH 时，在前面加上 npx 前缀：
npx -y @deepseek-ai/dsh plugin --profile web add dsh-session-management@<版本号>
卸载¶
执行：
dsh plugin --profile web remove dsh-session-management
然后重启 dsh web。
典型用法¶
下面是一组常见的操作顺序。
1、安装插件并重启 dsh web。
2、打开「设置」，进入「会话管理」。
3、点击「管理」，打开已归档聊天管理窗口。
4、选择查看方式：
- 按工作区查看，适合多个工作区并存的情况；
- 按月份查看，适合按时间整理历史会话。
5、如果只是想先隐藏会话，可以使用一键归档全部会话。记录会保留，只是从侧边栏列表中隐藏。
6、如果需要清理本地记录，可以先执行「导出数据」，生成与官方格式一致的 ZIP 归档。
7、确认备份完成后，再执行「删除所有聊天」。运行中的会话会被跳过。
8、如果之前误归档，或只想处理某一组会话，可以在管理窗口里按组批量取消归档，或删除该组已归档的聊天。
适用场景与注意¶
适合以下使用场景：
- 长期使用 DSH Web，会话数量较多；
- 归档后仍需要恢复会话；
- 需要真正删除本地聊天记录；
- 需要批量导出会话数据；
- 希望按工作区或月份管理历史会话。
使用前注意：
- 插件以当前
dsh进程权限运行，安装前应检查源码与许可证； - 删除操作会移除本地会话日志文件，执行前建议先导出数据；
- 运行中的会话会被跳过，不能直接删除；
- 删除父会话不会级联删除子代理会话，子代理会话是独立记录，可以单独删除；
- 聊天中的图片附件采用 content-addressed 存储，可能被多个会话共享，删除会话不会连带删除附件。
链接¶
社区目录：
https://www.skillhub.cn/plugins/cokiscarazo-rgb/dsh-session-management
GitHub：
