Skip to content
WZR0821Public

About

读鼠 Jerreader:面向中、英、日文阅读与学习的 iOS / Android 电子书阅读器,支持点按翻译与 AI 解析。

Topics

Resources

Stars

116 stars

Watchers

0 watching

Forks

Repository files navigation

读鼠 Jerreader

Important

本 APP 由 Claude Fable 5.2 及 Opus 5.5 开发完成。

Jerreader 是一款面向中、英、日文阅读与学习的 iOS / Android 电子书阅读器。它以原文阅读为主,查词、翻译和解释按需显示,不会把译文写进原书。简体中文系统的桌面显示名为“读鼠”,工程名、包名和应用内品牌仍使用 Jerreader。

平台 当前版本 开发者 许可
iOS 18+ · Android 7.0+(arm64) 2.0.2(build 74) Jerry Wong MIT

主要功能

阅读与书架

  • 支持 EPUB、PDF、DOCX 和 TXT。EPUB 和 PDF 由 Readium 打开,DOCX 和 TXT 会先在本机转成可重排的 EPUB 副本。
  • 导入的书只作为只读输入,翻页、翻译、批注和退出阅读都不会改写原文件;重复导入时会识别出书架里已有的那一本。
  • 目录、全文搜索和书签集中在阅读器的导航面板,结果可以直接跳转;选中文字可以划线和批注。
  • 阅读设置包括字体(衬线 / 日文明朝、无衬线 / 日文黑体、OpenDyslexic)、字号、行间距、段间距、左右边距、上下边距、背景、逐页或滚动阅读,以及顶部栏、底部栏的透明度。每本书的排版单独保存,新书按“默认阅读排版”打开;上下边距和界面布局对所有书生效。
  • 日文书可以在“原版 / 横排”之间切换:原版保留 EPUB 自带的横竖排,横排统一从左向右阅读。书里的 ruby 注音照常显示。
  • 阅读中可以快速调整阅读进度;每本书记录阅读进度和累计阅读时长。
  • 书架支持类似文件夹的分组、系列、标签、最近阅读、搜索、筛选和排序;可以编辑封面(换了新封面也能撤销)、书名、作者、语言、系列和标签,也能批量整理书籍。
  • “设置 → 界面主题”里可以选外观模式(跟随系统 / 浅色 / 深色)、八种主题色,以及要不要页面顶部的背景光晕,上方的预览卡随选择即时变化。阅读页的明暗跟所选的阅读纸张走,不受外观模式影响。

翻译与查词

  • 中文、英语、日语互译,能自动判断常见文本的语言。
  • 在“设置 → 翻译与 AI”里选“句子”或“段落”后,轻点正文就翻译所在的句子或段落;也可以长按后拖动系统选区手柄,精确选择要翻译的文字。
  • 关闭轻点翻译后,短按 EPUB 正文里的词语会直接查词,并写进学习记录。
  • 内置中日词典,装好后离线可查;词条来自中文维基词典,经 Kaikki.org 提取,按 CC BY-SA 4.0 授权。英语扩展包(ECDICT,MIT 许可)可以在“离线资源”里下载,Android 另带约 8,000 词的英汉基础词典。
  • 内置词典查不到时会联网查中文维基词典,只发送要查的词;联网查询失败时,iOS 可以打开系统词典,Android 改用已配置的 AI。
  • 译文只显示在临时卡片或覆盖层里,关闭后正文和阅读位置不变;卡片里可以复制、收藏,或把词语加入生词本。
  • 被页边界截断的句子可以用“扩展跨页句段”补全后再翻译;主翻译服务失败时,会换用已配置的备用翻译服务。
  • 配置 AI 后,还可以用 AI 句子结构分析、语境查词和 AI 阅读透镜。

学习工具

  • “学习 → 翻译”是独立的翻译工作台,有词语和句子两种模式,默认是句子模式。
  • 生词本保存词条、原句和查询次数,并合并重复记录;查询历史可以搜索、删除或清空,清空历史不会删掉已收藏的词条。
  • “学习 → 练习与工具”里有生词间隔复习、原句练习卡、语法知识库和阅读成长报告。
  • 复习卡先显示词语、原句和书名,点“显示释义”再看读音和释义;按“不认识 / 模糊 / 认识”评分,复习间隔分 1、3、7、14、30、60 天几档。日文词条可以“朗读单词”和“朗读原句·跟读”。
  • 每组复习最多 10 个词;“管理复习”里能看到新词、下次复习时间或“已暂停”,也能暂停、恢复或重置进度。
  • 生词和收藏的译文可以导出为 CSV、Markdown 或 Anki TSV。

数据与备份

  • 备份可以选书籍、阅读数据、学习记录和非敏感设置四类,写进你选的文件夹(iOS 可选 iCloud Drive、“我的 iPhone”或其他文件提供商,Android 用系统的目录授权)。
  • 可以自动备份并设定备份间隔。旧备份按保存时间(7、14、30、90、365 天,或不按时间删除)、最多份数(2、3、5、10、20 份)和总容量(250 MB 到 5 GB,或不限容量)从最旧的开始清理,最新的一份始终保留。
  • 恢复时可以从备份文件夹里选,也可以选单个备份文件;重装后重新选同一个文件夹,就能从已有备份恢复。
  • API Key、代理凭据、目录授权和可以重新生成的翻译缓存不进备份。

PDF、DOCX 与 TXT

PDF 由 Readium 打开。带文字层的 PDF 可以轻点句子或段落直接翻译,也可以长按精确框选;没有文字层的扫描页会在本机按需 OCR。双栏论文可以按书打开“论文双栏模式”,轻点识别时只读取所点的那一栏,减少左右两栏被拼成一句。

DOCX 和 TXT 会先在本机生成可重排的 EPUB 阅读副本,再交给 Readium;转换只处理 App 内部的副本,不改原文件。只支持 .docx,旧版 .doc 不在 App 内解析。

OCR 的结果受图片清晰度、倾斜角度、手写和复杂排版影响。受 DRM 保护的出版物会被拒绝打开,Jerreader 不提供绕过 DRM 的功能。

下载与安装

安装包在 GitHub Releases。

  • Android:下载 APK 安装。需要 Android 7.0 及以上、64 位 ARM 处理器(APK 只含 arm64-v8a)。APK 沿用测试分发用的 Debug 证书,和此前的 1.5.1 相同,可以直接覆盖安装。
  • iOS:提供未签名 IPA,需要用自己的证书签名后安装,最低 iOS 18。1.5.0 起 bundle ID 改为 com.raydon.Jerreader,和 GitHub 上此前的 1.3.5、1.5.1 IPA(com.example.Jerreader)不同:装上后是另一个 App,旧版里的数据不会自动带过来。

开始使用

  1. 在书架导入书籍:先选格式,再从系统文件选择器里选文件。
  2. 点封面开始阅读,再次打开会回到上次的位置和排版。
  3. 在“设置 → 翻译与 AI”里选“句子”或“段落”,轻点正文翻译所在的句子或段落。默认开启“轻点翻译时禁用点按翻页”,这时用滑动或底部按钮翻页。这个开关在“设置 → 翻译与 AI”和阅读器的“阅读设置 → 阅读交互”里,只在打开“轻点正文快速翻译”时起作用。
  4. 需要精确范围时,长按后拖动系统选区手柄。
  5. 译文卡片可以复制、收藏或加入生词本;配置了 AI 后还能看句子结构分析。
  6. 目录、全文搜索和书签从阅读器顶部打开;字体、字号、背景、布局等在“阅读与翻译”设置里调整。

数据与隐私

默认的阅读内翻译不需要 API Key:iOS 用 Apple 系统翻译,第一次使用某个语言方向时可能要联网下载语言包;Android 用本机翻译,要先在“离线资源”下载语言包。

  • AI 大模型:在“设置 → AI 大模型”添加供应商,粘贴自己的 API Key,由 App 直接调用。可选 Claude、ChatGPT、DeepSeek、通义千问、豆包、Kimi、智谱 GLM、MiniMax、Gemini,列表里没有的服务用“自定义”添加。每个供应商可以加多个模型,并单独设置接口格式和思考强度;“测试连接”只发送固定短句。
  • AI 套餐(2.0.0 起):在“设置 → AI 大模型 → 添加供应商 → 套餐”里,可以不用 API Key:
    • ChatGPT 套餐(实验):点“Continue with ChatGPT”,在 OpenAI 的页面登录 ChatGPT 账号,翻译和语法解释就用 Plus、Pro 等套餐的额度,不另外收费。额度用完时翻译会停下并提示,不会改成按量付费。登录走 OpenAI 的“Sign in with ChatGPT”;手机上的这种登录方式 OpenAI 还没有写进文档,所以标为实验,登录不上时请改用 API Key。密码只在 OpenAI 的页面输入,App 拿到的登录凭据只存在本机(iOS 钥匙串、Android 系统密钥库加密),不进备份。
    • Claude 套餐额度:Claude Max、Ultra 订阅每月附带的 API 额度(Max 每月 $100、Ultra 每月 $200)。在 claude.ai 领取并关联 Console 组织后,到 Claude 控制台新建 API Key,按普通 Claude 供应商添加即可。
    • Coding Plan、Token Plan 这类编程套餐的条款只允许在编程工具里使用,阅读翻译不在其列,所以不提供。
  • AI 代理:在“设置 → 翻译与 AI”选“AI 代理”,填写自己部署的 HTTPS 中转地址,供应商的 Key 只留在服务器上。仓库里没有现成的代理服务端。

配置步骤和请求格式见维护说明的 AI 大模型配置 和 AI 代理协议。

使用在线翻译或 AI 功能时,选中的文字和语言方向会发给所选服务商,必要时还会带上经过长度限制的邻近上下文,并可能产生费用。API Key 保存在设备的安全存储里(iOS 钥匙串、Android 加密存储),不写入书籍、日志、安装包或备份;建议给个人 Key 设置用量上限并定期轮换。公开分发或多人共用时,更适合用 AI 代理。代理的翻译请求带稳定的幂等键(X-Jerreader-Idempotency-Key),服务端可以据此合并短时间内的重复请求,避免重复计费。

本机数据边界

  • 书籍、阅读位置、批注、生词和翻译历史默认只保存在设备上。
  • 只有用到在线翻译、联网词典或 AI 功能时,相关文字才会发给对应的服务。
  • 自动化测试使用 Mock 和本地 Stub,不访问真实的翻译账户,也不依赖外网。

开发与构建

iOS 是 SwiftUI + SwiftData 的原生工程;Android 用 Compose 和 Room,书库、翻译、查词和学习的 Kotlin 代码以及部分界面放在 shared/ 模块。iOS 不链接 shared/,复习、备份清理、原句练习等规则由 shared/parity/ 里的同一份对拍用例在两端分别测试。

需要带 iOS 18 SDK 的完整 Xcode(Xcode 16 或更高版本)和 JDK 17。测试使用 Mock 或本地 Stub,不需要真实的 API Key。

scripts/safe_xcodebuild.sh doctor
scripts/safe_xcodebuild.sh host-test
scripts/safe_xcodebuild.sh build
scripts/safe_android_build.sh

iOS 只通过 scripts/safe_xcodebuild.sh 构建,默认是 generic iOS device、不签名、不启动模拟器;Android 走 scripts/safe_android_build.sh。两者共用排队锁、串行执行,失败后先查原因,不自动重跑。规则见 AGENTS.md 和 iOS 低负载验证,打开工程的步骤见维护说明的 打开与运行。

更多说明:架构说明 · Android 构建与交付 · 维护说明 · 产品需求文档

项目结构

目录 用途
Jerreader/ iOS App:SwiftUI、SwiftData 与 Readium Swift Toolkit
JerreaderTests/、JerreaderUITests/ iOS 单元测试和界面测试
androidApp/ Android App:Compose、Room 与 Readium Kotlin Toolkit
shared/ Android 用的 Kotlin 共用模块;shared/parity/ 是两端共用的对拍用例,shared/dictionaries/ 是内置中日词典
scripts/ 构建、测试和打包脚本
docs/ 架构说明、各版本维护记录、历史交接记录和第三方许可

两端版本号通常保持一致:iOS 在 Jerreader.xcodeproj 的 MARKETING_VERSION / CURRENT_PROJECT_VERSION,Android 在 androidApp/build.gradle.kts。1.7.1 是只打了 Android 包的修复版,没有单独发布;2.0.0 起两端重新同号。

版本记录

当前版本:iOS 和 Android 都是 2.0.2(74)。书籍导入、书架管理、Readium 阅读、阅读内翻译、查词、学习记录和备份恢复的主要流程已经打通。

2.0.2(74) 是 2.0.1 的修复版,两端同时发布,只修两个问题,都是发布后补验 2.0.1 时查出来的(验证情况见 2.0.2 维护记录):

  • Android:PDF 里点句翻译后拖动或双指缩放页面,选区框和保存过的划线还留在原来的屏幕位置,压到别的字上。2.0.1 说明里写了这处已修好,实际没有生效;现在页面一动,它们就回到那句话上。
  • iOS:“批量整理”的书籍列表里,一行只有书名、作者和左边的圆圈能点,中间的空白点了没反应。现在整行都能点。

2.0.1(73) 是 2.0.0 的修复版,两端同时发布(完整清单和验证情况见 2.0.1 维护记录):

  • 修复护眼、冷灰、深色纸张和自定义背景色下,轻点句子或朗读时选区只剩一圈描边、里面没有填充色的问题。
  • 阅读设置新增“上下边距”,原来的“页边距”改名“左右边距”。上下边距对所有书生效,默认值就是 2.0.0 的留白,升级后版面不变。
  • 离开“设置”再回来,总是从设置首页开始,不再停在上次进过的子页面。
  • “界面主题”页扩充:加了实时预览和外观模式(跟随系统 / 浅色 / 深色),主题色从五种增加到八种(新增松石、赤陶、石墨),背景光晕可以关掉,并能直接跳到默认阅读纸张的设置。
  • 书架右上角的“更多”图标(圆圈里三个点)重画,圆圈和点都收小了一些。
  • 两端都修的:登录 ChatGPT 套餐后,已经填好密钥的 DeepSeek 不再从供应商列表里消失,登录后的提示也如实说明翻译服务是否已经在用套餐;PDF 读到最后一页进度记为 100%;同一条语法讲解重复保存不再变成两条;备份或恢复进行中离开页面不会被打断。
  • iOS:目录里的“当前章节”在一个文件含多个目录项的书和 PDF 上不再判错;PDF 里保存过的划线重新打开或旋转屏幕后照常显示,别的应用留下的批注不再挡住点句翻译;从备份恢复后已登录的套餐不再显示“未设置”;批量整理只加标签时不会把书移出文件夹;设备日历不是公历时阅读时长不再全是 0。
  • Android:自定义背景色下文字颜色跟着明暗变化;阅读页的状态栏和导航栏随纸张变色;PDF 连续滚动时屏幕上露出的每一页都能点句翻译,文字型 PDF 不再整页识别不到字;从译文卡片加的批注落在选中的那句话上;书名、作者排序改成自然顺序(“第 2 卷”排在“第 10 卷”前面)。

2.0.0(72) 是大版本更新,两端同时发布(验证情况见 2.0.0 维护记录)。最初发布的是 build 71,当天修好 ChatGPT 套餐的问题后换成 72,版本号不变:

  • AI 套餐:“设置 → AI 大模型 → 添加供应商”新增“套餐”页。“ChatGPT 套餐(实验)”用 ChatGPT 账号登录,翻译和语法解释走 Plus、Pro 等订阅的额度;“Claude 套餐额度”一步步说明怎样用 Max、Ultra 每月附带的 API 额度。编程套餐的条款只允许在编程工具里使用,所以不接入。详见上面的数据与隐私。
  • 全新界面「纸墨」:静态视觉和动效一起重做,iOS 与 Android 按同一份设计规范逐页实现。暖白纸面、墨色文字,强调色只用在主要操作、选中状态和进度上;卡片分纸卡、浮起两级,浅色模式用柔和的染色阴影。动效参考了 GitHub 上的 iOS 与 Compose 设计、动画 skill:按压、切换和首次出现都用可中断的弹簧,系统“减弱动态效果”(Android 为“移除动画”)打开时改成短暂的淡入淡出。
    • 书架:顶部是日期和“继续阅读”大卡(封面、进度、“继续”按钮),下面的阅读统计卡数字滚动出现;书籍网格每本显示封面、进度条、书名、作者和格式,读完的书有对勾;第一次进入时依次浮现,点封面从封面处放大进入阅读器。
    • 阅读器:标准布局的上下栏保持 1.7.0 的高度、常驻;顶栏按钮换成圆形按钮和“AI”胶囊,底栏是自绘进度条(拖动时显示目标章节)和居中的圆形翻译按钮;加书签时图标弹跳并有触感反馈;阅读设置面板、译文卡片和 AI 伴读重新排版。
    • 学习:分区切换改成滑动的胶囊;翻译工作台是三张纸卡,交换语言时按钮旋转;“练习与工具”顶部是今日练习大卡(环形进度、收藏数和“开始复习”);生词本、查询历史(按天分组)、复习卡(答案揭示、分色评分按钮、完成对勾)、原句练习、语法知识库和阅读成长报告(柱状图生长)都重新设计。
    • 设置:每类设置配一个彩色图标块,分组标题、行高和 AI 供应商图标统一;操作指南和备份中心一并换新。
  • 议题 #2 的两个修复(1.7.1 只打了 Android 包,没有单独发布)随 2.0.0 一起发布,iOS 本来就没有这两个问题。
  • 修复 Android 1.7.0、1.7.1 安装包打不开 PDF(只显示“无法打开这本书”)、本机翻译也用不了的问题:打包压缩代码时删掉了 ML Kit 要用的构造函数,这次补上了保留规则。
  • build 72 修复 ChatGPT 套餐登录后测试连接和翻译都被 OpenAI 拒绝的问题(请求格式不符合套餐接口的要求)。出错时的提示也改了:不再笼统地说“配置无效”或“登录已失效”,而是写明原因,并附上 OpenAI 的原话和请求 id,测试连接页的这段文字可以复制。

1.7.1(70,只有 Android,没有单独发布) 修复 议题 #2 反馈的两个问题。iOS 没有这两个问题,停在 1.7.0(验证情况见 1.7.1 维护记录):

  • 滚动阅读时,左右滑动不再切换章节。以前手指稍微横移一点就会跳到相邻章节,丢掉阅读位置。滚动阅读时底栏的“上一页 / 下一页”切到上一章 / 下一章,屏幕左右边缘的轻点不再翻页。竖排书不变,仍然滑到边缘换章。
  • 选中的文字占满大半页时,译文浮窗不再被压成贴在屏幕上下边缘的细条,也不会被挤到屏幕外:浮窗保留最小高度,始终留在上下栏之间,放不下时盖在选中的文字上。拖动浮窗也不会拖出屏幕。

1.7.0(69) 的改动(验证情况见 1.7.0 维护记录):

  • 书架导入可以先选格式(全部、EPUB、PDF、Word、TXT),选定后系统文件选择器里只能选这种格式。
  • 选一句不再连着整段翻译:日文对白「」后面即使没有句号也算句末,连续几段对白不再被当成一句;iOS 上拖动选区手柄后严格按最终选区翻译,智能补全最长补到 220 字,超过时保留原选区。
  • 阅读界面分「标准」「沉浸」两种布局,在“阅读设置 → 阅读界面 → 界面布局”切换。标准布局的上下栏更小、常驻,翻页键融进页面;沉浸布局正文全屏,轻点正文上下的空白处呼出上下栏,4 秒后自动收起。
  • Android 界面以 iOS 为准逐页对齐,一、二、三级菜单都按截图核对过;Android 发给 AI 代理的请求也改成了和 iOS 相同的格式。
  • iPad 版暂停开发,这一版只做 iPhone 和 Android 手机的适配与验收。

此前的版本:

  • 1.6.0(68):AI 大模型设置重做(Claude、ChatGPT、DeepSeek 置顶,每个供应商可以加多个模型,并单独设置接口格式和思考强度),设置首页改为 iOS 设置样式。维护记录
  • 1.5.0(67):新增 AI 阅读透镜、困惑地图、章节闭环、续读回顾和复习卡跟读;关闭轻点翻译后短按正文词语可以直接查词;iOS bundle ID 改为 com.raydon.Jerreader。维护记录
  • 1.4.1(60):统一字号上限、精简离线资源及许可,新增阅读栏透明度、沉浸阅读和日语注音。验证与维护记录
  • 1.4.0(58–59):统一主导航、书架、学习与设置二级页的布局和图标;修复分页与书籍时间保护,完善外部文件夹备份。界面验收 · 验收与维护方案
  • 1.3.5 及 9–10 月的维护按日期记在 维护说明。

GitHub 上此前的 1.5.1 来自另一条开发线,和这里的 1.5.0–1.7.0 功能不完全相同,它的提交历史和 v1.5.1 标签都保留着。安装包见 Releases。

已知限制

  • iOS 提供的是未签名 IPA,安装前要自己签名。
  • Android 沿用测试分发用的 Debug 证书,不等同于应用商店的正式签名;APK 只含 arm64-v8a。
  • iPad 版暂停开发,没有专门的适配和验收。
  • 语音、听书和语速设置暂时关闭,只有复习卡里的日文朗读可用。
  • Apple 系统翻译第一次使用某个语言方向时,可能需要联网下载语言包。
  • 在线词典、第三方 AI 服务和自建代理的可用性与费用由相应服务商决定。
  • OCR 和自动断句是阅读辅助,复杂版面下可以改用长按选区精确选择。
  • 2.0.0 到 2.0.2 的自动化验收都在模拟器上完成,测试使用 Mock,没有连接真实的 AI 服务;ChatGPT 套餐没有用真实账号登录过,登录不上时请改用 API Key。

许可与致谢

Jerreader 自身的代码以 MIT 许可证 开源。下面的内容不在 MIT 范围内,仍按各自的许可使用:

  • 内置中日词典:词条来自中文维基词典,经 Kaikki.org 提取,按 CC BY-SA 4.0 授权,见 来源与许可。
  • 英语词典:取自 ECDICT,按 MIT 许可使用,见 ECDICT 许可。
  • Readium Swift Toolkit 与 Readium Kotlin Toolkit:构建时作为依赖获取,不随仓库分发,按其自身的开源许可使用。

About

读鼠 Jerreader:面向中、英、日文阅读与学习的 iOS / Android 电子书阅读器,支持点按翻译与 AI 解析。

Topics

Resources

Stars

116 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages