PDF-AI-Viewer

PDF 阅读翻译器 # PDF 阅读翻译器 / PDF Reader & Translator 读英文文献太慢？划词即译，一句话让 AI 总结整篇论文，读完自动变成你自己的 `.md` 笔记。 **免费、开源、单文件免安装。** A desktop PDF reader with select-to-translate, AI full-document summary and ask-the-paper chat. **Free, open source, single-file portable.** [![Stars](https://img.shields.io/github/stars/fangvv/PDF-AI-Viewer?style=social)](https://github.com/fangvv/PDF-AI-Viewer/stargazers) [![Forks](https://img.shields.io/github/forks/fangvv/PDF-AI-Viewer?style=social)](https://github.com/fangvv/PDF-AI-Viewer/forks) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE) [![Python 3.9+](https://img.shields.io/badge/Python-3.9%2B-blue.svg)](https://www.python.org/) [![Platform Windows](https://img.shields.io/badge/Platform-Windows-lightgrey.svg)](#-快速开始--quick-start)

面向研究生、科研党，以及任何需要大量阅读英文文献的人。 Built for graduate students, researchers, and anyone who has to read a lot of English papers.

📖 目录 / Table of Contents

🚀 快速开始 / Quick Start

Windows 用户：下载这一个文件，双击即用。不需要装 Python，不需要配环境。

  1. 下载 PDF阅读翻译器.exe（约 60 MB，免安装便携版）
  2. 双击打开，把 PDF 拖进窗口
  3. 刷选文本点「翻译」即可 —— 微软 Edge / MyMemory 引擎无需任何 API Key，开箱即用
  4. 只有想用「大模型翻译 / 全文总结 / AI 问答」时，才需要在「设置 → 大模型设置」填一次 Key

👉 ⬇ 下载 Windows 免安装版

也可以到 Releases 或仓库的 dist/ 目录获取。

Windows users: download one file and double-click it. No Python, no environment setup.

  1. Download PDF阅读翻译器.exe (~60 MB, portable build)
  2. Double-click it and drag a PDF into the window
  3. Select text and click “Translate” — the Microsoft Edge / MyMemory engines need no API key at all
  4. A key is only required for LLM translation / summary / AI chat, configured once under “Settings → LLM Settings”

不想下载 exe？从源码运行 只需 3 行命令。 Prefer the source? Run from source in 3 commands.

📸 界面一览 / Screenshots

左侧阅读 PDF，右侧看译文，中间浮着 AI 总结报告。夜间模式下 PDF 页面自动反色（白底变黑底），工具栏、翻译面板与问答窗口同步切换。

PDF on the left, translation on the right, AI summary report floating in the middle. In dark mode PDF pages are automatically inverted, and the toolbar, translation panel and chat window follow the theme.

日间主题：主界面与 AI 总结
Light: main window with the AI summary		 夜间主题：PDF 页面自动反色
Dark: PDF pages automatically inverted
日间主题：主界面与 AI 总结 夜间主题：PDF 反色
AI 阅读问答：整篇文献随行，问完即成笔记
AI chat: the whole paper as context, every Q&A becomes a note		 大模型设置：任意 OpenAI 兼容服务商，模型可下拉拉取
LLM settings: any OpenAI-compatible provider
AI 阅读问答 大模型设置

⭐ 为什么选它 / Why This One

读文献时 没有工具的日子 用本项目
遇到生词长句 复制到翻译网页，窗口来回切 刷选文本，翻译按钮就在鼠标旁，原地出译文
想知道论文讲了什么 从头读到尾，自己抄要点 「全文总结」一键生成结构化报告，流式输出
有疑问要追问 手动复制段落去问大模型 「AI 问答」自动带上整篇文献，多轮追问
读完留个记录 新建文档一条条敲 问答自动写进同名 .md，重开文献即恢复
晚上读文献 白底屏幕刺眼 夜间模式，PDF 页面自动反色
二次开发 / 自己接模型 没门 MIT 开源，支持任意 OpenAI 兼容接口

本表只对照「没有工具时的手工流程」，不评价其他任何软件。上表本项目一栏均为当前版本的实际能力，其余以各软件官方说明为准。

一句话：它不只是「多一个翻译按钮」，而是把读完一篇论文做成一条流水线 —— 划词翻译 → 全文总结 → 边读边问 → 自动生成笔记。

In short: not just “another translate button” — it turns finishing a paper into one pipeline: select-to-translate → full-document summary → ask the paper → notes written automatically.

功能特性 / Features

使用说明 / Usage

  1. 点击「打开 PDF」或使用 Ctrl + O 打开一个 PDF 文件（也可直接把 PDF 拖到窗口）
  2. 在左侧 PDF 中用鼠标刷选要翻译的文本，翻译按钮会出现在鼠标附近，点击即可翻译
  3. 翻译结果显示在右侧；也可点击「翻译选中内容」或按 Ctrl + T
  4. 可在右上角选择翻译引擎（自动 / 微软 Edge / 大模型 / MyMemory）
  5. 使用「A- / A+」按钮调节翻译字体大小
  6. 缩放：工具栏选择适合页面 / 适合宽度 / 百分比，或按住 Ctrl 滚动鼠标滚轮快速缩放
  7. 点击工具栏「全文总结」对整篇论文生成总结，结果在独立窗口中流式显示
  8. 点击工具栏「AI 问答」或按 Ctrl + Shift + Q 呼出问答窗口，边读边提问；Enter 发送，Shift + Enter 换行，回答期间按钮变「停止」可随时中断
  9. 问答会自动写入与 PDF 同目录同名的 .md 文件，可随时点「打开笔记」用系统默认程序查看/编辑
  10. 在工具栏搜索框输入关键词回车，即可全文搜索并高亮定位，支持「上一个 / 下一个」跳转
  11. 首次使用大模型翻译或总结前，请到「设置 → 大模型设置」填写接口地址、API Key 和模型名（AI 问答使用同一套配置）
  12. 夜间阅读可到「设置 → 主题」切换夜间模式，PDF 页面会自动反色，问答窗口同步切换
  13. 若 PDF 自带内部链接，点击正文中的参考文献引用（如 [1]）可直接跳转到文末对应条目
  14. 关闭程序后，下次打开同一 PDF 会自动跳转到上次阅读位置，并恢复窗口与问答窗口状态
  1. Click “Open PDF” or press Ctrl + O to open a PDF file (or drag a PDF onto the window)
  2. Select the text you want to translate in the PDF on the left; a translate button appears near the mouse — click it to translate
  3. The result appears on the right; you can also click “Translate Selected” or press Ctrl + T
  4. Choose a translation engine in the top-right (Auto / Microsoft Edge / LLM / MyMemory)
  5. Use the “A- / A+” buttons to adjust the translation font size
  6. Zoom: choose Fit Page / Fit Width / Percentage in the toolbar, or hold Ctrl and scroll the mouse wheel for quick zoom
  7. Click “Full-document Summary” in the toolbar to summarize the entire paper; the result streams into a standalone window
  8. Click “AI Chat” in the toolbar or press Ctrl + Shift + Q to open the chat window and ask questions while reading; Enter sends, Shift + Enter inserts a line break, and the button turns into “Stop” so you can interrupt an answer
  9. Each exchange is written automatically into a .md file in the same folder as the PDF; click “Open Note” to view/edit it with your default editor
  10. Type a keyword in the toolbar search box and press Enter to search the whole document with highlighted, centered results; use “Prev / Next” to navigate
  11. Before using LLM translation or summary for the first time, configure the base URL, API key, and model under “Settings → LLM Settings” (the AI chat reuses the same configuration)
  12. For night reading, switch to dark mode under “Settings → Theme”; PDF pages are inverted and the chat window follows the theme
  13. If the PDF has internal links, click an in-text reference citation (e.g. [1]) to jump directly to the corresponding entry at the end of the document
  14. After closing, reopening the same PDF resumes at your last reading position and restores both window states

大模型设置 / LLM Settings

本软件支持任意 OpenAI 兼容 的大模型接口，由用户自行选择服务商并填写：

This software supports any OpenAI-compatible LLM endpoint. You choose the provider and fill in:

边读边问 / Ask While Reading

打开 PDF 后，点击工具栏「AI 问答」或按 Ctrl + Shift + Q 呼出对话窗口（非模态，不挡住阅读）。提问后：

After opening a PDF, click “AI Chat” in the toolbar or press Ctrl + Shift + Q to summon the chat window (non-modal, so it never blocks reading):

笔记文件格式（可手工编辑）/ Note file format (hand-editable):

# A.pdf 阅读问答记录

## 1. 问：为什么要用 Transformer？
> 第 3 页 · 2026-09-30 14:22

**答：**

因为……

---

若 PDF 所在目录不可写（只读光盘、被其他程序占用等），本次问答会改存到 ~/.pdftranslator/chatnotes/ 并在窗口内提示，内容不会丢。

If the PDF’s folder is not writable (read-only media, file locked by another program, etc.), that exchange is saved to ~/.pdftranslator/chatnotes/ instead and the window tells you — nothing gets lost.

❓ 常见问题 / FAQ

问题 回答
免费吗？会不会有广告、会员、次数限制？ 完全免费开源（MIT），无广告、无会员、不限次数
一定要填 API Key 才能用吗？ 不需要。划词翻译选「微软 Edge / MyMemory」开箱即用；只有 AI 总结、AI 问答、大模型翻译需要 Key
我的 API Key 安全吗？ Key 只存在本机的 Windows 凭据管理器中，不写进配置文件、不上传、不发送到除服务商以外的任何地方
AI 会把我的论文传到云上吗？ 只有在你使用大模型相关功能时，文本才会按你填的接口地址发给对应服务商；纯翻译用 Edge / MyMemory 走各自的公开接口
有 exe 还要装 Python 吗？ 不用，dist/PDF阅读翻译器.exe 双击即用，配置也只写在用户目录
支持 macOS / Linux 吗？ 目前只提供 Windows 版。核心是 Python + PyQt6，跨平台移植门槛不高，欢迎提 Issue / PR
几百页的论文会卡吗？ 页面按需渲染，滚动大文件依然流畅
扫描版 PDF（纯图片）能用吗？ 翻译与总结依赖可提取的文本；提取不出文本时 AI 问答会自动退回普通对话（软件本身暂不含 OCR）
界面能改吗？想二次开发 可以，MIT 许可，代码结构见项目结构，AGENTS.md 里有开发约定
Question Answer
Is it free? Any ads, plans or quotas? Completely free and open source (MIT). No ads, no paid plans, no usage caps
Do I need an API key to use it? No. Select-to-translate works out of the box with Microsoft Edge / MyMemory; a key is only needed for LLM translation, summary and AI chat
Is my API key safe? It is stored only in your local Windows Credential Manager — never in a config file, never uploaded anywhere except to the provider you configured
Does the AI upload my paper to the cloud? Only when you use LLM features, and only to the provider endpoint you typed in
Do I need Python if there is an exe? No — dist/PDF阅读翻译器.exe just runs; settings are kept in your user folder
macOS / Linux support? Windows-only for now. The core is Python + PyQt6, so a port is not far off — Issues and PRs welcome
Will a 500-page paper lag? Pages render on demand, so scrolling large files stays smooth
What about scanned (image-only) PDFs? Translation and summary rely on extractable text; if there is none, AI chat falls back to plain conversation (the app has no built-in OCR yet)
Can I modify it / build on it? Yes, MIT licensed — see the project structure; AGENTS.md documents the conventions

安装与运行（源码）/ Installation & Run (from Source)

需要 Python 3.9+。

Requires Python 3.9+.

# 克隆仓库 / Clone the repository
git clone https://github.com/fangvv/PDF-AI-Viewer.git
cd PDF-AI-Viewer

# 安装依赖 / Install dependencies
pip install -r requirements.txt

# 国内用户可使用清华源加速 / Chinese users can use the Tsinghua mirror
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple

# 运行 / Run
python main.py

打包自己的 exe（需先安装 PyInstaller）/ Build your own exe (requires PyInstaller):

pyinstaller --noconfirm "PDF阅读翻译器.spec"
# 产物 / Output: dist/PDF阅读翻译器.exe

🤝 反馈与贡献 / Feedback & Contributing

如果这个工具帮你省下了一点读文献的时间，点个 ⭐ 就是最快的支持。 If it saved you some time on papers, a ⭐ is the quickest way to say thanks.

项目结构 / Project Structure

pdf_translator/
├── main.py          # 主窗口：分栏布局、工具栏、菜单栏、翻译/总结/问答线程、浮动按钮
├── pdf_viewer.py    # PDF 阅读器：按需渲染、刷选、缩放、链接点击
├── translator.py    # 翻译引擎：Edge / OpenAI 兼容大模型 / MyMemory，流式总结与多轮对话
├── chat_window.py   # AI 阅读问答：浮动对话窗口（气泡渲染、流式显示、字号与主题）
├── chat_log.py      # 问答记录读写：与 PDF 同目录同名的 .md 笔记
├── latex_fallback.py# LaTeX 公式 → Unicode 兜底转换（总结与问答共用）
├── settings.py      # 配置存储：阅读位置、最近历史、界面设置、大模型配置
├── make_logo.py     # Logo 生成脚本
├── requirements.txt # 依赖清单
├── AGENTS.md        # 给 AI 助手/开发者的工程说明与约定
├── LICENSE          # MIT 许可证
├── dist/            # 打包产物（PDF阅读翻译器.exe）
├── screenshot1–4.png    # 界面截图（日间主界面 / 问答 / 大模型设置 / 夜间）
└── logo.ico / logo.png  # 应用图标

技术栈 / Tech Stack

翻译引擎 / Translation Engines

引擎 / Engine 说明 / Description 需要 Key
微软 Edge / Microsoft Edge 官方翻译接口，质量稳定 否
大模型 / LLM 通用 OpenAI 兼容大模型，翻译质量高，可做 AI 总结 是（可选）
MyMemory 免费在线翻译服务 否

选择「自动」时，程序会依次尝试各引擎，直到成功为止。

When “Auto” is selected, the program tries each engine in turn until one succeeds.

许可证 / License

MIT

致谢 / Acknowledgements

This site is open source. Improve this page.