dsh-export-kit

DeepSeek Harness 对话导出套件：一键导出对话为 Markdown / TXT / JSON / CSV / PNG 长图 / PDF，支持公式复制（LaTeX 与 Word 兼容 MathML）与设置备份、全会话归档。零侵入 bundle 插件，无需修改 Harness 源码。

• 版本：v0.1.1 ｜ 许可证：MIT ｜ 文档：English

---

功能

对话导出（6 种格式）

格式	说明
Markdown	保留原始 Markdown 结构与公式定界符
TXT	纯文本，去除 Markdown 标记
JSON	结构化轮次数据，便于程序处理
CSV	表格格式，含 BOM，兼容 Excel / WPS
PNG	长图导出：主题色头部 + 图文排版 + 公式光栅化
PDF	基于浏览器打印的「另存为 PDF」，正文可选中、可搜索、自动分页

导出弹窗支持：

• 范围：全部（自动分页加载完整历史）或仅当前可见内容
• 时间戳：可选是否包含每轮时间
• 主题：轻色 / 深色 / 跟随系统（PNG、PDF 生效）
• 进度与取消：长会话导出可随时取消

公式复制

点击对话中的任意公式，弹出菜单即可复制多种格式：

• $ LaTeX $ / $$ LaTeX $$ / \( LaTeX \) / \[ LaTeX \]
• equation / align / display 环境模板
• MathML（通用）与 Word MathML（mml: 命名空间前缀，可直接粘贴至 Word）

公式源码按 data-math → annotation[encoding=application/x-tex] → .katex-mathml → data-latex 四级提取，兼容 DSH 原生公式渲染。

备份与归档

• 设置备份 / 恢复：一键导出本插件全部偏好为 JSON 文件，可随时恢复
• 全会话归档：遍历全部会话，逐个采集为单个 JSON 归档文件

安装

# 安装到 web profile（安装完成后需重启 dsh 生效）
dsh plugin --profile web add /data/dsh-workspace/dsh-export-kit

# 升级（重新执行安装命令即可覆盖）
dsh plugin --profile web add /data/dsh-workspace/dsh-export-kit

# 卸载
dsh plugin --profile web remove dsh-export-kit

使用

1. 打开任意对话，右上角标题栏出现 导出 按钮
2. 点击后在弹窗中选择格式 / 范围 / 时间戳 / 主题，开始导出
3. 设置 → 导出设置：调整默认格式、默认公式复制格式、主题与时间戳偏好，以及备份 / 归档入口

PDF 说明：PDF 通过浏览器打印功能实现——点击导出后会在打印对话框中选择「另存为 PDF」，而非直接生成文件。

设置项

设置	说明
默认导出格式	打开导出弹窗时默认选中的格式
公式复制格式	点击公式时菜单中置顶的格式
包含时间戳	导出默认是否带时间
导出主题	PNG / PDF 默认配色（自动跟随系统）

数据与隐私

• 所有导出均在浏览器本地完成，不上传任何内容
• 全会话归档仅在会话已加载时采集其内容，未打开的会话在归档文件中标记为 skipped

开发

cd dsh-export-kit
npm install
npm run build   # 构建 client bundle（lib/client.js）+ host 半（lib/index.js）+ 类型产物（lib/types/）
npm test        # 运行单元测试
npm run typecheck

变更

• 版本变更见 CHANGELOG.md
• 许可：LICENSE (MIT)