前言¶

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