前言¶
在 DeepSeek Harness 里跑智能体时,会话归档后容易从侧栏消失。想回看某段工具输出、检索一条历史消息、恢复旧版本,或者安全清理占用的本地空间,通常需要额外手段。
dsh-archived-chats 把“归档后会话管理”做成一个本地优先的 DSH 插件,提供浏览、搜索、预览、历史版本、备份恢复、回收站和保留策略。
这是什么¶
dsh-archived-chats 是面向 DeepSeek Harness 的 local-first archived-chat center,由 Ultronen 维护,MIT 许可。
它解决的不是实时对话问题,而是会话离开主界面之后的问题:按工作区查找归档会话,检查消息、工具结果和已存储内容,管理本地历史版本,导出或导入备份,并在删除时保留可恢复路径。
核心功能¶
- 按工作区浏览归档会话,并支持对消息和工具结果做全文搜索。
- 原生只读预览 Markdown、reasoning、tool activity、JSON、代码和已存储图片。
- 提供 Local History,可查看归档后生成的已验证版本,并支持 Restore as copy。
- 支持 JSON + Markdown ZIP 导出,以及 conflict-safe import。
- 提供 Recycle Bin,支持撤销、两级恢复和经确认的 permanent purge。
- 提供存储统计与保留策略;保留策略与执行分离,清理前先做短预览并显式选择。
- 提供 Origins & Branches,用于查看 fork 和 subagent 树的只读关系。
安装与启用¶
1、新增安装:
dsh plugin --profile web add dsh-archived-chats@latest
2、启用插件:
重启 DSH 一次,然后打开 Settings → Session Archive。
3、更新已有安装:
dsh plugin --profile web update dsh-archived-chats
插件数据保存在本地目录:
$DSH_HOME/plugin-data/archived-chats/
插件元数据、回收站记录、策略和已验证快照都放在该目录下,没有上传或云同步。
典型用法¶
- 查看归档会话:在 Session Archive 中按工作区浏览,再用全文搜索定位消息或工具结果。
- 恢复旧版本:在 History 中预览已验证快照,选择 Restore as copy。导入和恢复会创建或选择非冲突 ID,不替换已有会话。
- 备份与迁移:导出 JSON + Markdown ZIP。导出包含完整会话 JSON 和可读 Markdown,不包含附件字节或 descendant sessions。
- 删除会话:普通删除先进入 Recycle Bin,并带有快照保护;需要彻底删除时,单独执行 permanent purge。
- 降级前备份:如果降级到不显示 History 或不理解 recycle snapshots 的版本,先备份:
$DSH_HOME/plugin-data/archived-chats/
适用场景与注意¶
适合经常归档 DSH 会话、需要在本地查找历史消息、工具结果、代码、JSON 或图片,并希望删除可恢复、导出范围可核对的人。
注意:
- 插件以当前 dsh 进程权限运行,文件访问边界取决于本机 DSH 环境和 Host 能力。
- 如果 Host 缺少写入能力,相关操作会返回
restore-unsupported,不会写入或覆盖数据。 - 安装前建议检查源码、许可证和数据路径;本插件声明为 MIT 许可。
- 导出 ZIP 的范围不包括附件字节和 descendant sessions,重要附件需另行保留。
- 社区目录是独立插件目录,不等同于官方应用商店。
链接¶
- 社区目录:https://awesome-dsh-plugin.com/p/Ultronen/dsh-archived-chats/
- GitHub:https://github.com/Ultronen/dsh-archived-chats