前言¶
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
