by Edwardxlai
把英文论文读成舒服的中文:本地 PDF 论文翻译、原文对照、边读边问 AI、文献管理。Read English papers in comfortable Chinese.
# Add to your Claude Code skills
git clone https://github.com/Edwardxlai/easyreadGuides for using ai agents skills like easyread.
Last scanned: 10/2/2026
{
"issues": [],
"status": "PASSED",
"scannedAt": "2026-10-02T10:20:09.293Z",
"npmAuditRan": true,
"pipAuditRan": true,
"promptInjectionRan": true
}See how easyread compares with popular alternatives.
easyread is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by Edwardxlai. 把英文论文读成舒服的中文:本地 PDF 论文翻译、原文对照、边读边问 AI、文献管理。Read English papers in comfortable Chinese. It has 1,178 GitHub stars.
Yes. easyread passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.
Clone the repository with "git clone https://github.com/Edwardxlai/easyread" and add it to your Claude Code skills directory (see the Installation section above).
easyread is primarily written in Python. It is open-source under Edwardxlai on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh easyread against similar tools.
No comments yet. Be the first to share your thoughts!
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.
--link。原 PDF 留在原位,缓存、笔记和进度留在 EasyRead;删除论文不会删除原 PDF。链接需要原路径一直可访问,已有论文不会因重复导入而改变存储方式。用法| 引擎 | 要什么 | 说明 |
|---|---|---|
| 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 下载:
EasyRead-Setup-x.x.x.exe,双击安装。没有代码签名,如果弹出“Windows 已保护你的电脑”,点“更多信息 → 仍要运行”。EasyRead-x.x.x-arm64.dmg,把 EasyRead 拖进“应用程序”;第一次打开被系统拦截时,按下面对应的提示处理EasyRead-x.x.x.AppImage,chmod +x 后运行。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 放在“应用程序”里才能在程序里更新。
提示“无法验证开发者”或“Apple 无法验证是否包含恶意软件”:先点“完成”(不要点“移到废纸篓”),打开“系统设置 → 隐私与安全性”,向下找到安全性提示,点“仍要打开”;在确认窗口点“打开”,按提示输入登录密码或使用 Touch ID
提示“已损坏,无法打开”:先从 EasyRead 官方 Releases 重新下载,并把应用拖进“应用程序”;文件也可能确实损坏或被改动,不能只凭这条提示判断原因。只有确认文件来自这个官方仓库、并信任该文件后,才在“终端”执行下面的命令,再重新打开 EasyRead;这条命令移除隔离属性,不会修复损坏的文件
xattr -dr com.apple.quarantine /Applications/EasyRead.app
为什么会出现验证提示:目前的 macOS 安装包用的是项目自己的自签名证书(为了应用内更新),不是 Apple 开发者证书,也没有经过公证,因此可能被系统拦截;代码完全开源,也可以从源码运行
如果系统提示“将损坏你的电脑”,或明确检测出恶意软件并要求移到废纸篓,请停止安装,不要用上面的步骤绕过;按 Apple 官方说明 处理
或者从源码运行:需要 Python 3.10+。
先从 Releases 下载最新版的 zip 解压(或者 git clone 本仓库)。
Windows:双击 start.cmd。第一次会自动装好环境(一分钟左右),之后双击直接打开。
macOS / Linux:在解压出来的目录里运行
./start.sh
这样启动的,浏览器里的 EasyRead 页面全部关掉后,后台服务过十几秒会自己退出;还有翻译在跑的话,等译完再退。
每次推送都会在 Windows、macOS、Linux 上自动装一遍、跑测试、启动一次(见上面的“测试”徽章)。
或者用 pip(数据放在 ~/EasyRead):
pip install git+https://github.com/Edwardxlai/easyread
easyread
浏览器会打开 http://127.0.0.1:8765。服务只监听本机。
桌面版复用同一套本地 Python 服务和 Web 界面,由 Electron 负责启动服务并显示窗口。开发环境需要 Node.js 22+、Python 3.10+ 和 PyInstaller:
npm install
python -m pip install pyinstaller
npm run dev
生成可分发安装包:
npm run dist
输出在 dist/electron/:Windows 为 NSIS 安装程序,macOS 为 DMG(另有一个给应用内更新用的 zip),Linux 为 AppImage。macOS 包由 scripts/mac_sign.cjs 用固定的自签名证书签名,证书从环境变量 MAC_SIGN_P12、MAC_SIGN_P12_PASSWORD 读(发版时来自仓库 Secrets);本机没设时退回临时签名,这样打出的包不能应用内更新。推送 v* 标签后,GitHub Actions 会在三个系统上构建,并把这些安装包自动附加到 GitHub Release;源码 zip 仍会由 GitHub 保留。打包后的文献库和设置:Windows 存在安装目录下的 data(安装目录写不进去时退回 ~/EasyRead),macOS、Linux 存在 ~/EasyRead。
Ctrl+V 也行)。长论文可以选“只译正文”,或者“指定页”只译第几页到第几页。导入时还能选这次用哪个模型;“导入后”选“读英文原文”就只排版、不翻译,想看中文了随时点“翻译成中文”。
整篇翻译默认超过 60 页时会先确认,可以选择全部翻译、只译前 60 页或先不译;上限在“设置 → 模型”里修改,填 0 表示不询问EasyRead 自带命令行,Claude Code / Codex 这类 agent 可以在对话里直接读你的笔记和问题、把回答写到对应段落旁边,也可以亲自翻译或重译某几页。技能说明在 skill/paper-reading/SKILL.md,把这个目录放进 ~/.claude/skills/ 或 ~/.codex/skills/ 即可。
想让 agent 把一篇论文讲透而不是只译出来——还原作者真实的思考起点、把关键公式落到能自己算的例子、再把结论的边界查一遍——用 skill/paper-xray/SKILL.md。它读的是同一份 library/<ID>/,谈出来的东西