pip install pdf2zh

FROM 文件路径
TEMPLATE 模型提示词的模板
SYSTEM 定义模型的角色、行为、风格

PARAMETER stop <｜hy_end▁of▁sentence｜>
PARAMETER stop </｜hy_end▁of▁sentence｜>
    阻止模型输出参数到翻译内容；
PARAMETER stop <｜hy_User｜>
    阻止模型输出自言自语的内容；
PARAMETER stop <｜hy_Assistant｜>
    阻止模型输出无意义的垃圾内容。

PARAMETER temperature 0.8
	默认0.8
	控制模型回答内容的创造性/随机性。
    参数是0时完全抛弃随机性，0.1-0.4回答直奔主题，很少胡言乱语。
    0.7-0.9均衡表现，1.0-1.5开始天马行空偶尔胡编乱造。
PARAMETER seed 42
	配合 temperature 0.1 参数让模型生成的文本稳定到每次都一模一样。
PARAMETER repeat_penalty 1.1
	默认1.1
	控制模型复读的概率，重复惩罚。
    参数是1.0时让模型随意复读，1.1-1.2有效抑制模型复读的情况。
    1.3极度让模型强制排斥重复词汇并自动找补。
PARAMETER repeat_last_n 64
	默认64
	配合 repeat_penalty 参数阻止模型在一定短语内无限重复使用相同词
PARAMETER num_ctx 2048
	默认2048
	控制模型上下文的上限。根据显存设置上限，如8GB=8192，16GB=16384。
    或是根据模型支持的上下文上限设置，如qwen2.5:7b=8192，qwen3:8b=32768。
PARAMETER num_predict 128
	默认128
	控制模型生成内容的上限。，-1无限，-2填满上下文

FROM C:\Users\Downloads\Hy-MT2-7B-Q4_K_M.gguf

PARAMETER stop "<｜hy_end▁of▁sentence｜>"
PARAMETER stop "</｜hy_end▁of▁sentence｜>"
PARAMETER stop "<｜hy_User｜>"
PARAMETER stop "<｜hy_Assistant｜>"

PARAMETER temperature 0
PARAMETER seed 42
PARAMETER repeat_penalty 1.05
PARAMETER repeat_last_n 64
PARAMETER num_ctx 8192
PARAMETER num_predict 4096

You are a professional technical document translation engine.
Translate the source text from ${lang_in} into ${lang_out}.

Rules:
1.Translate faithfully. Do not summarize, omit, expand, explain, or add information that is not present in the source.
2.Output only the translated text. Do not add introductions, conclusions, notes, or explanations.
3.Preserve the original order and paragraph boundaries. Do not merge separate paragraphs or split a paragraph without a clear reason.
4.Preserve all numbers, URLs, file paths, identifiers, command-line options, API names, and technical terms that should remain unchanged.
5.Preserve mathematical expressions, LaTeX, equations, variable symbols, and special markup exactly.
6.Preserve code, programming syntax, indentation, string literals, variable names, function names, and identifiers. Never rewrite code or translate code identifiers.
7.Translate natural-language comments or prose only when they can be clearly distinguished from executable code.
8.Preserve every placeholder and special marker exactly, including its spelling, capitalization, order, and count. Never remove, duplicate, translate, or modify placeholders.
9.Preserve headings, list numbering, table structure, citations, and meaningful line breaks.
10.Do not add Markdown fences, labels, or formatting that does not exist in the source.
11.Keep the translation concise and faithful. Do not add unnecessary words that may cause text expansion.
12.If a segment is code, a formula, or an ambiguous non-translatable fragment, preserve it rather than guessing.

Source text:
${text}

Translated text:

python C:\PyScript\translate_pdf2zh.py C:\PyScript\test.pdf --model hy-mt2-pdf:7b --no-skip-subset-fonts --pages 29 --prompt-file C:\Users\Documents\PyScript\prompt.txt

# 最简：整本翻译，模型用默认值
python translate_pdf2zh.py "book.pdf"

# 指定模型（不指定时：TTY 下交互选择已装模型）
python translate_pdf2zh.py "book.pdf" --model Hy-MT2

# 只自检不翻译：查 PDF 页数 / Ollama 服务与模型 / pdf2zh 是否可用
python translate_pdf2zh.py "book.pdf" --model Hy-MT2 --dry-run

# 只译前 5 页验质量，看版式与术语是否正常
python translate_pdf2zh.py "book.pdf" --model Hy-MT2 --probe-only

# 只译指定页范围（可多段，逗号分隔，越界部分自动裁掉）
python translate_pdf2zh.py "book.pdf" --pages 1-50
python translate_pdf2zh.py "book.pdf" --pages 1-5,20-30

# 非交互环境 / 重定向输出到文件时手动关面板，用普通滚动日志
python translate_pdf2zh.py "book.pdf" --model Hy-MT2 --plain > run.log 2>&1

# 调参：分片页数 / 单片超时 / 模型常驻时长 / 输出目录 / 保留分片 / 失败即停
python translate_pdf2zh.py "book.pdf" --model Hy-MT2 \
    --pages-per-chunk 10 --timeout 1800 --keep-alive 10m \
    --out-dir ./out --keep-chunks --stop-on-error

# 指定源语言与目标语言（默认英译中；也可写全称或中文）
python translate_pdf2zh.py "book.pdf" --src-lang English --dst-lang 中文

# 自定义翻译提示词（UTF-8，可含 ${lang_in} / ${lang_out} / ${text} 占位符）
python translate_pdf2zh.py "book.pdf" --prompt-file my_prompt.txt

ImportError: cannot import name 'TextTranslateRequest' from 'tencentcloud.tmt.v20180321.models'

# 先卸载现有版本
pip uninstall tencentcloud-sdk-python
# 接着安装可用版本
pip install tencentcloud-sdk-python==3.0.1257