YoPlayer173 · 首页模块与季集生命周期重构

YoPlayer173：首页模块与季集生命周期重构

2026-11-09，Skin2026.10.3.173 / Home1.0.59。基于公开169完成已确认的A、B1、B2、C0、C1方案。
先安装Home，再安装Skin；沿用现有媒体库、键位、观看记录与偏好，不需要重新扫描或清库。

主要变化

• 检查、CI与打包使用同一版本合同登记，未知现代版本明确拒绝，旧合同与交付档案保持原字节。
• 共用URL与原生媒体条目集中到plugin_paths/media_items，首页和搜索各自集中查询、缓存与发布。
• provider保留公开路由及目录结束职责；19条路由的正常原生事件/RPC轨迹与B1一致。
• 修复过期widget请求绕过RowRevision、覆盖新栏目错误提示的问题。
• 季集控制器按单窗口实例整理初始化、请求、目录确认、选中发布和退出；保留原Monitor、原生导航及两次迟到校验。

没有增加播放器、解码、系统或内核功能。插件ID、字体、许可、控件/窗口属性与播放绑定保持。
实施细节见方案、B1、B2、C0、C1。

验证与部署

218项运行回归、16项独立合同/真实CLI打包检查通过，仓库结构、严格引用、主题只读生成器及PR CI通过。
31个季集合成场景的完整属性、RPC、焦点及终态事件与172一致；关键守卫临时移除可被对应测试捕获。
两端均由169/Home56升级到173/Home59：11个文件修改、4个模块新增、零整文件删除，完整1,638成员等交付包。

CE正常退出后，新备份1,728成员在设备和本机逐项核验。实际检查覆盖：

• 首页11个GIF封面路径、左右导航、进入分库和Back；有效截图1张，黑帧2张排除。
• 搜索结果和计数、修改关键词、取消保留原词、空结果；18分类、150条分类结果、空筛选及25条继续观看。
• 隐藏栏目返回空目录，原显示设置恢复；正常选季/全部集、连续快速切季、子菜单取消。
• 直接进入指定episode、关闭后重开另一剧集，新窗口身份与选中DBID正确。

真实观看/续播保持；视频数据库仅version维护表变化。原三队列、音量、首页焦点及各行位置、两剧季记忆、
隐藏bool和3项展示字符串均按本轮原值恢复。设置语义、JSON/keymaps/Home用户文件保持，GUI仅uptime变化。
一次恢复回传超时后，fresh只读确认已经完成且没有残留进程，没有重复恢复。
10个临时观察文件归档并逐成员核验后清理，远端仅保留当前备份；退出保护已撤销，Kodi正常运行。

Windows辅助目标新备份1,697成员核验后停止态同步，35个保护文件及kodi.exe字节保持，保留停止状态。
本轮没有播放、扫描、数据库恢复或真实已看写入。Windows结果不替代CE验收。

验证限制

日志保留4条加载期间的原生焦点错误（Kodi日志级别为error <general>；详情9001三条、视频列表525一条）。
后续焦点、选中与返回检查通过，已检查记录中未发现provider/Python运行失败。
尚未独立复现并对照169确定这4条错误的根因，不能据后续交互通过认定其无害，也不宣称日志零错误。
单张有效截图不能证明动画时序；实体电视、遥控与CEC仍需人工验证。测试数不是源码覆盖率，重构未证明提速。
本轮使用单季实际样本验证季/全部切换；特别篇、稀疏季号、已看刷新迟到等场景由合成测试覆盖。

下载与升级

文件	SHA256
YoPlayer-Skin-2026.10.3.173.zip	f2382affc3f046b003ba035ff90bc214ef1d1e3db18431a30f04c6951a4886f6
YoPlayer-Home-1.0.59.zip	af9aaf8d553af2fc356f107f611ce6e1317909769dc9988d708f34b9fad9d1b2

附件另有SHA256SUMS.txt与YoPlayer-173-retired-files.json。两ZIP复用已部署验证的原字节；Home59复用B2原包。
退役附件同时明确本轮无路径删除，并保留较旧安装升级所需的168历史9路径清单及旧哈希；不可删除userdata或整个插件目录。
安装见说明，维护效果见重构后评估。

旧代码退役清单

旧实现	替代位置	引用、运行包与设备状态
provider的plugin_url/detail_path/movie_item/media_entries	plugin_paths/media_items	正式调用者迁移，旧函数体删除，无包装副本；ZIP及两端一致
provider首页查询/缓存和路由主体	home_directory	查询AST保持，原位置删除；ZIP及两端一致
provider搜索查询/缓存/输入/发布主体	search_directory	取消、状态归一及lazy评分保持；ZIP及两端一致
provider季/轨道分支	同文件私有处理函数	目录结束仍由provider负责；ZIP及两端一致
start中的生命周期长分支与嵌套switch	同文件_SeasonSession与纯选择/请求函数	公开命令与原属性保留，旧实现替换；ZIP及两端一致
get_genres / filter_legacy_history	原provider保留	home_settings/history仍有实际调用，未作删除

本次相对169无整文件、XML、控件、字体或图片退役，无需删除新的设备路径；两端运行树和新增模块已完整核验。
原版baseline/reference和历史交付包保持原字节。

复核结案与169→173对比见结案报告。