前言¶

在 DSH（DeepSeek Harness）的使用場景中，智能體生成的輸出常爲 Markdown 文件。點擊這些鏈接時，系統通常會喚起默認的 Markdown 編輯器或查看器，這會打斷當前的工作流，需要頻繁切換窗口。我們需要一種方式，能在 DSH 界面內直接預覽這些文檔。

插件介紹¶

dsh-markdown-link-preview 是一個由 Lukeknow0 維護的插件。它的核心作用是攔截聊天區中指向同源 Markdown 文件的點擊事件，將內容直接渲染在 DSH Better Sidebar 中，替代外部應用打開。

安裝與前置條件¶

安裝前，請確保已安裝並啓用 dsh-better-sidebar 插件。

執行以下命令安裝插件：

dsh plugin --profile web add github:Lukeknow0/dsh-markdown-link-preview

安裝完成後，重啓或刷新 DSH Web 頁面。

核心功能¶

該插件主要提供以下能力：

• 點擊捕獲與渲染：捕獲聊天區中指向同源 Markdown 文件的普通左鍵點擊，在側邊欄中爲每個文檔打開獨立標籤。
• 多文檔並排：支持在側邊欄中同時打開多個 Markdown 文件，便於對照閱讀。
• Markdown 渲染：支持 GitHub Flavored Markdown、代碼塊、表格、圖片以及相對鏈接的渲染。
• 安全清洗：使用 marked 進行解析，並配合 DOMPurify 對生成的 HTML 進行清洗，防止 XSS 攻擊。
• 同源限制：僅接管與 DSH 頁面同源的 HTTP(S) URL。插件不會接管跨域鏈接、file:、data: 或 javascript: URL。
• 保留原生行爲：對於 Cmd/Ctrl 點擊、右鍵菜單或新窗口操作，完全保留原始瀏覽器行爲，不進行干預。

適用場景與注意¶

• 依賴環境：該插件依賴 dsh-better-sidebar 插件運行，且要求 React 版本不低於 18.2.0。
• 隱私與安全：插件不上傳文檔內容，不連接任何遠程服務。Markdown HTML 在渲染前會經過 DOMPurify 清洗。
• 源碼審查：雖然許可證爲 MIT，但在生產環境使用前，建議檢查 GitHub 倉庫源碼，確保符合當前的安全與合規要求。

總結¶

通過 dsh-markdown-link-preview，可以在 DSH Better Sidebar 中無縫預覽同源 Markdown 文件，避免頻繁切換外部應用。插件通過同源限制和 DOMPurify 清洗保障了基本的安全性。更多細節可訪問 GitHub 倉庫。