它和“把 PDF 丢给翻译软件”有什么不一样
- 像读一本排好版的中文书。 宋体正文、舒服的行宽和行距，公式用 KaTeX 按原文重排，表格是三线表，参考文献保留原文；原文的粗体、斜体在译文里照样保留。顶栏一键切深色。
- 随时核对原文。 一键切“对照”，每段下面附英文；右侧可以开原页，跟着阅读位置翻页，还会框出当前段落在原页的位置。
- 在论文里找内容。 按 Ctrl / ⌘ + F 同时搜索原文和译文，显示匹配数、高亮结果，用 Enter / Shift + Enter 跳到下一处 / 上一处
- 翻译和解释分开。 正文只放忠实的译文；AI 的解释、回答放在页边，一眼就能分清哪句是论文说的。
- 沿引用继续读。 正文中能对应的数字、字母编号或作者年份可跳到参考文献；文末可返回正文引用位置。阅读页左侧“引用”按树状展开本文参考文献和库中引用本文的论文，匹配到库内论文可直接打开，并可返回上一论文的原阅读位置；未入库的条目可通过 DOI/arXiv 或选择本地 PDF 加入并关联，也可搜索。引用关系取自本地已整理的参考文献，并非完整的全球引用索引；匹配不确定时不会自动连线。
- 边读边问 AI。 右侧“问 AI”面板实时对话，回答逐字流出来；可以一次引用好几段（选中文字拖进输入框就行）。问“我标红的那些公式有什么联系”，它会按颜色找出你的划线。可以开多个对话，模型单独选：Claude、GPT（Codex）、DeepSeek、通义、本机 Ollama……好的回答一键放到页边。
- ASD-STE100 问答。 在“问 AI”的“回答方式”里选择这个模式，用简明中文回答问题或总结论文，保留专业术语、公式和数值。模式按对话保存，支持复制、放到页边和导出 Markdown。ASD-STE100 是英文标准；这个模式借鉴其短句、主动表达和术语一致等原则，提供中文写作辅助，不将中文答案标为符合英文标准或已认证。正文过长时只提供节选，回答需说明依据范围。
中文提示词另参考 asd-ste100-skill 的语义保留原则：保留条件、范围和“可能／建议／必须”等语气强度，不为简短而丢失精度。
- 精读问答。 “回答方式”里的第三档，适合想弄明白“作者为什么这么做、这个结论能撑多远”的时候：先还原作者要解决的问题，分清哪些设计拿掉就塌、哪些是顺手加的，把关键公式代进具体数字算一遍，再核对正文数字和图表、基线对照条件是否对齐。论文没报告的就直说没报告，不替作者补数字。和简明回答一样会把全文发给模型，用量更多。
- 边读边批注。 选中文字四色荧光笔或下划线、写笔记、提问；问题一键让 AI 回答，笔记可以让 AI 点评。笔记面板按正文顺序汇总批注，可以筛选、滚动回看；点击卡片定位正文，点“编辑”才改笔记。通过缩略图选择或从正文拖拽，把图表关联到笔记，展开查看或修改图表名称；正文里的图表引用可以悬停预览。可以勾选导出成 Markdown（放进 Obsidian、Notion）
- 译文可以改。 双击一段直接改；术语表里改一个译法，全文替换。
- 不只是 arXiv。 拖进任何 PDF；或者填 arXiv 编号、DOI、论文标题、论文网页（OpenReview、ACL、NeurIPS、bioRxiv、PMC、期刊页面），自动找到公开的 PDF 并补全作者、年份、出处。
- 从 Zotero 搬过来。 导入对话框里点“从 Zotero 迁移整个文献库”，自动找到 Zotero 的数据文件夹，把有 PDF 的论文连同分类（多级照样分层）、标题、作者、年份、期刊、DOI、摘要一起搬进来；只读 Zotero 的数据库副本，不改动 Zotero，可以重复迁移。也能“导入整个文件夹”：选一个放论文的文件夹，子文件夹的层级就是分类的层级。两种都在后台导入、可以中途停止，导入后不翻译，想读哪篇再译哪篇。
- 链接本地 PDF。 Zotero 和文件夹批量导入可勾选“链接本地 PDF，不复制原文件”，命令行可用
--link。原 PDF 留在原位，缓存、笔记和进度留在 EasyRead；删除论文不会删除原 PDF。链接需要原路径一直可访问，已有论文不会因重复导入而改变存储方式。用法
- 文献库。 侧栏像聊天软件：论文和分类都能置顶；自己建分类（右键改名、删除，把论文拖进去），分类可以分层（右键“新建子分类”“移到…”，点父分类列出所有子分类的论文），内置分类可以隐藏；最近阅读、搜索、未读 / 在读 / 已读、星标、阅读进度、复制引用（GB/T 7714、APA、BibTeX）、导出单文件离线 HTML 发给别人，或者“导出手机版”（只读、体积小，传到手机上用浏览器打开）。删掉的论文先进回收站，可以恢复。快捷键可以自定义。
- 云文献库与批量引用。 在“设置 → 云文献库”里把文献库迁移到其他磁盘或网盘同步文件夹，也能接入已有的库；原库保留，复制后核对，重启生效。论文列表和分类支持批量复制或保存 GB/T 7714、APA、BibTeX 引用
- 用了多少心里有数。 每次翻译、每条 AI 回答都记下用了多少 token；用 Claude 订阅时，还能看到 5 小时 / 7 天额度用到多少、什么时候重置。
- 不会丢东西。 每次修改先存在浏览器，本地服务确认写进文件才删；翻译方后来改了你改过的段落，只提示，不覆盖。
翻译用什么模型：你来选
| 引擎 | 要什么 | 说明 |
|---|
| Claude Code（推荐） | 装好并登录 Claude Code | 不用 Key，用你订阅的额度；会自己看原页图核对公式，译文最好 |
| Codex CLI | 装好并登录 Codex | 不用 Key，用 ChatGPT 账号 |
| CodeBuddy CLI | 按官方 CLI 文档安装并登录，账号需有 CLI 使用权益 | 不用 Key；模型名自己填，留空用 CLI 默认模型。当前免费体验版不含 CLI，与 WorkBuddy 同账号共享积分 |
| ZCode CLI（实验性） | 按官方 CLI 指南安装并登录，使 zcode 在 PATH 中可用 | 复用本机登录态；模型和推理选项在 ZCode 中选择。支持翻译、问 AI 和图片附件（需模型支持）；真实账号调用尚待验证 |
| Grok Build / Antigravity CLI / Cursor CLI | 装好并登录 Grok Build、Antigravity CLI 或 Cursor CLI | 不用 Key，用各自的订阅；模型名自己填，留空用它的默认 |
| API 接口 · 国内直连：DeepSeek / 智谱 / 阿里云百炼 / Kimi / 硅基流动 / 魔搭 | API Key | 智谱 GLM-4.7-Flash、硅基流动小模型免费；DeepSeek 一篇 20 页论文几毛钱 |
| API 接口 · 海外（要梯子）：OpenAI / Anthropic / Gemini / OpenRouter / Groq / Cerebras | API Key | Gemini、OpenRouter、Groq、Cerebras 有免费额度 |
| API 接口 · 本机：Ollama / LM Studio | 本机装 Ollama 或 LM Studio | 完全离线、免费，推荐 qwen3.5:9b（显卡小用 4b） |
| API 接口 · 自定义地址：任意 OpenAI 兼容接口、中转站 | 地址 + Key | Chat Completions 和 Responses 两种格式都支持；接口名称和地址可保存复用，Key 按地址分别保存；点“获取模型列表”从接口拉模型名 |
不想让它导入后马上翻译，在设置里关掉“导入后自动开始翻译”就行，之后可以让对话里的 agent 来译。
设置里会自动检测本机装了什么，点“试译一句”马上知道能不能用。某一页翻译失败（限流、网络、额度）会自动重试，还不行就先跳过、接着译后面的页，最后一键“重试失败的页”。
默认逐篇翻译，单篇内部仍可分段并发。在“设置 → 模型 → 翻译”中可将“同时翻译几篇”设为 1–4 篇，重启后生效。多篇并行会叠加分段并发，增加内存和模型限流风险，建议保持默认 1 篇；详见配置说明
生成译图（可选）：在“设置 → 模型 → 翻译设置”打开“生成译图”，默认使用 Codex 订阅：需要安装支持内置生图的 Codex CLI，并使用 ChatGPT 登录，不需要另填 API Key。生图消耗订阅额度，具体限制见 Codex 生图用量说明。不可用或额度不足时，回退到原图和文字译文，不会自动调用单独计费的 API。也可主动选择“图片 API（单独计费）”，填写兼容 Images Edits 的地址、模型和 Key。
翻译先保存正文和图内文字，再按这篇论文的目标语言生成译图，尽量保留原图布局。图片沿用正文的“原文／译文／双语”设置：分别显示原图、译图或两者，双语顺序也同步。有可用译图时不重复展示图内文字译文；没有可用译图或加载失败时，显示原图和文字译文。离线导出保留相同的切换和兜底能力。功能默认关闭；开启后自动为后续翻译生图，并显示已有论文的补图入口。生成结果不保证逐像素保真，图表细节可与原图对照。
已翻译论文补图或重新生图：先在设置中开启“生成译图”，然后打开论文，在标题下点击“为本文生成译图”，只补齐缺失或已过期的译图；单张图片下可点击“生成译图 / 重新生成译图”，也可从图片右键菜单操作，无需重译正文。关闭开关时，这些入口和失败重试入口都会隐藏，已有译图保留；正在运行的任务仍可查看进度和取消。手动修改过的图内文字会作为生成参考；旧论文没有保存图内文字时，直接根据原图翻译。失败时保留已有图片、译文和笔记。
安装
最省事：下载安装包（不用装 Python）。在 Releases 下载：
- Windows：
EasyRead-Setup-x.x.x.exe，双击安装。没有代码签名，如果弹出“Windows 已保护你的电脑”，点“更多信息 → 仍要运行”。
- macOS（Apple 芯片）：
EasyRead-x.x.x-arm64.dmg，把 EasyRead 拖进“应用程序”；第一次打开被系统拦截时，按下面对应的提示处理
- Linux：
EasyRead-x.x.x.AppImage，chmod +x 后运行。
- 如果 Linux 提示缺少
libfuse.so.2，可按 AppImage 官方说明配置 FUSE，或在独立目录运行 ./EasyRead-x.x.x.AppImage --appimage-extract，再运行 ./squashfs-root/AppRun；无需关闭沙箱
论文和设置存在哪：Windows 安装版在安装目录下的 data 文件夹（装在 D 盘就在 D 盘，更新和卸载都会保留）；macOS、Linux 在用户目录下的 EasyRead 文件夹（和 pip 安装版同一个位置）。卸载重装不会丢。
以后升级：Windows、macOS 安装版和直接打开的 Linux AppImage 都可以在程序里更新，有新版本时顶栏会提示（也可以在右上角问号里手动检查），点“更新”，可以放到后台下载，下好后点“更新并重启”。解压运行的 AppImage 和从源码运行的照旧从 Releases 下载新版。macOS 和 Linux 从 1.3.2 及以前升级时，要先手动下载 1.3.3 一次；macOS 要把 EasyRead 放在“应用程序”里才能在程序里更新。
This is the beginning of the README. Read the rest at the original. Read the full README ↗
