dsh-session-export

dsh plugin --profile web add dsh-session-export

dsh-session-export

English | 中文

   

为 DeepSeek Harness 提供确定性的会话证据报告：/transcript 把会话写成单文件 HTML 报告或 Markdown/JSON 转录，/stats 在终端打印统计卡，/archive 把原始会话日志写成逐会话 ZIP——全部落到本机路径，且支持任意持久化后端（JSONL 或 SQLite）。

通过 ctx.sessionQuery 直读会话日志本身——无旁路采集、无驻留内存、无数据漂移。 装插件之前的历史会话照样能导。

安装

环境要求：Node.js 20 或 22 · 挂载了 commands 与 sessionQuery 服务的 DeepSeek Harness profile（官方 web / agent profile 均满足）。

dsh plugin --profile web add dsh-session-export

试一次

在任意会话里：

/transcript --html

Exported 23 messages (41 tool calls, 128450 tokens) → /path/to/cwd/dsh-transcripts/transcript-a1b2c3d4-20260929T101530.html

一个自包含 HTML 文件——KPI 卡片、轮次时间轴、工具排行、错误高亮、暗/亮主题——离线可开，可打印成 PDF。

会话工具链

插件 · 层 · 回答的问题

dsh-session-export · 证据层 · "这个会话到底发生了什么？"

dsh-session-recall · 记忆层 · "我以前做过什么，在哪？"

dsh-session-eval · 评测层 · "刚才的会话好不好？趋势在变好吗？"

三者都通过同一个受信的 ctx.sessionQuery 接缝读取。

贡献

• 本地开发：npm ci && npm run doctor && npm run typecheck && npm test && npm run bundle（Node 20/22；npm run doctor 自动修复未发布的 peer 依赖，见 [CONTRIBUTING.md](CONTRIBUTING.md) 第零步）。
• 源码入口：[src/render/html.ts](src/render/html.ts)、[src/render/markdown.ts](src/render/markdown.ts)、[src/mask.ts](src/mask.ts)——完整源码地图见 [CONTRIBUTING.md](CONTRIBUTING.md)。
• 当前缺口：前三项（#5 diff 块撑破、#6 连接串脱敏、#7 排行条锚点）均已交付——余下工作浏览 issues 与 good first issue 标签。
• 规矩：行为变更必须带测试；文档必须 README.md 与 README.zh.md 同步改；版本发布由维护者执行。详见 [CONTRIBUTING.md](CONTRIBUTING.md)。

命令契约

输入 · 结果

/transcript · 导出当前会话 → <会话 cwd>/dsh-transcripts/transcript-<id8>-<时间戳>.md

/transcript --html · 单文件 HTML 报告：KPI 卡片、轮次时间轴、工具排行、错误高亮、暗/亮主题、打印转 PDF

/transcript --json / --md / --html · 任意组合输出格式

/transcript <path> / --out <path> · 写入指定路径（--out 后允许空格）

/transcript --id <sessionId> · 导出另一个会话

/transcript --last 30m · 部分导出：最近 30 分钟的条目（7d/12h/30m/90s）

/transcript --errors-only · 调试视图：报错的工具结果 ± 两条上下文

/transcript --mask · 脱敏：遮蔽 API key、Bearer token、私钥、邮箱、数据库 URL 凭据等

/transcript --mask-hash · 确定性脱敏：密文变 #xxxxxxxx 摘要——同密钥同标记，相等性在脱敏后仍可判

/transcript --manifest · 证据清单：为本次每个导出物写 .manifest.json 边车（字节数 + SHA-256）

/transcript --full · 附上 log-only 事件附录 + Mermaid 轮次时间轴

/stats · 终端统计卡：消息、轮次、时长、工具调用（含失败）、token、成本、工具排行、sparkline——不写文件

/bundle · 一键审查 ZIP：转录报告 + 原始 JSONL 归档 + sha256 证据清单，为审计/审查流程设计

/bundle --mask --manifest · 脱敏转录 + 证据清单

/bundle --no-archive · 仅转录报告（不含原始归档）

/archive · 归档当前会话（含子代理后代）→ 逐会话 ZIP

/archive --all --since 7d · 批量归档最近 7 天的全部会话

/diff <id1> <id2> · 会话对比：比较两场会话——公共前缀、独有尾部、stats 差量（终端或 --html 报告）

与所有 ctx.commands 命令一样，这五条命令都运行在人类命令平面：结果不进模型历史，零 token 消耗。

项目定位

dsh-session-export 是会话证据层，不是记忆优化器。

• 核心价值是可审计（发生了什么、顺序如何、失败点在哪）。
• 核心价值是可复现（稳定输出、可移植文件、确定性渲染）。
• 核心价值是可运维（批量归档、落 Host 路径、可打印交付物）。

如果你的主要目标是上下文压缩或语义记忆，优先用记忆框架；如果主要目标是复盘取证、代码评审和事故复盘，优先用本插件。

为什么需要它

官方 @deepseek-ai/dsh-session-log-export 通过浏览器下载原始 JSONL/zstd ZIP，且仅支持 JSONL 后端；官方 @deepseek-ai/dsh-session-stats 提供基础统计投影。两者是毛坯层，本插件是建在其上的证据层——确定性复盘报告、SHA-256 清单、脱敏、策略包、输出契约、/diff 与 /bundle（见下方对比表）。

转录语义遵循 @deepseek-ai/dsh-session/surface：本插件渲染 append-origin 表面事件——用户真实看到过的全部内容——而不是模型可见表面（后者的 compaction 替换会抹掉用户已经读过的对话）。

竞品视角

能力重心 · 官方 /export · 旁路监听型导出 · 记忆框架类插件 · dsh-session-export

主要产物 · 原始日志下载 · 可读转录文本 · 记忆/上下文优化结果 · 证据级会话复盘报告

数据来源 · 原始日志包 · 旁路事件流 · 推导后的记忆结构 · 会话主日志（sessionQuery）

历史覆盖 · 受后端限制 · 无补录常不完整 · 通常按召回策略选取 · 全量历史（含装插件前会话）

持久化后端 · 仅 JSONL · 监听器见到的 · 框架各异 · 任意后端（JSONL、SQLite…）

统计 · — · 面板计数器 · 框架各异 · /stats 卡片 + 成本估算 + 工具排行

谱系 / diff / 时间轴 · — · — · — · Mermaid 谱系、编辑器 diff、轮次时间轴

批量 · — · — · — · /archive --all --since

运维交付 · 浏览器 ZIP · 常见单次导出 · 记忆状态/索引 · HTML/MD/JSON + /stats + /archive

官方生态说明（2026-09）：官方 @deepseek-ai/dsh-session-log-export（浏览器下载原始 JSONL/zstd ZIP，仅 JSONL 后端）与 @deepseek-ai/dsh-session-stats（基础统计投影）是原始工具层；本插件是其上的证据层——确定性复盘报告、SHA-256 manifest、脱敏、策略包、输出契约、/diff 与 /bundle。

模型可调用工具（v1.3）

设置 exposeTool: true 可注册 transcript_export——与导出内核相同的类型化工具，模型可直接调用。预期桥接：dsh-session-recall 命中返回 sessionId，模型交给 transcript_export，用户磁盘上就有完整证据报告。每次调用一种格式（默认 html，可选 md / json），可选 mask / manifest / last；文件始终落到标准 dsh-transcripts 目录（或 defaultDir），带时间戳、不覆盖。该工具默认关闭，因为会把写本机文件的能力交给模型。

HTML 报告长什么样

/transcript --html 写出一个自包含文件——不引外部 CSS/JS，离线可开：

• KPI 卡片：消息数、工具调用（失败数标红）、token 进/出、时长、轮次、成本
• 轮次时间轴：每轮一条彩色横条，按墙钟占比着色
• 工具排行：横向条形图 + 每工具失败数
• Token sparkline：内嵌 SVG，每条 assistant 消息的输出 token 分布
• 错误焦点：失败的工具结果红边框 + 横幅 + 自动展开；页头一键跳到第一个失败
• **JSON

…(truncated)