在本地使用 DeepSeek Harness (DSH) 时，对话记录保存在磁盘文件中。如果需要备份、分享或迁移这些历史记录，手动整理较为繁琐。下面介绍 dsh-session-export 插件，它提供了一套标准的命令来列出本地会话并将任意会话导出为 Markdown 或 JSON 格式。
功能说明¶
该插件提供两个核心工具命令：
-
session_list
列出本地所有会话。返回结果包含会话的标题、ID、工作目录、创建时间以及大小。支持通过关键字进行过滤。 -
session_export
导出指定会话。输出格式支持 Markdown（包含用户/助手消息、工具调用与结果、推理过程）或 JSON（结构化数据）。支持直接指定输出路径，若不指定则默认返回全文。
数据存储与依赖
- 会话数据来源于 $DSH_HOME/sessions（默认路径为 ~/.dsh/sessions）。
- 插件支持导出 zstd 压缩的日志（.l.zstd）与明文日志（.l）。
- 标题自动读取 DSH 的 session/title 记录，若无标题则回退至首条用户消息。
- 依赖为 peer-only，随 DSH 宿主加载，无需额外安装运行时。
安装与启用¶
在终端中执行以下命令，将插件安装到指定的 profile 中：
dsh plugin --profile web add dsh-session-export
安装完成后，插件会自动加入 profile 的 dsh.profile.bundles 配置。执行安装命令后，需要重启或重载 DSH 配置才能使新工具生效。
典型用法¶
安装生效后，可以通过自然语言指令或直接调用命令行工具来操作。
-
列出所有本地会话：
调用session_list命令。 -
导出会话为 Markdown 并保存到文件：
调用session_export命令，指定会话 ID 和输出路径。 -
导出会话为 JSON 格式：
调用session_export，并设置format=json参数。
适用场景与注意¶
适用场景
- 备份：定期导出本地会话，防止数据意外丢失。
- 分享与复盘：将导出的 Markdown 文档用于文档分享或复盘分析。
- 结构化迁移：通过 JSON 导出数据，便于进行二次处理或录入知识库。
注意事项
- 插件为纯 Node 实现，零第三方运行时依赖。
- 插件以 DSH 宿主的权限运行，涉及本地文件系统访问，请确保源码安全。
- 本插件为 MIT 许可证开源项目。
总结¶
dsh-session-export 为 DSH 用户提供了标准化的会话导出能力。通过 session_list 和 session_export 两个工具，可以方便地将本地对话历史转化为 Markdown 或 JSON 格式，满足备份、分享和迁移的需求。
