# Python实战：用DeepSeek API打造一个PDF技术手册自动翻译
AI-long | TransPDF
背景
日常开发中经常需要阅读英文PDF技术文档。本文介绍如何用Python + DeepSeek API构建一个桌面端的PDF自动翻译工具——TransPDF的核心实现思路。
技术栈
- Python 3.10+
- PyMuPDF (fitz): PDF文本提取
- DeepSeek API: AI翻译引擎
- CustomTkinter: 现代化暗黑GUI
- WeasyPrint / PyMuPDF Story: Markdown→PDF渲染
第一步：PDF文本提取
import fitz
def extract_page_text(pdf_path, page_num):
doc = fitz.open(pdf_path)
page = doc[page_num]
text = page.get_text("markdown")
doc.close()
return text
PyMuPDF支持直接以Markdown格式导出文本，保留了标题、列表、粗体等结构信息，这是后续高质量翻译的关键。
第二步：调用DeepSeek API翻译
import requests
def translate_page(api_key, markdown_text, page_number):
system_prompt = "你是一名技术手册翻译专家..."
response = requests.post(
"https://api.deepseek.com/chat/completions",
headers={"Authorization": f"Bearer {api_key}"},
json={
"model": "deepseek-chat",
"messages": [
{"role": "system", "content": system_prompt},
{"role": "user", "content": markdown_text}
],
"temperature": 0.2
},
timeout=60
)
return response.json()["choices"][0]["message"]["content"]
关键点：
- System Prompt指定了"代码不翻译、保留Markdown格式"等规则
- temperature设为0.2，让翻译结果更稳定
- timeout设60秒，防止大页面积压
第三步：断点续传与重试
这是工程中最关键的部分：
import time
from pathlib import Path
def translate_with_retry(api_key, text, page_num, cache_dir):
cache_file = cache_dir / f"page_{page_num:04d}.md"
# 断点续传：已有缓存直接跳过
if cache_file.exists() and cache_file.read_text().strip():
return cache_file.read_text()
# 重试机制
for attempt in range(3):
try:
result = translate_page(api_key, text, page_num)
cache_file.write_text(result, encoding="utf-8")
return result
except Exception as e:
if attempt == 2:
raise
time.sleep(3)
time.sleep(1) # 页间延迟，避免API限流
第四步：Markdown合并与PDF渲染
翻译完成后，将所有缓存的Markdown合并，用CSS渲染为PDF：
import markdown
def render_to_pdf(output_md_path, final_pdf_path):
md_text = Path(output_md_path).read_text()
html_body = markdown.markdown(md_text, extensions=["extra", "tables", "fenced_code"])
html = f"""
<html><head><meta charset="utf-8">
<style>
body {{ font-family: "Microsoft YaHei", sans-serif; }}
pre {{ background: #f6f8fa; padding: 12px; border-radius: 6px; }}
table {{ border-collapse: collapse; width: 100%; }}
th, td {{ border: 1px solid #d0d7de; padding: 6px 10px; }}
</style></head>
<body>{html_body}</body></html>
"""
# 使用 PyMuPDF Story 或 WeasyPrint 渲染
story = fitz.Story(html)
pdf = story.write_with_links(rectfn)
pdf.save(final_pdf_path)
第五步：GUI界面
用CustomTkinter搭建暗黑主题界面，所有耗时操作放在后台线程：
import customtkinter as ctk
import threading
class App(ctk.CTk):
def start_translation(self):
thread = threading.Thread(target=self._translate_all)
thread.start()
def _translate_all(self):
# 后台线程中执行翻译
# 通过队列将进度传回主线程更新UI
pass
成本分析
实测翻译100页英文技术文档（每页约500词）：
- 软件授权：¥99（一次性）
- DeepSeek API费用：约¥0.5-1.0
- 总耗时：3-5分钟（全自动）
对比人工翻译2000+元的价格，性价比极高。
成品
这个工具已经打包为独立exe，可在Windows 10/11上直接运行。感兴趣的朋友可以在评论区找到获取方式。
欢迎使用Markdown编辑器
你好！ 这是你第一次使用 Markdown编辑器 所展示的欢迎页。如果你想学习如何使用Markdown编辑器, 可以仔细阅读这篇文章，了解一下Markdown的基本语法知识。
新的改变
我们对Markdown编辑器进行了一些功能拓展与语法支持，除了标准的Markdown编辑器功能，我们增加了如下几点新功能，帮助你用它写博客：
- 全新的界面设计 ，将会带来全新的写作体验；
- 在创作中心设置你喜爱的代码高亮样式，Markdown 将代码片显示选择的高亮样式 进行展示；
- 增加了 图片拖拽 功能，你可以将本地的图片直接拖拽到编辑区域直接展示；
- 全新的 KaTeX数学公式 语法；
- 增加了支持甘特图的mermaid语法1 功能；
- 增加了 多屏幕编辑 Markdown文章功能；
- 增加了 焦点写作模式、预览模式、简洁写作模式、左右区域同步滚轮设置 等功能，功能按钮位于编辑区域与预览区域中间；
- 增加了 检查列表 功能。
功能快捷键
撤销：Ctrl/Command + Z
重做：Ctrl/Command + Y
加粗：Ctrl/Command + B
斜体：Ctrl/Command + I
标题：Ctrl/Command + Shift + H
无序列表：Ctrl/Command + Shift + U
有序列表：Ctrl/Command + Shift + O
检查列表：Ctrl/Command + Shift + C
插入代码：Ctrl/Command + Shift + K
插入链接：Ctrl/Command + Shift + L
插入图片：Ctrl/Command + Shift + G
查找：Ctrl/Command + F
替换：Ctrl/Command + G
合理的创建标题，有助于目录的生成
直接输入1次#，并按下space后，将生成1级标题。
输入2次#，并按下space后，将生成2级标题。
以此类推，我们支持6级标题。有助于使用TOC语法后生成一个完美的目录。
如何改变文本的样式
强调文本 强调文本
加粗文本 加粗文本
标记文本
删除文本
引用文本
H2O is是液体。
210 运算结果是 1024.
插入链接与图片
链接: link.
图片:
带尺寸的图片:
居中的图片:
居中并且带尺寸的图片:
当然，我们为了让用户更加便捷，我们增加了图片拖拽功能。
如何插入一段漂亮的代码片
去博客设置页面，选择一款你喜欢的代码片高亮样式，下面展示同样高亮的 代码片.
// An highlighted block
var foo = 'bar';
生成一个适合你的列表
- 项目
- 项目
- 项目
- 项目
- 项目1
- 项目2
- 项目3
- 计划任务
- 完成任务
创建一个表格
一个简单的表格是这么创建的：
| 项目 | Value |
|---|---|
| 电脑 | $1600 |
| 手机 | $12 |
| 导管 | $1 |
设定内容居中、居左、居右
使用:---------:居中
使用:----------居左
使用----------:居右
| 第一列 | 第二列 | 第三列 |
|---|---|---|
| 第一列文本居中 | 第二列文本居右 | 第三列文本居左 |
SmartyPants
SmartyPants 是一个文本转换工具，主要功能是将普通的 ASCII 标点符号自动转换为更美观的印刷体标点符号。例如：
| 原始符号 | 转换后 | 说明 |
|---|---|---|
"引号" | “引号” | 直引号变弯引号 |
'单引号' | ‘单引号’ | 直单引号变弯单引号 |
-- | – | 两个连字符变短破折号 |
--- | — | 三个连字符变长破折号 |
... | … | 三个点变省略号 |
创建一个自定义列表
-
Markdown
- Text-to- HTML conversion tool Authors
- John
- Luke
如何创建一个注脚
一个具有注脚的文本。2
注释也是必不可少的
Markdown将文本转换为 HTML。
KaTeX数学公式
您可以使用渲染LaTeX数学表达式 KaTeX:
Gamma公式展示 Γ ( n ) = ( n − 1 ) ! ∀ n ∈ N \Gamma(n) = (n-1)!\quad\forall n\in\mathbb N Γ(n)=(n−1)!∀n∈N 是通过欧拉积分
Γ ( z ) = ∫ 0 ∞ t z − 1 e − t d t . \Gamma(z) = \int_0^\infty t^{z-1}e^{-t}dt\,. Γ(z)=∫0∞tz−1e−tdt.
你可以找到更多关于的信息 LaTeX 数学表达式here.
新的甘特图功能，丰富你的文章
- 关于 甘特图 语法，参考 这儿,
UML图表
可以使用UML图表进行渲染，例如下面产生的一个序列图：
- 关于 UML图表 语法，参考 这儿,
流程图
- 关于 Mermaid 语法，参考 这儿,
FLowchart流程图
我们依旧会支持flowchart.js的流程图语法：
- 关于 Flowchart流程图 语法，参考 这儿.
导出与导入
导出
如果你想尝试使用此编辑器, 你可以在此篇文章任意编辑。当你完成了一篇文章的写作, 在上方工具栏找到 文章导出 ，生成一个.md文件或者.html文件进行本地保存。
导入
如果你想加载一篇你写过的.md文件，在上方工具栏可以选择导入功能进行对应扩展名的文件导入，
继续你的创作。
注脚的解释 ↩︎
汇聚全球AI编程工具，助力开发者即刻编程。
更多推荐
6
0- 0
已为社区贡献1条内容
所有评论(0)