前言¶
DeepSeek Harness (DSH) 強調插件化架構，開發者需要通過插件擴展核心能力。在開發與調試智能體時，獲取可審計、可復現的會話證據是常見需求。官方 /export 命令通常僅提供原始日誌下載，格式單一且缺乏可讀性。dsh-session-export 作爲一個插件，直接讀取 ctx.sessionQuery，繞過了傳統錄音機式的數據採集方式，爲 DSH 提供了確定性的會話證據層。
插件定位¶
dsh-session-export 是一個會話證據層插件，由開發者 kittimzhe 維護，採用 MIT 許可證。
它不承擔記憶優化或上下文壓縮的任務，而是專注於三個方向：
* 審計性：記錄發生了什麼、按何種順序、伴隨何種失敗。
* 可復現性：生成穩定的輸出文件（HTML/Markdown/JSON）和便攜的報告。
* 操作性：支持批量歸檔、主機路徑持久化以及終端實時統計。
核心功能¶
該插件不依賴駐留內存或額外的記錄器，避免了數據漂移風險，支持讀取 canonical session log。
- 會話導出
通過ctx.sessionQuery讀取會話。支持導出爲單文件 HTML、Markdown 或 JSON。HTML 報告包含 KPI 卡片、回合時間軸、工具調用排名、錯誤高亮及深色/淺色主題。 - 終端統計
提供/stats命令，在終端打印統計卡片，包含消息數、回合數、耗時、Token 消耗、成本估算及工具排名。 - 會話歸檔
提供/archive命令，將當前會話（含子代理）打包爲 ZIP 文件。 - 差異對比
提供/diff <id1> <id2>命令，對比兩個會話的差異（共同前綴、獨特尾部、統計增量）。 - 審查打包
提供/bundle命令，生成包含轉寫報告、原始歸檔和證據清單的 ZIP 包，便於審計流程。 - 全歷史記錄
支持導出安裝該插件之前的會話歷史。
安裝與啓用¶
通過 npm 安裝該插件包：
npm install dsh-session-export
安裝後，需在 DSH 的插件配置中啓用該模塊，使其作爲 ctx.commands 暴露命令。
典型用法¶
插件提供了四個核心命令，均在人類指令層運行，不會進入模型歷史，也不消耗 Token。
- 導出當前會話
默認導出 Markdown 文本：
/transcript
生成 HTML 樣式報告（支持打印 PDF、深色模式）：
/transcript --html
- 查看統計
在終端打印會話統計卡片：
/stats
- 歸檔會話
將當前會話打包爲 ZIP：
/archive
- 對比會話
對比兩個會話的差異：
/diff <id1> <id2>
- 生成審查包
生成包含脫敏信息和證據清單的打包文件：
/bundle --mask --manifest
適用場景與注意¶
- 適用場景：需要深度審查對話質量、排查工具調用失敗原因、生成合規審計報告或進行對話回溯的開發者。
- 技術注意：插件以當前 DSH 進程權限運行，不支持模型直接寫入文件（除非開啓工具暴露模式）。安裝前建議檢查源碼與許可證（MIT）。
