前言¶
在 DeepSeek Harness（DSH）的 Web UI 中查看數學內容時，常常會遇到一類很具體的需求：看到一段行內公式或塊級公式，想快速拿到 TeX 源碼；或者想把某個公式單獨導出成文件，用於論文、PPT、網頁等場景。
DSH 的理念是「一切皆插件」，社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係，不要把它理解成官方應用商店。dsh-latex-tools 是一個面向 DSH Web UI 的插件：懸停任意 LaTeX 公式後，可以複製 TeX 源碼，也可以導出爲獨立的 SVG 文件。
這是什麼¶
dsh-latex-tools 是一個 MIT 許可的 DSH Web UI 插件，由 liuup 維護。它解決的問題很直接：在 DSH Web UI 中查看 LaTeX 公式時，提供「複製 LaTeX」和「導出 SVG」兩個操作。
核心功能¶
下面介紹已覈實的功能點。
-
複製 LaTeX
鼠標懸停行內或塊級 LaTeX 公式時，可點擊「複製 LaTeX」，將 TeX 源碼複製到剪貼板。 -
導出 SVG
可點擊「導出 SVG」，公式經 MathJax 渲染爲自包含的矢量圖，並下載爲formula-<slug>.svg。該文件可用於論文、PPT、網頁等場景。 -
離線可用
MathJax 腳本由插件自身的 host half 提供。首次導出時按需加載，之後由瀏覽器緩存，不依賴任何 CDN。 -
支持行內與塊級公式
插件支持行內公式和塊級公式；塊級公式按 display 模式導出。
安裝與啓用¶
安裝前要求環境中已有 Node.js。DSH 插件通過官方 npm 方式運行，不需要全局安裝。
先啓動 Web UI：
npx @deepseek-ai/dsh web
安裝 dsh-latex-tools：
npx @deepseek-ai/dsh plugin --profile web add dsh-latex-tools
插件安裝進 web profile 後，會隨 Web UI 啓動自動加載，無需手動啓用。
這個插件沒有配置項，因此不會出現在 Settings → Plugins 列表中。這裏顯示的是有配置項的插件；沒有配置項的插件不會出現在那裏。
安裝的是預構建產物，裝完重啓 Web UI 即可。
驗證安裝¶
可以執行下面的命令檢查插件層是否出現：
npx @deepseek-ai/dsh --profile web --dump-config
輸出中應能看到：
# == dsh-latex-tools
也可以在瀏覽器中檢查以下路徑是否存在：
/plugins/dsh-latex-tools/client.js
/dsh-latex-tools/mathjax/es5/tex-svg.js
其中：
/plugins/dsh-latex-tools/client.js是 browser half 的 bundle。/dsh-latex-tools/mathjax/es5/tex-svg.js是 SVG 導出用的 MathJax。
典型用法¶
下面給出可復現的使用步驟。
- 鼠標懸停公式，行內公式或塊級公式均可。
- 點擊「複製 LaTeX」，TeX 源碼即進入剪貼板。
- 如果需要導出文件，點擊「導出 SVG」。
- 公式經 MathJax 渲染爲自包含的矢量圖，並下載爲
formula-<slug>.svg。 - 該 SVG 文件可用於論文、PPT、網頁等場景。
插件裝進 profile 後，隨 Web UI 啓動自動加載，無需手動啓用。安裝預構建產物後，重啓 Web UI 即可生效。
GitHub 安裝與源碼安裝¶
如果需要從 GitHub 安裝，可以使用：
npx @deepseek-ai/dsh plugin --profile web add github:liuup/dsh-latex-tools
這種方式拉取的是源碼。pnpm 會自動執行包內的 prepare 腳本完成構建。需要注意，pnpm ≥10 默認拒絕運行 git 依賴的 prepare 腳本，首次 add 可能會失敗。
遇到這種情況時，按 dsh 打印的提示，把對應條目加入 profile 的 pnpm-workspace.yaml 中的 allowBuilds 段，然後重跑安裝命令。
生產使用建議 pin 到具體提交：
npx @deepseek-ai/dsh plugin --profile web add github:liuup/dsh-latex-tools#<commit-sha>
如果選擇本地源碼安裝，需要先本地構建。產物 lib/ 已被 gitignore，因此不能跳過構建直接安裝。步驟如下：
git clone https://github.com/liuup/dsh-latex-tools.git
cd dsh-latex-tools
pnpm install && pnpm build
npx @deepseek-ai/dsh plugin --profile web add link:/absolute/path/to/dsh-latex-tools
npx @deepseek-ai/dsh web
卸載¶
從 web profile 移除插件：
npx @deepseek-ai/dsh plugin --profile web remove dsh-latex-tools
重啓 Web UI 後生效。
適用場景與注意¶
適合在 DSH Web UI 中頻繁查看、複製或導出 LaTeX 公式的用戶。典型用途包括：
- 把公式 TeX 源碼複製到編輯器或筆記中。
- 將公式導出爲獨立 SVG，用於論文、PPT、網頁。
- 在無外部 CDN 依賴的環境下完成公式導出。
安裝第三方插件前，建議檢查源碼與許可證。dsh-latex-tools 的許可證爲 MIT。
需要特別注意：插件以當前 dsh 進程權限運行。安裝前請確認你信任該插件的來源和代碼。
結尾¶
dsh-latex-tools 解決的問題很具體：在 DSH Web UI 中懸停 LaTeX 公式後，可以複製 TeX 源碼，也可以導出爲獨立 SVG。它沒有配置項，安裝後隨 Web UI 自動加載，適合需要處理數學公式內容的開發者。
GitHub 倉庫：
https://github.com/liuup/dsh-latex-tools
