DeepSeek Harness(DSH)的插件化設計允許用戶通過社區插件擴展功能。dsh-session-chat-share 專注於會話數據的導出與分享,解決開發者或用戶需要將對話記錄以特定格式(Markdown、HTML、TXT 或 PNG)保存或分發的需求。該插件通過命令行和界面操作兩種方式,讓用戶能夠精確控制導出的範圍與內容。
核心功能¶
1. 命令行與界面集成¶
插件在 Web 端註冊了 /share 斜槓命令,並在 Session Header 中添加了“Share”操作按鈕。如果當前 Harness 的 UI Workspace 支持貢獻點(registry)sessionRowMenu,該插件還會在 Sidebar 的 ... 菜單中增加“Share”和“Save TXT”選項,允許直接對單條會話行進行操作。
2. 範圍選擇與導出¶
通過 /share 命令打開的對話框會列出會話的可共享消息。用戶可以通過 From/To 選擇器、點擊行或切換到“多選模式”來選擇導出的範圍。支持以下四種導出格式:
* Markdown:純文本,按角色(User/Assistant)標題組織。
* HTML:自包含頁面,使用 GFM-lite 渲染(支持標題、列表、表格、引用、代碼塊、鏈接),圖片以 Data URI 嵌入。
* TXT:純文本文件。
* PNG:將上述 HTML Artifact 柵格化爲圖片文件。
3. 配置選項¶
導出前可配置以下選項:
* Redact sensitive info(默認開啓):對憑據形狀和本地絕對路徑進行模糊處理,但這是基於模式匹配的盡力而爲操作,非絕對保證。
* Include tool calls(默認關閉):包含工具調用行。
* Include subagent conversations(默認關閉):包含子代理對話,並附帶分隔標題。
4. 數據讀取機制¶
插件通過主機的 session-query 服務以“冷讀”方式讀取會話數據。這意味着無論瀏覽器當前緩存了多少條消息,導出都能覆蓋整個會話。命令運行在人類指令層面,不產生 Token 消耗。
5. 可選自動保存¶
在插件配置中設置 autoSaveDir 後,每次會話回合結束後,系統會自動將當前會話保存爲 TXT 文件到指定目錄。
安裝與啓用¶
確保你的 DeepSeek Harness 版本爲 0.1.6-alpha.2 或更高。使用以下命令安裝插件:
dsh plugin --profile demo add dsh-session-chat-share
安裝後,插件即可在任意會話中生效。
典型用法¶
- 打開分享對話框:在任意會話中輸入
/share。 - 導出全文爲 TXT:輸入
/share txt。 - 導出最近 10 條消息:輸入
/share last 10。 - 導出最近 10 條爲 TXT:輸入
/share txt last 10。 - 從 UI 選擇範圍:點擊 Session Header 的 Share 按鈕,或 Sidebar 的
...菜單,選擇行並導出。
注意事項¶
- 版本依賴:此插件需要 DeepSeek Harness 0.1.6-alpha.2 或更高版本。
- 數據量限制:對話框列表最多顯示 300 條可共享的消息。若需導出更早的消息,請使用
/share txt等命令直接導出全文。 - 託管限制:分享功能僅涉及將 Artifact 複製到剪貼板或下載到本地,不會上傳到任何服務器。
- 內容包含:消息文本按表面渲染內容分享;推理文本和工具結果默認不包含(除非開啓對應選項)。
- Sidebar 菜單:Sidebar 中的 Share/Save TXT 行需要 Harness 支持
sessionRowMenu貢獻點註冊。
總結¶
dsh-session-chat-share 爲 DeepSeek Harness 提供了標準化的會話導出能力。通過集成在 UI 和命令行中,它允許用戶靈活地以 Markdown、HTML、TXT 或 PNG 格式保存對話。其基於 Host Session Query 的讀取機制確保了數據的完整性,而 Redaction 選項則在默認情況下保護了敏感信息。
- GitHub: https://github.com/chrisx9z/dsh-session-chat-share
- Catalog: https://www.skillhub.cn/plugins/chrisx9z/dsh-session-chat-share