前言¶
DSH (DeepSeek Harness) 生态强调“一切皆插件”。在使用 dsh-better-sidebar 查看和编辑 Markdown 文件时，如果需要将内容导出为静态页面或 PDF 以便分享，通常需要借助外部工具。dsh-md-export 是一个为 DSH Web 插件设计的扩展，它直接在 dsh-better-sidebar 的工具栏中集成了导出功能，无需离开当前界面即可生成独立的 HTML 或 PDF 文件。
这是什么¶
这是一个由 AnakinCao 维护的 DSH Web 插件。它的核心作用是向 dsh-better-sidebar 的 Markdown 文件查看器工具栏追加一个“Export”按钮。通过这个按钮，用户可以一键将当前正在编辑的 .md 文件导出为独立的 HTML 文件（包含内联的 Mermaid 图表）或通过浏览器打印功能生成 PDF。
核心功能¶
- 零依赖，保留内置行为：插件不会替换
dsh-better-sidebar自带的预览、编辑和保存逻辑，仅作为工具栏的补充。 - 所见即所得：导出的 HTML 直接取自内置预览器的渲染 DOM（包括 Mermaid 生成的 SVG），不进行二次渲染。
- 同目录保存：生成的 HTML 文件默认保存在 Markdown 文件所在的同一目录下，文件名与原文件相同，仅扩展名改为
.html。 - 主题跟随：导出的 HTML 布局和样式会自动跟随当前预览器的主题（亮色/暗色），并非针对 A4 纸的打印优化。
- 编辑模式友好：如果在编辑模式下，导出操作会自动切换到预览模式，确保导出内容是最新的。
- 自动跟随：按钮会根据文件类型和预览/编辑模式的变化自动出现或隐藏。
安装与启用¶
安装命令如下：
dsh plugin --profile web add <dsh-md-export-0.1.0.tgz>
安装完成后，需要重启 dsh web 进程以加载新的插件包，随后在浏览器中进行硬刷新（Cmd/Ctrl + Shift + R）。
典型用法¶
- 在
dsh-better-sidebar中打开任意.md文件。 - 在工具栏上找到新增的 Export ▾ 按钮。
- 点击按钮并选择导出方式：
- Save HTML (same dir)：将文件保存为 HTML，文件名与 md 文件同名，保存在 md 文件同目录。
- Export PDF (print)：打开浏览器的打印对话框，用户可选择“另存为 PDF”。
适用场景与注意¶
- 依赖项：该插件依赖
dsh-better-sidebar的内部 CSS 类名（如nArs4W_前缀）。如果dsh-better-sidebar进行了版本升级并修改了这些内部类名，该插件可能需要同步更新以保持兼容。 - PDF 限制：PDF 导出依赖浏览器的打印功能。插件无法直接生成
.pdf二进制文件并保存到 md 目录，必须通过浏览器的打印对话框手动保存。 - HTML 保存限制：HTML 保存依赖会话检测（读取
localStorage中的dsh-sidebar:v1:*键）。在特定边缘情况下检测失败时，会回退到浏览器的下载行为。 - 文件类型：插件目前仅适用于
.md文件，但也支持.markdown扩展名。
短结尾¶
dsh-md-export 为 DSH 用户提供了一个轻量级的 Markdown 导出方案。它利用现有的渲染引擎，通过极少的代码扩展实现了从 Markdown 到静态页面的转换。更多细节和源码可查看其 GitHub 仓库或技能目录页。
链接¶
- GitHub: https://github.com/AnakinCao/dsh-md-export
- 目录页: https://www.skillhub.cn/plugins/AnakinCao/dsh-md-export
