基于 Kazumi 改造的追番客户端：本地媒体库、磁力下载与弹幕增强

之前看番一直是用 弹弹play 的 RSS 订阅把番剧下载到本地再看，但这条路问题不少：一些冷门番和老番基本都是死链，根本下不动，想看的时候没法马上就能看到。所以最近改成了线上看番，用了一段时间 Kazumi——不确定会追的番和厕纸就线上看，其他番继续通过 RSS 下到本地看。

弹弹play 有一个对使用体验影响非常大的问题，如图所示：

加载弹幕的时间可能会非常长，并且经常直接卡死——标题栏都已经变成「未响应」了，软件里其他界面也感觉卡卡的。加上现在有了线上看番的需求，于是就有了把这两个软件的功能整合到一起的想法。

Kazumi 是一个开源的、基于自定义规则的番剧采集与在线观看程序，本身就接入了弹弹play 的弹幕库，所以我要做的其实只有两件事：补上磁力下载，以及补上本地媒体库搜刮。顺手也把之前给自己做的追番统计整合了进来。目前完成的效果如下：

所有功能都是靠 vibe coding 完成的，目前核心功能已经可用，v1.0.5 已发布。这个分支基于上游 Kazumi 2.2.6 开发，上游功能已同步到 2.4.2，只针对 Android 10 及以上和 Windows 10 及以上构建适配，规则与片源仍以官方仓库为准。

项目地址：https://github.com/yoshinosk/Kazumi-Enhanced

本地媒体库

• 目录扫描与分组：递归扫描本地视频目录（后台 isolate），按文件名标题特征把混存目录自动拆分为多部番剧；支持多个根目录、Windows 目录实时监听、回到前台或文件变化自动重扫；逐层遍历容错，按真实路径去重，避免 junction 环导致无限遍历。
• 识别与搜刮：基于 Bangumi 的元数据搜刮与自动匹配，支持文件夹级 / 单文件级识别结果与手动「修改识别结果」；搜刮失败时可选用 ffmpeg 抽帧走 trace.moe 以图搜番兜底，ffmpeg 路径可配置。
• 浏览与排序：文件夹 / 番剧 / 网格海报墙三种视图；按首播日期、最近播放、最近更新、番剧季度、标题、文件数排序，分组型排序带吸顶分组标题；支持搜索、全库空间统计、未匹配卡片首帧缩略图、特别篇 / 剧场版徽章。
• 播放与续播：应用内播放并联动弹幕、播放历史与追番进度；封面带续播角标与「上次看到哪里」，分集显示已看完 / 看到 xx:xx，播完自动推进下一集；外挂字幕自动加载、多季目录排序。
• 缺集与管理：缺集检测一键跳转磁力补集；番剧右键菜单支持续播 / 详情 / 缺集检测 / 修改识别 / 删除，删除前列出文件夹、视频数与体量，二次确认后递归清理文件、搜刮结果与缩略图缓存。
• 与在线功能联动：详情页直接展示本地可播资源，播放页集数显示本地文件角标，搜索结果命中本地库时提示，追番封面显示「本地 N」「缓存 N」；本地看完可联动 Bangumi 收藏的 EP 进度，全集看完自动标记「看过」。
• 历史修复：旧版本遗留的占位番剧历史会自动迁移到真实番剧条目。

磁力搜索与下载

• 搜索：内置 Mikan 与 AnimesGarden 两个搜索源，支持字幕组筛选与搜索历史（最多 20 条，可单条删除或一键清空），结果支持长按 / 右键快捷下载、复制磁力链与查看详情。
• RSS 订阅：支持 Mikan RSS 与 AnimesGarden 关键词订阅，检查间隔 30 分钟 ~ 1 天，打开应用或添加订阅时立即检查；订阅列表显示封面，支持自动下载开关与去重。
• 添加任务：支持磁力链接、种子直链、本地 .torrent 种子文件与剪贴板自动识别；可选择种子内的部分文件下载，每个任务可单独指定下载目录，按 info-hash 归一化去重。
• 下载引擎：基于 libtorrent 的内置引擎，支持并发数与队列调度、全局 / 时段限速、仅 WiFi 下载、磁盘空间检查、失败重试与手动校验；监听端口、最大连接数、上传 / 下载限速、做种停止策略、DHT、UPnP、强制加密、IPv6 与 tracker 自动更新均可配置。
• 做种与恢复：做种可按时长或分享率自动停止（时长最低 1 小时）；种子元数据持久化缓存，重启后不必等待 DHT 即可续传续做种；对「刚创建就 100%」这类假完成 / 假做种做二次校验。
• 边下边播与自动入库：未完成任务可通过内置 HTTP 流边下边播；下载完成后可自动搜刮，达到置信度阈值时可自动移入媒体库，未达标则标记「待确认」供手动匹配或重新搜刮。
• 任务管理与系统集成：按添加时间倒序或按番剧分组并做缺集检测，支持任务搜索、清除已完成、单选 / 多选 / 整组删除（可同时删文件）、集数范围标签与全部暂停 / 继续；下载完成或失败有系统通知，Android 侧有前台服务保活与网络切换即时暂停 / 恢复。

局域网同步

• 自动发现与配对：Windows 桌面端开启共享后，Android 手机端在同一 Wi-Fi 下自动发现；首次输入 6 位配对码，之后打开应用即自动连接，也支持手动填写 IP:PORT 兜底。
• 媒体库、收藏与进度同步：桌面端的媒体库目录、文件元数据与搜刮结果同步到手机，并与手机本地媒体库合并展示；本地播放历史按集双向合并，收藏状态按最后修改时间合并（含删除同步），在线观看历史同样会同步到另一端的「在线」列表，两端可以接着看。
• 桌面媒体库串流：手机可直接播放桌面端视频，支持 HTTP Range 拖动进度、续播、弹幕与详情页本地剧集入口；桌面端离线时保留上次同步的快照供浏览。
• 安全边界：配对码 + 访问 token、按 IP 限流、媒体库根目录校验与目录穿越防护；仅在可信局域网使用，明文 HTTP 不暴露到公网。

播放器增强

• 字幕样式：字号、加粗、颜色、描边、背景不透明度均可自定义，带实时预览，播放中调整立即生效。
• 轨道与画面：音轨 / 字幕轨道选择、字幕延迟、A-B 循环、播完动作（自动连播 / 单集循环 / 播完暂停）、画面旋转，Windows 渲染器可选 auto / gpu / gpu-next。
• 操作与快捷键：底栏「上一集」与静音按钮、自定义倍速 0.25 ~ 8x、移动端双击快进 / 快退、桌面悬停音量滑块（Windows 音量最高 200%）、进度条悬停时间气泡、画面右键打开「更多选项」菜单。
• 截图：Windows 下用快捷键（默认 S 键）直接截图存为文件，文件名自动带「番剧标题 + 集数 + 播放进度」，连按不会覆盖，与上游的截图挑选面板并存。
• 超分辨率：Anime4K 扩展为官方六档（效率、降噪、均衡、质量、均衡增强、极致），新增 Restore_CNN_Soft 与 Upscale_Denoise_CNN_x2 着色器。
• 收尾引导：最后一集播完后可直接前往详情页在线播放，或搜索磁力补集。

弹幕增强

• 时间轴校准：基于弹幕时间分布的头尾空白、越界信号与密度形态自动检测偏移，给出推荐偏移与置信度，避免把片头 / 片尾的自然空窗误判成偏移。
• 作用域记忆：偏移按「番剧:分集」持久化，单集校准不会污染同番剧的其他集数，历史遗留的全局偏移会自动清理。
• 弹幕池面板：播放器弹幕面板提供当前弹幕池列表，以及 ±1 秒、±10 秒、恢复无偏移的时间轴快捷调整。
• 倍速修复：逐 tick 补发区间内的整秒弹幕，修复非 1 倍速播放时弹幕丢失或重复的问题。

追番统计与补标

• 统计页：收藏按放送年份 / 季度归档浏览，提供单年各季度与历年的追番曲线、各状态数量总览、状态分布环形图与评分分布柱状图（含平均分）。
• 筛选与批量操作：季度列表可按收藏状态（在看 / 想看 / 搁置 / 看过 / 抛弃）筛选，组内可按评分 / 收藏时间 / 标题排序；支持多选批量修改状态或删除；视图大小可选大 / 中 / 小，设置自动记忆。
• 季度补标：按年份 / 季度浏览 bgm.tv 的动画条目，点按卡片单条打标，也支持多选批量标记；统计页的各季度标题可一键直达对应季度。
• 记录导入导出：支持导出 / 导入与 bangumi-note 兼容的追番记录 JSON，导入按原状态还原且不覆盖已有收藏。
• 评分详情：详情页点击评分可查看平均分、Bangumi 排名、评分人数与 1 ~ 10 星评分分布明细。

桌面端与外观

• 自定义背景图：可选择本地图片作为全应用背景，支持毛玻璃模糊强度与不透明度调节；页面、卡片、吸顶标题栏统一为半透明玻璃表面，页面切换淡入淡出。
• 桌面交互：全局 ESC 返回（输入文字时不误触发、弹窗打开时优先关弹窗）、双击标题栏在最大化 / 还原之间切换、播放器画面与媒体库番剧 / 磁力任务的右键菜单，磁力任务支持多选批量操作。
• 导航与宽屏布局：底部导航新增「下载」与「媒体库」，磁力搜索 / 磁力下载 / RSS 订阅 / 离线缓存统一到下载中心；宽窗口下下载中心改用左侧边栏切换分类。
• 其他：Android / Windows 开机自启（默认关闭）、可将「媒体库」设为默认启动页、首页「继续观看」一键续播上次进度、时间表支持「只看日本动画」、详情页点击标题即可复制。

接下来准备做的是远端媒体库。项目仍在积极开发中，如果有建议也欢迎在评论区提出。