- ACTIVE
- FILE NO.001
- ANDROID
- GPL-3.0
WENKU8READER W-001 轻小说文库 · ANDROID READER
阅读，悦读/把喜欢的轻小说，装进口袋。
原生 Android 阅读客户端，数据来自 wenku8.net 轻小说文库： 浏览全站栏目、搜索分类找书、一键加入书架，内置沉浸式阅读器与整本离线下载。
- STARS
- 18
- FORKS
- 1
- ISSUES
- 0
- LANG
- KOTLIN
- STATUS
- ACTIVE 持续维护
- VERSION
- v0.8.1（正式版）
- PLATFORM
- Android 8.0+ API 26
- LICENSE
- GNU GPL-3.0
- CHANNEL
- 正式版 · GitHub Releases
- DEV BUILD
- 测试版 · 自动构建 Actions
- SOURCE
- TakaHoshino/Wenku8Reader
- DATA
- wenku8.net 轻小说文库
- MODULES
- 07 功能模块 05 界面
- UPDATED
- 2026.10.18
项目概览OVERVIEW
轻小说文库（Wenku8Reader）是一款原生 Android 阅读器： 浏览 wenku8 全站栏目、搜索与分类找书、一键加入书架，并内置沉浸式在线阅读器 —— 支持侧滑翻页、自动翻页、音量键翻页、简繁转换，还可将整本书离线下载为 TXT / EPUB 随时阅读。
应用采用 Material 3 Expressive 设计语言：卡片化界面、动态取色（跟随系统壁纸生成主题色）、 弹性形变与柔性顶栏、波浪进度与形变加载指示器、装饰形状空态、深色 / 纯黑（OLED 省电）模式， 并适配 120Hz 高刷新率屏幕，滑动与翻页顺滑跟手。
- MIN SDK
- Android 8.0（API 26）
- RECOMMENDED
- Android 12+ 完整动态取色与高刷体验
- COMPILE SDK
- 37 targetSdk 34
- TOOLCHAIN
- JDK 21 · AGP 9.4.1 · Gradle 9.7.1 · Kotlin 2.3.21
本项目以 GNU General Public License v3.0 发布，仅用于个人学习与交流， 请遵守 wenku8.net 站点使用条款并支持正版。
| 页面 | 说明 |
|---|---|
| 探索 | 顶栏 + 圆角搜索条，推荐 / 标签双 Tab（内置 50 个分类），封面卡片流 |
| 书架 | 卡片化书单，进度一目了然，一键续读 |
| 详情 | 封面信息卡、标签药丸、开始 / 继续阅读、离线下载卡、内容简介 |
| 阅读器 | 沉浸式全屏，状态指示器（电量 / 时间 / 章节 / 进度），悬浮章节进度条 |
| 设置 | 分组卡片：账号、外观（主题 / 纯黑 / 取色）、阅读设置、关于 |
界面随版本迭代，截图与说明以仓库为准
功能特性FEATURES
首页栏目（封面轮播 + 文字榜单）、书名 / 作者搜索、分类标签浏览。
- 发现
- 搜索
- 50 分类
收藏管理、多种排序（默认 / 最近更新 / 书名 / 字数 / 倒序），一键继续阅读。
- 收藏
- 排序
- 续读
侧滑 / 滚动双模式翻页、点按翻页、自动翻页（可设间隔）、音量键翻页，章节进度自动记录并续读。
- 侧滑 / 滚动
- 自动翻页
- 音量键
- 进度记忆
整本下载为 TXT（简 / 繁 / UTF-8）或 EPUB，保存至 Downloads/Wenku8/。
- TXT
- EPUB
- 简繁可选
详情 / 目录 / 章节自动落盘缓存，断网也能看已读章节，二次打开不重复联网。
- 离线可读
- 去重请求
Cloudflare 自动绕过（多镜像 + cf_clearance 复用），主站域名可在设置中切换。
- 多镜像
- cf_clearance
- 随机 UA
动态取色 / 手动种子色、深色模式（跟随系统 / 浅色 / 深色）、OLED 纯黑模式，阅读外观可细调。
- 动态取色
- OLED 纯黑
- 字体 / 字号 / 行距 / 边距
技术实现STACK
原生 Kotlin + Jetpack Compose + Material 3 Expressive 构建， 无 WebView 外壳，界面全部由 Compose 绘制。
- Kotlin
- Jetpack Compose
- Material 3
- miuix-kmp
基于 OkHttp + Cronet，配合多镜像兜底与 cf_clearance 会话复用， 在网络受限环境下仍尽量保持可用。
- OkHttp
- Cronet
- 多镜像
图片加载使用 Coil，简繁转换使用 opencc4j，插图章节直接渲染图片。
- Coil
- opencc4j
- 插图渲染
推送后由 GitHub Actions 依据 Conventional Commits 自动升版本、跑单元测试、打包并发布 Release。
- JDK 21
- Gradle 9.7.1
- AGP 9.4.1
- GitHub Actions
版本记录RELEASES
-
2026.10.18
RL-008
STABLE
v0.8.1 搜索修复版
搜索改用 Cronet POST /so.php；直连被 Cloudflare 拦截时，搜索 / 详情 / 目录 / 正文统一改走绕过栈，修复搜索 403。
-
2026.10.17
RL-007
RELEASE
v0.8.0 账户与站方书架
账户登录实验开关与账户二级页；Wenku8 书架接入书架页，与本地书架同等地位；启动检查更新、网络日志导出、收藏按钮整合。
-
2026.09.26
RL-006
DEV
v0.8.0-dev.111 测试版
自动构建发布，APK 16.8 MB · 已下载 11 次。可在「设置 → 更新 → 更新通道」切换测试版。
-
2026.09.26
RL-005
TEST
v0.8.0-dev.110 测试版
自动构建发布，含 SHA256SUMS 校验文件。
-
2026.09.25
RL-004
TEST
v0.8.0-dev.109 测试版
自动构建发布，已下载 8 次。
-
2026.09.25
RL-003
STABLE
v0.7.0 正式版
首个正式版：液态玻璃底栏（移植自 SukiSU）、段落懒加载、长按选字、插图预览与保存，详情页收藏改为五角星。
-
2026.08.29
RL-002
DONE
仓库建立
Wenku8Reader 在 GitHub 上开源，采用 GPL-3.0 许可。
-
2026.08
RL-001
DONE
项目立项
确定技术路线：Kotlin + Jetpack Compose 原生实现，不套 WebView。
下载与构建DOWNLOAD
> 正式版通过 GitHub Releases 发布，「下载最新版」始终指向最新正式版。
> 测试版由 GitHub Actions 自动构建，可在应用内切换更新通道。
# 本地构建 Debug 包 ./gradlew :app:assembleDebug # 产物：app/build/outputs/apk/debug/app-debug.apk # 跑单元测试（纯 JVM，无需模拟器） ./gradlew :app:testDebugUnitTest
- RELEASES v0.8.1
- SOURCE TakaHoshino/Wenku8Reader
- QQ 群 1106956143
- 支持作者 爱发电 · 买杯咖啡
- 许可 GNU GPL-3.0
- 鸣谢 LightNovelReader
本应用仅用于个人学习与交流，数据来自 wenku8.net，请遵守站点使用条款并支持正版。 网络层与 Cloudflare 绕过方案参考并致谢 LightNovelReader； 部分界面实现改编自其他开源项目，逐项来源见仓库 NOTICE。