Repository navigation
Releases: point258/kazuhomo
Release list
kazuhomo 2.4.2.4
kazuhomo 2.4.2.3
kazuhomo 2.4.2.3
这一版把「登录后到底同步了什么」补齐了：追番收藏可离线看，观看进度会自动写回 Bangumi。
新增
- 观看进度自动同步
播放页在一集看到 90%（或播放结束事件）时，把它标成 Bangumi 上的「看过」：
PUT /v0/users/-/collections/-/episodes/{episode_id}{"type":2}。- 只对已收藏的条目生效，不会凭空往你账号里加条目；
- 只增不减，同一次播放只上报一次；
- 失败的进本地队列（
SyncQueue），下次启动 / 登录 / 进追番页时按顺序补传，断网也不丢。
- 追番列表落地缓存
上次拉到的收藏（含ep_status）写进本地，重启或没网时直接显示，
顶部一行状态：已同步 · 11:04/离线数据 · 上次同步 11:04 · 点此重试。 - 合并而不是覆盖
刷新按条目 id 合并，ep_status取「云端 / 本地缓存 / 待传队列」三者最大值；
某类收藏没拉全（返回条数 = 单页上限）时不删旧条目，避免半页数据把列表清空。 - 启动时（已登录）自动拉一次收藏 + 补传队列。
踩到的坑（写出来省得后来人再试）
ep_status 在 Bangumi v0 里只能用在书籍上，对动画会直接 400：
{"description":"can't set 'vol_status' or 'ep_status' on non-book subject"}
动画的"看到第几话"必须走章节级接口，而且 ArkTS 的 http 模块没有 PATCH，
所以用的是单集 PUT（/v0/users/-/collections/-/episodes/{id}），集号→章节 id 通过
/v0/episodes?subject_id= 取并缓存 10 分钟。
实测（Mate 80 模拟器 + 真实账号）
| 环节 | 结果 |
|---|---|
| 登录（走代理直连官方） | 已连接 point258 |
| 追番「在看」写云端 | 云端出现该条目 |
| 播放第 3 集 → 回写 | 日志 进度已同步 554779 → 第 3 集（已标为看过），云端 ep_status=3 |
| 断网（代理指向无效端口） | 列表仍在，顶部显示「离线数据 · 上次同步 11:04 · 点此重试」 |
| 恢复网络 | 启动即刷新为「已同步」 |
资产
| 文件 | 最低 API |
|---|---|
kazuhomo2.4.2.3.hap |
26.0.0 |
kazuhomo2.4.2.3-23+.hap |
23（HarmonyOS 6.1，MatePad Pro 12 / 麒麟 T93 用这个） |
未签名包，真机需用 DevEco 自动签名或自己的发布证书重签。
账号类功能仍要求能直连api.bgm.tv（只读镜像不转发令牌），登录/同步时记得开代理。
kazuhomo 2.4.2.2
kazuhomo 2.4.2.2
修一个所有人都中招的登录 bug：不管令牌对不对，登录一律报 401 / 「令牌无效或已过期」。
根因
登录校验走的是 Mirror.v0Base()，而它的默认值就是只读镜像 https://bgmapi.anibt.net。
这个镜像不转发 Authorization——拿一个乱写的令牌去请求，返回的也是同一句：
GET https://bgmapi.anibt.net/v0/me
401 {"title":"Unauthorized","description":"need Login"}
于是不管用户填什么令牌，服务端都回 401，客户端就翻译成「令牌无效或已过期」。
同一个坑还影响追番列表和改收藏状态（/v0/users/{u}/collections、/v0/collections/{id}）。
顺带说明：Mirror.directOnly() 里本来有「/v0/me 只走官方」的规则，但它只在 URL 还是
https://api.bgm.tv/... 时才生效；me() 先手工拼了自定义 base，规则就被绕过去了。
改法
- 新增
Mirror.authBase()：带令牌的请求统一由它分发 ——
已知的公共只读镜像（api.bgm.tv官方 /bgmapi.anibt.net/api.kazumi.fyi）一律回官方，
只有用户自己填的反代才用它。 EpRequest增加auth标记：认证请求跳过线路改写，不会再被镜像顶掉（也就不存在"重试到镜像"）。- 登录失败按原因给话：
401→ 令牌无效或已过期- 连不上 → 「连不上 api.bgm.tv：登录只能直连 Bangumi 官方…可以在设置 → 网络 → HTTP 代理里填代理」
- 收藏接口失败也区分「网络到不了」和「HTTP 错误」。
一个必须说清楚的前提
登录必须能直连 api.bgm.tv。只读镜像只能看番，转发不了令牌；
如果你的网络直连不了官方，请到「设置 → 网络 → HTTP 代理」填一个代理再登录。
（这也是为什么大家在镜像下看番正常、一登录就失败。）
资产
| 文件 | 最低 API |
|---|---|
kazuhomo2.4.2.2.hap |
26.0.0 |
kazuhomo2.4.2.2-23+.hap |
23（HarmonyOS 6.1，MatePad Pro 12 / 麒麟 T93 用这个） |
未签名包。真机安装请用 DevEco Studio 自动签名或自己的发布证书重签。
kazuhomo 2.4.2.1
kazuhomo 2.4.2.1
补丁版，增加了2in1设备的支持
kazuhomo 2.4.2
kazuhomo 2.4.2 · 首个公开版本
Kazumi 的鸿蒙原生客户端 —— ArkTS + ArkUI（Stage 模型）写的，不是 Flutter 套壳。
界面走 HarmonyOS Design：渐变沉浸光感标题栏、悬浮玻璃页签条、三档系统材质。
本版改动
- 修复推荐页标题栏「渐变沉浸光感」丢失：列表重新从标题栏下穿过，滚动态改为「顶栏底色渐隐 + 轻微失焦」遮罩（不再是硬邦邦的实色块）
- 关于页：项目主页指向本仓库；Telegram 群组改为 QQ 群 1126494767；新增「上游鸿蒙分支」入口
- 应用名统一为
kazuhomo
能干什么
- 找番：推荐（本季 / 近半年 / 历史总榜 / 评分榜 + 15 题材）、时间表、搜索、追番
- 看番：详情 → 选源 → 剧集 → 播放（AVPlayer），双击快进、长按倍速、横滑找进度、左亮度右音量、全屏锁屏、系统超分，播不了可切网页播放
- 弹幕：弹弹play，滚动/顶/底三种模式 + 轨道避让
- 下载：直链直存，m3u8 自动分片 + 解密 + 拼接，离线可看
- 规则：内置 6 条采集规则，支持导入 / 仓库拉取 / 编辑器真实链路测试
- 网络：接口地址、图片代理、请求规则全部可改，带线路测速；国内默认走可用镜像，也可以填自己的 Bangumi API
资产
| 文件 | 适用 |
|---|---|
kazuhomo2.4.2.hap |
HarmonyOS 6.0 / API 26+（推荐） |
kazuhomo2.4.2-23+.hap |
HarmonyOS 6.1.0(23)+ 兼容包 |
两个包都未签名，安装时系统会提示风险；真机长期使用请用 DevEco Studio 自动签名重签。
包名app.kazumi.harmony，可覆盖升级。
已知问题
- 条目短评 / 剧集评论暂不可用（需要能代理
/p1/**且不校验签名的中转，拿到后改「请求规则」即可） - 下载的「直链暂停续传」「AES-128 加密源」尚未用真实站点做完整回归
- Anime4K / DLNA / SyncPlay / PiP / 图片搜索未实现（详见 README 对比表）
完整功能与实现说明见 README。
注：本版资产已用当前源码重新打包一次，唯一差异是
deviceTypes增加了2in1（让带「电脑桌面」的平板能装）；功能与最初发布完全一致。新装机请优先用 2.4.2.1。