前言¶
DeepSeek Harness (DSH) 採用插件化架構,允許用戶根據實際需求擴展功能。在對話中插入 Mermaid 圖表是常見需求,但瀏覽器原生的渲染往往缺乏交互性,難以進行縮放或局部查看。dsh-chat-enhancer 插件專注於解決這一問題,通過專門的預覽窗口提升圖表的可讀性與操作體驗。
插件簡介¶
這是一個由 Tieboyh 維護的插件,旨在爲 DeepSeek Harness Web 提供聚焦的對話增強功能。它從 Mermaid 圖表的可視化交互入手,通過居中預覽、縮放與平移等功能,改善開發與討論過程中的圖表展示效果。
核心功能¶
該插件當前版本 0.2 的核心能力集中在 Mermaid 代碼塊的處理上:
- 多格式渲染:支持將對話中的
mermaid、mermaidjs和mmdfenced blocks 直接渲染爲 SVG。 - 居中預覽窗口:圖表不再佔據瀏覽器全屏,而是在一個居中的預覽窗口中顯示,保持上下文。
- 平滑縮放:提供以指針爲中心的鼠標滾輪縮放,操作手感平滑。
- 平移與控制:支持點擊拖拽平移,並提供“適應窗口”、“100% 縮放”以及通過鍵盤快捷鍵控制視圖。
- 主題響應:當 DSH 的淺色或深色主題切換時,圖表會自動重新渲染以適配當前配色。
- 安全與容錯:使用 Mermaid 的
securityLevel: strict,若渲染失敗則回退顯示源碼。
安裝與啓用¶
在終端中執行以下命令即可安裝插件:
dsh plugin --profile web add dsh-chat-enhancer
安裝、升級或移除插件後,需要重啓 DSH Web 才能生效。
典型用法¶
在對話中請求模型返回 Mermaid 代碼塊,例如:
```mermaid
flowchart LR
A[開始] --> B[完成]
```
點擊渲染結果上的“Open”按鈕進入預覽窗口。在預覽窗口內:
- 縮放:滾動鼠標滾輪圍繞指針縮放,或使用
+/-鍵。 - 平移:按住鼠標左鍵拖動。
- 視圖控制:按下
0鍵適應窗口,按下Esc鍵關閉預覽。
注意事項¶
該插件使用 Mermaid 的嚴格安全級別,渲染出錯時會回退顯示源碼。安裝後請務必重啓 DSH Web 進程。
總結¶
dsh-chat-enhancer 通過引入專門的預覽交互層,解決了 Mermaid 圖表在純文本對話中難以精細查看的問題。對於需要頻繁討論架構、流程或數據流的技術場景,該插件能提供更清晰的視覺反饋。