dsh-latex-tools

Readme

<h1 align="center">dsh-latex-tools</h1>

<p align="center"><a href="./README_en.md">English</a> | 中文</p>

<p align="center">♾️ Copy and export the LaTeX in DeepSeek Harness 悬停任意 LaTeX 公式，即可复制 TeX 源码或导出为独立的 SVG 文件</p>

<p align="center">🐳 All the code are proundly generated by DeepSeek V4 Flash 0731</p>

<p align="center">
  <img src="./images/image_1.png" alt="dsh-latex-tools 悬停公式显示复制/导出工具条" width="720" />
</p>

## 功能

- **复制 LaTeX**：鼠标悬停公式（行内或块级），点击「复制 LaTeX」，TeX 源码即进入剪贴板。
- **导出 SVG**：点击「导出 SVG」，公式经 MathJax 渲染为**自包含的矢量图**（字形轮廓内嵌为 path，无外部字体/样式依赖），下载为 `formula-<slug>.svg`，可用于论文、PPT、网页。
- 完全离线可用：MathJax 脚本由插件自身的 host half 提供，首次导出时才按需加载，之后浏览器缓存；不依赖任何 CDN。
- 支持行内与块级公式（块级按 display 模式导出）。

## 安装

要求：安装 Node.js，然后直接用官方 npm 方式运行（无需全局安装）：

```sh
npx @deepseek-ai/dsh web
```

插件装进 profile 后随 Web UI 启动自动加载，**无需手动启用**；Settings → Plugins 列表只显示有配置项的插件，本插件没有配置项，不会出现在那里。

一键 npm 安装

```sh
npx @deepseek-ai/dsh plugin --profile web add dsh-latex-tools
```

安装的是预构建产物，无需本地构建、无需任何额外配置，装完重启 Web UI 即可。

### 验证安装

```sh
npx @deepseek-ai/dsh --profile web --dump-config   # 应看到 "# == dsh-latex-tools" 层
# 浏览器检查：
#   /plugins/dsh-latex-tools/client.js   —— browser half 的 bundle
#   /dsh-latex-tools/mathjax/es5/tex-svg.js  —— SVG 导出用的 MathJax（约 2.1 MB）
```

<p align="center">
  <img src="./images/image_2.png" alt="dsh-latex-tools plugin list" width="550" />
</p>


### 卸载

```sh
npx @deepseek-ai/dsh plugin --profile web remove dsh-latex-tools
```

从 `web` profile 移除插件依赖与配置层，重启 Web UI 后生效。

<details>
<summary><b>开发</b>（构建、测试、GitHub/源码安装，点击展开）</summary>

```sh
pnpm install
pnpm typecheck   # tsc --noEmit
pnpm test        # vitest（jsdom：工具条显隐 / 复制 / SVG 导出）
pnpm build       # tsdown：lib/index.js（host half）+ lib/client.js（browser half）
```

### 从 GitHub 安装（无需本地构建）

```sh
npx @deepseek-ai/dsh plugin --profile web add github:liuup/dsh-latex-tools
```

git 安装拉取的是源码，pnpm 会自动执行包内的 `prepare` 脚本完成构建。pnpm ≥10 默认拒绝运行 git 依赖的 `prepare`，**首次 `add` 会失败**——`dsh` 会打印指引：按提示把对应条目加入 profile 的 `pnpm-workspace.yaml`（`allowBuilds` 段），然后重跑上面的命令。生产使用建议 pin 提交：`github:liuup/dsh-latex-tools#<commit-sha>`。

### 本地源码安装（开发/自用）

```sh
git clone https://github.com/liuup/dsh-latex-tools.git
cd dsh-latex-tools
pnpm install && pnpm build          # 构建出 lib/（产物已被 gitignore，必须本地构建）
npx @deepseek-ai/dsh plugin --profile web add link:/absolute/path/to/dsh-latex-tools
npx @deepseek-ai/dsh web            # 启动 Web UI
```

</details>


## License

[MIT](./LICENSE)