前言¶
DeepSeek Harness (DSH) Web 端提供了官方的 Session Log 导出功能，主要用于调试、恢复和重放会话。但在需要阅读对话内容、进行 AI 交接或整理文档时，原始的日志格式不够直观。dsh-conversation-exporter 插件为 DSH Web 添加了本地导出功能，能够将对话以整洁的 Markdown 格式输出到本地。
它是什么¶
dsh-conversation-exporter 是一个由 liuyuelintop 维护的客户端插件，遵循 MIT 协议。它的核心作用是在 DSH Web 界面中新增导出动作，不依赖任何云端服务，仅通过本地 DSH 运行时读取当前会话数据并生成 Markdown 文件。
核心功能¶
- 全量导出：一键下载当前整个会话，生成可读的 Markdown 文件。
- 选择性导出：支持按“轮次”筛选。一次导出包含一条用户消息及其对应的最终助手回复。
- 本地处理：所有处理均在本地完成，不上传、不存储云端、无遥测数据。
- 保留富文本格式：支持保留 Mermaid 流程图等富 Markdown 格式。
安装与启用¶
在终端中运行以下命令，将插件添加到 DSH 的 web 配置文件中：
npx @deepseek-ai/dsh plugin --profile web add dsh-conversation-exporter@latest
添加后，需停止并重新启动 DSH Web 进程以使配置生效：
npx @deepseek-ai/dsh web
典型用法¶
- 打开 DSH Web 中的任意一个会话。
- 点击界面上的 Export Chat 按钮，即可下载当前会话的完整 Markdown 文件。
- 若需筛选内容，点击 Select turns…。此时所有轮次默认选中。
- 使用 Select all 或 Clear 调整选中状态。
- 点击 Export selected turns 进行导出。
- 浏览器将下载一个文件，文件名为
<会话标题>--<短会话ID>.md，例如Project-Architecture-Guide--2002da4d.md。
导出的 Markdown 文件中：
* 会话标题作为一级标题（H1）。
* 消息使用引用块标记，Human 和 Assistant 分别标记为 > Human 和 > Assistant。
* 如果某条消息在代码块中间结束，导出器会自动闭合该代码块。
* 未完成的回复会标记为 > Response incomplete.。
* 仅包含图片的消息会显示为 [Image omitted]。
适用场景与注意¶
- 适用场景：适合需要将对话内容整理为文档、进行 AI 交接、或作为非调试用途的会话存档。
- 重要说明：
- Session Log 的区别：本插件生成的 Markdown 侧重于可读性和人工阅读，不包含原始事件、工具调用、中间响应、注入上下文、子代理日志等调试信息。这些数据仅在官方 Session Log 中提供。
- 轮次限制：只能按“整轮”导出，无法单独选中 Human 或 Assistant 的气泡。
- 隐私与权限：导出完全本地化，没有上传路径。插件读取的是当前 DSH 进程权限范围内的会话数据。
- 版本兼容性：DSH 目前处于开发者预览阶段，插件 API 可能会发生变化。V0.3 版本适配
@deepseek-ai/dsh@0.1.0-rc.6。
总结¶
dsh-conversation-exporter 解决了 DSH 会话在非调试场景下的“可读性”问题。如果你需要将对话转化为 Markdown 文档，它是比 Session Log 更轻量、更直观的选择。
- 插件目录：dsh-conversation-exporter
- 源码地址：GitHub
