dsh-session-export · DSH 会话导出/备份工具

把 DeepSeek Harness（DSH）本地保存的会话一键导出为 Markdown / JSON，用于备份、分享、整理与迁移。 Session export & backup tool for DeepSeek Harness (dsh) — list local sessions and export any of them to Markdown or JSON, with full chat turns, tool calls and results.

支持 zstd 压缩（.jsonl.zstd，DSH 默认存储格式）与明文（.jsonl）两种会话日志。纯 Node 实现，零第三方运行时依赖。

功能 Features

• 支持 outPath 直接写文件，默认返回全文
• peer-only 依赖（随 DSH 宿主加载，无需额外安装）
• 标题自动取自 DSH 的 session/title 记录，无标题时回退到首条用户消息

安装 Install

dsh plugin --profile web add dsh-session-export
# 或任意 profile：dsh plugin --profile <name> add dsh-session-export

安装后自动加入 profile 的 dsh.profile.bundles，重启/重载即可使用。

使用 Usage（agent 工具）

• 「列出我所有的会话」→ 调用 session_list
• 「把会话 导出成 Markdown 存到 ./backup.md」→ 调用 session_export
• 「把这个会话导出为 JSON 给我看」→ session_export format=json

English: "List all my sessions" → session_list; "Export session to Markdown at ./backup.md" → session_export.

会话数据来自 $DSH_HOME/sessions（默认 ~/.dsh/sessions）。

为什么选它 Why

• 备份防丢失：对话历史本地落盘，随时导出归档
• 分享与复盘：导出 Markdown 可直接发文档、贴博客
• 结构化迁移：JSON 导出便于摘要、统计、知识库入库

配套插件 Companion plugins

• dsh-session-search — 跨会话全文搜索
• dsh-context-dashboard — 会话上下文/Token 统计

License

MIT © istone