dsh-math-render：在 DeepSeek Harness 網頁端渲染 LaTeX 公式

在 DeepSeek Harness (DSH) 的網頁聊天界面中，發送包含數學公式的消息通常只能以純文本形式顯示。對於需要精確展示公式符號的開發者或用戶來說，這不夠直觀。dsh-math-render 插件解決了這個問題，它接管了消息氣泡的渲染邏輯，並支持在輸入框上方提供實時的公式預覽。

這是什麼¶

這是一個客戶端插件，用於在 DSH 網頁端渲染 LaTeX 公式。它支持在消息氣泡中渲染公式（如 $...$、$$...$$ 等），並在用戶輸入時提供草稿的實時預覽。該插件由 huanglianqi 維護，採用 MIT 許可證。

安裝與啓用¶

執行以下命令安裝插件：

dsh plugin --profile web add dsh-math-render

安裝完成後，需要重啓 harness（讀取 bundle 列表）並刷新 GUI 頁面，插件才能生效。

核心功能¶

1. 消息氣泡渲染
   插件覆蓋了原本的用戶氣泡渲染器。在消息中使用 $...$、$$...$$、\(...\) 或 \[...\] 語法，內容會以公式形式渲染在對話中。助手回覆的渲染依然由 shell 的 KaTeX 流水線處理，不受此插件影響。

2. 實時預覽
   當編輯器草稿中包含公式時，輸入框上方會出現預覽條，展示當前輸入的公式效果。如果草稿中沒有任何公式，該預覽條不會出現。

3. 診斷路由
   插件提供了診斷路由，可用於監控插件掛載狀態。

典型用法¶

1. 輸入預覽：在輸入框中輸入 $x^2$，上方會顯示預覽條，展示平方公式。
2. 消息展示：發送包含 $E=mc^2$ 的消息，該消息會以公式形式渲染在對話中。

行爲細節¶

• 無公式渲染：消息如果沒有 TeX 語法，渲染行爲與官方插件一致，純文本不受影響（如 *、#、反引號保持原意）。
• 轉義機制：反引號（`）內的內容是轉義出口，不會被解析爲公式。
• 貨幣符號：單獨的 $ 符號（例如緊跟在數字後或空格後）不會被誤判爲數學符號。
• 錯誤處理：語法錯誤的 TeX 會被 KaTeX 渲染引擎報錯，錯誤信息與助手回覆一致。
• 回退機制：如果渲染器崩潰，插件會放棄該單元格，回退到官方的氣泡渲染，不會破壞對話記錄。

限制與注意事項¶

1. 氣泡樣式限制
   氣泡的幾何樣式（CSS）是直接複製的，無法通過插件重命名哈希類名進行自定義。顏色、字體和間距依賴 DSH 的 --dsh-* / --dsw-* 自定義屬性，這些樣式由 shell 控制。移除插件後，氣泡會恢復到官方樣式。

2. 預覽模式限制
   預覽是一個獨立的條帶，不是編輯器內的內聯所見即所得（WYSIWYG）編輯。編輯器本身是 Lexical 編輯器，插件未暴露內聯組件。

3. 配置互斥
   插件提供的 dsh.bundle 配置與手寫的 file:// 行設置不能同時啓用，兩者是互斥的 Loader 源。

兼容性¶

• 引擎要求：需要 dsh >= 0.1.5-rc.1。
• 驗證版本：已在 dsh 0.1.5-rc.2 上驗證通過。

結語¶

dsh-math-render 爲 DSH 網頁端增加了基礎的 LaTeX 渲染能力，通過簡單的安裝即可提升數學符號的展示體驗。更多細節可參考 GitHub 倉庫 或 社區目錄。