前言¶
在 DeepSeek Harness (DSH) 的插件生態中，會話內容往往以原始文本或流式數據呈現。若需將對話記錄歸檔爲可讀文件，通常需要手動複製粘貼。本文介紹 dsh-save-session，一個能夠直接在會話標題欄一鍵導出內容爲 Markdown 或渲染 HTML 的插件。
簡介¶
dsh-save-session 是一個客戶端插件，由用戶 jh1016248 維護，開源協議爲 MIT。它的核心價值在於簡化會話導出流程：通過界面按鈕或對話指令，自動過濾掉思考過程、工具調用記錄等噪音，僅保留用戶與助手的正文內容，生成乾淨的 Markdown 或渲染後的 HTML 文件。
核心功能¶
導出格式¶
插件提供兩種導出模式：
- 保存 MD：下載
session-<時間戳>.md文件，內容爲純淨的 Markdown 格式，適合直接編輯或作爲文檔存儲。 - 保存 HTML：下載
session-<時間戳>.html文件。該文件包含 Markdown 渲染效果，支持標題、代碼塊、列表、引用、鏈接、表格等格式。文件左側設有目錄面板，每條消息一行（角色 + 單行預覽），點擊可跳轉；窄屏下自動隱藏。
內容過濾¶
導出的文件僅包含用戶消息與助手正文。以下內容一律被過濾：
- 模型思考過程
- 工具調用與工具結果
- 注入的上下文 / 子代理報告
工具集成¶
插件在模型側註冊了工具 save_session_md。開發者可以在對話中通過自然語言指令調用該工具，例如說“保存當前會話爲 md”。工具支持可選的 path 參數，默認寫入會話工作目錄。
安裝與啓用¶
安裝前請確保環境滿足依賴要求。
- 安裝插件
使用以下命令安裝：
dsh plugin --profile web add dsh-save-session
-
環境依賴
* Node.js 版本需 >= 20。
* 需安裝@deepseek-ai/dsh-tools版本 >= 0.1.0-rc.8。
* Client 槽位需注入@deepseek-ai/dsh-client-runtime和@deepseek-ai/dsh-client-ui-slots。 -
重啓 Profile
安裝完成後，必須重啓 profile 才能生效。執行dsh web重啓服務。
典型用法¶
安裝並重啓後，可通過以下兩種方式使用：
- 界面操作：在會話標題欄右側的操作行，點擊「保存 MD」或「保存 HTML」按鈕，瀏覽器會自動下載對應文件。
- 對話指令：在對話中直接發送包含工具意圖的文本（如“保存當前會話爲 md”），系統將自動調用
save_session_md工具執行導出。
注意事項¶
- 生效機制：插件通過註冊 UI 槽位和工具註冊表實現功能，安裝後務必重啓 profile。
- 源碼檢查：作爲插件使用，建議在安裝前檢查其源碼與許可證，確保符合本地環境的安全規範。
