需要 Node.js 22+、pnpm 10.30.3 和 Go 1.26.5+，版本不符会构建失败；首次构建需下载约 67 MB 版面模型，权重不进 Git；AI 功能需先安装并登录对应 CLI，或自行配置 API 地址与 Key，未配置时翻译会显示等待配置；扫描版 PDF 尚不支持 OCR，正文会被标记为不完整。
NeoRead
cynicalight活跃维护本地优先的 EPUB/PDF 阅读器，支持批注、双语对照翻译，并通过 Claude Code、Codex CLI、Kimi CLI 接入 AI 辅助阅读。
NeoRead: a local-first EPUB/PDF reader with annotations, side-by-side translation, and AI assistance through Claude Code, Codex CLI, and Kimi CLI.
v0.10.0发布于 2026-10-31 11:14 UTC416star +13 / 7 天37fork同步于 2026-11-10 12:00 UTC
git clone https://github.com/cynicalight/NeoRead.git
cd NeoRead
pnpm install
pnpm desktop 硬件要求按 README 说明
README 未说明显存或 GPU 要求；PDF 版面解析通过 ONNX Runtime 在本机完成，内置约 67 MB 版面模型，无需安装 Python 或 PaddlePaddle。安装包仅提供 macOS（Apple Silicon）DMG 与 Windows x64 EXE，Linux 需从源码运行。
支持 Apple Silicon
本地优先的 EPUB/PDF AI 阅读器，支持双语对照、批注和结合原文向 AI 提问
本地优先的 EPUB/PDF 阅读器，支持批注、双语对照翻译，并通过 Claude Code、Codex CLI、Kimi CLI 接入 AI 辅助阅读。
核心能力
- 图书库与论文库分开管理，支持嵌套分类、标签和重复论文合并
- PDF 本地按页解析版面并翻译正文图题，公式图片转 LaTeX
- EPUB 按章翻译，原文译文对照滚动、句子悬停联动
- 批注在原文和译文间共享，支持书签、高亮、标签与 Markdown 导出
- 复用已登录的 Claude Code、Codex CLI、Kimi CLI 账户，或接入 OpenAI/Anthropic 兼容 API
容易踩的坑
内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README
- v0.10.0NeoRead 0.10.0最新正式版2026-10-31 · 2026-10-31 11:14 UTC
新增启动反馈
启动时显示加载状态，并沿用已选择的界面主题；完善启动期间关闭窗口和重新打开的处理。
迁移旧版书库前先确认
检测到旧版 Reader 数据时，先显示迁移确认界面，由你决定是否迁移。
统一控制动态效果
可在设置中开关动画，统一调整阅读滚动、标签切换和界面过渡效果。
整理设置布局
开关选项统一使用切换开关，主题、代理和操作按钮与标题并排显示；在图书库中打开设置时，图书库页仅显示书库位置。
改善卡片组展开显示
调整展开卡片组上下遮罩的位置，为内容留出更多显示空间。
重新解析后刷新封面
文档重新解析完成后更新封面，避免继续显示旧封面。
- v0.9.5NeoRead 0.9.52026-10-30 · 2026-10-30 18:40 UTC
查看更新说明
NeoRead 0.9.5
调整引注窗口字号
缩小引注窗口中的文字，方便查看和操作。
Reader 更名为 NeoRead
应用与安装包更名为 NeoRead。首次启动可迁移旧 Reader 数据，复制与校验完成后才启用新数据；清理旧数据需单独确认。
新增 Word 与 WPS 引用插件
在设置中安装插件后，可从论文库添加或编辑引注、生成参考文献表、切换样式及刷新引用。支持桌面版 Word（Windows、macOS）和 Windows WPS；使用时需保持 NeoRead 运行。
内置多种引用样式
支持 GB/T 7714—2015、GB/T 7714—2025、APA、IEEE、Chicago 等样式，并支持页码等定位信息、多篇引注和脚注或尾注排版。
交互式首次使用引导
通过实际操作介绍 Agent 连接、论文导入与阅读。新建论文库附带已解析和翻译的示例论文，可直接体验原文定位与阅读功能。
管理论文附件
为论文添加文件或链接附件，展开浏览附件并预览 PDF；支持拖放添加，下载结束后可继续清理文件。
编辑文档目录与批量操作
文档导航按原文顺序展示，支持编辑目录、多选和批量删除；PDF 导出与重新导入时保留导航类型。
查看联网搜索与工具活动
对话中显示联网搜索和工具执行过程，并保留已完成活动的详情；联网搜索选项集中到设置中，修改后自动保存。
改善 PDF 缩放、颜色与阅读布局
为每篇 PDF 保留缩放状态，拖动面板时减少重复渲染与画面闪动；改善图形和文字路径的阅读配色，提供独立滚动条并记住阅读布局。
改善论文表格与快捷切库
论文表格随面板宽度调整，拖动列宽时更合理地分配空间；支持使用功能键打开常用论文库。
改善知网收录与标签选择
浏览器插件改善知网论文识别、PDF 获取及需要登录的下载流程，减少关联论文误匹配，并支持使用标签胶囊多选标签。
恢复不可用的论文库
论文库路径不可用时，可重新定位或打开已有论文库；切换前检查数据完整性。论文解析完成前暂不允许打开，避免进入不完整的阅读页面。
修复 Reader 数据迁移卡住
修复启动缓存目录冲突导致迁移无法完成的问题。已完成复制与校验但尚未启用的数据可继续迁移，保留原有书库与迁移记录。
改善迁移退出与故障诊断
迁移期间退出 NeoRead 时，等待后台迁移进程结束后再退出，避免重启后仍被占用。迁移日志可区分目录冲突、校验失败和书库占用等原因。
按业务数据迁移旧 Reader 书库
仅迁移旧书库、书库位置和代理配置，避免 Windows 等平台的浏览器缓存目录冲突；支持继续完成已中断的迁移。清理只处理已迁移的旧业务数据，保留引用连接文件及其他未迁移内容，并支持显式重试此前失败的清理。
调整设置页布局与选择操作
重新组织显示、检索、代理和诊断设置，统一分组与分隔样式；点击 Agent 卡片即可选择当前 Agent，并支持拖动高亮颜色调整顺序。
书籍详情与真实封面
书籍列表显示真实封面，新增书籍详情面板，支持查看和编辑书籍信息。
修复部分 EPUB 正文显示异常
修复 XHTML 自闭合标签导致的正文缺失和异常下划线。
多文档标签页与阅读恢复
在设置中开启多文档标签页后，可切换、拖动排序和批量打开文档，重启后恢复标签与已保存的阅读位置；支持重新打开本次运行中误关的标签。
书籍后台解析与 EPUB 段落操作
PDF 书籍按章节在后台解析，封面显示处理进度；EPUB 按需加载章节，支持段落聚焦、复制、向 AI 提问和图片预览，并改善目录定位。
原文与译文支持上下排列
双语阅读新增上下布局，交换原文与译文位置时保留滚动位置；改善聚焦段落与图片的缩放、居中和边距。
详情浮层与重新解析
单击图书或论文打开详情浮层，双击进入阅读；可直接编辑图书信息，并从右键菜单重新解析已有文档。目录支持一键展开或折叠。
改善重新翻译后的批注处理
重新翻译时处理关联批注的恢复，并及时更新已打开的阅读器；旧版笔记提供手动迁移入口。
修复 macOS 应用菜单与切换
修复启动后 NeoRead 未显示在顶部应用菜单和 Command-Tab 应用切换器中的问题。
修复 macOS Word 插件安装与引用窗口
修复 macOS Word 插件安装，引用编辑窗口可显示在 Word 上方；兼容旧 Reader 引用数据，并改善引用预览显示。
论文封面卡片与作者显示
论文库新增封面卡片视图，使用 PDF 首页作为封面；可在设置中控制标题下方的作者显示。
调整书籍与论文卡片大小
使用 Command/Ctrl 加滚轮或加减号调整卡片大小，按 Command/Ctrl+0 恢复默认；分别保存书籍和论文库的卡片大小。
改进论文标题识别与信息查找
导入 PDF 时尝试识别论文标题；配置翻译模型后，可根据首页文字提供可应用或删除的 AI 标题建议。应用建议后自动查找论文信息，查找失败时会重试。
批量补充论文信息
在设置的诊断页面，可为缺少出处的论文重新识别标题并查找信息。手动编辑过的标题会保留，论文详情自动隐藏空字段。
改善长时间对话与工具执行
延长模型执行等待时间；工具调用达到次数限制时，使用已有结果完成回答，并显示工具失败及调用限制信息。
减小桌面应用体积
macOS 安装包去除重复的本地推理库；Electron 内置界面语言资源仅保留简体中文、繁体中文和英文，不限制文章与笔记的语言。
导出保留原布局的译文 PDF
使用已保存译文生成 PDF 副本，保留页数与页面布局，支持中文、行内公式及图表标题。无法安全排入的区域保留原文并说明原因，支持取消，不修改书库原文件。
重新组织 Agent 卡片与首次引导
本地 CLI 和 API 连接以可展开卡片展示，支持滚轮、键盘切换及本地调用记录。改善小窗口引导、设置关闭与跳过操作。
论文库默认使用表格
未设置显示偏好时默认展示论文表格，已有卡片视图选择继续保留。
从系统直接打开 PDF 与 EPUB
支持通过系统“打开方式”导入文档；PDF 进入论文库，解析完成后打开。只有同时超过 100 页和 100 MB 的 PDF 才提示确认导入。
改善引用插件检测与窗口恢复
插件检测失败时仍可查看设置和错误提示，并支持 macOS Word 目录授权。引用窗口按需打开，改善主窗口关闭后恢复及后台服务异常退出。
改善聊天活动与图片问答
重新组织思考、搜索与工具执行过程的展示；PDF 图片问答附带邻近段落，帮助理解上下文。
调整 PDF 缩放与快捷键提示
新 PDF 默认以 100% 显示，切换阅读模式时适配页面宽度；快速查找显示对应平台的快捷键。
- v0.9.4NeoRead v0.9.42026-10-29 · 2026-10-29 16:45 UTC
查看更新说明
调整引注窗口字号
缩小引注窗口中的文字，方便查看和操作。
Reader 更名为 NeoRead
应用与安装包更名为 NeoRead。首次启动可迁移旧 Reader 数据，复制与校验完成后才启用新数据；清理旧数据需单独确认。
新增 Word 与 WPS 引用插件
在设置中安装插件后，可从论文库添加或编辑引注、生成参考文献表、切换样式及刷新引用。支持桌面版 Word（Windows、macOS）和 Windows WPS；使用时需保持 NeoRead 运行。
内置多种引用样式
支持 GB/T 7714—2015、GB/T 7714—2025、APA、IEEE、Chicago 等样式，并支持页码等定位信息、多篇引注和脚注或尾注排版。
交互式首次使用引导
通过实际操作介绍 Agent 连接、论文导入与阅读。新建论文库附带已解析和翻译的示例论文，可直接体验原文定位与阅读功能。
管理论文附件
为论文添加文件或链接附件，展开浏览附件并预览 PDF；支持拖放添加，下载结束后可继续清理文件。
编辑文档目录与批量操作
文档导航按原文顺序展示，支持编辑目录、多选和批量删除；PDF 导出与重新导入时保留导航类型。
查看联网搜索与工具活动
对话中显示联网搜索和工具执行过程，并保留已完成活动的详情；联网搜索选项集中到设置中，修改后自动保存。
改善 PDF 缩放、颜色与阅读布局
为每篇 PDF 保留缩放状态，拖动面板时减少重复渲染与画面闪动；改善图形和文字路径的阅读配色，提供独立滚动条并记住阅读布局。
改善论文表格与快捷切库
论文表格随面板宽度调整，拖动列宽时更合理地分配空间；支持使用功能键打开常用论文库。
改善知网收录与标签选择
浏览器插件改善知网论文识别、PDF 获取及需要登录的下载流程，减少关联论文误匹配，并支持使用标签胶囊多选标签。
恢复不可用的论文库
论文库路径不可用时，可重新定位或打开已有论文库；切换前检查数据完整性。论文解析完成前暂不允许打开，避免进入不完整的阅读页面。
修复 Reader 数据迁移卡住
修复启动缓存目录冲突导致迁移无法完成的问题。已完成复制与校验但尚未启用的数据可继续迁移，保留原有书库与迁移记录。
改善迁移退出与故障诊断
迁移期间退出 NeoRead 时，等待后台迁移进程结束后再退出，避免重启后仍被占用。迁移日志可区分目录冲突、校验失败和书库占用等原因。
按业务数据迁移旧 Reader 书库
仅迁移旧书库、书库位置和代理配置，避免 Windows 等平台的浏览器缓存目录冲突；支持继续完成已中断的迁移。清理只处理已迁移的旧业务数据，保留引用连接文件及其他未迁移内容，并支持显式重试此前失败的清理。
调整设置页布局与选择操作
重新组织显示、检索、代理和诊断设置，统一分组与分隔样式；点击 Agent 卡片即可选择当前 Agent，并支持拖动高亮颜色调整顺序。
书籍详情与真实封面
书籍列表显示真实封面，新增书籍详情面板，支持查看和编辑书籍信息。
修复部分 EPUB 正文显示异常
修复 XHTML 自闭合标签导致的正文缺失和异常下划线。
多文档标签页与阅读恢复
在设置中开启多文档标签页后，可切换、拖动排序和批量打开文档，重启后恢复标签与已保存的阅读位置；支持重新打开本次运行中误关的标签。
书籍后台解析与 EPUB 段落操作
PDF 书籍按章节在后台解析，封面显示处理进度；EPUB 按需加载章节，支持段落聚焦、复制、向 AI 提问和图片预览，并改善目录定位。
原文与译文支持上下排列
双语阅读新增上下布局，交换原文与译文位置时保留滚动位置；改善聚焦段落与图片的缩放、居中和边距。
详情浮层与重新解析
单击图书或论文打开详情浮层，双击进入阅读；可直接编辑图书信息，并从右键菜单重新解析已有文档。目录支持一键展开或折叠。
改善重新翻译后的批注处理
重新翻译时处理关联批注的恢复，并及时更新已打开的阅读器；旧版笔记提供手动迁移入口。
修复 macOS 应用菜单与切换
修复启动后 NeoRead 未显示在顶部应用菜单和 Command-Tab 应用切换器中的问题。
修复 macOS Word 插件安装与引用窗口
修复 macOS Word 插件安装，引用编辑窗口可显示在 Word 上方；兼容旧 Reader 引用数据，并改善引用预览显示。
论文封面卡片与作者显示
论文库新增封面卡片视图，使用 PDF 首页作为封面；可在设置中控制标题下方的作者显示。
调整书籍与论文卡片大小
使用 Command/Ctrl 加滚轮或加减号调整卡片大小，按 Command/Ctrl+0 恢复默认；分别保存书籍和论文库的卡片大小。
改进论文标题识别与信息查找
导入 PDF 时尝试识别论文标题；配置翻译模型后，可根据首页文字提供可应用或删除的 AI 标题建议。应用建议后自动查找论文信息，查找失败时会重试。
批量补充论文信息
在设置的诊断页面，可为缺少出处的论文重新识别标题并查找信息。手动编辑过的标题会保留，论文详情自动隐藏空字段。
改善长时间对话与工具执行
延长模型执行等待时间；工具调用达到次数限制时，使用已有结果完成回答，并显示工具失败及调用限制信息。
减小桌面应用体积
macOS 安装包去除重复的本地推理库；Electron 内置界面语言资源仅保留简体中文、繁体中文和英文，不限制文章与笔记的语言。
- v0.9.3NeoRead v0.9.32026-10-28 · 2026-10-28 13:19 UTC
查看更新说明
Reader 更名为 NeoRead
应用与安装包更名为 NeoRead。首次启动可迁移旧 Reader 数据，复制与校验完成后才启用新数据；清理旧数据需单独确认。
新增 Word 与 WPS 引用插件
在设置中安装插件后，可从论文库添加或编辑引注、生成参考文献表、切换样式及刷新引用。支持桌面版 Word（Windows、macOS）和 Windows WPS；使用时需保持 NeoRead 运行。
内置多种引用样式
支持 GB/T 7714—2015、GB/T 7714—2025、APA、IEEE、Chicago 等样式，并支持页码等定位信息、多篇引注和脚注或尾注排版。
交互式首次使用引导
通过实际操作介绍 Agent 连接、论文导入与阅读。新建论文库附带已解析和翻译的示例论文，可直接体验原文定位与阅读功能。
管理论文附件
为论文添加文件或链接附件，展开浏览附件并预览 PDF；支持拖放添加，下载结束后可继续清理文件。
编辑文档目录与批量操作
文档导航按原文顺序展示，支持编辑目录、多选和批量删除；PDF 导出与重新导入时保留导航类型。
查看联网搜索与工具活动
对话中显示联网搜索和工具执行过程，并保留已完成活动的详情；联网搜索选项集中到设置中，修改后自动保存。
改善 PDF 缩放、颜色与阅读布局
为每篇 PDF 保留缩放状态，拖动面板时减少重复渲染与画面闪动；改善图形和文字路径的阅读配色，提供独立滚动条并记住阅读布局。
改善论文表格与快捷切库
论文表格随面板宽度调整，拖动列宽时更合理地分配空间；支持使用功能键打开常用论文库。
改善知网收录与标签选择
浏览器插件改善知网论文识别、PDF 获取及需要登录的下载流程，减少关联论文误匹配，并支持使用标签胶囊多选标签。
恢复不可用的论文库
论文库路径不可用时，可重新定位或打开已有论文库；切换前检查数据完整性。论文解析完成前暂不允许打开，避免进入不完整的阅读页面。
修复 Reader 数据迁移卡住
修复启动缓存目录冲突导致迁移无法完成的问题。已完成复制与校验但尚未启用的数据可继续迁移，保留原有书库与迁移记录。
改善迁移退出与故障诊断
迁移期间退出 NeoRead 时，等待后台迁移进程结束后再退出，避免重启后仍被占用。迁移日志可区分目录冲突、校验失败和书库占用等原因。
按业务数据迁移旧 Reader 书库
仅迁移旧书库、书库位置和代理配置，避免 Windows 等平台的浏览器缓存目录冲突；支持继续完成已中断的迁移。清理只处理已迁移的旧业务数据，保留引用连接文件及其他未迁移内容，并支持显式重试此前失败的清理。
调整设置页布局与选择操作
重新组织显示、检索、代理和诊断设置，统一分组与分隔样式；点击 Agent 卡片即可选择当前 Agent，并支持拖动高亮颜色调整顺序。
书籍详情与真实封面
书籍列表显示真实封面，新增书籍详情面板，支持查看和编辑书籍信息。
修复部分 EPUB 正文显示异常
修复 XHTML 自闭合标签导致的正文缺失和异常下划线。
多文档标签页与阅读恢复
在设置中开启多文档标签页后，可切换、拖动排序和批量打开文档，重启后恢复标签与已保存的阅读位置；支持重新打开本次运行中误关的标签。
书籍后台解析与 EPUB 段落操作
PDF 书籍按章节在后台解析，封面显示处理进度；EPUB 按需加载章节，支持段落聚焦、复制、向 AI 提问和图片预览，并改善目录定位。
原文与译文支持上下排列
双语阅读新增上下布局，交换原文与译文位置时保留滚动位置；改善聚焦段落与图片的缩放、居中和边距。
详情浮层与重新解析
单击图书或论文打开详情浮层，双击进入阅读；可直接编辑图书信息，并从右键菜单重新解析已有文档。目录支持一键展开或折叠。
改善重新翻译后的批注处理
重新翻译时处理关联批注的恢复，并及时更新已打开的阅读器；旧版笔记提供手动迁移入口。
修复 macOS Word 插件安装与引用窗口
修复 macOS Word 插件安装，引用编辑窗口可显示在 Word 上方；兼容旧 Reader 引用数据，并改善引用预览显示。
- v0.9.2NeoRead v0.9.22026-10-25 · 2026-10-25 12:54 UTC
查看更新说明
Reader 更名为 NeoRead
应用与安装包更名为 NeoRead。首次启动可迁移旧 Reader 数据，复制与校验完成后才启用新数据；清理旧数据需单独确认。
新增 Word 与 WPS 引用插件
在设置中安装插件后，可从论文库添加或编辑引注、生成参考文献表、切换样式及刷新引用。支持桌面版 Word（Windows、macOS）和 Windows WPS；使用时需保持 NeoRead 运行。
内置多种引用样式
支持 GB/T 7714—2015、GB/T 7714—2025、APA、IEEE、Chicago 等样式，并支持页码等定位信息、多篇引注和脚注或尾注排版。
交互式首次使用引导
通过实际操作介绍 Agent 连接、论文导入与阅读。新建论文库附带已解析和翻译的示例论文，可直接体验原文定位与阅读功能。
管理论文附件
为论文添加文件或链接附件，展开浏览附件并预览 PDF；支持拖放添加，下载结束后可继续清理文件。
编辑文档目录与批量操作
文档导航按原文顺序展示，支持编辑目录、多选和批量删除；PDF 导出与重新导入时保留导航类型。
查看联网搜索与工具活动
对话中显示联网搜索和工具执行过程，并保留已完成活动的详情；联网搜索选项集中到设置中，修改后自动保存。
改善 PDF 缩放、颜色与阅读布局
为每篇 PDF 保留缩放状态，拖动面板时减少重复渲染与画面闪动；改善图形和文字路径的阅读配色，提供独立滚动条并记住阅读布局。
改善论文表格与快捷切库
论文表格随面板宽度调整，拖动列宽时更合理地分配空间；支持使用功能键打开常用论文库。
改善知网收录与标签选择
浏览器插件改善知网论文识别、PDF 获取及需要登录的下载流程，减少关联论文误匹配，并支持使用标签胶囊多选标签。
恢复不可用的论文库
论文库路径不可用时，可重新定位或打开已有论文库；切换前检查数据完整性。论文解析完成前暂不允许打开，避免进入不完整的阅读页面。
修复 Reader 数据迁移卡住
修复启动缓存目录冲突导致迁移无法完成的问题。已完成复制与校验但尚未启用的数据可继续迁移，保留原有书库与迁移记录。
改善迁移退出与故障诊断
迁移期间退出 NeoRead 时，等待后台迁移进程结束后再退出，避免重启后仍被占用。迁移日志可区分目录冲突、校验失败和书库占用等原因。
按业务数据迁移旧 Reader 书库
仅迁移旧书库、书库位置和代理配置，避免 Windows 等平台的浏览器缓存目录冲突；支持继续完成已中断的迁移。清理只处理已迁移的旧业务数据，保留引用连接文件及其他未迁移内容，并支持显式重试此前失败的清理。
调整设置页布局与选择操作
重新组织显示、检索、代理和诊断设置，统一分组与分隔样式；点击 Agent 卡片即可选择当前 Agent，并支持拖动高亮颜色调整顺序。
书籍详情与真实封面
书籍列表显示真实封面，新增书籍详情面板，支持查看和编辑书籍信息。
修复部分 EPUB 正文显示异常
修复 XHTML 自闭合标签导致的正文缺失和异常下划线。
用户点评
登录用户的真实使用记录，可按版本和硬件筛选共 0 条
还没有人点评。第一个说出真实体验的人最有价值。
一个本地优先的 EPUB / PDF AI 阅读器，用于阅读电子书与论文、对照译文、记录批注，以及结合原文向 AI 提问。
NeoRead 以 EPUB 和 PDF 为两种核心文档格式，将图书库与论文库分开管理，提供目录、搜索、双语对照、批注与 AI 助读。文档、阅读进度和笔记保存在本机。AI 功能可以通过已登录的 Claude Code、Codex CLI 或 Kimi Code CLI 调用，无需在 NeoRead 中另填 API Key；也可以填写 API 地址和 Key，接入 OpenAI 或 Anthropic 兼容接口。
可从官网了解项目，或在 GitHub Releases 下载安装包：macOS（Apple Silicon）DMG 与 Windows x64 EXE。Intel Mac 安装包暂停构建，Linux 不提供安装包，也可以从源码运行。安装包没有受系统信任的开发者证书，首次运行可能需要允许系统安全提示。流程与验证范围见安装包与发版说明。
功能
书库与论文管理
- 图书库与论文库：分别管理电子书和论文，可在两库间移动文档。图书库支持 EPUB / PDF；论文库只收 PDF，单个文件不超过 50 MB、150 页，超过 50 页时会先询问。
- 论文信息：编辑作者、年份、出处、DOI、arXiv、摘要等信息；在线补全不覆盖手动修改。支持嵌套分类、标签与智能标签分类、列表与可排序表格视图、阅读状态、批量操作、重复论文检测与合并、双向相关论文。
- 期刊评级：配置 easyScholar 密钥后，在论文标题旁显示期刊评级，可选择要显示的评级体系。
- 多种收录方式：通过编号、链接或标题导入；安装 NeoRead Connector Chrome 扩展后，可从论文页面或搜索结果收录 PDF、论文信息和离线网页快照；也可从本机 Zotero 迁移 PDF、论文信息、分类、标签、笔记和可转换的批注。
- 引用导出：支持 GB/T 7714、APA、BibTeX 和 RIS，可复制单篇引用或批量导出。
- 回收站：删除后保留原文件、批注和对话，可撤销或恢复；确认彻底删除后才移除数据。
阅读与翻译
- 多文档标签页：可同时打开多篇论文或图书，在标签间切换并保留阅读位置、未发送问题和对话；支持批量打开、关闭确认和重启恢复。操作与快捷键见标签页说明。
- 统一阅读界面：左侧目录与搜索，中间正文，右侧 AI 对话与笔记；可调整侧栏宽度或收起侧栏。
- PDF 解析与翻译：本地按页解析正文与版面，翻译正文和图题，并把公式图片转为 LaTeX；图书 PDF 按章翻译。进度显示在书库封面浮层中，可边处理边阅读。鼠标移到段落或图片上时，可复制内容、放大查看原图或让 AI 解释。
- EPUB 双语阅读：正文在应用内连续滚动或翻页阅读，“翻译本章”按需翻译当前章节；原文与译文对照滚动，句子悬停联动，批注在原文和译文间共享。译文可单独设置字体、字号和字重。
- 阅读记录：书签、高亮、下划线、问题批注、批注标签、论文笔记与阅读位置恢复；悬停即可预览批注，支持按颜色和标签筛选、搜索笔记、撤销批注改动、摘录批注、Markdown 导出及桌面
neoread://链接。PDF 内部引用支持悬停预览和返回阅读位置。 - 阅读偏好：双击选中整句，可选开启选中文字自动复制；可自定义高亮颜色和译文字体；界面支持浅色、深色、纸张与跟随系统，桌面窗口外观同步切换。
AI 助读
- 问答与解释：选区翻译与解释、多选区引用、EPUB 当前章节或 PDF 当前页总结、对话历史和生成取消。普通提问默认附带论文标题和摘要，可开启章节正文；引用选段提问时附带所在章节。回答中的出处可跳回原文并闪烁定位。
- 在 Codex 中继续：完成 Codex 文档阅读对话后，从 Agent 顶栏打开独立的 Codex App 对话，保留已有上下文并附带原文和聊天快照。关闭 NeoRead 后也可继续阅读；两边后续消息不自动同步。
- 两种接入方式：检测本机 Claude Code / Codex CLI / Kimi Code CLI 的安装与登录状态，通过官方 CLI 使用已有账户；或在设置中配置 API 连接，支持 OpenAI Chat Completions 与 Anthropic Messages 协议。问答与翻译可分别选择模型和思考强度。
桌面应用
- 应用内更新：检查并下载新版本，显示下载进度；macOS 固定证书版本原地更新，Windows 校验后静默安装并重新打开 NeoRead。
- 代理与诊断：在设置中选择跟随系统代理、手动代理或直连，并检测连接；遇到问题时可导出过滤敏感字段的诊断日志。
- 指南与更新说明：首次使用指南帮助完成 Agent 设置；每个版本附带离线更新说明，可从更新提示直接到 GitHub 反馈。
论文库的收录限制、联网查找、重复合并与人工检查步骤见论文库说明。
两种格式各自保留适合其排版的阅读方式：
| 能力 | EPUB | |
|---|---|---|
| 阅读内核 | 应用内渲染清理后的章节，Readium Go Toolkit 解析 | PDF.js Viewer |
| 导航 | 分级目录、章节跳转、章内与跨章链接 | Outline 目录、页码跳转 |
| 排版 | 连续滚动 / 翻页、字号、字体、行距、页边距 | 连续滚动、缩放、适合宽度 |
| 翻译 | 按章手动翻译，原文 / 译文对照 | 导入后解析并翻译 |
| 搜索 | SQLite FTS5，配合字面子串匹配 | 逐页文本搜索 |
| 定位与批注 | 章节资源、段落 ID 与字符范围 | 页码与归一化选区矩形 |
空书库中可以点击“先体验示例文档”，加载项目附带的原创三章 EPUB 和两页 PDF。
截图
以下截图来自应用本身，使用项目自带的示例文档；图片会跟随 GitHub 的浅色 / 深色外观。
| 书库 | Agent 设置 |
|---|---|
快速开始
需要 Node.js 22+、pnpm 10.30.3 和 Go 1.26.5+。
git clone https://github.com/cynicalight/NeoRead.git
cd NeoRead
pnpm install
pnpm desktop
pnpm desktop 会构建 Go 服务、Web 界面和 Electron，然后打开桌面窗口。主 API 监听本机随机端口，并随应用关闭。
若安装时 Electron 二进制未成功下载，可运行以下命令后重试：
node apps/desktop/node_modules/electron/install.js
使用 AI
AI 是可选功能。本地阅读、搜索和批注不需要登录 AI 账户。
通过 CLI 接入：先安装所需的官方 CLI，并在终端完成登录：
# 使用 Codex
codex login
# 或使用 Claude Code
claude auth login
NeoRead 不安装 CLI、不读取其凭据文件，也不自行实现 OAuth。账户权限、额度、模型可用性与计费方式由 CLI 登录和对应服务决定。旧版 CLI 可能需要升级才能支持桥接参数。
通过 API 接入：在设置中选择 API，填写地址、Key 和模型。请求协议默认按官方地址自动识别，也可手动选择 OpenAI Chat Completions 或 Anthropic Messages；中转地址保持填写的根路径。Key 只保存在本机后端，界面只显示是否已配置。各厂商思考强度的适配规则见 API 厂商适配。
打开 NeoRead 设置，指定主 Agent，并检查文字与图片能力检测结果。真实测试通过后显示绿色徽标，等待中的 PDF 翻译会自动继续。问答与翻译可分别选择模型及支持的思考强度；未指定时使用对应任务的推荐模型。
应用内置约 67 MB 的版面模型，首次解析 PDF 即可离线提取版面和定位图片区域；无需安装 Python 或 PaddlePaddle。模型在构建时获取并校验，权重不进入 Git。未配置通过能力测试的主 Agent 时，正文阅读和图片区域悬停仍可用，翻译显示等待配置。退出后会恢复任务并复用已保存译文；扫描页尚不支持 OCR，会明确标记正文不完整。
调用 AI 时，相关内容会离开本机。 图片能力测试使用合成图片；启用主 Agent 后，导入 PDF 的正文和图题会发送翻译，公式图片会发送转换为 LaTeX；图表和表格不会发送解析。EPUB 只在点击“翻译本章”后发送该章正文。触发翻译、解释、总结或发送问题后，NeoRead 会将选区、论文标题与摘要、按需附带的章节或当前页面上下文及最近对话交给 CLI 或 API 服务。章节和上下文有长度限制；当前页总结不等于整篇论文总结。
CLI 在临时空目录中运行。Claude 配置为禁用工具与 MCP；Codex 使用只读沙箱并禁用 shell 工具。CLI 的原始日志不会作为回答显示。Codex 通过 App Server 接收增量文字，Claude 使用 stream-json，Kimi 使用 ACP 消息片段，API 使用 SSE；纯文字和图片对话均逐段传输。前端对接约定见 Agent 流式输出文档。
本地数据
原文件存放在文件系统，文档信息、进度、批注、对话与设置存放在 SQLite。NeoRead 没有内置云同步。论文元数据查找和在线导入会访问公开的论文服务；自动补全仅发送识别到的 DOI 或 arXiv 编号，可在设置中关闭。期刊评级只在配置 easyScholar 密钥后查询，并在本机缓存结果。
| 运行方式 | 数据目录 |
|---|---|
| 已安装桌面版 | Electron userData/library/；macOS 通常为 ~/Library/Application Support/NeoRead/library/ |
未打包桌面版（pnpm desktop） | macOS 为 ~/Library/Application Support/NeoRead Dev/library/ |
浏览器开发模式（pnpm dev） | 项目根目录的 .neoread/ |
桌面版可在 设置 → 论文库 → 书库位置 中选择新的保存文件夹。NeoRead 会在其中新建 NeoRead Library，保存当前阅读状态后，复制 PDF、EPUB、笔记、批注、阅读记录及其他书库数据，校验成功后重启。已有的 NeoRead Library 不会被覆盖，原书库保留为迁移时的备份，之后的修改只写入新位置。笔记仍保存在书库数据库中，不单独导出文件；这不是 Zotero 持续同步。
书库保存路径（包括上级目录）不能包含 ?。自定义位置记录在 userData/library-location.json，命令行也会跟随该位置。若外接存储设备未连接或保存位置已被移走，桌面版会停止启动并提示错误，不会自动创建空书库。上表是未自定义时的默认目录。
旧 Reader 的书库通常在 ~/Library/Application Support/Reader/library/。安装版 NeoRead 首次启动时会一次性复制并校验旧书库及相关配置，迁移完成后可选择清理已迁移的旧业务数据；开发模式不读取旧 Reader 数据。迁移范围、恢复与清理规则见迁移说明。
library/
├── neoread.sqlite # 文档信息、阅读记录、对话、设置与全文索引
├── books/ # EPUB 原文件
├── papers/ # PDF 原文件
├── cache/ # EPUB 资源；PDF analysis 下的 Markdown、图片与解析稿
└── ai-work/ # CLI 临时目录，请求结束后移除
桌面版的运行日志保存在 userData/logs/，最多保留 7 天，不会自动上传。备份前先关闭应用，再复制整个数据目录。本地 API 使用每次启动随机生成的 token，并校验 Host / Origin。EPUB 导入会检查压缩包大小、资源路径并清理活动内容；原文件保持原样。
开发
启动 Go 服务和带热更新的 Web 界面：
pnpm dev
终端会输出 http://127.0.0.1:5173/#token=…，请用完整地址打开。Vite 将请求代理到 127.0.0.1:17840 的 Go 服务。该 token 用于本地服务鉴权，不是 AI 账户凭据，请勿分享带 token 的地址。
开发运行默认不监听插件端口；设置 NEOREAD_DEV_CONNECTOR=1 可启用。未打包桌面版默认不注册 neoread://；设置 NEOREAD_DEV_PROTOCOL=1 可启用。
pnpm dev、pnpm desktop 和 pnpm build 会先准备固定版本的版面模型。首次构建需要下载约 67 MB，后续校验并复用 apps/processor/models/ 中的构建缓存；该目录不进入 Git。离线构建可将 NEOREAD_BUILD_LAYOUT_MODEL 设为已有权重文件的绝对路径，仍需通过大小和 SHA256 校验。pnpm install、类型检查和普通单元测试不下载模型。
pnpm typecheck # TypeScript 类型检查
pnpm test # Go 集成测试与 Vitest
pnpm build # 构建 Go、Web 和 Electron
pnpm api:generate # 从 OpenAPI 重新生成客户端类型
项目官网位于 website/，是无需构建的静态 HTML / CSS / JavaScript。本地预览：python3 -m http.server 4321 -d website，然后打开 http://127.0.0.1:4321/。
测试覆盖文档导入、持久化、资源访问边界、CLI 与 API 协议、PDF 解析与部分前端回归。构建和测试通过不能替代真实文档与界面的人工检查，详见验证记录。
技术与结构
前端使用 React、TypeScript、Vite、Tailwind CSS、shadcn/ui（Base UI）和 Zustand。Electron 负责窗口、原生文件选择、应用更新与 Go 服务生命周期。Go 管理本地文档、SQLite、搜索和 AI 调用。PDF 版面解析由 Node 处理器通过 ONNX Runtime 在本机完成。
apps/
├── desktop/ # Electron main / preload
├── web/ # React 界面、PDF.js 与 EPUB 阅读适配器
├── server/ # Go 本地服务
├── processor/ # PDF 版面解析与本地版面模型
└── connector/ # NeoRead Connector Chrome 扩展
packages/
├── ui/ # shadcn/ui + Base UI 组件
├── neoread-core/ # Document、Location、TOC、Annotation、ReaderAdapter
└── api-client/ # OpenAPI 类型与 API 客户端
docs/ # 范围、路线图、接口与验证记录
website/ # 项目官网静态页面与 README 截图
assets/ # Logo 源文件与应用图标
业务模型围绕 Document 组织。PDF 用页码和坐标定位；EPUB 使用章节资源、段落 ID 和字符范围定位。阅读界面通过 ReaderAdapter 调用各自的引擎。项目使用 pnpm workspace，不依赖 Nx 或 Turborepo。
阅读布局会在当前书库中自动记忆：左右侧栏的宽度与展开状态、原文和译文的分栏比例及左右顺序。PDF 与 EPUB 共用最后一次手动调整，重新打开文档或重启应用后恢复；收起侧栏或临时切到单栏不会覆盖已记住的宽度。
当前限制与后续计划
当前主要面向无 DRM、横排从左到右的可重排 EPUB 与含文本的 PDF。尚未支持 OCR、密码 PDF 输入、PDF 缩略图、后台 PDF 全文索引、跨文档 AI 检索、独立多会话管理、Ollama 和阅读统计。复杂跨页 PDF 选区暂不创建高亮。
固定版式 EPUB、竖排、RTL、复杂脚注和大文件仍需更多真实样本验证。桌面端已接入 macOS 文件打开事件，但尚未注册系统文件关联；安装包由 CI 构建，尚未提供受系统信任的开发者签名或 macOS 公证。应用内更新的条件见发版与更新说明。
2026 年 10 月计划更新：
- NeoRead 命令行工具：在终端中检索、阅读和导入书库文档，供 Claude Code、Codex 等 Agent 和脚本使用。
- RAG 支持：AI 问答全面优化，基于检索为回答提供跨章节、跨文档的原文依据。
- EPUB 大部头翻译优化：改善大型图书的按章翻译速度、任务调度与续译体验。
更长期的计划见路线图。
Star History
致谢
感谢 Readium、PDF.js、shadcn/ui 和 Base UI。shadcn 组件保留在 packages/ui，相关许可见 packages/ui/LICENSE.md。更多技术来源与归属见第三方来源。
koreader
koreader·Lua
基于 LuaJIT 的电子书阅读器，支持 PDF、EPUB、DjVu、FB2 等格式，可运行在 Kindle、Kobo、PocketBook 等墨水屏设备和 Android 上。
电子书阅读器+4电子书阅读器
31014+712.0kv2026.07.12026-11-10 10:14 UTC
calibre
kovidgoyal·Python
功能完整的电子书管理工具，能整理书库、转换 EPUB、MOBI 等格式，并支持编辑元数据和推送到 Kindle 阅读。
电子书管理+4电子书阅读器
26399+222.8kv9.18.02026-11-10 07:13 UTC
readest
readest·TypeScript
一款现代跨平台电子书阅读器，支持 EPUB、MOBI、Kindle 等格式，界面直观、工具丰富，适合重度阅读用户在多设备间无缝阅读。
电子书阅读器+4电子书阅读器
26151+1041.9kv0.12.202026-11-10 11:10 UTC
calibre-web
janeczku·Fluent
把 Calibre 书库变成网页版书架，支持在线浏览、阅读和下载电子书，方便多设备访问自己的藏书。
电子书管理+4电子书阅读器
18548+61.9k0.6.272026-10-10 05:40 UTC