iOS 主要功能实施计划（2026-10-10）

持续补全的当前差距与验收清单见 iOS / Android 关键功能差距。

目标与已确认约束

建立用户可操作的仓库导入／扩展安装 → 浏览／详情 → 漫画、小说阅读与视频播放 → 收藏、历史、更新检测闭环。 本轮沿用已经验证的 Mihon、Aniyomi、Tsundoku、JAR 与 CMS；不扩大生态测试范围。 界面全部使用原生 SwiftUI，平台图像解码与播放器使用 Apple 原生能力；阅读语义复用 reader-core。 保留 Android 主要功能，翻译、OCR、翻译日志暂不迁移。超分、WebView 兼容、真机 JVM 和分发独立验收。 接手时工作区已有 Claude 的未提交改动；不创建分支、不提交、不丢弃既有工作。

模块与生命周期

• core-library：从已有桌面持久化实现提取跨平台漫画库与更新检测，复用共享 Room 和 core-domain 规则； 桌面保持源码接口兼容，iOS 仅消费投影，不另建收藏／历史数据库。
• ios-shared：装配共享漫画库、仓库索引与 reader-core，保留完整 Source DTO 和 64 位身份。
• source-host：扩展导入／转换／校验／注册使用现有进程会话，不销毁重建 Mobile 兼容平台。
• SwiftUI：应用级数据库与源会话；子页面借用会话。阅读画布与控件面板的生命周期独立。

实施阶段与验收

1. 记录闭环：收藏增删／分类、历史、漫画／小说／视频进度记录与恢复、收藏更新检查及失败报告。 验收共享持久化与重开测试，原生详情和库入口的 UI 测试。
2. 仓库与安装：识别 kototoro://add-repo?url=…&kind=…，支持粘贴与系统打开；复用 JSON／Protobuf 索引解码，持久化仓库记录；用户选择 APK／JAR，设备端转换与 SHA／身份校验后安装，支持重启恢复。 JVM 的动态注册沿用 registry replace 与租约，不关闭仍在使用的源。 验收 repo-hub 的五种链接、无效地址／重复记录、转换失败保留旧安装、装入后枚举和重启恢复。
3. 共享阅读引擎：分页／连续场景、缩放与平移、宽页拆分／双页、可见页进度和预读；图像在原生层 解码，保持源客户端请求及沙盒 artifact 校验。超长页分块和内存预算单独测试。
4. 原生阅读控件：章节胶囊变形为章节面板；右上更多变形为选项面板；两者互斥，关闭回到原入口。 章节保留章节／页面／书签、分支、搜索、排序、列表／网格、筛选与多选操作；更多分为快捷动作、布局、 显示、控件和设置。底栏为独立的上一章图标按钮／可拖动页进度条／独立的下一章图标按钮， 三者不共用背景，不额外显示上一页和下一页。 书签为可选的右下浮动按钮，悬在下一章按钮上方，浮动控件最多四个。支持减少动态效果与辅助功能。
5. 最终验证：默认原生 CMS 构建及可选 JVM 模拟器构建、共享测试、确定性 fixture 的端到端闭环； 对照已测试源做针对性回归。记录真机／分发、源特定高级功能和后台调度的实际未验收范围。

当前执行记录

• 已核对交接、现有源预览、SwiftUI 页面、桌面持久化、仓库解码与 registry 更新接口。

• 记录闭环已装配：core-library 从桌面实现提取共享持久化与更新检测，桌面入口保留类型别名； iOS 收藏／分类、历史、书签和三类媒体的继续阅读／播放入口调用同一数据库。

• 仓库与安装已装配：粘贴和系统打开 repo-hub 链接，四种扩展索引及 TVBox/CMS 导入； APK／DEX JAR 转换、已有 class JAR 注册、更新、托管扩展卸载与重启恢复；支持从系统文件选择器直接导入本地 APK／JAR 文件，在 SourceHostManagement 中自动识别 AndroidManifest.xml 并调用 MihonJarInspector 校验包名、版本与生态，或作为 JAR 解析器插件注册，转换临时文件在 finally 中清理。 转换器版本升至 5：移动 JVM 缺少 jdk.zipfs，改为普通目录输出后流式封装 JAR； 使用只有 java.base 的 JVM 子进程增加回归，模拟器实际再漫画 APK 转换安装通过。

• 阅读引擎已实际调用 reader-core：分页／连续场景、双页与封面、宽页独立显示、宽页左右拆分（PageSegment 按阅读方向拆为右半／左半或左半／右半）、白边自动裁切（ReaderEdgeDetection 降采样像素扫描与边界收敛）、 超长图可视区域分块解码（ImageDecodeSize 预算限流 + VisibleImageTiles 按视口与缩放倍率计算分块 + ImageIO 原生区域裁切与降采样）、四种缩放基准、缩放平移边界、连续进度与页内偏移恢复、自动翻页／连续自动滚动。 原生解码图片保留有限预读窗口；双页模式下记录当前槽位的最末可见页（lastVisible），确保读至末章最后一个双页跨页时进度可达 100%。

• 小说阅读器补充目录与段落书签面板：通过 IosLibrary.toggleNovelBookmark 记录／取消当前可见段落书签并保留正文摘要， 支持在“目录与书签”面板内切换章节、跳转书签段落与滑动删除书签。

• 控件使用 SwiftUI／Liquid Glass：章节与更多按钮展开为互斥面板；章节／页面／书签、分支、搜索、 卷分组、顺序／网格、下载筛选／重复合并、多选／区间／下载／移除；更多包含八项动作与布局（含宽页左右拆分与自动裁切白边开关）／显示／控件。 底栏为两个独立的换章图标按钮和中间的原生 Slider／页码胶囊；拖动跳页复用阅读引擎的页面定位， 三者高度均为 44pt，进度胶囊从左至右为当前页码／滑块／总页码；首末章禁用相应按钮， 辅助功能保留上一章／下一章名称及页码语义。 返回按钮使用原生玻璃按钮样式并显式指定圆形，与更多入口、所有浮动按钮统一为 44pt； 圆形控件与进度胶囊共用同一尺寸值，浮动按钮在原生玻璃效果绘制前显式设定尺寸。 书签置于下一章按钮上方的可选右下浮动区，浮动动作最多四个；设置按作品保存，可设为全局默认。

• 整章下载保留完整 SourcePage、请求上下文与图片摘要，完整下载后原子发布清单；详情请求失败时 已保存章节仍可进入离线漫画阅读。保存页面和裁切／批注使用原生图像及文件导出。

• CMS 内容／章节／页面身份现包含来源，防止多个站点相同 vod_id 覆盖或被身份保护拒绝。 旧库不执行破坏性迁移，已有完整记录仍可打开；旧记录与新来源身份可能各保留一条。

• 浏览分页与重试已修正：MacCmsSourceRuntime 在候选列表／详情 URL 全部请求失败时向上抛出异常而非静默返回空列表； SourceBrowseModel 在后续页加载失败时保留已加载条目与当前页码，点击“重试”仅重拉失败页而不清空已有结果。

• settings.gradle 补充 Google 官方 Maven Central 镜像以解决 repo.maven.apache.org 边缘节点对 Ktor 3.5.0 iosArm64 klib 返回 404 的问题；:ios-shared:compileKotlinIosArm64 与 :ios-shared:assembleKototoroSharedDebugXCFramework 双切片（真机 iosArm64 + 模拟器 iosSimulatorArm64）编译打包通过。

• 漫画下载接入应用级持久化队列：单章与多选章节共用串行 worker，支持暂停／继续、失败重试与移除任务。 设置页、阅读器章节面板和更多面板均可打开下载管理页；退出阅读器后前台任务继续执行。 进入后台暂停正在执行与等待中的任务；进程重启后，中断任务恢复为暂停状态。 每页保存 partial.json 检查点，继续时逐页校验 SHA-256／长度与图像解码，完整保存后原子发布 chapter.json。 损坏图片重新获取，损坏清单重新请求页面；再次下载已完成章节会重新校验，移除队列任务保留图片文件。 IosDownloadArchive 保留作品与所选章节的源字段、memo 和 64 位身份，省略无需重复保存的整部作品章节目录。 单个队列最多 500 条／32 MiB；写入失败不发布新状态，无法读取的原队列文件保留。 暂停不能打断已进入同步 JNI 的请求，worker 槽位等旧请求实际结束后才释放，防止暂停后立即继续造成重叠请求。

• 扩展管理参考 Android 统一管理页，采用 SwiftUI 原生分段列表、搜索、菜单、添加表单与详情 sheet。 “扩展／仓库”分开管理，支持全部／已安装／可安装／更新、生态与语言筛选；可安装项按语言分组。 语言筛选常驻在状态分段下方，支持多选、逐项取消与单独重置；常用语言和多语言置顶。 SwiftUI 菜单连续勾选时保持展开，多个语言按任意匹配过滤，未选时显示全部；多来源扩展保留所含语言的匹配。 语言多选、生态与安装状态通过 @AppStorage 持久化；退出页面、重启和添加／刷新仓库后保留选择。 状态偏好使用稳定的英文标识，独立于显示文案；语言单独重置和整体清除均写回偏好。 已安装扩展展示名称、版本与包含的来源；成人发现与浏览页共用设置，已安装成人扩展仍可管理。 多仓库按生态＋包名合并，优先最高版本；仓库详情保留自身版本，安装明确绑定其仓库。 安装／文件导入由已有端侧流程处理结果，管理页不以运行时能力或版本大小禁用入口；刷新期间仍可添加仓库。 名称优先使用扩展／仓库可读名称，再回退到来源名称；已安装展示元数据持久化，图标缓存并缩小解码。 仓库不可用或移除后仍使用已知名称和图标；缺图以名称首字占位，避免所有扩展显示相同的通用符号。 各仓库独立刷新与报错，刷新失败保留当前目录，移除仓库保留已安装扩展；卸载仍走原生确认。 RepositoriesModel 负责共享仓库／安装编排，ExtensionPresentation 负责平台列表派生与筛选； SwiftUI 页面复用同一个行与详情组件，既有索引解码、运行时与持久化边界不变，无新增依赖。

• 图书馆备份（主方案 §97）：core-library/LibraryBackup 共享导出／合并，桌面改为委托；iOS 以系统 zlib 读写 Android 同格式 ZIP，预览校验 CRC 与行数，合并不清空本地记录；设置页可导出到“文件”并从文件恢复。

• 浏览筛选面板：排序、标签包含／排除、状态／分级／类型／受众／语言／年份，与分类胶囊同步； JAR 源显示插件可读标题，扩展源显示站点图标（按需获取、磁盘缓存，失败回退首字图标）。

• 封面网格固定 2:3 并裁切填充，解码封面进入内存缓存，回滚不再重新加载； 详情页参照 Android 重做（模糊背景、主操作按钮、状态／评分标签、标签流式布局、章节搜索／排序／分支／当前章进度）。

• 阅读器分页改用系统原生分页（一次一页，系统松手动画），新增点击区域翻页（右左阅读镜像、可反转／关闭）、 边缘跨章（向前从上一章末页开始），背景铺满安全区。

• 扩展筛选（主方案 §98）：Mihon／Tsundoku／Aniyomi 显示扩展自己的 FilterList（开关、三态、下拉、排序方向、 文本、嵌套分组），只提交改动项；JAR 解析器按能力增加年份区间、原作语言与作者；搜索中可从分类栏打开筛选。

• 仓库深链（主方案 §99）：修复从网页导入跳转闪退；支持 tachiyomi/aniyomi/anikku 旧式链接； 无 tachiyomix.extensionLib 的 Mihon 扩展按版本号推断库版本，可正常安装。

• 详情页全景封面（主方案 §100）：顶部横幅／全屏两种布局与清晰／均衡／柔和预设，随滚动移出、下拉拉伸、 可选缓慢动画；设置页可关闭并回退到模糊背景。

• 作品库与显示模式（主方案 §101）：“作品库”封面网格、分类胶囊（计数／重命名／删除）、搜索与排序； 作品库、浏览、历史、更新统一支持列表／详细列表／网格／紧凑网格。

• 来源与扩展（主方案 §102）：TVBox 并入扩展管理与浏览分组；来源逐个开关（多语言扩展默认只开系统语言）； 浏览页列表/网格与内容/来源类型筛选；JAR 仓库命名、安装入口、堆与原地更新修复；电影网格与网格尺寸。

• 播放器与搜索（主方案 §103）：AVPlayerLayer 与统一自定义控制栏；底部全局搜索覆盖收藏、历史及启用来源， 支持置顶／内容类型筛选与查询进入来源列表，来源列表使用顶部搜索按钮。 独立 fixture 构建缺少真实 Mihon 接口，会明确提示并禁用真实扩展安装；测试结束后须恢复真实扩展构建。

验证证据

• :dex-convert:test：16 项，0 失败，2 项可选真实产物用例跳过；其中无 zipfs 子进程回归实际执行。

• :source-tvbox:jvmTest：15 项，0 失败，1 项在线探测跳过；新增跨站点相同外部 ID 回归与第二页临时失败重试回归。

• :source-host:test：93 项，0 失败，验证失败安装保留旧状态、无目录元数据本地归档自动检测、重开与卸载。

• :ios-shared:iosSimulatorArm64Test：14 项，0 失败，验证完整 DTO／64 位身份、记录重开、双页 lastVisible 进度与小说段落书签、 更新分支、阅读场景（含宽页左右拆分、像素预算计算、超长图可视分块计算、白边边界检测）与离线清单、仓库重复导入、身份变化拒绝及分页失败恢复。

• :ios-shared:compileKotlinIosArm64 与 :ios-shared:assembleKototoroSharedDebugXCFramework：通过，生成 ios-shared/build/XCFrameworks/debug/KototoroShared.xcframework。

• 桌面漫画库／更新检测定向测试：13 项，0 失败。

• SourceImageFileTests：2 项，0 失败，验证沙盒图片 SHA-256／长度／路径校验、ImageIO 尺寸读取、区域裁切与 sampleSize 降采样、 宽页左右半页切分、白边像素采样与裁切。

• ProductFlowTests 两项模拟器 UI 测试通过：仓库链接 → 设备转换安装 → 重启； CMS 收藏 → 播放 → 重启继续播放 → 历史记录。

• repo-hub 当前链接已对照页面读取；支持已验证的五种类型，其他类型明确拒绝，不扩展生态范围。

• 默认无 JVM 原生构建的四项 UI 测试通过：CMS 导入／分类浏览（含第二页 503 失败保留首屏条目、点击重试追加第二页条目）／ 双线路详情／HLS 播放与换集、收藏历史与重启续播，以及两项链接解析回归。

• SourceRuntimeTests/testIndependentSourceRunsThroughEmbeddedJVM 与两个 RepositoryLinkTests 通过： SwiftUI 章节／更多面板互斥、书签列表、整章下载、换章图片重新加载，终止并重开后继续到原章节／页。 链接解析覆盖 repo-hub 五种支持类型、转义字符、重复参数、错误 scheme 和未支持生态。

• 底栏修正后再次运行上述三项 UI 测试，0 失败：使用原生 Slider 跳至首尾页、换章和重启续读； 检查不存在上一页／下一页按钮，书签位于下一章上方且水平中心对齐；实际截图保存于 iosApp/build/reader-footer-attachments/。

• 换章按钮调整为独立圆形图标后，阅读器端到端定向测试再次通过（1 项，0 失败）； 最新实图保存于 iosApp/build/reader-footer-icons-attachments/。

• 最终控件尺寸与页码布局回归通过（1 项，0 失败）：进度胶囊与换章按钮等高，浮动按钮与换章按钮 等宽等高，返回按钮宽高相等；当前／总页码分置滑块左右，跳页、换章和重启续读均通过。 最新实图保存于 iosApp/build/reader-final-controls-attachments/。

• 下载队列增量：Native 15 项通过（新增完整下载字段与精确身份往返、来源不一致／未知版本拒绝）。 ReaderDownloadQueueTests 5 项通过：不可中断请求的暂停／立即继续串行性、重启进度恢复、失败后继续下章及重试去重、 后台暂停与移除后的迟到结果、损坏文件／写入失败保留状态；图片 2 项、分类重启 1 项回归通过。 JVM fixture 阅读 UI 验证单章进入队列、下载管理页显示完成、重启续读与队列记录恢复，截图已实际检查。 日志为 iosApp/build/ios-download-native-tests.log、ios-download-default-tests.log、 ios-download-default-final-tests.log、ios-download-fixture-tests.log、ios-download-fixture-final-tests.log； 截图在 iosApp/build/download-queue-attachments/。compileKotlinIosArm64 通过（ios-download-device-compile.log）。 最终默认构建 7 项定向回归与 JVM fixture 1 项再次通过，文档构建通过（ios-download-docs-build.log）。

• 原生扩展管理增量：Native 15 项、host 会话 8 项、默认 Swift／UI 10 项（状态派生 7、链接解析 2、 管理 UI 1）通过，compileKotlinIosArm64 通过。UI 覆盖无效地址恢复、来源搜索、安装状态、 仓库导航与两处扩展详情；截图已实际检查，位于 iosApp/build/extensions-final-attachments/。 日志为 extensions-native-host.log、extensions-default-final.log、extensions-device-compile.log。 真实 JVM ProductFlowTests/testRepositoryLinkConvertsApkOnDeviceAndPersistsInstallation 通过： 添加后进入指定仓库，安装原始 APK，再重启验证已安装名称与所含来源；同包同时存在其他仓库时仍使用 当前仓库的资源。日志为 iosApp/build/extensions-real-install-final.log，实图在 iosApp/build/extensions-install-attachments/。这些验证不替代真机运行验收。 语言入口独立后，8 项 Swift／UI 定向回归通过，实际验证中文／英语／多语言切换与单独重置， 中文筛选保留中英双语扩展并排除纯英语扩展。日志为 iosApp/build/extensions-language-final-tests.log， 实图在 iosApp/build/extensions-language-attachments/，JVM 模拟器预览已重新构建并安装。 语言多选增量：9 项 Swift／UI 定向回归通过，覆盖中英同时选择的并集、逐项取消、取消最后一项、 多语言分组、菜单内清空与单独重置；菜单连续选择及双勾选实图已检查。 日志为 iosApp/build/extensions-multilanguage-final-tests.log，截图在 iosApp/build/extensions-multilanguage-attachments/；JVM 预览构建与文档构建通过。 筛选持久化增量：既有 8 项派生／筛选测试和管理 UI 回归通过，新增 UI 回归验证返回页面、进程重启后 恢复中英多选、生态与可安装状态，并验证整体重置在再次重启后仍生效。日志分别为 iosApp/build/extensions-filter-persistence-tests.log 与 extensions-filter-persistence-final-tests.log； 首轮新增回归因搜索模式隐藏工具栏而失败，修正测试操作顺序后定向回归通过。 实图已检查，位于 iosApp/build/extensions-filter-persistence-attachments/；JVM 预览和文档构建通过， 模拟器已安装更新后的 JVM 预览。 安装入口与展示增量：12 项 Swift／UI 回归通过，验证较旧仓库版本仍可交由端侧安装、技术包名／别名回退到 可读来源名称、仓库缺失时从持久化展示信息恢复名称／来源／图标；管理 UI 验证安装按钮可用、文件选择器打开 与取消，以及原有搜索／多选筛选／仓库详情流程。日志为 iosApp/build/extensions-install-display-final-tests.log。 真实 JVM 原始 APK 安装与重启恢复回归通过（extensions-install-display-real-install.log）， 已检查列表真实图标与文件选择器实图，位于 iosApp/build/extensions-install-display-attachments/。 JVM 预览与文档构建通过，模拟器已保留更新后的 JVM 预览；未新增依赖。

2026-10-11 增量验收：CopyManga 1.4.85、MH1234 1.6.5 的模拟器安装及重启状态， 独立测试构建的安装拦截，Aniyomi／CMS 播放、跨生态筛选、六种显示模式与网格尺寸、 单源／全局搜索及查询进入“更多”，合计 9 项定向 UI 验收通过。 独立搜索胶囊已检查模拟器实图；失败根因、日志和具体范围见主方案 §103。

作品库分类管理增量（主方案 §104）

作品库新增“管理分类”，使用原生拖拽列表与“在书架显示”开关，复用共享数据库的 sort_key／show_in_lib，一次事务保存；取消编辑不落库，分类列表变化时拒绝过期快照。 隐藏只收起分类胶囊，保留收藏成员关系与“全部”入口；隐藏当前分类后自动返回“全部”， 仍可在管理页重新开启。原有备份格式保留排序与可见性，不增加 schema 或持久化副本。

共享分类与备份 8 项测试通过；分类创建／重启和拖拽／取消／隐藏／重启恢复两项定向 UI 用例通过。 管理页实图已检查，文档构建通过。具体日志与验收范围见主方案 §104。

浏览增加“最近使用”和“使用频率”排序，分别读取共享使用时间和本地作品记录数； 重复进入同一作品不会增加作品计数。首次访问保留手动顺序和开关，置顶仍优先，排序偏好与使用时间在重启后保留。 全局搜索清空后恢复最近搜索，取消任务不会继续启动排队请求，迟到结果不能覆盖后续搜索。

共享分类／备份／来源 9 项原生测试、来源排序与全局／单源搜索两个定向 UI 用例通过， 另有三项确定性搜索模型检查验证取消边界；来源排序与清空搜索实图已检查。具体日志与验收范围见主方案 §105。

浏览页新来源版本提示（主方案 §106）：首次目录建立基线，后续来源按 iOS 构建版本写入共享 added_in； 列表／网格显示“新”标记，提供新增数量与持久化的新来源筛选，复用已有排序、置顶、开关和备份字段。 共享分类／备份／来源 10 项原生测试通过；新来源基线、标记、筛选、重启、真实网格与空状态恢复， 以及原有使用排序两个定向 UI 用例分别通过。列表／网格／空状态三张实图已检查；日志与范围见主方案 §106。

内容空间（主方案 §108–§109）：作品库、浏览和记录的右上角打开同一个原生 Space 卡片面板， 共用选择并随重启保留；设置关闭后恢复各页内容类型分段切换。 漫画／小说／视频卡片分别显示该类型最近作品、封面和进度，并可直接续读或继续播放。 面板与底栏继续阅读附件共用原有详情／章节恢复流程，不新增数据表或历史存储。 跨页选择、重启、空间关闭与漫画卡片续读的模拟器验收已通过；自定义空间与独立空间导航栈尚未迁移。 底栏继续阅读附件同样只取当前空间的最近作品；空间关闭时取全部历史。

视频外挂字幕（主方案 §110）：来源提供的 WebVTT／SubRip／ASS 字幕下载后由共享解析器生成 cue，叠加在播放画面上，并与内嵌字幕共用一个字幕菜单；外挂音轨与画中画字幕尚未接入。

条漫缩放（主方案 §111）：连续条漫支持双指缩放（1–4 倍）、双击切换和横向平移，按缩放宽度重新排版，分块随之变清晰；阅读进度与缩放无关，切换阅读模式后恢复适应宽度。横向条漫的交互缩放仍待。

小说下载（主方案 §112）：小说章节与插图进入同一下载队列，可离线阅读。主界面搜索与作品库顶栏修正见 §113。来源设置、User-Agent 预设与 Cloudflare 内置浏览器验证见 §114。

下载/缓存存储管理增量（2026-10-14）

设置和下载队列新增存储管理：分别统计漫画/小说离线章节、页面/封面与图标缓存， 支持明确确认后删除离线章节、清除缓存及缓存上限设置。移除队列记录后仍可管理保存文件， 漫画离线提示改按文件状态显示；旧目录没有元数据时使用队列信息或日期/大小。

阅读窗口和实际未结束的下载/图片请求会阻止冲突清理。章节删除与队列持久化协调， 写入失败恢复原目录；重启恢复未提交删除，已提交残留只重试释放空间。文件使用权覆盖 取消后仍运行的 JNI/解码，清理期间新图片请求等待。默认 512 MiB 的缓存软预算在空闲时清理较旧文件。 复用原下载格式与目录身份，不修改数据库或引入依赖；库、收藏、进度与本地导入文件保留。 具体测试、统计边界和后续视频下载范围见关键功能差距清单及 iosApp/README.md。

追加小说阅读控件：参考漫画的返回/章节/更多与底部进度，书签、排版和下载收纳进面板； 四种悬浮按钮可选择、全部关闭并在重启后保留。目录、阅读设置和下载队列统一由一个弹出层状态管理。 上下边距按正文区计算，挖孔另行避让，页脚放在下边距内；移除旧页脚占位和固定滚动留白。 28 项定向原生测试通过；随后 60/12 pt 边距与全部四种悬浮按钮操作、连续面板、配置恢复分别通过。 测量使用实际正文布局坐标，控件显隐不改变分页正文；详细日志与外网小说下载限制保存在差距清单。

明确未验收的范围

2026-10-14 本地视频增量：默认原生构建可从“本地视频”选择单个媒体文件，系统先校验可播放性/视频轨道， 再由共享本地来源复制到沙盒，复用 AVPlayer、收藏/历史及续播。重复导入相同文件保留作品/章节 ID； 同名同长度的不同内容不覆盖旧副本，失败导入不删除原作品。没有新增依赖、数据表或历史实现。 JVM 13 项、iOS Native 59 项与原生 UI 4 项通过；Arm64 编译通过，视频播放/重启续播/坏文件拒绝实图已检查。 日志、补全顺序与仍未支持的视频目录/播放列表/自动封面等范围见上述关键功能差距清单。

• 真机 JVM 与签名／分发仍未验收；扩展安装需要可选 JVM 构建，默认原生构建支持 CMS。 真机 iosArm64 原生切片与 KototoroShared.xcframework 编译已通过，但不替代真机运行验收。
• reader-core 的区域分块解码、自动裁边、宽页左右拆分已装入原生画布并通过单元测试验证，仍需在真实超长条漫源与真机内存压力下补充端到端性能验收。
• 翻译／OCR／日志按约定暂不迁移。当前隐藏已读筛选表示隐藏当前章之前的章节，未实现逐章阅读标记。
• 更新检测目前为手动触发；后台定时检测、系统后台下载调度与网络传输的字节级断点续传尚未接入。 漫画队列支持按页恢复；暂停／迟到请求／重启规则已在确定性 Swift worker 测试验证， 真实慢源中断后的逐页恢复、真机存储压力与长期大队列性能仍需补充验收；视频下载尚未接入。
• 更多与章节面板已经具备原生布局和核心操作，仍需真机辅助功能、iPad／横屏及长章节性能验收。