DDDMUC/dsh-chat-export

dsh-chat-export

DeepSeek Harness 会话可读导出 —— 把任意会话导出成可读的 Markdown / HTML / ZIP 文字稿。 官方 @deepseek-ai/dsh-session-log-export 只给你一份原始日志（session.v3.jsonl.zstd，二进制、多帧 zstd、events v3），人读不了；这个插件补上缺的那一半：会话头部菜单「导出文字稿」+ /export-md 命令，产出带标题、模型、用量、时间戳、思考块、工具调用与结果、代码块和图片的文字稿，HTML 还能直接打印成 PDF。

中文 · English

中文

▲ 会话头部：自己的「导出文字稿」按钮，紧挨官方的 ⋯ 菜单

为什么需要它

官方会话导出给你的是 dsh-session-.zip → session.v3.jsonl.zstd：一坨多帧 Zstandard 压缩的 JSONL。它能喂给工具，但不能读——想知道「当时到底聊了什么、模型调了哪些工具、那张图长什么样」，得自己写解析器。

这个插件把同一份会话日志渲染成人能读的文字稿，并且不改写任何内容：只读日志，原文照搬。

特性

- 两种入口 —— 会话头部「导出文字稿」按钮，或 /export-md 斜杠命令（避开官方的 /export）；命令解析出的选项会带进对话框，两边永远不会打架
- 四种格式 —— Markdown、HTML（单文件、自包含样式、可打印成 PDF）、纯文本（无任何标记，终端/记事本都能读）、ZIP（md + html + txt + 图片素材 + meta.json）
- 内容齐全 —— 用户/助手消息、思考块（可折叠）、工具调用与结果（可折叠、超长自动截断并标注）、代码块（围栏长度自适应，正文里的 - 导出前可预览 —— 对话框里点「预览开头」直接看 Markdown 开头
- 两种落盘方式 —— 浏览器下载，或写进指定目录（走官方 ctx.fs，受会话沙箱约束）
- 范围可选 —— 「完整日志」按发生顺序导出全部内容（含后来被压缩或删除的历史）；「仅当前上下文」只导出模型现在还能看到的部分
- 附件按内容去重 —— 同一张图在会话里出现多次，只存一份
- 没有装饰性图标 —— 产物里只有文字（用户 / 助手 /  bash · 54ms · 结果 43 行 ），不把 emoji 塞进你的档案件
- 中英双语界面 —— 跟随 DSH 界面语言（zh / en）
- 零运行时依赖 —— 不 import 任何 @deepseek-ai/，commands / connection / fs / sessionPersistence / sessionQuery / attachments 全部在调用时通过 cordis 上下文获取；ZIP 写入器自研（node:zlib 的 raw deflate），PDF 走浏览器打印
- 不用重启也能改浏览器半 —— 浏览器半是纯 ESM 源码，client-hmr 会热替换

安装

npm（推荐）：
sh
dsh plugin --profile web add dsh-chat-export

或从 GitHub 仓库直接安装：
sh
dsh plugin --profile web add github:DDDMUC/dsh-chat-export

本地开发（改代码即时生效）：
sh
dsh plugin --profile web add link:/绝对路径/dsh-chat-export

装完重启 dsh web（宿主半的新插件行要重启才加载；之后改浏览器半不用）。

使用

方式一：会话头部按钮

1. 打开一个会话，点头部的「导出文字稿」
2. 选格式、范围、图片策略，按需要打开思考块 / 系统提示 / 注入内容 / 时间戳 / 用量
3. 「浏览器下载」直接存文件；「保存到目录」填一个路径则写进磁盘
4. 想先看看效果就点「预览开头」

方式二：斜杠命令

/export-md                           # Markdown，默认选项
/export-md html                      # 自包含 HTML，可打印成 PDF
/export-md txt                       # 纯文本，无任何标记
/export-md zip --images=embed        # 打包，图片内嵌
/export-md md --thinking --surface   # 带思考块，只导当前上下文
/export-md html --save=/tmp/导出     # 直接写进目录

命令只解析参数，真正的导出在对话框里确认——所以敲错参数会当场报错并给出用法，不会悄悄导出一份你以为不一样的东西。

参数一览

| 参数 | 作用 |
| --- | --- |
| md / markdown | Markdown（默认） |
| html | 自包含 HTML |
| txt / text / plain | 纯文本（不带任何标记） |
| zip | 打包（内含 md + html + txt + 图片 + meta.json） |
| --thinking / --no-thinking | 思考块（默认关） |
| --tools / --no-tools | 工具调用与结果（默认开） |
| --system / --no-system | 系统提示词（默认关） |
| --injected / --no-injected | 注入内容，如插件/目标/指令注入的用户消息（默认关） |
| --timestamps / --no-timestamps | 每条消息的时间戳（默认开） |
| --usage / --no-usage | 表头的用量统计（默认开） |
| --surface / --no-surface | --surface 只导当前模型上下文；默认完整日志 |
| --images=auto\|embed\|assets\|none | 图片策略；auto 表示单文件内嵌、ZIP 放 assets/ |
| --limit=N | 单条工具结果的字符上限（默认 4000，0 表示不截断） |
| --save[=目录] | 写进目录而不是下载；不填目录则用会话工作目录下的 dsh-chat-exports/ |

产物长什么样

Markdown：
markdown
AI 写作智能体项目概览

由 dsh-chat-export 从 DeepSeek Harness 会话导出

session-5e6c2afd-… · /Users/337mu/Documents/Default Project

| 项 | 内容 |
| --- | --- |
| 模型 | deepseek-official/deepseek-flash · commandcode/… |
| 时间 | 2026-09-21 00:38:16 → 2026-09-21 23:52:12（23h 13m） |
| 规模 | 116 轮 · 989 步 · 用户 89 条 · 助手 908 条 · 876 次工具调用 · 图片 16 张 |
| 用量 | 输入 1,107,646 · 输出 1,321,824 · 缓存读 310,001,920 · 合计 312,431,390 |

回合 1 · 27.8s

用户 · 00:38:25

任务正文……

助手 · 00:38:28 · deepseek-official/deepseek-flash

正文……

思考（312 字）

思考正文……

bash · 1.2s · 结果 42 行

参数

{ "command": "ls -la" }

结果

输出……

shot.png

一次工具调用 = 一行，产物里没有任何装饰性图标。 参数和结果都收在同一个折叠里，默认展开的只有「谁在什么时候说了什么」。876 次工具调用的长会话，肉眼可见的就是 876 行 ▶ \名字\ · 耗时 · 结果 N 行，需要哪次再点开。

纯文本（txt，注意没有任何标记、图标、代码围栏，全靠分隔线和缩进）：
text
想办法让我用上jev模型
========================================================================

session-48310605-bb1a-4966-a207-380f947e220b
/Users/337mu/Documents/Default Project

模型  commandcode/deepseek/deepseek-v4.1-flash
时间  2026-09-21 21:51:26 → 2026-09-21 22:47:16（55m 50s）
规模  1 轮 · 52 步 · 用户 1 条 · 助手 31 条 · 85 次工具调用
用量  输入 78,004 · 输出 52,120 · 缓存读 4,302,080 · 合计 4,432,204

由 dsh-chat-export 从 DeepSeek Harness 会话导出

回合 1 · 42m 00s

用户 · 21:51:45
想办法让我用上jev模型

助手 · 21:51:51 · commandcode/deepseek/deepseek-v4.1-flash
我先搞清楚 "jev 模型" 指的是什么，同时看一下 DSH 的模型/提供商配置。

[工具] bash · 54ms · 结果 43 行
参数  {
"command": "pwd; echo \"--- workspace ---\"; ls -la"
}
结果  /Users/337mu/Documents/Default Project
--- workspace ---
total 1960

正文原样照搬（连 Markdown 标记一起）—— 宁愿保留几个星号，也不悄悄改你说过的话。

文件名：dsh-chat--.（标题里的路径分隔符与控制字符会被中和，中日韩字符保留）。

▲ 导出对话框：格式 / 范围 / 图片 / 内容 / 输出

它是怎么工作的

- 数据全部走官方服务：ctx.sessionPersistence.open(id, 'read') 读会话日志（和官方 ZIP 用的是同一个入口，自带多帧 zstd 解码、格式迁移、断尾修复），标题走 ctx.sessionQuery.readTitle，图片字节走 ctx.attachments.readImage。降级链：sessionPersistence → sessionQuery.readSession → readSurface，全都没有才报 503。
- 导出在宿主端做，不在浏览器里做：浏览器拿到的原始事件只是一个分页窗口（要靠 loadOlder() 一页页翻到 hasMore 为 false），而且没有附件字节。宿主端一把拿全。
- HTTP 走 ctx.connection.fetch：挂在 /api/dsh-chat-export. 下，白拿连接服务的鉴权与 Host/Origin 围栏（未登录 401，跨源 403）。不用 webServer.register：它的 exact 路由会盖掉 /api 桥接并绕过鉴权。
- ZIP 是自己写的：条目少、结构平，用 node:zlib 的 raw deflate 加本地头 + 中央目录 + EOCD 就够了，不值得为它引一个依赖。
- PDF 不引依赖：HTML 自带 @media print 样式和「打印 / 另存为 PDF」按钮，用浏览器打印。无头 Chrome 那条路要拖进 puppeteer，不成比例。

三个从真实日志里挖出来的坑，插件都处理了（写成注释留在代码里）：

1. session.v3.jsonl.zstd 是多帧串联（9.6 MB 的样本有 39,968 帧）。zstdDecompressSync(整文件) 会静默只返回第一帧；createZstdDecompress() 解完第一帧就抛 ZSTD_error_prefix_unknown。所以要么走持久化服务，要么逐帧扫边界。
2. agent/inbox/spliced 的 data.inserted[] 里可能有只此一份的用户消息（样本里 170 条里有 6 条在 user/message 里找不到）。必须按 message id 去重合并，否则漏话。
3. user/message 上没有 turn/step 字段，轮次只能靠 turn/start 边界推。

已知限制

- 「保存到目录」只支持 Markdown 和 HTML。 宿主的 ctx.fs 只有文本写入、没有二进制写入；绕过它直接用 node:fs 会无视会话的沙箱策略。ZIP 请用浏览器下载（对话框里选 ZIP 时保存按钮会禁用并说明原因）。
- 不导出子会话（subagent）。 v0.1.0 只导当前会话；子会话递归打包留给后续版本（官方 ZIP 的 includeDescendants 是那块功能）。
- 纯文本里的图片只能给描述（[图片] shot.png（640×480, 2.0 KiB）），txt 装不下二进制。
- PDF 是浏览器打印出来的，不是插件生成的。 产物是 HTML，点「打印 / 另存为 PDF」由浏览器负责排版。
- 用量数字来自 assistant/message.data.usage。 官方日志里没有费用字段，所以只能给 token，给不了钱；推理 一栏在不上报该字段的 provider 上是 0。
- 正文会被做两处「不影响观感」的规整（否则一份带 # 标题 的提问会把整份文字稿的目录结构顶掉）：
1. 正文里的 Markdown 标题整体下沉到 4–6 级，让「回合 / 消息」始终是文档骨架（代码块里的 # 不动）；
2. 正文里出现的  /  会被反斜杠转义成字面量，免得对话里随口一句就把后面半篇内容折叠进去（转义后显示效果完全一样，还是那几个字符）。
其余文字一字不改，代码块内容原样保留。

兼容性

- DSH >=0.1.6-alpha.2
- Node >=22（用到 node:zlib 的 Zstandard 支持）

License

MIT © 2026 DDDMUC

English

▲ Session header: its own "Export transcript" button, next to the official ⋯ menu

Why

The official Session export hands you dsh-session-.zip containing session.v3.jsonl.zstd: multi-frame Zstandard-compressed JSONL. Great for tools, unreadable for humans. This plugin renders the same log as a transcript a person can actually read, and never rewrites a byte of it.

Features

- Two entry points — a labelled "Export transcript" button in the Session header, or the /export-md command (which avoids the official /export). A typed line presets the dialog, so the two can never disagree.
- Four formats — Markdown, self-contained HTML (printable to PDF), plain text (no markers at all; readable in any terminal), and a ZIP bundle (transcript.md + transcript.html + transcript.txt + assets/ + meta.json).
- 完整内容 — 用户与助手消息、可折叠的推理块、可折叠的工具调用与结果（带截断标记）、不会被正文破坏的代码围栏、图片附件、时间戳，以及会话标题、模型和用量。
- 一次工具调用占一行。 参数和结果共用一个折叠的展开区域，因此默认情况下你看到的是谁在何时说了什么；只有需要时才展开某次调用。
- 导出前可预览，并且有两种输出：浏览器下载，或通过宿主文件系统写入某个目录。
- 范围可选 — 按顺序导出完整日志，或仅导出模型仍能看到的内容。
- 附件去重、双语界面（中/英），以及零运行时依赖：不导入任何 @deepseek-ai/、手写 ZIP 写入器，PDF 则通过浏览器自带的打印对话框生成。

安装
sh
dsh plugin --profile web add dsh-chat-export

之后重启 dsh web。编辑浏览器端部分时无需重启。

用法

在会话标题栏点击“导出文字稿”（Export transcript），或输入：

/export-md                           # 使用默认选项导出 Markdown
/export-md html                      # 自包含 HTML，可打印为 PDF
/export-md zip --images=embed        # 打包为 ZIP，并内嵌图片
/export-md md --thinking --surface   # 开启推理，仅导出当前上下文
/export-md html --save=/tmp/exports  # 直接写入某个目录

标志：--thinking、--no-tools、--system、--injected、--timestamps、--no-usage、--surface、--images=auto|embed|assets|none、--limit=N、--save[=dir]。

工作原理

所有内容都通过官方服务（sessionPersistence、sessionQuery、attachments）读取，这些服务在调用时从 cordis 上下文解析；导出是在宿主端生成的，而不是在浏览器中——浏览器始终只持有一个分页的事件日志窗口，并且没有附件字节。路由位于 /api/dsh-chat-export. 下，通过 ctx.connection.fetch 访问，因此它们会继承连接服务的身份验证及其主机/来源防护。

已知限制

- 保存到目录仅支持 Markdown 和 HTML；宿主的 ctx.fs 没有二进制写入能力，而绕过它使用 node:fs 会忽略会话沙箱。请改为下载 ZIP。
- v0.1.0 不包含子会话（subagent）导出。
- PDF 由浏览器的打印对话框生成，并非由插件生成。
- 用量仅为 token 计数 — 会话日志不包含费用字段。
- 消息文本不做 Markdown 转义（因为它就是对话本身）；HTML 渲染器在添加自己的标记之前会先进行转义，因此会话无法向导出内容中注入 HTML。

兼容性

- DSH >=0.1.6-alpha.2
- Node >=22

许可证

MIT © 2026 DDDMUC