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才能生效，刷新瀏覽器頁面通常不夠。
