前言¶
在 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
