安卓漫画阅读器，Komikku 的 fork（上游链路：Tachiyomi → Mihon → TachiyomiSY → Komikku → Lumen）。
Lumen is a fork of Komikku with a SyncYomi protocol v2 client, incremental Komga library updates and its own branding. Chinese-first README below.
- 安装包在 Releases：文件名形如
Lumen-arm64-v8a-1.14.1.21.apk，只出 arm64-v8a 一个 ABI - 要求 Android 8.0 及以上；包名
app.lumen.beta，与上游 Komikku 共存互不影响 - 版本号 = 上游版本 + 交付序号，例如
1.14.1.21表示「基于上游 1.14.1 的第 21 次交付」；每次交付序号 +1
- 服务端合并取代客户端合并：缺失不再等于删除。不会再出现「新加的漫画同步不过去，先读一页再同步就正常了」这类丢条目问题
- 增量同步：上传只带自上次成功同步后变化的内容，下载只取 cursor 之后变化的项，不再整库搬运
- 流式上传：逐条写 protobuf 记录再 gzip 分块发送，大书库不再内存溢出
- 分类删除走显式墓碑：删掉的分类 uid 随请求头
X-Sync-Deleted-Categories上报，另一台设备下次同步即删除，不会复活 - 分类新增稳定 uid 与合并版本：改名、改序、隐藏都能跨设备收敛，不再多出重复分类
- 老服务端自动回退 v1：capabilities 返回 404 时完全按改动前行为工作
- 要求：服务端 SyncYomi ≥ 1.3.0；客户端的「设置 → 数据 → 同步」里会显示当前用的是 v2 还是 v1
- 「整库更新」先查 Komga 的
/api/v1/series/latest，用本地水位线判断哪些作品有变化，没变化的条目直接不请求（因此也不会误删章节）；查询失败/超时自动回退全量 - 「更新」页显示本次增量诊断：服务器数 / 查询页数 / 有变化数量 / 跳过数量 / 回退原因
- 设置项：「更新方式（增量 / 全量）」「Komga 不可用时（回退全量 / 跳过）」
- 应用名 Lumen，自有图标（超椭圆底板 + 两层投影）与启动画面；通知不再放大图标（只留左侧小图标），强调色统一为深墨色
#0B1622 - 同步完成通知写清去向：一次同步分两步，标题分别标明「同步到服务器」与「写进本机」，正文一行摘要（上传/下载了多少），下拉展开看分板块明细、增量还是整库、用时，以及这次是谁触发的（手动点同步 / 更新书架前自动 / 定时 / 开机 / 回前台 / 打开章节 / 阅读后）
- Komga 追踪器复用图源账号：追踪器原来不带任何凭证，对需要登录的 Komga 一律 401；现在按地址匹配 Komga 图源，直接用它的 API key / 用户名密码
- 中文界面补全：设置页缺译项、同步提示、上游硬编码文案都补成中文；Lumen 新增文案统一放
i18n-kmk（KMR），中文覆盖放在 app 模块的values-zh-rCN，不碰 Weblate 拥有的上游语言文件 - 本地构建的 APK 自动带软件名、ABI 与版本号，例如
Lumen-arm64-v8a-1.14.1.21.apk
上游 Komikku / TachiyomiSY / Mihon 的功能全部保留并持续跟进，包括：在线源阅读、本地下载阅读、可配置阅读器、追踪（MyAnimeList / AniList / Kitsu / MangaUpdates / Bangumi / Shikimori 等）、书库分类、定时更新、备份与恢复、Feed、合并漫画、自动 Webtoon、E-Hentai/ExHentai 等。详细清单见上游 Komikku README。
上游代码的改动一律用注释标记，便于跟进上游：
| 标记 | 含义 |
|---|---|
// KMK --> … // KMK <-- |
本 fork（Lumen）的改动 |
// SY --> … // SY <-- |
来自 TachiyomiSY 上游 |
| 无标记 | Mihon / Tachiyomi 上游代码 |
./gradlew assemblePreview # 交付版 APK（包名 app.lumen.beta）
./gradlew assembleDebug # 调试版（包名 app.lumen.dev）
./gradlew spotlessCheck # 格式门禁（CI 会跑）
./gradlew testReleaseUnitTest # 单元测试
./gradlew verifySqlDelightMigration # 校验数据库迁移- 需要 JDK 21（版本见
.github/.java-version）；首次构建会下载约 1 GB 依赖 - 开发约定与上游同步规则见 AGENTS.md；技术栈、模块结构等完整参考见 docs/agents-md-full-reference.md
- 交付版的 APK 由维护者在本地构建后附到 Release；本仓库的 GitHub Actions 当前全部停用（
.github/workflows/build-apk.yml保留着，需要自动化时重新启用即可）
请附上：版本号（更多 → 关于 → 版本）、复现步骤、截图。 同步相关问题还请附上「设置 → 数据 → 同步」里显示的协议版本（v1 / v2）与服务端版本——v1 与 v2 的同步语义差别很大（v1 不会同步删除，也不会传增量）。
- Komikku（本 fork 的直接上游）
- TachiyomiSY
- Mihon 与最初的 Tachiyomi
- 以及所有为上述项目贡献过的开发者
本应用的开发者与任何内容提供方均无关联，本应用自身不托管任何内容。
Copyright 2015 Javier Tomás
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.