前言¶
DeepSeek Harness 官方提供会话导出功能，产出的是原始日志（如 session.v3.jsonl.zstd），这是二进制、多帧 Zstandard 压缩的 JSONL 数据，人无法直接阅读。dsh-chat-export 补上缺的那一半：将同一份会话日志渲染为人能读的文字稿。
该插件提供两种入口：会话头部的分享图标按钮（悬停显示“导出文字稿”）和 /export-md 斜杠命令。
安装¶
在终端执行：
dsh plugin --profile web add dsh-chat-export
安装后需重启 dsh web 宿主进程才能加载新插件。
入口与基础用法¶
方式一：会话头部按钮¶
打开一个会话，点头部的“导出文字稿”按钮。在弹出的对话框中，可以选择格式、范围、图片策略以及是否导出思考块、工具调用等信息。对话框提供“预览开头”功能，可在确认前查看 Markdown 开头效果。确认后可选择“浏览器下载”或“保存到目录”。
方式二：斜杠命令¶
在对话框中直接输入命令。默认生成 Markdown 格式。
/export-md
命令参数详解¶
命令支持多种格式和选项，参数会带进对话框进行确认。
格式¶
md/markdown：Markdown 格式（默认）。html：自包含 HTML，可打印成 PDF。txt/text/plain：纯文本，无任何标记。zip：打包文件，包含 md + html + txt + 图片 +meta.json。
常用选项¶
--thinking/--no-thinking：是否包含思考块（默认开）。--images=auto|embed|assets|none：图片策略。auto表示单文件内嵌、ZIP 放assets/。--save[=目录]：保存到目录而不是下载。不填目录则用会话工作目录下的dsh-chat-exports/。--surface：只导当前模型上下文（默认完整日志）。
功能特性¶
- 范围可选：支持“完整日志”和“仅当前上下文”两种范围。
- 附件去重：会话中重复出现的图片附件只存储一份。
- 中英双语：界面跟随 DSH 语言设置。
- 零运行时依赖：不引入任何
@deepseek-ai/*依赖，通过 cordis 上下文获取服务。 - 支持热替换：浏览器端代码支持 HMR，修改后无需刷新页面。
- 导出前预览：对话框内可直接预览导出内容的开头。
产出格式与限制¶
产出内容¶
导出的文字稿包含用户/助手消息、思考块（可折叠）、工具调用与结果（可折叠、超长自动截断）、代码块、图片、时间戳、会话标题、模型信息及用量统计。
已知限制¶
- 保存目录限制：“保存到目录”仅支持 Markdown、HTML 和纯文本，不支持 ZIP（因
ctx.fs不支持二进制写入）。 - 不导出子会话：不包含 subagent 子会话内容。
- 纯文本图片：纯文本中的图片仅显示描述。
- PDF 生成：PDF 由浏览器打印生成，非插件生成。
- 费用信息：用量数据来自日志，无法提供费用信息。
- 排版处理：
- 正文 Markdown 标题会整体下沉至 4-6 级，以保持“回合/消息”为文档骨架。
- 正文中的
<details>会被转义为字面量，防止对话内容意外折叠。
总结¶
dsh-chat-export 解决了官方原始日志难以阅读的问题，通过渲染工具和命令，让开发者能快速导出可读的文字稿进行归档或复盘。
