面向 Android 的 ESJ Zone 第三方小说阅读客户端
EsjzoneViewer 是 ESJ Zone 的第三方 Android 应用，并非 ESJ Zone 官方客户端。
本项目基于 DeeChael/Esjzone 继续开发，在原有基础上改进阅读体验、本地书架、下载与社区功能，感谢原作者的贡献。
- 原始项目：DeeChael/Esjzone
- 原作者：DeeChael
- 当前维护者：breakyuna
- 开源许可证：GNU General Public License v3.0
小说、封面、章节、评论等内容主要来自当前选择的 ESJ Zone 站点；目录中的部分文库8章节链接会访问文库8并获取正文。应用提供适合 Android 设备的浏览与阅读界面，不代表原站发布内容或作出承诺。
- 登录时，应用会尝试向
www.esjzone.cc和www.esjzone.one分别发送账号与密码，以建立各站点的会话；登录会话保存在本机。切换站点时，如果该站点会话不可用，使用会员功能可能需要用同一账号补登。 - 设置、搜索历史、书架、阅读历史、书签、阅读划线和阅读统计保存在本地；本地阅读历史不上传，云端历史单独展示。正文必须带登录 Cookie 才能读取，所以已登录时网站观看记录总会停在最后请求的一章，没有开关；阅读已下载或仅来自缓存的章节时，也会补请求该章节页面。后台下载或批量解锁结束后，若下载前网站已有这本书的记录则恢复原记录，没有记录则重新请求第一章，让记录停在第一章。
- 云端收藏仅用于补充本地书架，不会因云端缺失而删除本地书籍；主动从书架移除书籍时，应用会尝试取消对应的云端收藏。
- 应用会缓存内容，并保存用户下载的小说章节；请妥善保护设备与应用数据。
- 检查与下载更新会访问 GitHub 及其附件下载服务，不携带 ESJ Zone 登录会话。下载和自动备份支持选择公共存储目录并迁移，下载内容可重新扫描；未选择时使用私有目录，卸载或清除应用数据前请按需导出。
- 自动备份默认关闭；手动和自动备份默认不包含下载内容，可按需开启。备份支持书架分组，但不包含书架作品列表、登录会话和应用设置。
- 小说、插画、封面及其他站点内容的相关权利归各自权利人所有，本项目不声称拥有这些内容。
- 使用、下载或导出内容时，请遵守原站规则及适用要求，尊重作者与译者的权益。
- 成人内容显示可在设置中调整，请根据年龄与所在地要求使用相关功能。
- 站点结构、登录状态或网络环境变化可能影响在线功能，应用不保证所有页面始终可用。
若 ESJ Zone（www.esjzone.cc / www.esjzone.one）运营方或相关权利人认为本应用存在不当行为，可通过 GitHub Issues 联系维护者，说明相关页面与具体问题，以便核实处理。
下载渠道：GitHub Releases
- 使用 Android 10（API 29）或更高版本的设备，下载 Release 中的 APK 并安装。
- 在登录页或设置页选择可用站点：
www.esjzone.cc或www.esjzone.one。 - 使用 ESJ Zone 账户登录后，浏览小说、管理书架或继续阅读。
💡 下载完成的章节可以直接在应用内阅读，无需先导出 TXT 或 EPUB；未下载的内容、远程插图和在线社区功能仍可能需要网络。
- 🔍 浏览与搜索：热门推荐、最新更新、随机推荐、关键词搜索、筛选与搜索历史。
- 📚 本地优先书架：云端收藏补充、宫格与列表、本地分组、排序、按书名、作者或本机已缓存的标签本地搜索（简繁不敏感）及批量管理。
- 📖 阅读体验：上下滚动与横向分页，提供平移、淡入淡出和覆盖翻页，支持按分卷折叠、可切换正序/倒序的目录、全书进度定位、点击和音量键翻页。
- 🎨 阅读自定义：调整字体、排版、简繁转换、亮度及快捷工具栏，支持保持亮屏；图片背景可调整模糊度、透明度、文字颜色和辉光。
- 🕘 历史与标记：恢复阅读位置，管理本地书签与正文划线，本地和云端历史分开展示。
- 📊 阅读统计：阅读时长、趋势、书籍排行与标签分布，支持暂停统计的无痕模式。
- 📥 下载与导出：后台下载、补下载及离线阅读，按已下载章节导出 TXT 或 EPUB。
- 💾 备份与恢复：按类别导入、导出本地数据，支持可选的自动备份与下载内容备份。
- 💬 社区互动：论坛、留言板、灌水楼、评论与回复。
- 👤 会员中心：只读查看注册日期、升级进度、系统消息、我的回复和经验记录；回复所在章节不会以登录状态打开，以免改写网站观看记录。
- 🌐 站点与站外链接：切换两个 ESJ Zone 站点，支持 ESJ 目录中的部分文库8章节阅读与下载；遇到站点验证时可能需要在应用内完成验证，其他站外链接通过浏览器打开。
- ⚙️ 设置与维护：浅色和深色主题、多种主题配色、导航顺序与启动页设置、中英文界面、存储管理及应用更新；动态取色需要 Android 12 或更高版本。
- Kotlin：应用开发语言
- Jetpack Compose / Material 3：界面与交互
- AndroidX Navigation 3：类型化页面与 Tab 导航
- Room：本地书架、历史、书签和阅读统计存储
- DataStore：应用与阅读设置持久化
- WorkManager：后台下载、字体下载与自动备份
- OkHttp：网络请求与会话处理
- Jsoup：HTML 与 CSS 选择器解析
- Coil：封面、头像和插图加载
- Gson：JSON 数据处理
ESJ Zone 的网络请求、登录认证、页面结构与 HTML 解析相关说明整理在 NETWORK/ 目录中。
这些文档最初由 GPT Work 使用云浏览器分析页面 DOM、表单、内联脚本及可观察的请求行为，后续结合维护者抓包确认和客户端实现持续维护，也包含解析约束与本地存储说明。它们并非 ESJ Zone 官方 API 文档；推断或尚未验证的内容已标注，使用时请注意其验证状态。
欢迎通过 Issues 报告问题或提出建议，也欢迎提交 Pull Request。
为了方便定位问题，请尽量提供：
- 应用版本、设备型号和 Android 版本
- 复现步骤、预期表现与实际表现
- 相关页面地址、截图或错误日志
🔒 提交截图和日志前，请删除密码、Cookie、会话凭据及其他不希望公开的个人信息。涉及账户或凭据的安全问题请遵循 安全说明，不要公开提交敏感细节。
开发前请阅读 项目协作指南，按其中的权限与验证要求操作。相关使用说明：
感谢原作者 DeeChael 提供项目基础，感谢所有参与开发、测试和反馈的贡献者。
同时感谢 Jetpack Compose、Material 3、Room、AndroidX Navigation 3、OkHttp、Coil、Gson 和 Jsoup 等开源项目。
本项目采用 GNU General Public License v3.0，完整文本见 LICENSE。保留原项目的版权与许可证信息，第三方依赖遵循各自的许可证。
应用内可从设置页版本号下方的“开源许可”进入次级页面，离线查看本项目、第三方依赖和阅读字体的来源与完整许可文本。项目依赖许可位于 app/src/main/assets/open_source_licenses/，字体许可保留在 app/src/main/assets/font_licenses/；新增依赖时同步补充对应归属与许可。