前言¶
DeepSeek Harness 官方提供會話導出功能，產出的是原始日誌（如 session.v3.jsonl.zstd），這是二進制、多幀 Zstandard 壓縮的 JSONL 數據，人無法直接閱讀。dsh-chat-export 補上缺的那一半：將同一份會話日誌渲染爲人能讀的文字稿。
該插件提供兩種入口：會話頭部的分享圖標按鈕（懸停顯示“導出文字稿”）和 /export-md 斜槓命令。
安裝¶
在終端執行：
dsh plugin --profile web add dsh-chat-export
安裝後需重啓 dsh web 宿主進程才能加載新插件。
入口與基礎用法¶
方式一：會話頭部按鈕¶
打開一個會話，點頭部的“導出文字稿”按鈕。在彈出的對話框中，可以選擇格式、範圍、圖片策略以及是否導出思考塊、工具調用等信息。對話框提供“預覽開頭”功能，可在確認前查看 Markdown 開頭效果。確認後可選擇“瀏覽器下載”或“保存到目錄”。
方式二：斜槓命令¶
在對話框中直接輸入命令。默認生成 Markdown 格式。
/export-md
命令參數詳解¶
命令支持多種格式和選項，參數會帶進對話框進行確認。
格式¶
md/markdown：Markdown 格式（默認）。html：自包含 HTML，可打印成 PDF。txt/text/plain：純文本，無任何標記。zip：打包文件，包含 md + html + txt + 圖片 +meta.json。
常用選項¶
--thinking/--no-thinking：是否包含思考塊（默認開）。--images=auto|embed|assets|none：圖片策略。auto表示單文件內嵌、ZIP 放assets/。--save[=目錄]：保存到目錄而不是下載。不填目錄則用會話工作目錄下的dsh-chat-exports/。--surface：只導當前模型上下文（默認完整日誌）。
功能特性¶
- 範圍可選：支持“完整日誌”和“僅當前上下文”兩種範圍。
- 附件去重：會話中重複出現的圖片附件只存儲一份。
- 中英雙語：界面跟隨 DSH 語言設置。
- 零運行時依賴：不引入任何
@deepseek-ai/*依賴，通過 cordis 上下文獲取服務。 - 支持熱替換：瀏覽器端代碼支持 HMR，修改後無需刷新頁面。
- 導出前預覽：對話框內可直接預覽導出內容的開頭。
產出格式與限制¶
產出內容¶
導出的文字稿包含用戶/助手消息、思考塊（可摺疊）、工具調用與結果（可摺疊、超長自動截斷）、代碼塊、圖片、時間戳、會話標題、模型信息及用量統計。
已知限制¶
- 保存目錄限制：“保存到目錄”僅支持 Markdown、HTML 和純文本，不支持 ZIP（因
ctx.fs不支持二進制寫入）。 - 不導出子會話：不包含 subagent 子會話內容。
- 純文本圖片：純文本中的圖片僅顯示描述。
- PDF 生成：PDF 由瀏覽器打印生成，非插件生成。
- 費用信息：用量數據來自日誌，無法提供費用信息。
- 排版處理：
- 正文 Markdown 標題會整體下沉至 4-6 級，以保持“回合/消息”爲文檔骨架。
- 正文中的
<details>會被轉義爲字面量，防止對話內容意外摺疊。
總結¶
dsh-chat-export 解決了官方原始日誌難以閱讀的問題，通過渲染工具和命令，讓開發者能快速導出可讀的文字稿進行歸檔或復盤。
