cynicalight / reader
git clone https://github.com/cynicalight/reader.git
v0.8.5 · 3d ago
Local-first EPUB/PDF reader with annotations and AI assistance through Claude Code and Codex CLI. Built with React, TypeScript, shadcn/ui, Go, and Electron.
+6
stars, 24h · #2,252
+~42
stars, 7 days · #2,832
+257
stars, 30 days · #2,033
270
★ total · +20% this week
22
forks · 13 open issues
Star history (as recorded here)
LanguageTypeScript
License—
Created2026-10-03 (18d ago)
Last pushtoday
Watchers0
OwnerUser
Links
- GitHub: github.com/cynicalight/reader
- Homepage: https://cynicalight.github.io/reader/
- Releases · Issues · Hacker News mentions
README excerpt
Reader 简体中文 | English | 官网 一个本地优先的 EPUB / PDF AI 阅读器,用于阅读电子书与论文、对照译文、记录批注,以及结合原文向 AI 提问。 Reader 以 EPUB 和 PDF 为两种核心文档格式,将图书库与论文库分开管理,提供目录、搜索、双语对照、批注与 AI 助读。文档、阅读进度和笔记保存在本机。AI 功能可以通过已登录的 Claude Code、Codex CLI 或 Kimi Code CLI 调用,无需在 Reader 中另填 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 密钥后,在论文标题旁显示期刊评级,可选择要显示的评级体系。 - **多种收录方式**:通过编号、链接或标题导入;安装 Reader Connector Chrome 扩展后,可从论文页面或搜索结果收录 PDF、论文信息和离线网页快照;也可从本机 Zotero 迁移 PDF、论文信息、分类、标签、笔记和可转换的批注。 - **引用导出**:支持 GB/T 7714、APA、BibTeX 和 RIS,可复制单篇引用或批量导出。 - **回收站**:删除后保留原文件、批注和对话,可撤销或恢复;确认彻底删除后才移除数据。 **阅读与翻译** - **统一阅读界面**:左侧目录与搜索,中间正文,右侧 AI 对话与笔记;可调整侧栏宽度或收起侧栏。 - **PDF 解析与翻译**:本地按页解析正文与版面,翻译正文和图题,并把公式图片转为 LaTeX;图书 PDF 按章翻译。进度显示在书库封面浮层中,可边处理边阅读。鼠标移到段落或图片上时,可复制内容、放大查看原图或让 AI 解释。 - **EPUB 双语阅读**:正文在应用内连续滚动或翻页阅读,“翻译本章”按需翻译当前章节;原文与译文对照滚动,句子悬停联动,批注在原文和译文间共享。译文可单独设置字体、字号和字重。 - **阅读记录**:书签、高亮、下划线、问题批注、批注标签、论文笔记与阅读位置恢复;悬停即可预览批注,支持按颜色和标签筛选、搜索笔记、撤销批注改动、摘录批注、Markdown 导出及桌面 `reader://` 链接。PDF 内部引用支持悬停预览和返回阅读位置。 - **阅读偏好**:双击选中整句,可选开启选中文字自动复制;可自定义高亮颜色和译文字体;界面支持浅色、深色、纸张与跟随系统,桌面窗口外观同步切换。 **AI 助读** - **问答与解释**:选区翻译与解释、多选区引用、EPUB 当前章节或 PDF 当前页总结、对话历史和生成取消。普通提问默认附带论文标题和摘要,可开启章节正文;引用选段提问时附带所在章节。回答中的出处可跳回原文并闪烁定位。 - **在 Codex 中继续**:完成 Codex 文档阅读对话后,从 Agent 顶栏打开独立的 Codex App 对话,保留已有上下文并附带原文和聊天快照。关闭 Reader 后也可继续阅读;两边后续消息不自动同步。 - **两种接入方式**:检测本机 Claude Code / Codex CLI / Kimi Code CLI 的安装与登录状态,通过官方 CLI 使用已有账户;或在设置中配置 API 连接,支持 OpenAI Chat Completions 与 Anthropic Messages 协议。问答与翻译可分别选择模型和思考强度。 **桌面应用** - **应用内更新**:检查并下载新版本,显示下载进度;macOS 固定证书版本原地更新,Windows 校验后静默安装并重新打开 Reader。 - **代理与诊断**:在设置中选择跟随系统代理、手动代理或直连,并检测连接;遇到问题时可导出过滤敏感字段的诊断日志。 - **指南与更新说明**:首次使用指南帮助完成 Agent 设置;每个版本附带离线更新说明,可从更新提示直接到 GitHub 反馈。 论文库的收录限制、联网查找、重复合并与人工检查步骤见论文库说明。 两种格式各自保留适合其排版的阅读方式: | 能力 | EPUB | PDF | | ---------- | ----------------------------------------------- | ------------------------ | | 阅读内核 | 应用内渲染清理后的章节,Readium Go Toolkit 解析 | PDF.js Viewer | | 导航 | 分级目录、章节跳转、章内与跨章链接 | Outline 目录、页码跳转 | | 排版 | 连续滚动 / 翻页、字号、字体、行距、页边距 | 连续滚动、缩放、适合宽度 | | 翻译 | 按章手动翻译,原文 / 译文对照 | 导入后解析并翻译 | | 搜索 | SQLite FTS5,配合字面子串匹配 | 逐页文本搜索 | | 定位与批注 | 章节资源、段落 ID 与字符范围 | 页码与归一化选区矩形 | 空书库中可以点击“先体验示例文档”,加载项目附带的原创三章 EPUB 和两页 PDF。 ## 截图 以下截图来自应用本身,使用项目自带的示例文档;图片会跟随 GitHub 的浅色 / 深色外观。 | 书库 | Agent 设置 | | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------- | | | | ## 快速开始 需要 **Node.js 22+、pnpm 10.30.