前言¶
DeepSeek Harness (DSH) Web 端提供了官方的 Session Log 導出功能，主要用於調試、恢復和重放會話。但在需要閱讀對話內容、進行 AI 交接或整理文檔時，原始的日誌格式不夠直觀。dsh-conversation-exporter 插件爲 DSH Web 添加了本地導出功能，能夠將對話以整潔的 Markdown 格式輸出到本地。
它是什麼¶
dsh-conversation-exporter 是一個由 liuyuelintop 維護的客戶端插件，遵循 MIT 協議。它的核心作用是在 DSH Web 界面中新增導出動作，不依賴任何雲端服務，僅通過本地 DSH 運行時讀取當前會話數據並生成 Markdown 文件。
核心功能¶
- 全量導出：一鍵下載當前整個會話，生成可讀的 Markdown 文件。
- 選擇性導出：支持按“輪次”篩選。一次導出包含一條用戶消息及其對應的最終助手回覆。
- 本地處理：所有處理均在本地完成，不上傳、不存儲雲端、無遙測數據。
- 保留富文本格式：支持保留 Mermaid 流程圖等富 Markdown 格式。
安裝與啓用¶
在終端中運行以下命令，將插件添加到 DSH 的 web 配置文件中：
npx @deepseek-ai/dsh plugin --profile web add dsh-conversation-exporter@latest
添加後，需停止並重新啓動 DSH Web 進程以使配置生效：
npx @deepseek-ai/dsh web
典型用法¶
- 打開 DSH Web 中的任意一個會話。
- 點擊界面上的 Export Chat 按鈕，即可下載當前會話的完整 Markdown 文件。
- 若需篩選內容，點擊 Select turns…。此時所有輪次默認選中。
- 使用 Select all 或 Clear 調整選中狀態。
- 點擊 Export selected turns 進行導出。
- 瀏覽器將下載一個文件，文件名爲
<會話標題>--<短會話ID>.md，例如Project-Architecture-Guide--2002da4d.md。
導出的 Markdown 文件中：
* 會話標題作爲一級標題（H1）。
* 消息使用引用塊標記，Human 和 Assistant 分別標記爲 > Human 和 > Assistant。
* 如果某條消息在代碼塊中間結束，導出器會自動閉合該代碼塊。
* 未完成的回覆會標記爲 > Response incomplete.。
* 僅包含圖片的消息會顯示爲 [Image omitted]。
適用場景與注意¶
- 適用場景：適合需要將對話內容整理爲文檔、進行 AI 交接、或作爲非調試用途的會話存檔。
- 重要說明：
- Session Log 的區別：本插件生成的 Markdown 側重於可讀性和人工閱讀，不包含原始事件、工具調用、中間響應、注入上下文、子代理日誌等調試信息。這些數據僅在官方 Session Log 中提供。
- 輪次限制：只能按“整輪”導出，無法單獨選中 Human 或 Assistant 的氣泡。
- 隱私與權限：導出完全本地化，沒有上傳路徑。插件讀取的是當前 DSH 進程權限範圍內的會話數據。
- 版本兼容性：DSH 目前處於開發者預覽階段，插件 API 可能會發生變化。V0.3 版本適配
@deepseek-ai/dsh@0.1.0-rc.6。
總結¶
dsh-conversation-exporter 解決了 DSH 會話在非調試場景下的“可讀性”問題。如果你需要將對話轉化爲 Markdown 文檔，它是比 Session Log 更輕量、更直觀的選擇。
- 插件目錄：dsh-conversation-exporter
- 源碼地址：GitHub
