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 🤖

Fntv-Plus v3.6.0

Fntv-Plus 更新日志

v3.6.0 (2026-09-06)

本次更新重点带来三大体验升级：全新首页轮播、沉浸式剧集详情页（一级 / 二级），以及演员信息页「一键查作品 + 是否入库」；同时重做播放逻辑与设置面板，并修复若干播放问题。

✨ 新功能 / 体验改进

• 全新首页轮播：默认采用立体堆叠的 3D 旋转木马样式，海报更大更聚焦，切换带有流畅的 3D 纵深动画；也可在设置中切换为滑动、卡片堆叠等其他样式。
• 沉浸式剧集详情页（一级 / 二级）：剧集页与季页均采用 Netflix 风格的两栏布局——左侧选集、右侧剧集信息与演员墙，并配有全屏背景海报；支持剧照点击放大，可一键补全每集的简介信息。
• 演员信息页「一键查作品 + 是否入库」：在演员页面新增「TMDB 完整作品」面板，点击即可查询该演员的全部影视作品；每部作品都会标记是否已收入你的影视库（库中作品带绿色徽章并可点进详情，未入库作品灰显并提示去 TMDB 查看），还支持「只看未入库」快速筛选。
• 云母增强玻璃质感界面：全新的磨砂玻璃视觉风格，让界面更具层次感（默认开启，可在设置中关闭）。
• 主界面 Logo 自定义化：首页顶部 Logo 支持切换为内置的多种海内外流媒体品牌标识（如 Netflix、Disney+、HBO 等），也可自行上传图片，并一键恢复默认。
• Trakt 观影记录同步：可将观影记录同步到 Trakt——已看完的电影、已看过的剧集集数，都会写入你的 Trakt 历史，方便跨平台统一记录。
• 自动连播与「下一集」倒计时：看完一集自动提示并播放下一集，体验对标主流流媒体。
• 智能跳过片头 / 片尾 / 前情：接入更多数据源，跳过覆盖更广、更准确。
• 设置面板全面升级：分类更清晰、采用 iOS 风格开关、支持搜索，并新增浅色主题。
• 年度观影报告：生成可分享的年度总结报告，并可导出为长图。
• 无障碍与多语言：新增键盘焦点高亮、屏幕阅读支持，并支持简体中文 / 英文切换。
• 安装与卸载界面美化：采用液体玻璃风格，并加入品牌闪屏动画。

🐛 修复

• 修复点击播放弹出「选择播放器」时页面出现白屏闪烁的问题。
• 修复使用 MPV 播放时白屏只有声音的问题。
• 修复在网盘 / 远程环境下播放偶发失败、一直转圈或卡顿的问题（百度、115、SVIP 直链等更稳定）。

🔧 优化

• 出厂默认更改：浅色主题、TMDB 免梯子直连（强烈建议开启，避免无法获取tmdb数据）、云母增强均默认开启，开箱即用。
• 视觉风格统一：全局配色由旧粉紫调整为冷调渐变玻璃风格。
• 播放体验提升：新增 MPV 画质预设（性能 / 均衡 / 高画质）、进度条悬停预览缩略图、倍速与音量跨集记忆。
• 弹幕接口可自定义：弹弹 play 获取弹幕支持填写专属 API 凭证，避免因公共接口限流而拉取失败（404）。
• 手动补全集信息：季页选集支持一键触发补全——当飞牛没能刮到某集的标题 / 简介时，可从 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）

📦 包命名说明

• 所有平台安装包均在 GitHub Release 下载
• -full 全量安装包：用于首次安装或完整覆盖更新，文件名形如 Fntv-Plus_3.6.0-full_win_x64.exe（含系统与架构）。
• -hotfix 热补丁包：应用内通过弹窗获取、重载即生效，无需下载全量包；包标识 -hotfix（如 patch-3.6.0-hotfix.json）。
  💡 Windows 版本由维护者手动上传，本 Release 的 macOS / Linux 安装包由 GitHub Actions 自动构建并发布。

---

自动构建于 GitHub Actions 🤖

Fntv-Plus v3.5.0

Fntv-Plus 更新日志

v3.5.0 (2026-08-25)

本次更新以稳定性与体验优化为主，重点新增「手柄控制」与「影视观影记录」两项功能，并修复若干已知问题。

✨ 新功能 / 体验改进

• 新增手柄控制：支持使用游戏手柄在应用内导航与操控播放。
  • 焦点导航：以高亮白框替代鼠标指针，方向键移动焦点、A 键确认（等效点击），无需鼠标即可完成界面操作。
  • 媒体控制：通过手柄即可控制播放 / 暂停、快进快退、音量等。
  • 自定义映射：设置面板新增「手柄」分类，可对手柄按键进行个性化映射。
• 新增影视观影记录：新增「观影记录」面板，集中回顾你的观看足迹。
  • 分区展示：按「已看完 / 在观看」分区，含封面、标题、总时长与最后观看时间。
  • 评分展示：已打分的作品在封面标题上方显示五角星评分。
  • 观影活动热力图：支持 年 / 季 / 月 / 周 多范围切换，直观呈现每日观看活跃度（正方形小格子，无数据日期以浅白占位）。
  • 详情跳转：在作品详情页点击「查看详情」可直接跳转至飞牛影视内对应作品详情播放页。

🐛 修复

• 修复若干已知问题，提升整体稳定性与界面交互体验。

🔧 优化

• 热更新机制完善：优化完善热更新补丁包安装覆盖机制。

---

💻 支持平台

• ✅ 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）

📦 包命名说明

• 所有平台安装包均在 GitHub Release 下载
• -full 全量安装包：用于首次安装或完整覆盖更新，文件名形如 Fntv-Plus_3.5.0-full_win_x64.exe（含系统与架构）。
• -hotfix 热补丁包：应用内通过弹窗获取、重载即生效，无需下载全量包；包标识 -hotfix（如 patch-3.5.0-hotfix.json）。
  💡 Windows 版本由维护者手动上传，本 Release 的 macOS / Linux 安装包由 GitHub Actions 自动构建并发布。

---

自动构建于 GitHub Actions 🤖

Fntv-Plus v3.4.1

Fntv-Plus 更新日志

v3.4.1-hotfix (2026-08-20)

本次更新修复电视直播 / 其他视频调用外置播放器失败的问题，优化界面显示与数据获取逻辑，并新增自定义界面选项与 MPV 快捷重播。

✨ 新功能 / 体验改进

• 新增自定义界面选项：设置中新增「自定义界面」入口，可对界面外观进行个性化调整。
• MPV 新增重新播放按钮：MPV 播放器新增「重新播放」快捷按钮，一键重播当前内容。

🐛 修复

• 修复其他视频调用外置播放器失败：修复部分「其他视频」调用外部播放器失败的问题。
• 修复电视直播源调用外置播放器失败：修复播放电视直播源（黑屏 / 无法播放）调用外部播放器失败的问题。
• 修复主进程热补丁加载失败：修复旧版本无法正确加载主进程补丁的问题，使热补丁可正常生效（含直播绕过逻辑）。

🔧 优化

• 优化深浅模式卡片显示：优化浅色 / 深色主题下卡片的显示样式，文字与背景对比更清晰。
• 优化每日放送卡片数据获取：优化「每日放送」卡片的数据获取逻辑，加载更稳定、刷新更及时。
• 优化首页轮播图加载显示：优化首页轮播图的加载与展示效果，切换更流畅。
• 优化轮播图海报兜底：轮播图海报获取失败时显示更友好的占位图，不再出现裂图或空白。
• 优化设置页面按钮显示：优化设置页面部分按钮的显示逻辑，减少误触与显示异常。

---

💻 支持平台

• ✅ 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）

📦 包命名说明

• **所有平台安装包均在 GitHub Release 下载
• -full 全量安装包：用于首次安装或完整覆盖更新，文件名形如 Fntv-Plus_3.4.1-full_win_x64.exe（含系统与架构）。
• -hotfix 热补丁包：应用内通过弹窗获取、重载即生效，无需下载全量包；包标识 -hotfix（如 patch-3.4.1-hotfix.json）。
  💡 Windows 版本由维护者手动上传，本 Release 的 macOS / Linux 安装包由 GitHub Actions 自动构建并发布。

---

自动构建于 GitHub Actions 🤖

Fntv-Plus v3.4.0

Fntv-Plus 更新日志

v3.4.0-full (2026-08-17)

本次更新重点上线 热补丁更新机制：用户通过弹窗获取补丁后，重载应用即可生效，无需下载全量包覆盖更新；同时修复多项问题并优化界面动画。

✨ 新功能 / 体验改进

• 上线热补丁更新机制：用户通过弹窗获取热补丁（包标识 -hotfix）后，重载应用即可生效，无需下载以 -full 标识的全量安装包覆盖更新；应用补丁后侧栏 / 关于页版本号同步显示为补丁版本。

🐛 修复

• 修复应用补丁弹窗误报「发现新热补丁」：当已是最新且无新补丁时不再误提示
• 修复关闭向导后遮罩残留、需点两次才退回侧栏：应用补丁 / 测试更新向导关闭时统一调用退出设置面板，一次性正确退回侧栏，不再残留遮罩层。
• 修复列表页（全部剧集）路由返回后居中失效：进入多季剧集详情页再退回列表页时，列表居中布局第二次失效的问题已修复（布局锁定机制改为绑定真实 DOM 节点，详情页清除标记时一并清空锁）。
• 修复飞牛影视个人视频库消失问题：修复个人视频库偶发不显示 / 消失的问题，确保进入影视界面时个人库正常加载。
• PotPlayer 播放 strm 失败初步修复：初步修复 PotPlayer 播放 strm 直链失败的情况，提升外置播放稳定性。
• 修复特定情况下详情页显示异常问题：修复某些情况下详情页布局 / 内容显示异常的问题。
• 优化 B 站弹幕匹配电视剧逻辑：优化 B 站弹幕对电视剧的匹配策略，减少误匹配与漏匹配。
• 修复特定情况下首页重复刷新问题：修复某些情况下首页重复刷新的问题，避免重复拉取与闪烁。

🔧 其它

• MPV 插帧新增 N 卡档：适配 RTX 50 系驱动级 Smooth Motion（呈现上下文 winvk，需在 NVIDIA App 按 exe 注册 mpv.exe 并开 SM 后生效）；同步修复此前误用 D3D11 导致无效的问题。
• 优化界面动画：卡片 / 按钮入场改用 anime.js 引擎（v4.5.0），新增 stagger 错落入场与更顺滑的过渡效果，并保留 CSS 降级兜底保证兼容性。

---

💻 支持平台

• ✅ 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）

📦 包命名说明

• -full 全量安装包：用于首次安装或完整覆盖更新，文件名形如 Fntv-Plus_3.4.0-full_win_x64.exe（含系统与架构）。
• -hotfix 热补丁包：应用内通过弹窗获取、重载即生效，无需下载全量包；包标识 -hotfix（如 patch-3.4.0-hotfix1.json）。
  💡 Windows 版本由维护者手动上传，本 Release 的 macOS / Linux 安装包由 GitHub Actions 自动构建并发布。

---

自动构建于 GitHub Actions 🤖

Fntv-Plus v3.3.6

Fntv-Plus 更新日志

v3.3.6 (2026-08-11)

本次更新重点新增「切换系统原生页面」与「文件管理器一键外置播放」能力，优化每日放送时间排序并支持点击联动跳库内详情页，同时对首页轮播进行全面改版，并修复了系统页缩略图异常等多项问题。

✨ 新功能 / 体验改进

• 新增「切换系统原生页面」能力（重点）：侧栏一键将整窗从影视界面切到飞牛原生 NAS 系统桌面（文件管理、设置等原生 UI）。可自定义系统页地址（端口各异时填写，留空自动用同端口根路径）；进入系统页后全局亚克力 / 白底清除等视觉改造自动让位，原生外观零污染。
• 文件管理器一键外置播放（重点）：在飞牛原生系统页（文件管理器）选中视频时，提供显式「外部播放器打开」入口，一键调用 PotPlayer / MPV 直接播放，无需先跳回影视界面；与视频预览「🎬 外部打开」共同构成外置播放双通道。
• 每日放送（Bangumi）列表优化时间排序逻辑，并新增点击联动：默认按「今天优先」的循环星期分组展示，打开当天即见今日番组（不再固定从周一排起）；可按星期 / 按热度切换，并保留「不感兴趣」剔除与本地屏蔽。新增联动——点击卡片时若飞牛影视库内已有该剧，直接站内跳转到对应剧集详情页；库内没有则退回打开 Bangumi / TMDB 外部链接。
• 首页轮播图全面改版：重构为「左侧背景大图 + 右侧文字信息 + 右侧竖向海报条」布局；海报条与左侧轮播联动（悬停切换、暂停自动播放、选中居中放大），移除旧轮播指示点。
• 新增获取轮播 Logo 固定在海报左下角的透明 TMDB Logo（缺失 tmdbId 时按标题匹配；纯白 Logo 改为最后兜底而非硬性排除）。
• 轮播徽标文案改为集数信息：连载剧显示「全 N 集 · 更新至 M 集」，完整版显示「全 N 集」，电影显示「年份 · 电影」。
• fnOS 视频预览支持一键外置播放：预览窗口标题栏新增「🎬 外部打开」按钮，并支持自动弹出选择窗（外置播放器 / 飞牛原生），直链抓取更可靠、不再「选了就播」。
• 设置面板新增「自定义代理」（HTTP/SOCKS5 + 账号密码鉴权 + 测试连接），Bangumi 每日放送 / TMDB 可走用户自建代理；新增「免梯子直连」覆盖 Bangumi 国外源。

🐛 修复

• 修复系统页（文件管理 / 设置等原生界面）缩略图变黑框、被放大的问题：将亚克力 / 液态玻璃的背景与模糊、白底清除、max-width 等全局规则严格限定到影视页，不再污染飞牛原生 UI。
• 详情页 / 列表页布局守护限定为媒体库列表页，修复演员页（/v/person）误套、首页崩溃、详情页时宽时窄 / 左右不对称。
• B站弹幕：番剧匹配优化（国创对称番剧、含「你们」番名误杀）、开发版弹幕失效修复。
• 海报墙在实时数据抓取失败时不再消失（启用硬编码兜底）；轮播图 / 详情页 Logo 持久化磁盘缓存，已加载图片不再反复重拉。

🔧 其它

• 检查更新改为仅走国内 Gitee 检测，更新弹窗更新日志改用 Markdown 富文本渲染。
• 设置面板「关于 / 外观 / 反馈」整合，侧栏常规显示版本号；合并「问卷反馈」与「Q群反馈」为「软件反馈建议」。

---

💻 支持平台

• ✅ 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）

💡 Windows 版本由维护者手动上传，本 Release 的 macOS / Linux 安装包由 GitHub Actions 自动构建并发布。

---

自动构建于 GitHub Actions 🤖

Fntv-Plus v3.3.5

更新日志

v3.3.5（2026-08-04）

本次更新大幅增强原生播放体验：原生网页播放器正式支持 B 站弹幕；接入 The Intro Database 实现片头片尾自动跳过；右下角新增「每日放送」实时影视浮层；同时引入插件机制为后续自定义化铺路。

🐛 问题修复（5 项）

• 修复 Go proxy 未就绪导致 PotPlayer 播放失败（lc-324）：新增 Node 主进程兜底代理（fallbackProxy），彻底解决启动时序竞争导致的 PotPlayer 无法启动播放的问题。
• 修复原生网页弹幕不可见 / 控制栏按钮缺失 / 渲染卡死（lc-327~329）：修复弹幕阈值不生效、控制栏开关按钮缺失、全透明导致页面卡死等问题，弹幕现在可正常显示，并新增「详情」弹窗按钮查看来源与登录态。
• 修复弹幕跨季错配（lc-332）：弹幕匹配优先「季数 + 集数」精确匹配，根治不同季弹幕串台导致的错位。
• 修复 Cookie 过期无法识别导致弹幕数量受限（lc-336/337）：拉取弹幕前校验 B 站登录态（nav isLogin），并在详情弹窗新增 Cookie 登录态标红提示（已登录绿 / 过期红 / 未登录红），一眼定位过期问题。
• 修复剧集模式下「同目录同名外挂字幕」被误杀（lc-339）：字幕评分新增「同集信号」（SxxExx / 第 N 集），兼容季名表述差异（如「无职转生Ⅲ」vs「无职转生」），避免相关字幕被错误剔除。

⚡ 体验优化（4 项）

• 日志文件重复合并（lc-325）：短时间内同一错误不再反复刷屏写入日志文件。
• 原生网页弹幕拉取提速（lc-331）：根治约 1 分钟延迟，响应速度对齐 MPV 弹幕。
• 原生网页弹幕样式可调（lc-333）：对齐 MPV 弹幕旋钮，支持字号 / 透明度 / 速度等参数调整。
• 主界面液态玻璃视觉（mainwin.ts）：叠加液态玻璃质感，导航栏镜面高光、卡片湿润浮起、深色同步，界面更通透。

✨ 新增功能（5 项）

• 飞牛原生播放器支持显示 B 站弹幕（lc-322~326）：原生网页播放器（飞牛原声）接入 B 站弹幕，控制栏新增弹幕开关，详情弹窗展示弹幕来源与 Cookie 状态。弹幕脚本由 Python 改为纯 JS 实现（third_party/fntv-mpv/.../uosc_danmaku/bili_danmaku.js，主进程 biliRunner.ts 以 require 方式运行），彻底移除 Python 运行时依赖，部署更轻、启动更快。
• 引入插件功能为后续自定义化添加配置：新增 preload / 主进程 handler 插件自动注册机制（registerHook / registerHandler），为后续自定义插件与配置开放统一接入能力。
• 片头片尾跳过接入 The Intro Database 数据自动填充（lc-313~318 / 338）：自动从 The Intro Database 获取片头片尾时间点并填充，免去手动设置；支持 v3 接口与多路兜底。
• 右下角每日放送接入 Bangumi / TMDB / 豆瓣 实时热门影视数据（hotUpdates / bangumiSync / tmdbSync）：右下角悬浮「🔥 每日放送」按钮，展示每日放送与热门影视；支持 Bangumi / TMDB / 豆瓣 多数据源切换，可按星期 / 热度 / 最新 / 剧集 / 电影排序，并支持「不感兴趣」屏蔽持久化。TMDB 需在设置面板填写自有 API Key（默认空，不内置密钥）。
• TMDB 免梯子直连（实验）（tmdbSync / config / embyWall）：针对 api.themoviedb.org 在部分网络环境被 DNS 污染、Electron/Node 默认不读系统代理导致无法直连的问题，新增「免梯子直连」开关——内置 CheckTMDB 每日更新的可用 IP 快照，通过自定义 DNS lookup 将 api / image.tmdb.org 解析到真实边缘 IP 直连（TLS 仍用原域名，证书不受影响）；海报同步经主进程代理拉取，图片一并打通。支持设置面板手动填写 IP 与一键「从 CheckTMDB 更新 IP」，并自动每日（24h）跟进仓库最新可用 IP，无需开启梯子即可使用 TMDB 数据源。与 HTTPS_PROXY 代理方案互斥、互不干扰。

---

💻 支持平台

• ✅ 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）

💡 Windows 版本由维护者手动上传，本 Release 的 macOS / Linux 安装包由 GitHub Actions 自动构建并发布。

---

自动构建于 GitHub Actions 🤖

Fntv-Plus v3.3.4

更新日志

v3.3.4（2026-08-02）

本次更新聚焦播放器稳定性与界面体验，修复若干已知问题，并新增 MPV 窗口置顶等功能。

🐛 问题修复（11 项）

• 修复设置面板配置 MPV 默认使用着色器不生效导致的卡顿：修复部分机型勾选 MPV 默认着色器后播放初期卡顿、掉帧的问题，优化着色器配置的加载时机与生效路径，确保画质滤镜正常应用且不拖累解码性能。
• 修复「继续观看」调用 PotPlayer 播放器失败：修复从「继续观看」入口启动 PotPlayer 时因播放地址与会话鉴权未正确传递导致的启动失败、黑屏报错，现已正确透传会话 Cookie 与可读名播放地址，PotPlayer 可稳定续播。
• 修复 PotPlayer 播放列表集数重复问题：修复播放列表面板中同一集重复出现、顺序错乱的问题，现按真实集数去重并正确排序，逐集连播更可靠。
• 修复多季剧集详情页页面显示异常：修复多季（如「第一季 / 第二季」）剧集详情页布局错乱、季切换后信息显示异常的问题，详情页现可正确区分各季内容并稳定渲染。
• 修复手动匹配元数据显示内容超出容器的问题：修复剧集手动匹配弹窗中文件位置等长路径超出弹窗容器被裁切的问题，弹窗内容现已自适应容器宽度，超长路径可完整显示并支持滚动。
• 修复影视页面弹窗按钮显示异常问题：修复影视相关弹窗内按钮错位、样式异常或点击无响应的问题，弹窗内交互控件现已正常对齐并可正常操作。
• 修复启用飞牛访问码导致无法进入影视首页：修复服务端启用「访问码」后进入影视首页卡在授权/空白页的问题，现已在登录与首页加载环节正确处理访问码校验，可顺利进入影视首页。
• 修复侧边栏数字显示异常问题：修复侧边栏栏目角标（未看数量等）显示异常、数字错乱或不刷新的问题，角标现已正确统计并在内容变化时实时更新。
• 修复特定文档导致软件崩溃重置的问题：修复打开/解析特定文档时触发软件崩溃、配置被意外重置的问题，增强异常文档的容错处理，避免连带清空用户配置。
• 修复 PotPlayer 播放列表显示 GUID 乱码：修复播放列表直接显示 item GUID 原始字符串（如 1d0b8996...）而非可读剧集名的问题，列表现显示正确的「番名 - 第 N 集」名称。
• 修复使用飞牛影视网页播放导致画面黑屏不显示的问题：修复部分环境下原生网页播放出现「有声音无画面」黑屏的问题，优化网页播放的合成与渲染路径，画面可正常显示。

⚡ 体验优化（3 项）

• 优化设置页面布局：重排设置页面分区与控件间距，信息层级更清晰；将「弹幕屏蔽」整合为「弹幕设置」并补充弹幕文件管理入口，查找与操作更顺手。
• 优化首页鼠标滚动逻辑：优化首页卡片墙的鼠标滚轮滚动体验，修正滚动方向、惯性及边界回弹逻辑，长列表浏览更跟手、不再误触翻页。
• 优化 B站弹幕下载逻辑和配置：放宽同番搬运（简称 / 异译）的相似度下限提升命中率，改为单源取弹幕避免多源合并导致时间轴错位；新增「打开弹幕文件夹」入口便于集中管理，并修复弹幕脚本加载异常导致弹幕整体失效的问题。

✨ 新增功能（1 项）

• MPV 播放器添加窗口置顶功能：新增 MPV 播放窗口「始终置顶」开关，观看时可让播放窗口停留在最上层，方便边看边操作其他窗口。

---

💻 支持平台

• ✅ 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）

💡 Windows 版本由维护者手动上传，本 Release 的 macOS / Linux 安装包由 GitHub Actions 自动构建并发布。

---

自动构建于 GitHub Actions 🤖

Fntv-Plus v3.3.3

更新日志

v3.3.3（2026-07-29）

本版本主要修复了弹窗按钮消失、首页轮播白屏与误注入等界面异常，优化了 fnOS 连接报错提示与日志体验，并新增首页刷新、侧边栏 QQ 群反馈等小功能，同时提升了 MPV 的 B站弹幕匹配效果。

🆕 新增功能

🏠 首页手动刷新按钮

• 首页导航栏新增刷新按钮，可一键刷新首页与轮播内容。

💬 侧边栏 QQ 群快速反馈入口

• 侧边栏新增「Q群反馈」按钮，一键加入官方 QQ 群，方便反馈问题与日常交流。

🐛 修复

🪟 弹窗按钮与界面

• 修复创建媒体库、创建剧集、剧集手动匹配等弹窗中「确认 / 选择 / 创建」按钮消失的问题。
• 修复创建媒体库弹窗误显示首页轮播大图的问题。
• 修复轮播图被误注入到弹窗内部的问题。

🖼️ 首页轮播白屏

• 修复部分情况下首页加载时白屏卡死的问题。

🔗 连接与报错

• 优化 fnOS 连接 / 登录失败时的报错提示，现在能区分不同原因并给出对应的处理建议。
• 修复 Electron 安全警告未被记录到报错日志的问题。
• 报错日志现在会记录更多关键上下文信息，便于排查问题。

🔧 其他修复

• 修复设置面板 Bangumi 同步开关重启后显示未勾选的问题。

✨ 优化

• 日志文件生成逻辑优化：单个日志文件体积更小、保留更多份数，并新增独立的报错日志文件，方便快速定位问题。
• 媒体类型匹配范围调整：弹幕、豆瓣、Bangumi 同步现在仅针对电影、电视节目、混合影片，自动跳过电视直播与其他视频。
• 一级详情页顶部导航栏透明化：导航栏不再遮挡背景剧照，浏览体验更沉浸。

🎞️ B站弹幕（MPV）优化

• 简化弹幕匹配规则，优先选择弹幕最多的单集；弹幕不足时自动合并多个候选。
• 提升匹配质量：自动回退、优先精确单集、合集自动降权。
• 弹幕较少时支持合并多个同类视频的弹幕（可在设置中调整阈值）。
• 修复 Windows 下弹幕面板中文乱码、脚本崩溃等问题，弹弹 play 限流时给出友好提示。
• 重构弹幕配置面板，手动搜索框自动填入解析到的番名。
• 弹幕匹配日志现已接入应用日志，便于排查匹配问题。

---

💻 支持平台

• ✅ 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）

💡 Windows 版本由维护者手动上传，本 Release 的 macOS / Linux 安装包由 GitHub Actions 自动构建并发布。

---

自动构建于 GitHub Actions 🤖

Fntv-Plus v3.3.2

更新日志

v3.3.2（2026-07-27）

本版本涵盖 v3.3.1 之后的全部开发提交（lc-109 ~ lc-127）。

🎯 1. FN ID 登录（飞牛 ID）外网全面修复

• 外网切换白屏：修复切到外网后仍用持久化内网 IP 直接连接导致白屏——新增启动域名可达性预检，不可达自动回退登录页（内网仍走内网）。
• 中继选择页可点击：修复 FN Connect 中继选择页三个选项无法点击，改为窗口内导航）。
• 自动填充健壮化：修复中继通过后仍需手动再输一次账号密码——用户名/密码/登录按钮改为多级选择器。
• 官方中继转发卡死（根治）：定位 NAS 实际暴露在子域，改由主进程直接轮询拿配置、绕过页面内 WebRTC 隧道，彻底解决官方中继登录静默卡死。
• 退出重登白屏：修复登录页强制刷白底；登录页背景图改用绝对URL，退出重登也正常显示。

🎨 2. 登录页背景图自定义

• 设置面板「退出行为」下方新增 「自定义登录页面背景图」 与 「清空」 两个按钮，可选本地图片作为登录页背景，配置持久化（重启生效）。
• 默认登录背景图统一为 bg-login.jpg。

🌗 3. 深色模式与界面

• 去突兀化：深色模式下详情页按钮与标题栏进一步收敛为极淡幽灵风（提供自定义关闭按钮。）。
• 亚克力默认值：首次登录的亚克力透明度 / 背景模糊默认值统一为 30。

🐛 4. 其他修复

• 列表页右侧留白：卡片网格改为确定性居中计算，修复偏右、横向滚动、虚拟滚动反复横跳等问题。
• 播放页劫持问题：修复特定情况下播放按钮走飞牛原生播放问题，现已可正常调用默认播放器播放。

⚡ 5. 性能与体验优化

• 首页刷新策略优化（lc-127）：原每次关闭视频（含播放器异常退出）都会整页刷新首页，频繁打断浏览体验。现已改为仅在每次「启动」时随初始加载刷新一次首页；

---

💻 支持平台

• ✅ 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	便携应用，添加执行权限后直接运行。 插件前往fntv-mpv 自行安装，要求mpv版本>0.37.0

💡 Windows 版本由维护者手动上传，本 Release 的 macOS / Linux 安装包由 GitHub Actions 自动构建并发布。

---

自动构建于 GitHub Actions 🤖