LyricWave — 宿主版本适配清单

每个精确构建单独复制本清单到任务记录填写，本文件保持可重复使用。勾选表示该项已有可追溯证据，不能用成员匹配、构建或安装成功代替人工通过。

状态统一为“已核对 / 未确认 / 不适用 / 已知降级 / 新异常”；不适用注明页面族、能力或形态依据。每项关联下面的证据表，人工操作与预期只在功能保全矩阵维护，实现规则查宿主适配手册。

1. 构建身份、范围与基线复制章节链接

• [ ] 入口按实际宿主 packageName 校验通过，TargetBuild 记录实际包名；首次加载与声明主进程过滤保持生效。
• [ ] 身份、外层清单/显式参数一致，正式版/beta/同名不同构建独立建档。
• [ ] 仅 Android 安装包名变化；内部类、方法和资源保持原包常量，实际包名只用于身份、版本及组件，其他改包行为未套用本兼容规则。
• [ ] 所有DEX/资源split已覆盖，页面族由真实入口/生命周期确定。
• [ ] 直接比较原始已适配版与目标版时，base对base、同类ABI split对同ABI、密度split对同密度，其余split按相同身份与限定符配对；目标新增或缺失项单独登记，未跨来源替代。
• [ ] 当前档案与参考档案资格区分，未凭旧类存在或版本号推定兼容。
• [ ] 原始owner/擦除描述符有字节码依据，未采用工具修复名/推断类型。
• [ ] 类结构、字段顺序或相似描述符仅记为结构候选；转为已确认映射前，owner/完整签名、声明与实例关系、调用/读写语义、Hook具体实现及生命周期作用均已闭合，未以结构或描述符匹配单独授予运行时兼容。
• [ ] 默认人工验收；设备/功能脚本、全量测试、哈希仅按明确任务范围执行。

2. 资料、解析与证据复制章节链接

规则依据：profile与三种接入方式。

• [ ] 文件名与精确 versionName+versionCode 一致、id 唯一且索引有序；profile.packageName 仅描述原包和内部命名空间，不作运行时白名单。
• [ ] 每条接缝标明索引、HLE或独立契约方式及回退策略。
• [ ] 必需角色/完整描述符、类型关系与当前调用链一致，抽象调用与Hook具体实现已区分。
• [ ] 新依赖已同步profile、代码Inventory/Contract、verification和适用离线覆盖。
• [ ] 新档案拒绝歧义；历史首匹配/旧HLE候选语义没有无依据扩大或替换。
• [ ] productionEnabled与runtimeVerified按阶段分开，evidence/knownDegradations与实际证据一致。
• [ ] 适配器新增方法导致混淆名移动时，旧名即使仍存在且签名相同，也按当前包的声明、调用与状态语义重核；空实现等无法由方法体或完整签名区分的候选，沿原生状态分支与父类声明追踪，未按同名或首个候选复用。
• [ ] 从相邻构建复制 evidence 时，各独立区域沿用现有字段并按目标实际包核对/更新 sourceBuild、sourceIdentity、memberSource 与 layoutReview，区分上游方案来源和宿主证据，未复制旧 runtimeVerified。

2.1 逐接缝证据模板复制章节链接

直接入口继续展开binding、holder、getter、listener、模型与清理路径；不在本模板另抄整套档案。

2.2 功能覆盖表复制章节链接

按此表逐域填写。自动来源/LLM虽然共用提交，模糊与CJK辉光各有适用结论；简体替换和声修复、逐行双声部对齐、英语拆词辉光、CJK末词补偿、跨行扫光与活动行高亮共用“歌词效果优化”开关，但仍分别填写安装、降级与失败结论。

3. 页面族与资源判定复制章节链接

依据：适配流程与页面族。仅填写实际页面族，另一族标记不适用。

• [ ] 工厂已有该family的独立接入，未把新族默认套入旧路径。
• [ ] Fragment各组安装前分别解析；双栏成功未代替chrome、恢复或歌词能力完整。
• [ ] songLayoutPolicy与布局契约匹配，layoutReview六类证据齐全。
• [ ] host ID/恢复tag及状态保存/右栏测量规则保持，新view关闭旧会话。
• [ ] 模块挂载容器和宿主LayoutParams类型正确，未用模块AndroidX替代宿主对象。

3.1 资源与binding证据复制章节链接

• [ ] 全部有效限定符与递归include已分析，资源名/数字ID未跨构建盲目复用。
• [ ] View父链/参数与binding覆盖有依据，回调使用缓存，配置/视图变化重新解析。

4. 按功能域判定复制章节链接

各域勾选后在2.1/2.2表补证据和状态，人工结果链接对应矩阵场景。仅修改共享策略时，再按第5节复核实现；新构建仍覆盖所有适用功能。

4.1 共用歌词结果提交复制章节链接

维护规则 · 人工场景

• [ ] 结果容器、发布实现、索引、指针/歌曲身份、安装及item更新均命中当前精确契约。
• [ ] LiveData实际声明基类、返回类型与公开生命周期入口有证据，按容器实例过滤。
• [ ] 索引/结果保存一致，异常后的读取对齐与复用失效判据已核对。
• [ ] 显式/推断请求、实时身份、postValue合并与空Pair真实边界符合当前宿主语义。
• [ ] 附加、待安装补发、候选owner/销毁与降级边界齐全，未直接重入安装或改写item。
• [ ] 安装入口空值抑制以同 Fragment、同 ViewModel、同请求及同播放 ID 为前提，并能取得存活且 ID 匹配的当前文档或 ready replacement；缺一即保持原生空安装。
• [ ] 空安装抑制只记录此前未知的原生观察、保留选择、置待安装并经既有结果通道主线程补发；不改安装入参、不重入安装，未为已有信息新增 profile 角色。
• [ ] 同指针去重前读取实际跟踪 LiveData 的当前值；空值或容器更换不沿用旧安装确认，读取失败保留选择与后续恢复机会，不当作去重成功。
• [ ] 附加和同一 ViewModel 的后续请求都会刷新实际 lyricsResult 容器，不继续向旧结果容器发布。
• [ ] 发布调用、容器实际保存和原生安装分别留证；仅有发布轨迹不能证明页面已覆盖，非空原生结果仍按既有仲裁。
• [ ] 失败定位能区分 Hook 入口未调用与身份、容器、文档状态导致的早退，诊断按会话有界且不输出歌词正文或凭据。
• [ ] 资料库补全后的 getId 变化已核对；仅以与播放器发布快照相同的非零 persistentId 建立配置身份关系，零值、不可读或不相等时不猜别名。
• [ ] 配置/缓存使用逻辑 ID，指针/索引/安装使用当前实际 item ID；core 的逻辑身份不会掩盖原生指针失活或绑定被意外改变。
• [ ] 同文档切换实际提交 ID 时，后台使用保留 TTML 准备独立指针，新对象不被旧文档去重折回；不改旧指针、不在主线程解析、不复制裸地址或猜测所有权。
• [ ] 同 Handle 的进行中准备合并目标变化，只接纳最新目标；解析失败不循环唤醒，实际传入指针失活不被其他存活指针掩盖，无原文时保留原生行为。
• [ ] 原生结果先于 Fragment native ID 对齐时，分别核对接收归属与提交目标：仅同当前 canonical 请求、同当前 ViewModel 且显式加载已捕获该 raw ID、结果仍存活时暂存一个结果，owner 对齐后经实际容器恢复；空/失活结果不占位，新请求、换 VM、切歌或关闭使其退役，且不改现有 native 目标 ID 优先级。

4.2 当前歌曲与歌词来源复制章节链接

维护规则 · 人工场景

• [ ] 当前item/ID、多ID、元数据转换与原生TTML/指针来源对应实际播放对象。
• [ ] 手动/禁用优先、原生质量门槛及用户来源次序沿所选策略，未因通道适配改变；原生来自宿主结果，未增加原生源网络或发布通道。
• [ ] automatic_lyrics_prefer_native 缺键开启，来源顺序缺键为 AMLL/AM-Lyrics/AM原生/Lunabeat；解码、保存和运行时会将旧顺序中位于原生前的 Lunabeat 仅移到原生之后，其他来源相对顺序不变，并继续补齐缺项、去重、过滤未知项。
• [ ] 两种原生优先模式共用逐字/语言/译文资格；关闭优先时达标原生仅查询前置来源，不达标或不可用仍查询全部第三方，包括原生后置的 Lunabeat，Lunabeat 不禁用；全部未命中回退可用原生。缓存按 provider 位置使用，来源计划变化撤销旧代次。
• [ ] 自动发布显式标记 autoManaged，索引/备份/更新保留归属；缺字段旧项和明确手动操作受保护，不按来源名称推断归属。
• [ ] 自动实时补全二级页包含总开关、原生优先及排序；来源行右侧拖动柄按住上下拖动、松手保存，取消不保存，柄外页面滚动正常且不与拖动争用；排序始终保存为同一份完整顺序且不新增显隐配置；原生优先开启时保存可见来源的新顺序，隐藏占位原位置能保持就保持，若 Lunabeat 移到原位置之前则只将占位前插到 Lunabeat 之前，不重排可见来源；隐藏时旧位置不限制可见来源互调；原生优先关闭、原生与 Lunabeat 同时可见时，触控拖动与无障碍上移/下移均不能使 Lunabeat 越过原生或使原生越过 Lunabeat，阻止后顺序不变；标题右上角重置图标复用既有 SVG，仅恢复 ModuleSettings.DEFAULT_AUTOMATIC_LYRICS_SOURCE_ORDER（AMLL/AM-Lyrics/AM原生/Lunabeat），不改变总开关或原生优先，重置后按当前显隐状态重建；排序保存、返回父页及无障碍动作正确；模块列表使用自身 AndroidX 资源及宿主有效密度，不依赖宿主私有列表或资源 ID。
• [ ] 拖动及无障碍连续改序仅局部移动当前列表并写设置，不重建页面；保存时同步内部隐藏原生占位索引，列表滚动位置和无障碍焦点保留，连续改序、松手保存及被阻止动作均不闪暗；被阻止动作不改变顺序、不保存。
• [ ] 重置、原生显隐等保留同页重建流程，但不重放切页透明度或快照动画；真正跨页继续使用原有切页过渡。
• [ ] 排序标题、资格说明、来源文字和拖动柄的内容边界与上方开关对齐，重置动作有无障碍名称且触摸范围充足；说明明确原生在排序模式下仍须达标，关闭原生优先时提示 Lunabeat 必须排在 AM 原生之后。
• [ ] 缓存/来源刷新/发布与后台代次、取消、恢复和共用提交都有当前接入依据。
• [ ] AMLL Kotlin 转换器与 CLI 的译文/音译和声 span 显式使用 TTML 默认命名空间及 ttm 元数据命名空间，未继承 Apple 轨道的默认命名空间。

4.2.1 简体系统语言替换和声修复复制章节链接

维护规则 · 人工场景

• [ ] FeatureInstallation 始终登记 LyricsParserFeature；共享 lyricEffectsOptimizationEnabled 关闭时返回 DISABLED 且不调用 LyricsParserTarget.install()，无新增设置，并遵循现有重启策略。
• [ ] 共享设置开启时，LyricsParserTarget.install() 委派的 AppleMusicCustomLyricsTarget.installParserRepair() 提供单解析 Hook；普通原生修复不依赖自定义歌词开关或替换会话运行。
• [ ] 自定义歌词开启而 LyricsParserFeature 关闭时，CustomLyricsFeature 仍可安装同一 installParserRepair() 以保留元数据和 raw-TTML 观察；重复入口复用同一 Hook，before 在共享设置关闭时跳过改写。
• [ ] TTMLParser$TTMLParserNative#songInfoFromTTML(String): SongInfo$SongInfoPtr 的 owner、实例归属、唯一参数与返回闭合到同一精确符号；不可用时只降级本能力并透传原歌词。
• [ ] 只安装一个解析 Hook：before 先检查共享设置及 locale 再修复参数，after 向可选观察者提供修复前的原始 TTML；设置关闭时观察仍可用，不存在第二 Hook 顺序依赖。
• [ ] 门禁要求共享设置开启，且 locale 语言为 zh、显式 Hans，或脚本缺省、地区为 CN/SG；其他情况不执行。原生 replacement 资格或自定义歌词开关不能替代门禁。
• [ ] 仅使用唯一 type="replacement"、xml:lang="zh-Hans" 轨道；正文 key 唯一，x-bg 组顺序对应，组内词数和完整、有效、唯一的词时间数值等价，双方声明的组时间一致。
• [ ] 规范 TTML 根/前缀与 Apple 轨道命名空间可验证，替换轨每个 x-bg 显式切回 TTML；超出输入上限、重复 key 或轨道歧义时整份透传，缺内容或词/时间不兼容时整行回退，无行内部分写入。
• [ ] 只填正文既有 x-bg 的词文本；正文行/span 时间、层次、属性、主唱前景及其他辅助轨不变，未引入通用转换器或原生内存位移。
• [ ] 共享设置开启时，普通原生歌词和 OpaqueTtmlParser 的模块文档都经过同一门禁与修复入口，普通原生歌词不需要启用自定义歌词；模块解析标记继续排除其原生来源归属。
• [ ] LLM 注册表持有原始原生 TTML，而非修复后的宿主入参；修复失败、输出不兼容或能力降级时仍以原文调用原生解析。
• [ ] 人工结果分别覆盖共享设置关闭、开启但自定义歌词关闭、自定义歌词开启而设置关闭的观察路径、zh-Hans/zh-CN/zh-SG 正向、zh-Hant/zh-TW/非中文反向、模块文档、正文与其他轨保持不变，以及缺 key/重复 key/时间冲突的原文回退。

4.3 AI 歌词翻译、缓存与统计复制章节链接

维护规则 · 人工场景

• [ ] 原生原文观察与确切指针关联、模块解析排除及数量/字节界限成立。
• [ ] 先选择手动、在线或原生文档，再判断时间轴/语言/译文资格并查 AI 缓存；未确定来源时不提前翻译原生歌词。AI 不依赖在线补全开关，所选来源变化时撤销旧注入；输出关联与原生解析失败保留原文。
• [ ] 请求和回复按主行及其 background[] 分组。纯和声段落、多个和声、和声先于主唱及声部语言不同时仍能关联；主唱无需翻译时请求 text: null、回复 translation: null。
• [ ] 打乱主行或和声回复顺序仍能按 ID 回填；缺失、重复、多出或跨主行的 ID 保留原生歌词。
• [ ] 每段只有一个 text for，引用原 TTML 键，缺键只补一次。和声按原顺序写为 TTML 命名空间下的 x-bg，裸文字、全角括号和半角括号均统一为一对半角 ()，原词、时轴、声部、音译与重复行保留。
• [ ] 翻译提示词覆盖上下文/语气/意象、信达雅润色、按语境处理重复及完整和声，中文译文不使用逗号和句号；无冲突的旧规则或示例。
• [ ] 影响已有译文的协议、声部分组或写回约定变化时提升 LlmLyricsClient.PROMPT_VERSION；单纯调整翻译风格可继续复用已有缓存。
• [ ] 无独立猜测式宿主映射，结果继续通过共用通道；原文入口缺失能明确停用。
• [ ] 翻译和连接检查共用 Chat Completions 请求编码：「不发送」不带思考字段，thinking.type 随开关发送、仅开启且显式选档时带强度，reasoning_effort 只发显式低/高档。「跟随接口」时省略强度。参数失败不自动换格式重试。
• [ ] llm_lyrics_thinking_format 经普通设置保存与升级；已有旧配置保持原发法，新配置和未知格式默认不发送。切换格式保留已选开关及强度，只用当前格式支持的有效值。
• [ ] 缓存按格式及有效参数隔离。新写格式 3，旧 1/2 仅作为原 thinking.type 格式兼容；格式 3 缺失或未知格式/强度拒绝，降级不误读。
• [ ] 思考格式或有效参数变更沿用旧请求取消；翻译与连接检查不混用旧参数、旧缓存或迟到结果。
• [ ] 有效译文经 TTML 校验即保存；播放器接受情况独立记录，后续缓存复用与原文或配置更新失效均有验证。
• [ ] 设置按钮到模拟 API、落盘、预览与计数的 Android UI 测试通过；关闭页面后手动请求继续保存，同歌曲并发不重复调用。
• [ ] 调用记录仅含安全元数据；缓存命中不增加 API 次数，缺失 usage 不估算，清空保留在途请求。
• [ ] 若改客户端/设置/缓存，已登记第5节维护结论与相应矩阵场景。

4.4 歌词模糊复制章节链接

维护规则 · 人工场景

• [ ] 独立lyricBlur角色/关系覆盖当前族，不依赖双栏预检或开关。
• [ ] adapter提交/显示快照、实际文档边界、ID映射与四路真实文字动画读取有当前证据，未把外层安装请求等同文档替换。
• [ ] 前奏/三点、Ending、Seek、文档/视图/交互失效与不完整读取分别判定。
• [ ] SDK效果/裁剪租约、模块写入和宿主后写的所有权及关闭恢复明确。

4.5 歌词辉光与末词补偿复制章节链接

维护规则 · 人工场景

• [ ] 辉光前景绑定与原生门槛有据；cjk.maxSpanGlowCharacters 缺省为 1。trim 后删除 \p{P} 的正文须为 1 个或 profile 放行的 2..min(值, 3) 个 CJK 码点；短 span 时长 ≥正文码点数 × 1000ms。纯标点及混入 Latin、数字、emoji、内部空白拒绝。
• [ ] 仅接受原始未合并的前景绑定：f 等于 native duration，g 等于含标点 trim 原文的 UTF-16 length；splitBindingCount 上界为未过滤原文码点数，允许标点自身的视图绑定，越界仍拒绝。无标点时边界不变。
• [ ] 去标点正文只在原 a0 已通过候选验证的作用域内参与脚本资格分类，不全局改写 j0/k0 集合，不替代 Apple 原生长度或动画触发。原文、显示标点、native duration、分组和 g 不改；不得按宿主合并的多个原始 span 总时长放行。仅单字分支调整回落子动画延迟，多字保留宿主错峰，背景限制、profile 多字开关和末词补偿保持。新构建须独立确认元数据与绑定语义，默认不继承。
• [ ] cjk.splitWordGlow 使用精确 profile 对象；确认前景布局 ID、原生 builder/trim 的完整签名及 aggregateTrimLine。该位置只消费 trim 结果的长度，真实文本仍由宿主渲染；其他调用位置不得改写。
• [ ] 同一前景 Latin 词组超过 7 字符、至少两个连续 span，且某段原始时长 ≥1000ms、trim 后长度 2～7（含标点）；词向量中无法唯一匹配的文本、单个超长 span、内部空白及混合脚本不放宽。
• [ ] 核对 builder 返回键为原生词 ID，发布前恢复所有获准条目的 g，嵌套或异常退出清理绑定作用域。核对 i/k 原生字母绑定、a/l 分组和 c/e/f/g；动画仅对同一视觉行的有效绑定临时令 g=7 并在退出时恢复。真实长度与 7 在其余读取点行为相同。
• [ ] 核对 riseFunction/riseView 指向原生上升监听器的函数及目标字母；仅调整当前合格组的上升插值进度，回缩、错峰和动画时长保留原值。核对各 span 的扫光时序、整词触发、取消、结束和循环；缺失契约时不启用，不借用邻近 profile。
• [ ] 可选terminalGradient按代码必需角色完整解析，profile路径不变；CJK开关只门禁 CJK 辉光。“歌词效果优化”默认关闭并重启生效后，AppleMusicHostFactory 的 lyricRepairs 组在 LyricsParserFeature 门禁下独立安装末词补偿及英语拆词资格，并保留各项完整诊断。
• [ ] 原文/发音尾词、时间/ID、余量调用与延迟补亮标签语义一致。
• [ ] 整体状态按 parser 与已声明可选项计算：全为 Active 时为 Active，仅全为 Unsupported 时为 Unsupported，否则为 Degraded；缺契约的 Unsupported 保留在诊断中。单项失败或不可用时，辉光、解析修复、逐行对齐已安装项不互相撤销。

4.6 跨行歌词扫光复制章节链接

维护规则 · 人工场景

• [ ] 与简体替换和声修复、逐行双声部对齐、CJK末词补偿、活动行高亮共用“歌词效果优化”开关；默认/缺键关闭且更改后重启生效。关闭时本 Feature 返回 DISABLED、不调用 target.install，CJK 辉光开关不控制本项。
• [ ] 独立 lyricWrapSweep 契约/资格/作用域明确；设置开启只作门禁，不因共用开关或其他能力成功而授予支持。
• [ ] 视觉行键、child范围、原文/发音bank与四路模型关系有当前证据。
• [ ] 时间单位、原生动画、静态/暗色/渐暗/后继写入的真实路径已核对。
• [ ] 换绑/回收/文档/布局/Seek/暂停恢复与旧写入退役覆盖，几何不支持保持原生。

4.6.1 歌词效果优化：活动行高亮复制章节链接

维护规则 · 人工场景

• [ ] 与简体替换和声修复、逐行双声部对齐、CJK末词补偿、跨行扫光共用“歌词效果优化”开关；默认/缺键关闭且更改后重启生效。关闭时本 Feature 返回 DISABLED、不调用 target.install。
• [ ] 精确 profile 的 lyricBackgroundHighlight 分区声明独立契约，代码必需成员/关系校验、调用方去优化和注册均成功；未声明与安装失败的状态及 scope 清理正确。与 lyricWrapSweep 分别报告支持、降级或失败，一方不可用不阻止另一方。
• [ ] 当前构建活动行的内部过滤路径有据；原始输入仍含父行时也能识别未结束背景句，候选覆盖当前、输入与已保留行。
• [ ] lineSubset 仅处理同次提交、同一当前集合的首次过滤结果及真子集变化；模块保留与释放不影响其他原生成员或调用。
• [ ] 正常提交与结束补交复制合并父行主词/背景词 ID，原生消费路径已核对；原始入参不被修改，释放只清模块旧父行。
• [ ] 提交后的集合、重绑通知、焦点与显示快照一致；模糊及行词动画读取该状态，滚动仍由原生交互门槛控制。
• [ ] 窗口以父句起点及原文/发音背景词最终结束点为界；媒体时钟、行调度偏移、到期与补交载荷语义已分别确认，TTML/媒体时钟未改。
• [ ] 暂停停止到期轮询，恢复继续；Seek、换文档、脱离和视图销毁的释放路径完整，reader 与各 adapter 会话隔离，旧回调不写入新绑定。
• [ ] 能力状态如实区分安装与运行失败；异常释放/清理、后续会话重建及非主线程透传有据，正常逐句路径无排查日志。

4.6.2 歌词效果优化：逐行双声部对齐复制章节链接

维护规则 · 人工结果沿用歌词效果优化矩阵

• [ ] 共享“歌词效果优化”开关、默认关闭与重启门禁；精确 profile 显式授予 capabilities.lineLyricAgentAlignment=true，相邻构建不自动继承。
• [ ] 随现有 LyricsParserFeature 门禁下的 lyricRepairs 组处理，缺资格保留原 parser并计入完整诊断；整体状态按 4.5 的汇总规则，任一子项失败不撤销其他已安装项，不依赖模糊开关或其他模糊成员的解析。
• [ ] 所选 lyricBlur 行角色、普通行筛选、位置换算、三个文本资源和稳定 native agent ABI 均已核对。
• [ ] 只为 Line 文档的两个有效 Person/Other（至少一 Person）分侧；首个实际 Person 原文决定主侧，Group 行、未知/单声部、更大阵容及 Word 文档恢复原生布局。
• [ ] 每次绑定重算主文、译文、音译的物理侧与 pivot，保留 textDirection、尺寸、边距及时间；一次性布局回调只读当前 view，不保留 native 指针或跨歌曲侧别缓存。
• [ ] 内容 payload 回到完整绑定，其他 payload 不改对齐或 pivot；滚动复用、混合脚本、翻译/音译切换及开关重启须按人工场景核对。

4.7 字体与歌词面板复制章节链接

维护规则 · 人工场景

• [ ] 普通/逐字/资源行、binding/adapter、右栏宽度/度量和行监听接入完整。
• [ ] 后台字体准备、重试、就绪状态、重建与原字体恢复分别有依据。

4.8 玻璃导航、mini与sheet复制章节链接

维护规则 · 人工场景

• [ ] 精确玻璃/API/形态资格，导航模型/getter/callback与资源已核对。
• [ ] 手机/平板导航、抽屉、mini与采样区域按真实树接入；菜单与布局就绪分别有据，平板顶栏的单抽屉按钮占位保持原生，材质展开、锚点/玻璃承载均无待布局且宽高一致、Compose内容度量有效后才接管。
• [ ] 窗口/配置变化及导航暂时透明时仍跟随锚点；几何同步后的同一就绪结果控制原生显隐、玻璃透明度与背景采样启停，布局未稳定时恢复原生且无双导航重叠。
• [ ] sheet状态/peek/settle/坐标刷新与原生动画终点、基线恢复有证据。
• [ ] 若声明 collapsedPeekMode=offset，已证明当前 setter 的完整副作用；只在当前owner、固定peek、稳定收起且无待布局时偏移，其他状态/关闭恢复沿原生 setter。
• [ ] 若声明 contentBackdropNode，完整字段与原生录制更新时机有据；唯一子树、坐标/尺寸/显隐及就绪门禁、View回退和宿主节点所有权正确。
• [ ] 预绘制中的裁剪/留白 setter 仅在值变化时调用；已核对原生列表同值写入是否仍请求布局，避免持续布局/采样循环，且原值捕获、宿主真实变更接管与关闭恢复保持正确。
• [ ] 共用mini启动的显示/登录/当前对象条件、调用形式及有界任务与root归属正确。

4.9 底栏收缩与渲染复制章节链接

维护规则 · 人工场景

• [ ] 独立收缩能力与手机/非平板形态成立，设置通过语义桥查询。
• [ ] 原生位移和Compose方向边界由绑定提供，实际容器/语义owner及缓存失效有据。
• [ ] 层级发现止于外层滚动目标/Compose场景，不展开列表行；pager承载继续深入，隐藏Compose显隐仍可识别，旧目标padding可恢复。
• [ ] 资格、接入与收缩配置共用会话设置快照，短周期和前台恢复刷新有效，重复布局不重复解码。
• [ ] 长列表非末尾的留白更新可合并至停稳，到末尾/短内容/未知边界/新目标/几何与前台变化立即同步；导航和mini局部测量不传播整页布局或抑制原生输入。
• [ ] 原生导航触摸隔离、mini原生输入、搜索身份及共享几何的当前形态前提已核对。
• [ ] 收缩与sheet校准、导航切页/配置/关闭恢复的边界正确；新leading/高度变化已单独分析。
• [ ] 可见标签仍由 BasicText 绘制，并由 onTextLayout 按 tab ID 保存最近一次原始约束与 TextLayoutResult；表随菜单、样式、配置、字体 resolver、密度或方向变化重建，容量限于当前菜单。
• [ ] 隐藏折射标签仅在文字、样式、字体状态（无 stale）及原始约束匹配时复用可见结果；不匹配或隐藏层先测量时由 BasicText 独立测量回退。refractionContent 默认仍使用原 content，仅 GlassNavigation 收缩路径传入替代文字绘制；可见与折射内容的图标、绘制/着色、触摸、图层及原单行省略号、基线、命中、选中和无障碍语义分别保留，原生列表与宿主契约边界不变，未承诺固定命中率或统一减半。
• [ ] 折射文字复用命中时已按结果尺寸测量、放置真实绘制节点并保留基线；未命中时只放置原 BasicText，不依赖空 placement 或未放置子树绘制。人工检查各选中标签、切页、展开/收缩及配置变化后的文字、着色与折射源完整性。
• [ ] 若改输入/动画/材质或同步上游，已登记第5节通用维护结论；性能说法有目标设备证据。

4.10 导航一级页面启动预热复制章节链接

维护规则 · 人工场景

• [ ] 精确能力、契约版本与当前手机/平板导航资源同时满足，未登记形态不安装。
• [ ] 原生按标签隐藏保留、tab模型/checked、参数/导航图及真实hostResource有据。
• [ ] tabArgumentKey/titleArgumentKey 已追溯当前包的参数写入/读取与常量初始化，完整键值和Bundle值类型一致；Class.getName拼接键已确认实际引用类，未因描述符通过而沿用旧值。
• [ ] 隐藏播放上下文/资料库事件保护的线程与同步归属符合当前包。
• [ ] 一次一事务、实际视口预布局、恢复实例复用、独立超时及旧root停止明确。
• [ ] 安装、排队、页面完成数量与具体停止原因分开记录，未以ACTIVE代表预热完成。

4.11 平板布局、视频与恢复复制章节链接

维护规则 · 人工场景

• [ ] 精确构建与开关符合资格；Activity的is_tablet/横屏、Fragment的宽度至少600dp/宽大于高/原生drawer分别有据，实际窗口/inset/DPI输入正确。
• [ ] 原生角色和SONG/QUEUE两种父链符合资源/binding证据，未用错误参数类型。
• [ ] 独立歌词 Fragment 保留而 View 重建时，adapter 创建、LiveData 观察及同指针安装去重有当前构建证据；若声明 fragmentLyricsRuntime.fields.installedPointer，owner、类型、可写性与读写语义闭合，仅在独立右栏原生 onCreateView 前使旧安装标记失效，未在普通 resume/逐帧刷新清除，也未猜用其他构建字段。
• [ ] 原生设置返回后不切歌即可恢复同曲原生/补全歌词；关闭自定义歌词、连续往返设置及正常切歌分别验收，保留既有结果通道和指针所有权，未通过重复请求或直接重入安装补偿。
• [ ] 共享布局使用当前CSS视口策略，封面基准与实际调用一致，原生scale/动作保持。
• [ ] 当前页面族的音量/输出、原生footer、模式契约/右下代理范围明确，收起命中分别按CSS尺寸、dp下限与可用空间判定，几何失效和恢复归属完整。
• [ ] 视频外框、静态基准、目标及resize先后有证据，零尺寸与迟到owner分别处理。
• [ ] QUEUE定制渐变按实际调用路径判定；getter/双数组setter/nullable positions、覆盖footer与单实例降级有据，未将共享类全部行为推定为两族均可用。
• [ ] 若改布局策略/交互，已登记第5节并覆盖矩阵的断点/密度/多窗口与恢复场景。

4.12 名称修正表面复制章节链接

维护规则 · 人工场景

合并行填写时仍分别给每个表面结论，不以一个表面代替另一表面。

• [ ] 实际目录接口/返回、类型别名与附属成员已核对，原地区/原名/ID/缓存语义保持。
• [ ] 未播放歌曲的原生 genre 已进入统一解析；未知/失败结果采用可见触发的有界退避，新身份/地区证据才清负状态，重绑不会清退避。
• [ ] 身份阶段、后续批处理分别限流，同 ID 在途合并，异常/超时释放容量，当前可见优先级和固定地区模式隔离保持。
• [ ] 派生缓存容量、弱身份登记、按类成员缓存、候选集复用及文本扫描角色门禁明确；分批动作仍执行 ID/代次/可见性复查，详细日志门控。
• [ ] 可选子组、已知降级与新回归分别报告，原生点击/跳页/封面路径保留。

Compose艺人页复制章节链接

维护规则 · 人工场景

• [ ] 角色/契约声明与独立安装组对应，部分声明缺失降级，未声明不安装。
• [ ] 方法、Success字段/构造器、views数组getter与类型关系有本构建证据。
• [ ] 状态替换/alias延迟/恢复原名的会话、pending和组关闭范围明确。
• [ ] 已核对实体/shelf/Success 判等是否包含文字；有显示变化时实际行会收到通知，不靠修改原生 ID/revision 强制刷新。
• [ ] 适用时 metadataPresentation v1 的快照工厂/读写、实体类型、lockup、Room 准备/分页行及搜索实体字段完整，实例/static、参数位置和类型关系在注册前解析；安装组降级独立报告。
• [ ] 属性 getter 的快照依赖、同别名合并、弱引用、恢复及关闭清理明确；歌曲更新不重复重建整页。
• [ ] 热门歌曲与查看全部的 Compose/StateFlow、分页 Epoxy/PagedList 分支分别闭合实体登记、查询及最终显示；搜索结果与最近搜索分别核对精确行身份。

4.13 设置、蜂窝、DPI、数据与插件复制章节链接

维护规则 · 人工场景

• [ ] 设置分类/去重、原生构造器/callback、结果桥与文件归属匹配当前族。
• [ ] 偏好列表回调或 Compose 参数变化已声明 settings.members v1 的 preferenceItems / compose 完整契约；方法归属、返回、参数和必需角色在注册前解析，旧档案未声明时仍使用已审核签名。
• [ ] 设置入口与 DPI 的组件过滤使用实际宿主；宿主类、方法和资源继续使用现有原包常量。
• [ ] 内置设置页和弹层以 miuix Compose 组件为基础，手机和平板复用页面与配置草稿，无独立旧版设置页或控件皮肤；Android 窗口、宿主入口与插件 View 的接入职责保留。模块设置窗口使用自身资源和生命周期、状态、返回分发，按宿主有效配置与语言展示；顶栏和内容随窗口尺寸与键盘调整，首页无额外副标题占位、标题留白与卡片间距协调、左右边界一致；子页进退使用 miuix 转场，返回父页恢复滚动位置。
• [ ] 实际窗口宽度达到 600dp 时显示原生 miuix NavigationRail，仅列六个设置分类且无“概览”入口，打开设置默认进入歌词管理；收起/展开使用 80dp/240dp 默认宽度，1200dp 兼容宽度下初始展开；右侧复用同一 NavDisplay 页面并填满剩余空间，无 720dp 居中限宽；窄屏保留带 MAIN 概览的单页。
• [ ] 宽屏导航栈根直接对应所选分类，分类切换替换根且不累积返回历史；一级分类页的顶栏关闭和系统返回退出模块设置，二级页返回所属分类；自动实时补全和 LLM 歌词翻译高亮歌词管理，底栏动画高亮界面与底栏。
• [ ] 窗口变窄时为现有分类或二级页补入 MAIN 根，变宽时移除 MAIN 前缀，只有 MAIN 时进入歌词管理；迁移后当前分类/二级页、共享最新草稿、各页滚动位置、全局弹层和已发起的 SAF 会话保持，返回语义随新宽度即时更新。
• [ ] 旋转、分屏、RTL 和键盘状态下，各页滚动位置与共享最新草稿保持；根 Scaffold 弹层不因分类导航换页，在途弹层和 SAF 结果仍归属于发起页；Rail 选中态、图标、文字、焦点及 RTL 排列一致。
• [ ] 分类切换、二级页进退和手势返回期间及结束后，页面和旧页视差均被裁剪在内容区内，不覆盖 Rail；全局弹窗仍能覆盖整个模块窗口。
• [ ] 各页说明/帮助弹窗的段落与通用提示沿同一内容边界对齐，无额外页面分组缩进；深浅主题使用正常正文前景色，长说明可滚动且确认按钮固定，页面摘要与禁用层级不受影响。
• [ ] 插件名称、元信息、状态及操作边界一致，状态无重复且真实诊断、运行版本和待重启提示仍可见。
• [ ] 小白条区域透明、无分割线；正文可滚动经过导航区且末项可完整滚至安全区域。深浅主题切换、横屏侧边、三键导航、键盘及弹层无重复 inset，宿主窗口外观保持自身状态。
• [ ] 设置窗口打开与用户关闭有连续转场，方向随布局方向镜像并尊重系统动画时长；退场中不接受新操作，宿主销毁或更换时立即释放窗口，不等待动画。
• [ ] 歌词快捷操作在统一圆角区域内等宽横排、用竖线分隔，搜索紧邻同组列表，加载更多与搜索框的宽度、高度、圆角和主题底色一致，左右边界对齐；首屏最多 20 条，每次加载更多增加 50 条（20→70→120），筛选结果由空恢复时重新显示最多 20 条，同条件刷新保留已展示窗口并按结果总数收敛；编辑表单紧凑且固定确认区在小屏、放大文字和键盘下可用。来源排序的非拖动行无额外蓝色高亮，长按反馈与连续位移保持；松手后归位、底色及缩放同步恢复，无黑色浮框或矩形按压层残留；取消不保存，动画不改变来源约束。
• [ ] 键盘、嵌套弹层、设置页依次消费返回；同页刷新不触发切页，窗口销毁时释放弹层及其会话。
• [ ] 文件结果只交给发起设置会话；编辑器关闭后的 TTML 结果不进入直接导入路径，第三方插件页面关闭时释放插件设置会话。
• [ ] 蜂窝独立资格与原生登录/availability、DPI宿主范围及失败边界正确。
• [ ] LLM 二级页直接显示思考字段选项；切换、返回和重开后格式持久化。按格式显示开关和支持的档位，不发送时隐藏相关控制；恢复原格式仍保留已保存且可用的值。
• [ ] 配置/资产/缓存/迁移与ZIP兼容范围明确，格式变化有独立迁移/回退。
• [ ] 普通宿主设置跳过独立及旧内联歌词索引；歌词消费者走独立后台索引，完整解码保留导入/迁移语义。
• [ ] 公共SDK/插件生命周期及通用Hook注册记录保持，业务未带入宿主私有接口。

5. 共享实现改动时的补充判定复制章节链接

纯混淆/资源更新在上面核对接缝并执行适用人工场景。只有实际改动下面的共享实现时，才逐行填写维护结论；写明未改及依据，避免把每次版本接入变成重写通用策略。

6. 安装、生命周期与失败复制章节链接

依据：安装与所有权。

• [ ] 资源与Application后安装顺序明确，基础设施失败停止依赖项。
• [ ] 仅改包名场景中，module.prop 为 staticScope=false、scope.list 保留 com.apple.android.music，并在 LSPosed 手动选择改名后的宿主。
• [ ] 必需解析先于activate，失败/close后的回调原生透传且状态如实上报。
• [ ] HLE父/子组、后加getter与Hook注册记录同归属，可选缺口不伪装成功。
• [ ] view/config变化先关旧再发新，监听/observer/动画/延迟任务清理完整。
• [ ] 仅恢复仍拥有的最后写入，原生后续值保留，热路径不发现新反射。
• [ ] 网络/文件/字体/TTML仍在既有后台路径，旧异步结果不操作新会话。

7. 人工验收、交付与回退复制章节链接

按功能覆盖表跳转矩阵执行全部适用场景，结果复制记录模板保存在任务记录；本清单不再维护第二套人工步骤。

• [ ] 全部适用域有明确状态，未执行/不适用/已知降级没有填成通过。
• [ ] 实际宿主包名、TargetBuild 版本、profile 原包及人工结果分别记录，启用资格/运行时状态与证据一致。
• [ ] 配置/数据/插件协议的兼容或迁移范围与交付物相符。
• [ ] 新tuple/能力停用、原生恢复与代码/产物回退方法明确。
• [ ] 通用文档仅更新规则和判据，单次分析/结果留在任务记录，旧冻结基线未无据改写。

---

在 GitHub 查看事实来源