DeepSeek Harness (DSH) 的官方日志导出（dsh-session-log-export）默认生成 raw JSONL 的 ZIP 压缩包，内容难以直接阅读。dsh-session-md 插件补齐了这一缺口，它将一次会话导出为人类可读的 Markdown 或自包含 HTML 页面。
插件支持多种导出模式，覆盖从“给模型复现”到“人读周报”等不同场景。它提供界面按钮一键下载，也支持通过工具调用直接写入文件。
安装¶
插件安装命令如下：
dsh plugin --profile web add dsh-session-md
安装完成后刷新浏览器页面即可生效。该插件声明了 dsh.bundle.patch，无需手动编辑配置文件。
- Node 版本：要求
^22.19.0 || >=24 - 依赖：零
@deepseek-ai/*依赖，无peerDependencies
使用方式¶
界面操作¶
在会话标题栏右侧的操作区（通常与官方“下载 Session 日志”在同一位置）有一个下载图标按钮。点击后会弹出模式菜单，支持以下导出类型：
- 全部：工具参数与结果完整保留，适合给 Agent 接手或复现。
- 交接版：保留工具调用，去掉思维链，适合节省 Token 的接手版。
- 简洁：人读模式，工具调用只保留名称。
- 审计版：不截断内容，包含系统提示词与注入上下文，适合留档。
- HTML 导出：生成自包含的 HTML 页面，可直接打印或发送。
文件名由 Host 的 Content-Disposition 指定，支持中文标题。浏览器下载路径由浏览器决定，不受会话文件沙箱限制。
工具调用¶
你也可以直接通过对话让模型调用工具来导出：
export_session_md({ mode: 'readable' }) // 当前会话导出为简洁版
export_session_md({ all: true, path: '/abs/dir' }) // 批量导出全部会话
export_session_md({ includeToolDetails: false }) // 仅保留工具名
导出模式详解¶
插件提供四种主要的渲染预设，参数可显式覆盖默认值：
| 模式 | 工具调用 | 思维链 | 系统提示词 | 说明 |
|---|---|---|---|---|
full 全部 |
参数 + 结果 | 保留 | 不含 | 复盘用，有长度限制 |
handoff 交接 |
参数 + 结果 | 去掉 | 不含 | 省 Token 的接手版 |
readable 简洁 |
仅留名字 | 保留（折叠） | 不含 | 最短，适合人读 |
audit 审计 |
参数 + 结果 | 保留 | 包含 | 不截断，留档用 |
默认输出（includeToolDetails: true）适合复盘；关闭工具详情（includeToolDetails: false）是“干净分享版”，体积通常只有原来的几十分之一。
技术细节¶
- 热插拔：插件支持标准 Cordis 插件生命周期，可进行
load/unload重载。 - 文件名处理：使用
slugify处理文件名，Windows 下会自动规避保留设备名（如CON、NUL）及非法字符。 - 离线验证：插件包含完整的离线测试套件，无需 DSH 环境即可验证渲染逻辑。
- 修改源码：修改插件源码后，需重启
dsh web才能生效，刷新浏览器页面通常不够。
