MewX/light-novel-library_Wenku8_Android

项目介绍

这是一个面向 Wenku8.com（轻小说文库）的第三方安卓客户端，2014 年起步，用 Java 和 Material Design 编写。它把网站的最近更新、搜索、排行榜、小说详情和章节选择做成原生界面，用户可以收藏小说、下载章节到本地离线阅读，并在左右翻页和上下滑动两套阅读引擎之间切换，阅读设置涵盖字体、字号、行距、段距、背景和夜间模式。

代码按 API/解析层（Wenku8API、Wenku8Parser 以及小说、章节、卷等模型类）与界面层分离，阅读器部分以 loader/setting/slider 的结构放在 reader/ 下，分页逻辑不直接绑定站点数据。小说以 XML 文件保存在 sdcard/wenku8/saves，这套存档格式同时也是接入其他文库内容的兼容接口。

最近一次改动把站点请求改为经过作者自建的 Cloudflare Worker 中继，因为原站 API 被大量滥用，不再直接调用。

快速使用

只想阅读的话，可以直接安装商店版本：Google Play 页面 或查看项目主页获取当前分发方式，遇到问题可到 Telegram 群 询问。

想改代码或自行编译，主线源码在 studio-android/，是 Android Studio 工程；eclipse-android-old/ 存的是 0.5.2.1 典藏版，而 eclipse-android/ 是删掉了 API 部分的 0.5.1 版本，编译后也无法正常取数据。第三方库全部用 Gradle 依赖声明，不再复制源码。大致流程：

1. git clone https://github.com/MewX/light-novel-library_Wenku8_Android
2. 用 Android Studio 打开 studio-android/，等待 Gradle 同步完成。
3. 在真机或模拟器上构建运行。App 使用源码里配置的 Cloudflare Worker 中继地址，README 没有给出独立部署中继的步骤；如果要自建中继，需要自行修改接口地址。
4. 需要自定义字体、侧栏壁纸或阅读背景时，把文件放进 sdcard/wenku8/custom，阅读设置和菜单设置会读取该目录。

如果想让 App 继续使用其他文库的内容，README 给出了存档格式：aid-intro.xml、aid-introfull.xml、aid-volume.xml，以及用 <!--image-->URL<!--image--> 标记插图的章节正文文件；还建议给不同站点的 aid 加偏移量（例如 linovel 加 1000 万、lknovel 加 2000 万），避免本地书架冲突。可行路径是抓取网页后转成这套格式，因为原 API 已经不适合作为数据源。完整格式说明见存档格式章节。

使用约束

• App 依赖第三方站点的数据。现在请求经作者自建的 Cloudflare Worker 中继转发，中继是否可用直接决定 App 能否取到内容。
• 维护状态是随时可能停更：README 明确写了开发者准备暂停维护，原因包括轻小说版权环境变化和失去数据源。
• 项目采用 GPL-2.0 许可，二次分发和衍生 App 需要遵守该协议。
• 存档集中在 sdcard/wenku8；自定义字体和背景只能放在 wenku8/custom，README 说明不支持外置 SD 卡里的自定义文件。
• 阅读进度、书架和登录凭据都保存在本地 saves 文件里，cert.wk8 只是简单加密，设备存储本身需要按敏感数据对待。
• 1.x 面向 Material Design 时代的 Android，0.5.2.1 典藏版则是为旧机型保留的；两者都不是面向现代 Android 的通用阅读器。

HotRepo 点评

HotRepo 上该项目唯一一条日榜记录是 2026-11-01 的 Java 语言榜：3,261 Star、372 Fork、当天新增 20 Star，在该语言榜上最好名次为第 12。一个 2014 年起步的 GPL 阅读器还能出现在语言榜上，说明它仍有被发现的渠道；但这只是一天的数据，也没有全语言日榜名次记录，不足以推断长期增长趋势。更值得看的是它的技术取舍：把解析/模型层与阅读器分开，并用带跨文库兼容规则的 XML 存档承载阅读进度和书籍数据。对于想在不稳定数据源上做离线阅读器的人来说，这部分结构比 App 本身更值得参考，也解释了为什么项目在停止常规更新后仍有价值。