Introduction¶
DSH sessions often contain multi-turn Q&A, code blocks, tool calls, and rich components. Copying messages out usually results in a long strip of flat text: no titles, no summaries, unclear sections, requiring re-organization when sending to colleagues or archiving.
dsh-doc-share is a DSH conversation report sharing plugin maintained by dawsondx. It organizes completed rounds into a report featuring a cover, summary statistics, and chapter layout, and supports export as PNG images, single HTML files, PDF, or Markdown.
Below is an introduction to its features, installation methods, and considerations.
What is this¶
dawsondx/dsh-doc-share is a web-facing sharing plugin for DSH, licensed under MIT. The core problem it solves is converting DSH sessions from “chat logs” to “readable, shareable, and archivable reports.”
Core Features¶
Round Selection and Single-Round Sharing¶
- Round selection modal: Lists all completed rounds, supports search/filter, select all, clear, and load earlier history or all at once.
- Single-round quick share: Hover over the share button of any message round to export only that round of Q&A.
Report Layout and Content Organization¶
- Cover title is customizable.
- Content summary statistics the number of rounds, questions, word count, code blocks, and tool calls.
- Display
Q&Ain chapters by round. - Code blocks are isolated, tables preserve layout, and tool calls are collapsed into summary rows.
Export, Layout, and Theme¶
- Supports four export formats:
PNGimages, singleHTMLfiles,PDF, andMarkdown. - Layout is adjustable: width supports mobile / tablet / desktop, and font size has three levels.
- Can check “Hide process” to keep only the question and final answer.
- Dark theme:
HTML/PDFexport follows system / DSH light/dark preferences;PNGimages have a fixed light background. - Auto-save settings:
localStoragepersists previous width, font size, hide process, and title. - Auto-adapt Chinese/English: interface text follows DSH interface language.
Compatibility and Mounting¶
- Compatible with
dsh-genuirich components: fully renders cards, key-value panels, step bars, etc., when exportingPNG/PDF. - Mount via official slots:
conversation.chat.assistant-actions
conversation.session.header.utilities
Installation and Activation¶
Use the following command to install the plugin:
dsh plugin --profile web add dsh-doc-share
After installation, restart dsh web:
dsh web
Typical Usage¶
- Open
dsh weband enter a session. - Click “Report Sharing” in the top right corner to open the round selection modal; clicking the share button on any message round exports only that round.
- In the modal, check the Q&A to include; you can search by keywords; for earlier conversations, click “Load Earlier” or “Load All” before checking.
- Click “Generate Report”, adjust title, width, and font size in the preview modal, and check “Hide process” as needed.
- Choose to download
PNG/HTML/PDF/Markdown.
Applicable Scenarios and Notes¶
Suitable for scenarios such as: needing to organize a DSH session into content that is shareable, archivable, printable, or for secondary editing; needing to select specific rounds and export in different formats; sessions containing code blocks, tables, tool calls, or dsh-genui rich components.
Notes before use:
- Plugin targets
@deepseek-ai/dsh@0.1.0-rc.6. peerDependenciesrequirements:
@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
- After DSH adjusts page structure, the plugin may need to adapt synchronously.
PNGgeneration for very long conversations is slow due tohtml-to-imagetaking full-page screenshots.- Ensure selected rounds are already rendered on the page; individual rounds that have been unmounted due to page virtualization will be skipped with a console warning.
- Settings auto-save to
localStorage. - This project references the interaction and DOM scanning scheme from
hellodigua/dsh-share. - License is
MIT. - The plugin runs with the permissions of the current
dshprocess; check source code and license before installing.
Related Links¶
- Directory page:
https://www.skillhub.cn/plugins/dawsondx/dsh-doc-share - GitHub:
https://github.com/dawsondx/dsh-doc-share