企业官网建设流程全解析

Kotatsu-Redo 是一款免费开源的 Android 漫画阅读应用，内置 1200+ 在线漫画源。除了阅读，它还内置了强大的“打卡”（Scrobbling）系统：读完一章后自动向 Shikimori、AniList、MyAnimeList、Kitsu 四大追踪平台同步阅读进度、状态与评分，无需手动填写。本教程面向新手，带你从零完成登录、关联与自动打卡的全流程设置。

支持的打卡平台一览

Kotatsu-Redo 内置 4 个追踪服务，代码中统一由 ScrobblerService.kt 枚举定义，并通过 ScrobblingModule.kt 以依赖注入方式注册：

💡 建议：同一作品可同时在多个平台打卡，应用会并行向所有已登录的服务同步。

自动打卡是如何触发的

理解机制后，你就不需要担心“忘记打卡”这件事。

在 HistoryRepository.kt 中，每次打开新一话阅读时，应用会先写入本地阅读历史，紧接着遍历所有已授权的打卡服务并调用tryScrobble上报章节。核心逻辑位于 Scrobbler.kt 的scrobble方法：

• 优先取章节自带的编号（如“第 67 话”）；
• 若章节没有编号，则按当前分支内章节顺序自动推算；
• 仅对已关联（linked）该作品的条目进行上报，未关联则跳过。

也就是说：你只管看漫画，章节号会自动同步上去。

第一步：登录追踪平台账号

1. 进入对应平台的打卡设置页，界面由 ScrobblerConfigActivity.kt 实现；
2. 按提示跳转到平台的授权页面，登录后平台会回调应用并携带授权码；
3. 应用通过 ScrobblerAuthHelper.kt 完成 token 交换，随后拉取你的用户名与头像，登录即生效。

⚠️ 注意：只有完成登录的平台才会出现在打卡选项中，未登录平台无法使用。

第二步：在漫画详情页关联作品（Menu → Track）

登录完成后，还需要把“本应用里的漫画”和“平台上的作品”对应起来，这是打卡生效的关键一步：

1. 打开任意漫画的详情页；
2. 点击右上角菜单，选择Track（条目定义见 opt_details.xml）；
3. 弹出底部面板后，顶部会出现已登录平台的标签页，每个标签对应一个服务；
4. 面板内默认展示你的追踪列表，也可以直接点搜索图标按标题搜索（至少 3 个字符才会提交，见 ScrobblingSelectorSheet.kt）；
5. 点击目标作品并点“完成”，即完成关联。该操作会建立本地 mangaId 与平台作品 ID 的映射（见 Scrobbler.kt 的linkManga），此后阅读即自动上报。

打卡状态与评分：6 种状态一次看懂

关联完成后，详情页会出现打卡信息卡片，可切换状态和打星。6 种状态在 ScrobblingStatus.kt 中定义：

切换状态、评分的操作面板实现在 ScrobblingInfoSheet.kt，下拉选状态、拖动星星即可，改动会立即推送到对应平台。

管理所有已打卡作品

想集中查看某平台下正在打卡的所有作品？进入该平台的打卡设置页即可：列表由 ScrobblingConfigViewModel.kt 驱动，点击任意条目可跳回漫画详情；点击头像可查看账号信息，也可在此处退出登录。

常见问题（FAQ）

Q：读完章节后平台没有更新？先确认该作品是否已“关联”（Menu → Track 已完成），未关联的作品不会上报。

Q：支持一次登录多个平台吗？支持。四个服务相互独立，可同时启用，tryScrobble会并行处理所有已登录服务。

Q：离线阅读会打卡吗？本地（CBZ）漫画同样会写入阅读历史并触发打卡，只要关联了平台作品即可。

Q：如何停止打卡某部作品？在打卡信息卡片菜单中选择移除（unregisterScrobbling，见 Scrobbler.kt），平台侧的记录保留，只是不再自动更新。

掌握以上步骤后，Kotatsu-Redo 就能把你 Shikimori、AniList、MyAnimeList 的漫画进度变成“全自动打卡”，看完结一本漫画的所有记录都会井然有序。更多功能（分类、更新通知、备份同步）可参考 README.md 与源码目录 app/src/main/kotlin/org/koitharu/kotatsu/scrobbling/ 继续探索。