Skip to content

Releases: Edwardxlai/easyread

EasyRead v1.3.0

Choose a tag to compare

@Edwardxlai Edwardxlai released this 02 Oct 15:11

在线试读:https://edwardxlai.github.io/easyread/demo/

安装:下载下面对应系统的安装包(Windows .exe、macOS .dmg、Linux .AppImage),装好就能用,不用装 Python。想从源码跑的,下载 Source code (zip) 解压,Windows 双击 start.cmd,macOS / Linux 运行 ./start.sh(需要 Python 3.10+)。macOS 第一次打开提示“已损坏”或“无法验证”时,按 README 里“macOS 首次打开”一节处理。

云文献库

  • 设置 → 云文献库:可以把文献库换到别的文件夹,比如 D 盘或 OneDrive、Dropbox、iCloud、坚果云的同步文件夹,C 盘不够用时也能挪走(#18)。页面上分“本机”和“网盘”两块,每个位置一个按钮:迁移(复制过去)、切换(用那里已有的库)、合并(把两边的论文合在一起)。
  • 原来的库一直保留;复制完会逐篇核对,重启后才换过去。同一个库在另一台电脑上开着时会提醒你。没搬完的目标可以在设置里一键清理,只删这次新建的内容。
  • 浏览器版也能弹出系统的“选择文件夹”窗口。

批量操作

  • 文献库里点“批量操作”,或者 Ctrl/⌘ + 点论文,就能勾选多篇:一次加入分类、移出分类、切换在读 / 已读、翻译、导出引用、移到回收站。Shift + 点连选一段,Ctrl/⌘ + A 全选,勾着的论文可以一起拖到侧栏分类上。

导出引用

  • 勾选的论文或某个分类可以一次复制或保存 GB/T 7714、APA、BibTeX 引用;缺作者、年份等信息会提示补齐,期刊、会议和预印本(arXiv 等)各用对应格式。
  • 编号顺序可以按作者、按年份,或者自己拖动排(学位论文常用的顺序编码制),编号跟着走。

论文里的图

  • 翻译时把论文里的图从 PDF 截下来放进正文,图里的文字也一起翻译。感谢 @Wang-auspicious(#14)。
  • 以前导入的论文,打开阅读页时会按原页上的位置自动补截图。

整篇翻译先确认页数

  • 整篇翻译超过 60 页时先问一句:全部翻译、只译前 60 页,或者先不译。上限在设置里改,填 0 表示不问。

原页与正文双向联动

  • 原页面板支持连续滚动整篇论文,拖动右侧滚动条即可跨页浏览,页码随之更新
  • 勾选“跟随”时,滚动任意一侧,另一侧的阅读位置和对应段落高亮会一起变化;右侧上一页 / 下一页按钮也会同步定位正文
  • 取消“跟随”后,两侧可以独立滚动;页面图片按阅读位置加载,避免一次加载整篇论文

问 AI

  • 模型旁边多了“简明回答”开关(按 ASD-STE100 写作规则):短句、一句只讲一件事、步骤分条列出,数字、单位和前提条件一个不丢。会把全文一起发给模型作依据,用量更多;每个对话各记各的。感谢 @MeshedPoto(#16)。
  • 思考强度(#19):问 AI 时在模型菜单底部选“低 / 中 / 高……”,只对当前对话生效,模型按钮上会显示“Opus 5.5 · 高”。设置 → 模型里,每个模型都能设推理强度;Codex 和 API 模型还能开 Fast(可能多花额度)。
  • 回答里的公式不管写成 $…$、$$…$$ 还是 \(…\)、\[…\] 都能正常显示,不再露出 LaTeX 源码(同上 #16)。

英文界面

  • 界面跟着系统语言走:中文系统照旧显示中文,其他系统显示英文。顶栏的“中 / EN”按钮随时切换,设置 → 阅读 → 界面语言里也能改。
  • 英文界面第一次导入时,“导入后”默认选“读英文原文”:不需要译文的话,EasyRead 就是一个能划线、记笔记、问 AI 的英文论文阅读器。
  • 论文标题按界面语言决定先显示英文还是中文;切换语言时页面不再白闪。
  • 论文详情里的“添加”改叫“添加于”。

论文可以译成别的语言

  • 设置 → 阅读 → 论文译成:中文、日语、韩语、西班牙语、法语、德语,默认中文。导入框里“翻译成”旁边也能单独给这篇选。语言名跟着界面语言写,英文界面显示 Chinese、Japanese……
  • 每篇论文第一次翻译时记下当时的语言,之后改设置不影响已经译过的论文;以前译好的论文都按中文处理。
  • 译成日文、韩文、西文时,正文换成对应语言的字体;问 AI 和整理笔记也用这篇论文的译文语言回答。

修复

  • 模型把表格表头写成一维时,整篇译文变成空白(#15):现在这一页会算作没译成功,可以重试;以前存下的这种表格也能正常显示,一个块出错不再拖累整篇。感谢 @Lzy22301093(#17)。
  • 翻译进行中保存阅读进度时,偶尔把论文版本号一起改掉,导致新译好的页没刷出来。

其他

  • macOS 提示“恶意软件”或“已损坏”打不开时,README 里有一步步的处理办法。
  • 版本号和“检查更新”挪到设置 → 阅读;设置 → 高级里去掉了 Claude Code / Codex 命令输入框(需要时仍可在 config.json 里改)。

感谢 @Wang-auspicious(#14)、@MeshedPoto(#16)、@Lzy22301093(#17)的贡献,以及提 issue 的各位!

EasyRead v1.2.6

Choose a tag to compare

@github-actions github-actions released this 02 Oct 03:38

在线试读:https://edwardxlai.github.io/easyread/demo/

安装:下载下面对应系统的安装包(Windows .exe、macOS .dmg、Linux .AppImage),装好就能用,不用装 Python。想从源码跑的,下载 Source code (zip) 解压,Windows 双击 start.cmd,macOS / Linux 运行 ./start.sh(需要 Python 3.10+)。

读英文原文(不翻译)

  • 导入时“导入后”多了一个选项:读英文原文。模型只把公式、表格、段落排好,不翻译,阅读页正文直接是英文,和读译文一样能划线、记笔记、问 AI。比翻译省用量。
  • 想看中文了,点论文开头或详情里的“翻译成中文”:在原来的段落上就地补译文,之前的笔记、划线都还在。
  • 全是英文时,顶栏的“译文 / 对照”按钮会藏起来。

导入时选模型

  • 导入框里可以直接选这次用哪个模型来翻译或整理:默认是设置里翻译用的模型,也能选“问 AI”名单里已经配好的模型,不用先去设置里换。没整理成功的页重试时,还用上次选的模型。

设置:翻译和问 AI 的模型合到一页

  • 原来的“翻译”“问 AI”两页合成“模型”一页:所有模型都是卡片,点卡片可以“设为翻译”“设为问 AI”、改 Key 和地址。翻译用的那张标着“翻译”。
  • 选“跟随 Claude Code 默认”时,卡片上会写出实际用的是哪个模型。

原页与翻译

  • 并行翻译多批页面时,偶尔随机报 Failed to load document (PDFium: Data format error),现在不会了。
  • 一段文字从左栏跨到右栏时,原页上分两块框出来,不再把栏间空白和旁边的段落一起框进去;点原页定位到段落也更准。以前导入的论文打开时会自动重算一次。
  • 第一次导入时准备失败(比如渲染出错)的论文,再导入一次会重新准备,不再提示“已经在库里了”。
  • 同一篇论文已有任务在排队或运行时,不会被重复提交覆盖掉。
  • 指定页超出论文页数时直接提示,不再译错页。

问 AI

  • 回答里的 Markdown 表格和引用块(> …)正常显示,不再是一堆竖线和横线;页边讨论和笔记里也一样。感谢 @bisuwuss-netizen(#12)。
  • 回答被截断、被服务商内容过滤拦下、中途出错时会明确报错,不再当成完整回答存下来。
  • 推理模型的思考过程(<think>…</think>)被拆成几段发过来时也能藏好。
  • 被限流时按服务商给的 Retry-After 等待(秒数和日期两种写法都认)。

桌面版

  • 第一次打开最大化,之后记住上次的大小、位置和是否最大化。
  • macOS 关掉窗口后再从程序坞打开,复用原来的后台,不会再多开一个;重复打开 EasyRead 只会切到已有窗口。
  • 输入框右键菜单加了撤销 / 重做,灰掉当前用不了的项。

修复

  • OpenCode Go 报“400 MissingSessionID”(#10 的后续):请求里带上会话 ID。
  • 用公司代理或自签证书时,HTTPS 改用系统信任的根证书;证书校验失败会直接说是证书问题,不再笼统地说连不上。
  • 先删笔记、再同步到较旧的离线编辑时,删掉的笔记不会复活。
  • 同一毫秒里新建的对话、回答、小任务不会再撞编号。
  • Linux 安装包改在 Ubuntu 22.04 上打,22.04 及更老的系统也能打开。

其他

  • 阅读页默认字号从 18 px 调到 21 px(调过字号的照旧)。

原页、桌面版、问 AI 报错、证书和任务保存这批修复来自 @MeshedPoto(#11),感谢!

EasyRead v1.2.5

Choose a tag to compare

@Edwardxlai Edwardxlai released this 01 Oct 16:54

在线试读:https://edwardxlai.github.io/easyread/demo/

安装:下载下面对应系统的安装包(Windows .exe、macOS .dmg、Linux .AppImage),装好就能用,不用装 Python。想从源码跑的,下载 Source code (zip) 解压,Windows 双击 start.cmd,macOS / Linux 运行 ./start.sh(需要 Python 3.10+)。

用量

  • 翻译和“问 AI”都会记下用了多少 token。论文详情里能看到上次翻译、这篇论文累计各用了多少。
  • 用 Claude Code 订阅时,还能看到 5 小时额度和本周额度用到了百分之几、多久后重置。“问 AI”输入框旁边有个小圆环,点开能看到额度,还有当前对话占了模型上下文的多少。额度是整个账号共用的,你在别处用 Claude Code 也算在里面。

阅读页

  • 点“原页”“笔记”“问 AI”打开侧栏不再顿一下(162 页的论文以前要卡 0.4 秒)。
  • 在论文开头点“原页”,先显示第 1 页,不再是空白面板。
  • 原页面板的框更准:章节标题优先对上带编号的那一行,不会跑到图里同名的标签上。以前导入的论文,打开时会按新规则自动重算一次。
  • 文献库和阅读页顶栏加了太阳 / 月亮按钮,点一下切换深浅色(Aa 面板里的主题选项去掉了)。

修复

  • API 接口填 OpenCode 这类放在 Cloudflare 后面的地址时,报“403(没有权限用这个模型):error code: 1010”(#10)。
  • 翻译还在进行时把论文移到回收站,报“另一个程序正在使用此文件”。

其他

  • 有新版本时,文献库顶栏会提示“新版本 x.y.z”,点开能看这次更新了什么、去哪下载。一天最多查一次;帮助里可以关掉自动检查。
  • 用 start.cmd / start.sh 启动的,关掉所有 EasyRead 页面后,后台服务过十几秒自动退出,不再一直占着项目文件夹;还有翻译在跑的话,等译完再退。感谢 @NGman-s 提出这个问题(#9)。

EasyRead v1.2.4

Choose a tag to compare

@Edwardxlai Edwardxlai released this 01 Oct 15:52

在线试读:https://edwardxlai.github.io/easyread/demo/

安装:下载下面对应系统的安装包(Windows .exe、macOS .dmg、Linux .AppImage),装好就能用,不用装 Python。想从源码跑的,下载 Source code (zip) 解压,Windows 双击 start.cmd,macOS / Linux 运行 ./start.sh(需要 Python 3.10+)。

  • macOS 桌面版:⌘C / ⌘V / ⌘X / ⌘A / ⌘Z 恢复可用,屏幕顶部保留应用 / 编辑 / 窗口菜单(#5)。
  • 桌面版右键菜单:输入框里右键有剪切 / 复制 / 粘贴 / 全选,选中文字右键可以复制。

EasyRead v1.2.3

Choose a tag to compare

@Edwardxlai Edwardxlai released this 01 Oct 15:47

在线试读:https://edwardxlai.github.io/easyread/demo/

安装:下载下面对应系统的安装包(Windows .exe、macOS .dmg、Linux .AppImage),装好就能用,不用装 Python。想从源码跑的,下载 Source code (zip) 解压,Windows 双击 start.cmd,macOS / Linux 运行 ./start.sh(需要 Python 3.10+)。

  • 修复桌面安装包开始翻译就报错 No module named 'pypdfium2'(#3):发布流程打包时漏装了 PDF 处理依赖。打包脚本现在会先检查依赖,缺了直接停下。感谢 @bisuwuss-netizen 的修复。
  • 原页面板的框更准:双栏论文、正文旁边绕排的小表格,以前表格/图的框会跑到页面顶部只剩一条,现在框住整个表格或图。

EasyRead v1.2.2

Choose a tag to compare

@Edwardxlai Edwardxlai released this 01 Oct 14:24

在线试读:https://edwardxlai.github.io/easyread/demo/

安装:下载下面对应系统的安装包(Windows .exe、macOS .dmg、Linux .AppImage),装好就能用,不用装 Python。想从源码跑的,下载 Source code (zip) 解压,Windows 双击 start.cmd,macOS / Linux 运行 ./start.sh(需要 Python 3.10+)。

  • 导入时可以只译指定的页:“前几页”改成“指定页”,填第几页到第几页(比如只译第 5 到 12 页)。
  • 文献库右上角的引擎标签:Claude 别名还没查到具体版本时显示“Claude Opus”,不再显示小写的 opus。

EasyRead v1.2.1

Choose a tag to compare

@Edwardxlai Edwardxlai released this 01 Oct 14:00

在线试读:https://edwardxlai.github.io/easyread/demo/

安装:下载下面对应系统的安装包(Windows .exe、macOS .dmg、Linux .AppImage),装好就能用,不用装 Python。想从源码跑的,下载 Source code (zip) 解压,Windows 双击 start.cmd,macOS / Linux 运行 ./start.sh(需要 Python 3.10+)。

API 设置重新整理(#2)

  • 翻译和问 AI 的来源卡片从四张(Claude Code / Codex / 免费模型 / 付费 API)改成三张:Claude Code / Codex CLI / API 接口。
  • 服务商按“国内直连 / 海外(要梯子)/ 本机”分组,有免费模型的标“免费”;“自定义地址”单独一行,填任意 OpenAI 兼容接口或中转站。
  • 填写顺序改成 Key → 模型 → 高级(接口地址、接口格式)。模型下拉框显示“DeepSeek V4.1 Flash · 便宜、能看图”这样的名字;选了能看图的模型自动勾上“模型能看图”。翻译和问 AI 用同一套表单。
  • 支持 Responses 接口:“接口格式”可选 Chat Completions(通用)或 Responses(OpenAI 新接口);OpenAI 官方默认走 Responses。
  • “获取模型列表”:从接口的 /models 拉全部模型名放进下拉框,中转站、LM Studio 不用手抄模型名。
  • 模型不让改 temperature(推理模型、Kimi K2 系列)时自动去掉再发一次。
  • 推荐模型按各家官网更新到 2026-10:DeepSeek V4.1 Flash / V4 Pro、智谱 GLM-4.7-Flash(免费)、Qwen3.8、Kimi K3、GPT-6、Gemini 3.8 Flash、Ollama qwen3.5 等;去掉已停服的 GitHub Models。

显示实际用的模型

  • Claude Code 选“跟随默认”时,括号里写出默认的是哪个(比如“跟随 Claude Code 默认(Claude Opus 5.5)”),和 Codex 一样。
  • 文献库右上角的引擎标签带上模型:“Claude Code · Claude Opus 5.5”“Codex CLI · GPT-6.1-Sol”。

文献库

  • 打开过的论文自动从“未读”变成“在读”;从阅读页按“返回”回到文献库时,状态和进度马上刷新。
  • 侧栏“最近阅读”的“展开更多”和上面的论文标题左对齐(以前往里缩了一截)。

EasyRead v1.2.0

Choose a tag to compare

@Edwardxlai Edwardxlai released this 01 Oct 12:40

在线试读:https://edwardxlai.github.io/easyread/demo/

安装:下载下面对应系统的安装包(Windows .exe、macOS .dmg、Linux .AppImage),装好就能用,不用装 Python。想从源码跑的,下载 Source code (zip) 解压,Windows 双击 start.cmd,macOS / Linux 运行 ./start.sh(需要 Python 3.10+)。

桌面版安装包(感谢 @Wang-auspicious)

  • Releases 里有打包好的安装包,不用装 Python:Windows EasyRead.Setup.1.2.0.exe、macOS(Apple 芯片).dmg、Linux .AppImage。点图标打开的是独立窗口,关掉窗口后台服务一起退出。
  • 安装包没有代码签名:Windows 弹“已保护你的电脑”时点“更多信息 → 仍要运行”;macOS 第一次打开去“系统设置 → 隐私与安全性”点“仍要打开”。
  • 论文和设置放在用户目录下的 EasyRead 文件夹,和 pip 安装版同一处,卸载重装不会丢。

回收站

  • 侧栏最下面的“回收站”(有东西时才出现):删掉的论文可以恢复、彻底删除、清空;删除后的提示条上能直接撤销。

EasyRead v1.1.0

Choose a tag to compare

@Edwardxlai Edwardxlai released this 01 Oct 12:09

在线试读:https://edwardxlai.github.io/easyread/demo/

安装:下载下面的 Source code (zip) 解压。Windows 双击 start.cmd;macOS / Linux 运行 ./start.sh。需要 Python 3.10+。已经装过的,直接用新文件夹覆盖旧的(library/ 和 config.json 里的论文和设置会保留),或在仓库里 git pull。

开箱即用

  • 翻译、提问前先测一下能不能连上模型。连不上直接说怎么办:国内用 Claude / OpenAI / Gemini 要先开梯子,或者换成 DeepSeek、智谱等国内引擎;梯子节点在不支持的地区(比如香港)也会单独提示。连不上时剩下的页不再白跑。
  • 梯子只开了“系统代理”时,自动把代理交给 Claude Code / Codex(以前它们读不到,开着梯子也连不上)。
  • alphaXiv、Hugging Face Papers、Papers.cool 等链接只要带 arXiv 编号,直接去 arXiv 下载;链接里的版本号不存在时退到最新版。导入失败会写进运行日志。

读

  • 原文对照:右边原页框出的段,左边译文里也用同一种颜色标出来;点原页上的任意一段,正文跳到那段译文。
  • 设置 → 阅读里可以调字号、版心、行距、字体等排版,有“恢复默认排版”;Aa 面板也加了“恢复默认”。

记和问

  • 论文笔记可以让 AI 点评、帮你改;还没写时可以让 AI 起个草稿。结果放在笔记下方,由你决定替换还是追加(替换可撤销)。
  • AI 写的卡片可以删除,回答你问题的那种还能“重新回答”。
  • 问 AI 的输入框更清爽:去掉常驻提示,引用条更短。
  • 模型名单一开始就显示 Claude 各型号的实际版本(以前 Sonnet 要等用过一次才显示)。

修复

  • 窗口窄于 1100px 时文献库整页空白。
  • Windows 上开第二个 EasyRead 时两个实例同时占用 8765 端口,浏览器可能连到旧的那个。
  • 论文详情里的“新分类”改成按钮,点了再输入;说明页的快捷键对齐。

EasyRead v1.0.0

Choose a tag to compare

@Edwardxlai Edwardxlai released this 01 Oct 03:33

在线试读:https://edwardxlai.github.io/easyread/demo/

安装:下载下面的 Source code (zip) 解压。Windows 双击 start.cmd;macOS / Linux 运行 ./start.sh。需要 Python 3.10+。

第一个正式版。

读

  • 导入 PDF / arXiv 编号 / 链接,后台逐页译成中文;公式用 KaTeX 按原文重排,表格是三线表,参考文献保留原文。
  • 译文、对照(每段附英文)、原页三种看法;原页跟着阅读位置翻页,并框出当前段落。
  • 引用、公式、图表、章节都能点;跳过去后左下角“返回刚才读的地方”,所有跳转都把目标放在屏幕正中。
  • 翻译时模型对照原页图,发现原文笔误就在页边留“原文核对提示”,正文照录。

记

  • 四色荧光笔 / 下划线、笔记、问题、论文笔记,按原文顺序汇总,可导出 Markdown。
  • 双击改译文,术语表一处改、全文替换。

问

  • 右侧“问 AI”面板:多个对话,回答逐字流出;一次引用多段(选中文字拖进去);问到“标红的”“划线”时自动带上对应颜色的标记。
  • 模型可选:Claude Code、Codex(和 /model 同一份名单)、本机 Ollama、智谱 / 硅基流动等免费模型、DeepSeek / 通义等付费 API。

管

  • 文献库:置顶论文和分类、自建分类(把论文拖上去)、最近阅读、星标、阅读状态。
  • 所有数据都在本机:每篇论文一个文件夹,设置在 config.json。

分享

  • easyread export 导出单文件离线 HTML;easyread demo 生成可放到 GitHub Pages 的在线演示。
  • 在线演示:DPO 论文(CC BY 4.0)。