Edwardxlai / easyread
git clone https://github.com/Edwardxlai/easyread.git
v1.4.4 · 2d ago
把英文论文读成舒服的中文:本地 PDF 论文翻译、原文对照、边读边问 AI、文献管理。Read English papers in comfortable Chinese.
+9
stars, 24h · #3,652
+~44
stars, 7 days · #4,422
+1.0k
stars, 30 days · #822
1.0k
★ total · +5% this week
83
forks · 7 open issues
Star history (as recorded here)
LanguagePython
LicenseMIT
Created2026-09-30 (22d ago)
Last push2d ago
Watchers1
OwnerUser
GitHub topics
academicarxivchineseclaude-codecodexelectronllmpaper-readingpdf-translatorreference-managerresearch-tooltranslation
Links
- GitHub: github.com/Edwardxlai/easyread
- Homepage: https://edwardxlai.github.io/easyread/
- Releases · Issues · Hacker News mentions
README excerpt
EasyRead 让你更舒服地读论文 导入 PDF,后台逐页翻译;公式、表格照原文排好,随时对照原文,边读边划线、记笔记、提问。 本地运行,文献库默认保存在电脑上,也可以放进你自己的网盘同步文件夹 简体中文 · English ▶ 在线试读一篇 · 项目主页 · 下载 ## 它和“把 PDF 丢给翻译软件”有什么不一样 - **像读一本排好版的中文书。** 宋体正文、舒服的行宽和行距,公式用 KaTeX 按原文重排,表格是三线表,参考文献保留原文。顶栏一键切深色。 - **随时核对原文。** 一键切“对照”,每段下面附英文;右侧可以开原页,跟着阅读位置翻页,还会框出当前段落在原页的位置。 - **在论文里找内容。** 按 Ctrl / ⌘ + F 同时搜索原文和译文,显示匹配数、高亮结果,用 Enter / Shift + Enter 跳到下一处 / 上一处 - **翻译和解释分开。** 正文只放忠实的译文;AI 的解释、回答放在页边,一眼就能分清哪句是论文说的。 - **边读边问 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 同账号共享积分 | | **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(显卡