📈 GH Trending Explorer 🎲 Surprise me

← all repos

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)

2026-10-20 · 251 ★ 2026-10-22 · 270 ★
LanguageTypeScript
License—
Created2026-10-03 (18d ago)
Last pushtoday
Watchers0
OwnerUser

Links

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.