Fntv-Plus v3.7.0

Fntv-Plus 更新日志

v3.7.0 (2026-09-14)

本次更新以体验优化与问题修复为主：首页加载更顺滑、整机卡顿与动画迟滞根治、弹幕体验全面打磨，新增「自定义刮削」与季行翻页箭头，并根治季页选集只显示 11 集等问题，共修复 23 项。

✨ 新功能 / 体验改进

• 首页轮播加载体验重做：打开首页时原生内容立即显示，轮播位置提前留出并显示骨架卡，骨架内实时显示「加载中… N%」进度条，加载完成后无缝替换为真实轮播——彻底告别白屏闪烁、全屏遮罩与突跳替换。
• 自建弹幕接口（danmu_api）：弹幕优选源新增自建接口支持，命中即用，未命中自动降级内置 B 站弹幕；服务地址仅存于设置面板，不落配置文件与日志。
• 网页弹幕手动搜索：弹幕弹窗新增手动搜索段，展开后自动按番名搜索候选取前五条可直接拉取项，点选即刻上屏并记住选择。
• 弹幕接口分层诊断：接口测试扩展为超时 / 重复 / 关键词 / 三跳 / 代理五档可配，DNS、TCP、TLS、首字节逐层结论实时上屏，出问题能直接看到断在哪一层。
• 网页弹幕弹窗重做：照抄飞牛 Semi 原生弹层容器——真 Switch 开关、进出场动画、折叠菜单式布局，来源详情一览无余。
• 侧栏快捷操作面板：默认收起为一排可直接点击的图标（设置 / 观影记录 / 切换系统 / 反馈），支持折叠记忆，不再遮挡左侧分类文字。
• 详情页序号视图适配：纯数字选集（序号网格）也走美化布局，数字块带发丝线、圆角与悬停微浮，当前集有品牌色描边。
• 云母增强叠液态玻璃质感：磨砂组件底缘暗折射线、悬停镜面高光（静态化后零开销）。
• 版本号更新机制全新升级：更新类型改由版本号增量直接判定——第三位增加（如 3.7.0 → 3.7.1）为热补丁，应用内即可完成更新；第二位或第一位增加（如 3.7.0 → 3.8.0 / 4.0.0）为全量包更新，引导下载完整安装包。同版本号有热补丁不再重复提示。
• 热补丁机制完善：补丁包收集范围扩展（共享模块全部纳入），require 解析改为覆盖层优先——共享模块与插件子模块的热修复真正可靠生效。
• 设置面板新增「自定义刮削」分类（自 Web 版 fpk 移植，六卡对齐）：
  • 自定义刮削源：把季标题/季号/TMDB 等锚点发给自建刮削服务，返回的分集标题/简介回填飞牛（只填空/覆盖占位/中文覆盖英文，绝不倒打已有中文；写回带字段锁）。请求由桌面端代理发出，服务无需配置 CORS。
  • Jav 刮削（独立卡，默认关）：电影文件名含番号时详情页出现「⟳ jav 刮削」按钮，按番号从 javbus 查询回填标题（锁定防覆盖），封面就地替换（仅本地视觉）。
  • Fanart.tv 高清 Logo：TMDB 拿不到可用透明 Logo 时自动兜底官方高清 Logo（轮播标题替换 + 详情页 Logo 回填两处生效）。
  • TVMaze 分集兜底：「补全集信息」在 TMDB 缺英文标题/简介或整集缺失时自动用 TVMaze 官方 API 补英文（免 Key，国内直连）。
  • OMDb IMDb 评分 / MyAnimeList 官方：API Key 配置卡就绪（评分展示与跳片头映射链消费点后续接入）。
  • 分类页顶置「🚧 功能开发中，未正式生效」横幅，明示整体仍处验证期。
• 季行翻页箭头：剧集一级页季选择行两侧新增无背景雪佛龙箭头，点击整屏平滑翻页；超过 4 季才出现，解决横滑行滚动条隐藏后后面的季无法到达的问题。
• 「Bangumi 补全」按钮：季页新增按标题匹配 Bangumi 条目、逐集回填中文标题/简介（三段式拉取，实时进度反馈）。

🐛 修复

• 修复首页轮播骨架卡死不动（进度条停在 99% / 0% 永不进入轮播）的死锁：数据就绪早于页面就绪时收尾动画被误杀，已修复并加看门狗自愈兜底。
• 修复整机发卡：首页常驻无限动画把 GPU 合成器钉成 60fps 永动（空闲 GPU 进程占用 40~80%），加载态动画全部有限化，页面静止后 GPU 占用归零。
• 修复「所有动画慢吞吞一段一段」：移除鼠标跟随高光引发的全页样式重算风暴（悬停期渲染负载 80%+ → 39%）。
• 修复未识别视频占前排时首页轮播获取不到内容、进度条永久卡 99%（数据主源切换为 item/list API，服务端直接过滤非影视项）。
• 修复首页「已入库」角标永不亮、点卡片恒跳外链的问题（同上根因，库索引改走 API 主源，构建从 14 秒降到一次请求）。
• 修复 MPV 播放完全完毕后「重新播放」点击无效的问题。
• 修复「其他」分类视频播完点「重新播放」后播放列表丢失的问题（电视节目一直正常）；现在同文件夹视频与多集内容重播都会恢复完整列表。
• 修复深色模式下所有弹出窗口（编辑元数据等）整体发白的问题。
• 修复 MPV 搜索弹幕时候选标题显示乱码的问题（Windows 代码页差异，已与机器编码解耦）。
• 修复剧集详情页（含序号视图）文字排版问题：选集区溢出换行、演职人员头像行被错误折行堆叠等。
• 修复 MPV 拿不到 NAS 外挂字幕、「加载字幕」只能列本机磁盘的问题。
• 修复退出网页播放后弹幕层冻结残留、收起延迟两三秒的问题。
• 修复自建弹幕源模糊匹配挂错弹幕的问题（改为只认精确匹配）。
• 修复网页播放器起播 / 缓冲时白圈闪烁的问题。
• 修复弹幕弹窗搜索框被磨砂效果误伤成灰白玻璃块的问题。
• 修复 Trakt 面板全部按钮无响应（IPC 通道注册方式错误）。
• 修复开机整窗底色全透需手动强刷的问题。
• 修复播放页云母增强覆盖层（粒子 / 噪点 / 暗角）压在视频画面上的问题。
• 修复重复启动时「程序已在运行」弹窗（改为自动聚焦到已运行的窗口）。
• 修复 thumbfast 进度条悬停缩略图配置从未写入、Trakt 实时同步静默失效的问题。
• 修复剧集季页「选集」最多只显示 11 集的问题（根治）：原生选集带是「数据按页拉取（30 集/页）+ 横向虚拟窗口」双层裁剪，美化竖排后横向滚动死亡、窗口冻在首屏。现改为分区模式：第一分区（1 - 30）一次性全部竖排显示，点工具行「31 - 48」页码切换下一分区（同样全量显示），切回正常；列表不再有任何横向游动。
• 修复首页轮播海报错位：隐藏的库索引抓取 iframe 里也会启动一份轮播，与主页面双份并发互相踩踏导致海报顺序错乱；现在轮播只在真实顶层页面运行，并发请求合并为单飞。
• 修复构建偶发失败（EBUSY：打包目录被文件监视/杀软扫描占用）——打包前自动清理旧产物目录并在占用时自动重试。

🔧 优化

• 性能大幅提升：空闲 GPU / 渲染进程占用从 40~80% 双双降到接近 0%，悬停渲染负载减半，老旧机器也能流畅运行。
• 轮播与库索引数据源：主源统一切换 item/list API，一次请求到手，不再依赖隐藏页面滚动抓取，加载更快更稳。
• 播放页视觉净化：云母增强的全屏装饰层不再覆盖视频画面。
• 诊断能力增强：轮播关键链路、弹幕分层诊断等日志全部可在 app.log 取证，便于远程排查问题。
• 构建链：安装器画稿生成正式接入 build:win 构建流程（build:nsis-art），画稿与代码同步产出；TMDB 季集数据补透传播出日期，供「补全集信息」在集号缺失时按播出日期唯一匹配兜底。

---

💻 支持平台

• ✅ Windows (x64)
• ✅ macOS (Intel & Apple Silicon)
• ✅ Linux (x64 & ARM64)

📥 下载指南

平台	文件类型	说明
💻 Windows	.exe	由维护者手动上传至本 Release（不通过自动构建）
🍎 macOS	.dmg	磁盘镜像，安装后执行: sudo find "/Applications/Fntv-Plus.app" -exec xattr -d com.apple.quarantine {} \; 2>/dev/null
🐧 Linux	.AppImage	便携应用，添加执行权限后直接运行。弹幕与播放器配置已内置，仅需自行安装 mpv（要求版本 > 0.37.0）

📦 更新机制说明（v3.7.0 起生效）

• 所有平台安装包均在 GitHub Release 下载
• 更新类型由版本号增量自动判定，无需再区分安装包标识：
  • 热补丁更新：版本号第三位增加（如 3.7.0 → 3.7.1），应用内弹窗点击「应用补丁」即可完成，重载生效，无需下载全量包；
  • 全量包更新：版本号第二位或第一位增加（如 3.7.0 → 3.8.0 / 4.0.0），应用内引导前往 GitHub 下载完整安装包覆盖安装。
• 同版本号的热补丁重复发布不会重复提示。
  💡 Windows 版本由维护者手动上传，本 Release 的 macOS / Linux 安装包由 GitHub Actions 自动构建并发布。

---

自动构建于 GitHub Actions 🤖