legado-ios：阅读书源与本地阅读器

16次阅读

获取下载链

微信关注「软件教程管家」公众号，回复 legado-ios

30秒速读

在 iPhone 上看书最麻烦的不是找书，而是书源分散、排版各异、本地书和在线书各用一个应用。小浣熊阅读就是为这个场景准备的工具：它以 iOS 原生阅读体验为核心，把阅读书源、多源搜书、书架管理与本地 TXT、EPUB 阅读做到同一个应用里。本篇讲清它的书源怎么导、排版怎么调，以及它明确不提供的东西。

软件信息表

先把关键事实摆在前面，版本与安装包信息以 GitHub 仓库当前页面为准，本文不写未经核实的数字。

项目	小浣熊阅读
定位	面向 iOS 的阅读书源与本地阅读器
平台	iOS 或 iPadOS 15.0 及以上
技术路线	Swift 与 SwiftUI 原生应用
书源导入	JSON、文件、URL、二维码、legado 链接
本地阅读	TXT，无 DRM 的 EPUB 2 与 EPUB 3
朗读	系统朗读，HTTP TTS
许可证	GPL-3.0
获取方式	GitHub 开源仓库，自行签名或自行构建安装

它能帮你做什么

小浣熊阅读的功能边界很清晰：它不管内容从哪里来，只负责把你有权使用的书源和本地书，以统一的原生阅读体验呈现出来。

支持通过 JSON、文件、URL、二维码和 legado 链接导入阅读书源，并提供书源分组、编辑和调试能力。
支持多书源并发搜索、有效书源优先、结果缓存及同书多源合并，搜书等待体验直接针对多源场景优化。
书架提供列表、网格、分组、章节更新、换源和本机阅读进度管理，书多的时候仍能按分组快速定位。
阅读器支持字号、间距、边距、日夜主题、滚动或分页、目录、书签和朗读设置，排版调整不需要换应用。
支持本地 TXT 与无 DRM 的 EPUB 2 和 EPUB 3 导入，并识别书名、作者、封面、目录、章节锚点及插图。
提供 RSS 订阅、内容净化、阅读记录、时长统计和缓存管理等辅助功能，适合把阅读来源集中到一处管理。

一个真实使用场景推演

假设你通勤时想在 iPhone 上接着看一本本地 EPUB，回家后又想搜一本在线书先看几章再决定是否加入书架。先把本地书导入书架离线读，排版按自己的字号与间距调好；需要搜书时从已导入的书源并发搜索，优先看有效书源的结果，合意的书再加入书架统一管理。这个推演的关键判断是：本地书与在线书共用同一套书架与排版，而不是两个应用各记各的进度。实际搜书效果仍取决于网络与来源网站的响应，搜不到时先换书源再判断是不是应用问题。

上手指南

按下面顺序走，卡点主要集中在签名安装与书源准备两处，书源没准备好之前不要先评判搜书效果。

确认设备满足 iOS 或 iPadOS 15.0 及以上，并准备好自行签名或自行构建的环境。
通过 IPA 自行签名安装，或在 macOS 与 Xcode 环境中自行构建安装，支持 TrollStore 的设备可依据项目说明尝试安装。
先准备有权使用的书源，再通过 JSON、文件、URL、二维码或 legado 链接导入，不要指望应用内提供现成书源。
导入后先做书源分组与调试，确认常用书源能正常返回结果，再开始日常搜书。
把一本本地 TXT 或无 DRM 的 EPUB 导入书架，调好字号、间距、边距与日夜主题，确认排版符合自己的阅读习惯。
需要朗读时再配置系统朗读或 HTTP TTS，并确认语速与来源符合预期，不要在首次阅读时同时调试书源与朗读。

装完先改这几处设置

下面每一项都直接影响日常阅读体验，装完先调好再开始正式追书。

排版组合：字号、行距、边距与日夜主题一次调到位。体感差别是长文阅读时眼睛负担明显不同，调好一次就不用每本书重复折腾。
搜书策略：确认有效书源优先与结果缓存处于开启状态。体感差别是搜书时先出能用的结果，而不是等所有书源慢慢返回。
书源分组：按题材或用途把书源分组，并给常用分组起一眼能认出的名字。体感差别是书源一多也不会在列表里翻半天。
阅读进度与书签习惯：确认书架的阅读进度、目录与书签入口位置。体感差别是换设备或换书时能立刻回到上次读到的位置。
朗读与缓存管理：按需设置朗读来源与语速，并定期清理缓存。体感差别是朗读不断线、存储不会被旧缓存悄悄占满。

常见问题与注意事项

下面几条都是项目说明里明确写出的限制，接受它们再决定要不要长期用。

项目不提供、内置或分发网络书源，用户需要自行准备有权使用的书源或自行编写规则，搜不到书时先检查书源本身。
复杂 JavaScript、登录、验证码和 WebView 规则可能存在平台差异，并非所有阅读书源都能直接使用，换源之前先看规则类型。
来源网站改版或停止服务后，书源规则可能失效，需要更新规则或更换来源，这是书源类工具的常态成本。
EPUB 阅读暂不还原原书 CSS、固定版式和交互内容，主要采用阅读器重新排版，对版式有硬性要求的书不适合走这条路。
IPA 安装依赖自行签名或特定设备环境，免费 Apple 账号签名的描述文件通常有效期较短，需要周期性重新安装。
提交问题时提供应用版本、系统版本、设备和复现步骤，并删除日志或规则中的账号、Cookie 与 Token，不要把隐私信息贴进公开反馈。

适合谁，不适合谁

适合的人是需要在 iPhone 或 iPad 上使用阅读书源、管理个人书架并阅读本地 TXT 或 EPUB 的用户，也包括希望基于 SwiftUI 研究书源兼容与原生阅读界面的开发者，前提是能接受自行签名安装、自行维护书源并遵守内容授权规则。不适合的人包括：要求在官方商店一键安装、不想折腾签名的人；指望应用内置现成书源与内容资源的人；需要固定版式还原或跨平台同步的人；以及书源涉及复杂登录、验证码且不愿自己维护规则的人。

横向对比与选型建议

结论先行：目标平台明确为 iOS 或 iPadOS、需求包含书源导入、书架管理与本地阅读，就优先考虑小浣熊阅读；部署必须依赖官方商店分发、跨平台运行或稳定的第三方内容服务，就继续比较其他方案。和系统自带阅读应用相比，它的差异在于书源与多源搜书：自带应用排版稳定但不管书源生态，而它把书源导入、分组、调试与多源合并做成了主流程。和 Android 平台的同类阅读应用相比，它的差异在于 iOS 原生 SwiftUI 体验与签名安装成本：体验更贴合 iOS，但安装门槛也更高。评估时重点验证实际使用的书源是否涉及复杂 JavaScript、登录、验证码或 WebView 规则，同时检查 EPUB 是否需要保留原始 CSS、固定版式和交互内容，这两项是决定它能不能长期用的分水岭。