前言¶

DSH 會話裏經常出現多輪問答、代碼塊、工具調用和富組件。直接把消息複製出來，往往是一長串平鋪文本：沒有標題、沒有摘要、章節不清晰，發給同事或歸檔時還需要二次整理。

dsh-doc-share 是一個 DSH 對話報告化分享插件，由 dawsondx 維護。它把已完成輪次整理成帶封面、摘要統計與章節排版的報告，並支持導出爲 PNG 圖片、單 HTML 文件、PDF 或 Markdown。

下面介紹它的功能、安裝方式和注意事項。

這是什麼¶

dawsondx/dsh-doc-share 是一個面向 DSH web 的分享插件，許可證爲 MIT。它解決的核心問題，是把 DSH 會話從“聊天記錄”整理成“可閱讀、可發送、可歸檔”的報告。

核心功能¶

輪次選擇與單輪分享¶

• 輪次選擇彈窗：列出全部已完成輪次，支持搜索過濾、全選、清空，並可加載更早歷史或全部加載。
• 單輪快捷分享：懸停任意一輪消息的分享按鈕，只導出該輪問答。

報告排版與內容整理¶

• 封面標題可自定義。
• 內容摘要統計輪數、問題數、字數、代碼塊、工具調用。
• 按輪次分章展示 Q&A。
• 代碼塊單獨成塊，表格保留排版，工具調用摺疊成摘要行。

導出、版式與主題¶

• 支持 PNG 圖片、單 HTML 文件、PDF、Markdown 四種導出。
• 版式可調：寬度支持手機 / 平板 / 電腦，字號三級可調。
• 可勾選「不展示過程」，只保留提問與最終回答。
• 深色主題：HTML / PDF 導出跟隨系統 / DSH 深淺色偏好；PNG 圖片固定淺色底。
• 設置自動保存：localStorage 持久化上次的寬度、字號、隱藏過程與標題。
• 中英文自動適配：界面文案跟隨 DSH 界面語言。

兼容與掛載¶

• 兼容 dsh-genui 富組件：導出 PNG / PDF 時完整呈現卡片、鍵值面板、步驟條等。
• 通過官方插槽掛載：

conversation.chat.assistant-actions
conversation.session.header.utilities

安裝與啓用¶

使用以下命令安裝插件：

dsh plugin --profile web add dsh-doc-share

安裝完成後重啓 dsh web：

dsh web

典型用法¶

1、打開 dsh web，進入一個會話。

2、點擊右上角「報告化分享」打開輪次選擇彈窗；點任意一輪消息的分享按鈕則只導出該輪。

3、在彈窗中勾選要包含的問答，可按關鍵詞搜索；更早的對話點「加載更早」或「全部加載」後即可勾選。

4、點擊「生成報告」，在預覽彈窗中調整標題、寬度、字號，按需勾選「不展示過程」。

5、選擇下載 PNG / HTML / PDF / Markdown。

適用場景與注意¶

適合這類場景：需要把一次 DSH 會話整理成可發送、歸檔、打印或二次編輯的內容；需要選擇部分輪次並導出不同格式；會話中帶有代碼塊、表格、工具調用或 dsh-genui 富組件。

使用前注意：

• 插件面向 @deepseek-ai/dsh@0.1.0-rc.6。
• peerDependencies 要求：

@deepseek-ai/dsh-client-runtime ^0.1.0-rc.6
@deepseek-ai/dsh-client-ui-conversation ^0.1.0-rc.6
@deepseek-ai/dsh-client-ui-primitives ^0.1.0-rc.6
react ^18.2.0

• DSH 調整頁面結構後，插件可能需要同步適配。
• 超長對話的 PNG 生成較慢，原因是 html-to-image 全量截圖。
• 確認選擇的輪次需已在頁面渲染；個別輪次若被頁面虛擬化卸載，會跳過並在控制檯提示。
• 設置自動保存到 localStorage。
• 本項目參考了 hellodigua/dsh-share 的交互與 DOM 掃描方案。
• 許可證爲 MIT。
• 插件會以當前 dsh 進程的權限運行，安裝前應檢查源碼與許可證。

相關鏈接¶

• 目錄頁：https://www.skillhub.cn/plugins/dawsondx/dsh-doc-share
• GitHub：https://github.com/dawsondx/dsh-doc-share