dsh-pdf-translator

或使用完整路径的 powershell.exe

& "$env:SystemRoot\System32\WindowsPowerShell\v1.0\powershell.exe" -ExecutionPolicy Bypass -File "$env:USERPROFILE.dsh\profiles\desktop\node_modules\dsh-pdf-translator\scripts\setup.ps1"

Web / CLI profile 把 `desktop` 换成 `web`。然后编辑模型配置：

```text
%USERPROFILE%\.dsh\dsh-pdf-translator\config.json

{
  "base_url": "https://api.deepseek.com/v1",
  "model": "REPLACE_WITH_A_VISION_MODEL",
  "api_key": "REPLACE_WITH_YOUR_KEY",
  "thinking": "auto",
  "auto_repair_rounds": 3
}

手动改完后无需重启，直接翻译即可。也可以在聊天中发送「调用 pdf_translator_doctor 检查 PDF 翻译插件环境」。

使用

页面左下角和聊天标题栏都有 PDF 翻译 入口：

1. 点击 选择 PDF。
2. 确认输出目录和翻译页码，支持 all、1-5、1,3,5-8。
3. 点击 开始翻译。
4. 在 Harness 任务列表查看进度和结果。

也可以直接在聊天中说明：

使用 pdf_translate，把 D:\资料\paper.pdf 的第 1–3 页翻译为中文，先用 pdf_inspect 检查页数。

常用工具：

工具	用途
pdf_translate	翻译并生成中文 PDF 和 LaTeX 源码压缩包
pdf_inspect	查看页数、文件大小，校验页码范围
pdf_review	开启 AI 核验后逐页检查、预览和修订
pdf_translator_doctor	检查 Python、排版运行时和模型配置
pdf_cache_list	只读查看缓存
pdf_panel	显示或隐藏翻译面板

pdf_translate 主要参数：pdf、pages、workers（1–8，默认 4）、imageQuality、thinking、renderOnly、outputDir、background。默认后台执行，也可以通过 background: false 等待结果。

输出结构

每次翻译在所选输出目录下新建一个以文档名和时间命名的子文件夹，里面只有两个文件：

输出目录\论文名_20261024-120019_ab12cd\
├── 论文名_0cb8b7_zh.pdf          中文 PDF
└── 论文名_0cb8b7_zh-latex.zip    LaTeX 源码压缩包

zip 内是可直接用 XeLaTeX 或 Tectonic 编译的完整工程（main.tex、layout.tex、images/、README.txt 等），不包含编译日志和中间文件。译文、结构数据和核查报告保存在插件数据目录的 work 下，不会出现在输出目录。

main.tex 的字体是条件选择的：本机有宋体 / Times New Roman 时保持原样，缺少时（如 Overleaf）自动改用 Fandol 和 TeX Gyre Termes。因此整个 zip 可以直接上传 Overleaf，编译器选 XeLaTeX 即可，不需要改字体；记得连同 images/ 一起上传。

数据与更新

用户数据默认保存在：

%USERPROFILE%\.dsh\dsh-pdf-translator

包含 config.json、.venv、runtime、outputs 和 work。更新或重装插件不会删除这些数据；卸载后如需彻底清理，可手动删除该目录。

可用环境变量覆盖：

变量	用途
DSH_PDF_DATA_DIR	数据、缓存和输出目录
DSH_PDF_CONFIG	模型配置文件
DSH_PDF_PYTHON	Python 可执行文件
DSH_PDF_RUNTIME_DIR	Pandoc / Tectonic 目录

翻译时选中的页面图片会发送到配置的模型接口，可能产生 API 费用。API 密钥只保存在本机配置或进程环境中。

开发与测试

npm.cmd ci
npm.cmd run build
npm.cmd run check
npm.cmd test
.venv\Scripts\python.exe -m unittest discover -s work -p 'test_*.py'
npm.cmd pack
node scripts\verify-package.mjs dsh-pdf-translator-0.2.5.tgz

许可证

MIT，详见 LICENSE。

使用

页面左下角和聊天标题栏都有 PDF 翻译 入口：

1. 点击 选择 PDF。
2. 确认输出目录和翻译页码，支持 all、1-5、1,3,5-8。
3. 点击 开始翻译。
4. 在 Harness 任务列表查看进度和结果。

也可以直接在聊天中说明：

使用 pdf_translate，把 D:\资料\paper.pdf 的第 1–3 页翻译为中文，先用 pdf_inspect 检查页数。

常用工具：

工具	用途
pdf_translate	翻译并生成中文 PDF 和 LaTeX 源码压缩包
pdf_inspect	查看页数、文件大小，校验页码范围
pdf_review	开启 AI 核验后逐页检查、预览和修订
pdf_translator_doctor	检查 Python、排版运行时和模型配置
pdf_cache_list	只读查看缓存
pdf_panel	显示或隐藏翻译面板

pdf_translate 主要参数：pdf、pages、workers（1–8，默认 4）、imageQuality、thinking、renderOnly、outputDir、background。默认后台执行，也可以通过 background: false 等待结果。

输出结构

每次翻译在所选输出目录下新建一个以文档名和时间命名的子文件夹，里面只有两个文件：

输出目录\论文名_20261024-120019_ab12cd\
├── 论文名_0cb8b7_zh.pdf          中文 PDF
└── 论文名_0cb8b7_zh-latex.zip    LaTeX 源码压缩包

zip 内是可直接用 XeLaTeX 或 Tectonic 编译的完整工程（main.tex、layout.tex、images/、README.txt 等），不包含编译日志和中间文件。译文、结构数据和核查报告保存在插件数据目录的 work 下，不会出现在输出目录。

main.tex 的字体是条件选择的：本机有宋体 / Times New Roman 时保持原样，缺少时（如 Overleaf）自动改用 Fandol 和 TeX Gyre Termes。因此整个 zip 可以直接上传 Overleaf，编译器选 XeLaTeX 即可，不需要改字体；记得连同 images/ 一起上传。