DeepSeek Harness（DSH）是用於與模型交互和測試的框架。在開發需要生成數學公式、幾何圖表或報告的場景時，智能體往往需要將 LaTeX 或 SVG 代碼轉換爲可視化的圖片。jaxzhou/dsh-mathmatic-symbol 是一個 DSH 插件，它提供了四個工具，讓智能體能夠直接將數學公式渲染爲圖片、從聲明式規格繪製幾何圖形、轉換現有文件，以及組裝包含這些圖片的文檔。
該插件屬於“聯網工具”類別，由用戶 jaxzhou 維護，遵循 MIT 許可證。
核心功能¶
安裝後，插件會在 DSH 會話中註冊四個工具函數，分別解決不同的數學可視化需求：
- math_formula：將 LaTeX 公式渲染爲圖片（同時生成 SVG 和 PNG）。
- math_figure：根據聲明式的幾何規格繪製數學圖形。
- math_convert：將現有的公式或 SVG 轉換爲可直接嵌入的圖片格式。
- math_document：組裝文檔，並在文檔中自動插入生成的數學圖片。
安裝與啓用¶
在 DSH 環境中，使用以下命令安裝該插件：
dsh plugin --profile web add @jaxzhou/dsh-mathmatic-symbol
安裝完成後，插件會自動註冊提示引導，告訴模型在需要輸出圖片或文檔文件時優先使用這些工具，而不是手寫渲染代碼。
典型用法¶
渲染數學公式¶
使用 math_formula 函數，智能體可以直接傳入 LaTeX 字符串，插件會生成對應的圖片資源。
math_formula({ latex: "\\int_0^\\infty e^{-x^2}\\,dx = \\frac{\\sqrt{\\pi}}{2}" })
繪製幾何圖形¶
使用 math_figure，智能體可以通過聲明式的 JSON 規格來描述圖形。例如，定義一個三角形：
math_figure({ figure: { ... }, name: "triangle" })
轉換圖片格式¶
如果工作區中已有 SVG 文件，可以使用 math_convert 將其轉換爲 PNG，並調整縮放比例：
math_convert({ source: { path: "diagrams/flow.svg" }, format: "png", scale: 3 })
組裝文檔¶
使用 math_document，智能體可以指定文檔路徑和內容，插件會將生成的公式和圖表插入文檔中，並返回相對路徑。
math_document({ path: "docs/report.md", body: "...", math: "image", figures: { ... } })
技術特性與權衡¶
該插件在實現上有幾個明確的技術特徵：
- 無字體依賴：生成的 SVG 包含輪廓路徑（outline paths），不依賴系統字體，確保在任何環境下渲染一致。
- 確定性柵格化：PNG 輸出由
@resvg/resvg-js生成，且禁用了系統字體加載，同一輸入在任何機器上產生的字節相同。 - 內容尋址文件：相同的輸入總是寫入相同的文件名，便於緩存和構建流程中的覆蓋寫入。
注意：由於 SVG 中文本被轉換爲輪廓，圖片中的標籤無法被選中或搜索。這是爲了實現無字體依賴所做的必要權衡。
結語¶
jaxzhou/dsh-mathmatic-symbol 爲 DSH 中的數學可視化任務提供了標準化的解決方案。通過將複雜的渲染邏輯封裝爲工具調用，它簡化了智能體生成高質量數學文檔和圖表的過程。更多細節可參考插件目錄頁或源碼倉庫。
