或使用完整路径的 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 翻译 入口：

点击 选择 PDF。
确认输出目录和翻译页码，支持 all、1-5、1,3,5-8。
点击 开始翻译。
在 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 翻译 入口：

点击 选择 PDF。
确认输出目录和翻译页码，支持 all、1-5、1,3,5-8。
点击 开始翻译。
在 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`	显示或隐藏翻译面板

输出结构

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

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

Install

README

或使用完整路径的 powershell.exe

使用

输出结构

数据与更新

开发与测试

许可证

使用

输出结构