# Fntv-Plus

**Repository Path**: YDMY007/fntv-plus

## Basic Information

- **Project Name**: Fntv-Plus
- **Description**: 基于飞牛影视PC桌面版二次开发的个人优化版。集成MPV和PotPlayer播放器功能，丰富的自定义外观。提供多种便利功能如豆瓣进度同步，Bangumi点格子。未来将持续开发，欢迎出各优化建议。
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: release
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-02
- **Last Updated**: 2026-09-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Fntv-Plus 飞牛影视桌面客户端 · 增强版

<div align="center">

[![Release](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fapi.github.com%2Frepos%2FYDMY007%2FFntv-Plus%2Freleases%2Flatest&query=%24.tag_name&label=release&prefix=v&color=blue)](https://github.com/YDMY007/Fntv-Plus/releases/latest)
[![Downloads](https://img.shields.io/badge/dynamic/json?url=https%3A%2F%2Fraw.githubusercontent.com%2FYDMY007%2FFntv-Plus%2Fbadge-data%2Fdownloads.json&query=%24.total&label=%E4%B8%8B%E8%BD%BD&suffix=%E6%AC%A1&color=2ea44f&logo=github&logoColor=white)](https://github.com/YDMY007/Fntv-Plus/releases)
[![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-blue)]()
[![飞牛影视](https://img.shields.io/badge/%E9%A3%9E%E7%89%9B%E5%BD%B1%E8%A7%86-fnOS-056de2)](https://www.fnnas.com/)
[![Electron](https://img.shields.io/badge/electron-38-47848F?logo=electron&logoColor=white)](https://www.electronjs.org/)
[![License](https://img.shields.io/badge/license-GPL--3.0-green)](LICENSE)
[![Stars](https://img.shields.io/github/stars/YDMY007/Fntv-Plus?style=flat&logo=github&logoColor=white)](https://github.com/YDMY007/Fntv-Plus/stargazers)
[![Forks](https://img.shields.io/github/forks/YDMY007/Fntv-Plus?style=flat&logo=github&logoColor=white)](https://github.com/YDMY007/Fntv-Plus/forks)
[![Issues](https://img.shields.io/github/issues/YDMY007/Fntv-Plus?logo=github)](https://github.com/YDMY007/Fntv-Plus/issues)
[![Commits](https://img.shields.io/badge/commits-1067-2ea44f?logo=git&logoColor=white)](https://github.com/YDMY007/Fntv-Plus/commits)
[![Last Commit](https://img.shields.io/github/last-commit/YDMY007/Fntv-Plus/release?logo=git&logoColor=white)](https://github.com/YDMY007/Fntv-Plus/commits)
[![Gitee](https://img.shields.io/badge/Gitee-mirror-F47040?logo=gitee&logoColor=white)](https://gitee.com/YDMY007/fntv-plus)

<img src="https://count.getloli.com/get/@Fntv-Plus?theme=rule34" alt="访问计数" width="320">

</div>

> ### ⚠️ 重要警告与声明
>
> **🧪 这是作者个人的练习 / 学习作品，不代表任何官方立场，与飞牛影视官方无任何关联或合作关系。**
> - **本仓库于 2026 年 9 月 9 日脱离上游 fork 网络，正式成为独立仓库独立发展 · 项目受 [QiaoKes/fntv-electron](https://github.com/QiaoKes/fntv-electron) 启发，并沿用 GPL-3.0 许可证保留其版权与致谢**
> 
> 使用前请务必知悉以下风险：
> - **非官方第三方客户端**：在飞牛影视 Web 端之上做注入式修改，可能因飞牛端更新而失效、闪退或行为异常，**不保证长期稳定可用**。
> - **账号与隐私风险**：需登录你的飞牛账号，并可能涉及豆瓣 / Bangumi / Trakt / B 站等第三方账号授权（Cookie / Token 仅本地加密存储）；请仅在可信环境使用，后果自负。
> - **外链播放与本地代理**：调用系统 PotPlayer / MPV 播放，并通过内置 Go 代理在本地中转流媒体；请确保所播放内容符合所在地法律法规与版权规定。
> - **更新来源安全**：自动更新与热补丁仅从本仓库（GitHub / Gitee）官方渠道获取；请勿安装来源不明的补丁包，避免运行被篡改的代码。
> - **按「原样」提供、无担保**：基于 GPL-3.0 开源，**不提供任何明示或暗示担保**；因使用本项目产生的任何后果由使用者自行承担。

> **把飞牛影视，变成你桌面上的私人流媒体影院。** Fntv-Plus 是基于飞牛影视 Web 端、用 Electron 打造的第三方桌面客户端：冷调渐变玻璃与云母界面、Netflix 风格沉浸式剧集详情页、3D 首页轮播，**先重塑观影视觉**；再打通豆瓣 / Bangumi / Trakt 同步、B 站弹幕、演员作品库、年度观影报告，**织成你的专属观影档案**；最后叠加手柄控制、智能跳过、外链播放器等硬核播放增强——**完整支持 Windows / macOS / Linux 三平台**。

<div align="center">
  <img src="resource/docs/Home123.png" width="100%" alt="">
  <p><em>图：三种不同样式海报轮播墙</em></p>
</div>

<div align="center">
  <img src="resource/docs/Nashome.png" width="100%" alt="">
  <p><em>图：兼容使用原生 NAS 界面</em></p>
</div>

<div align="center">
  <img src="resource/docs/login.png" width="100%" alt="">
  <p><em>图：支持多种登录方式（域名 / IP 地址 / FN ID 远程）</em></p>
</div>

<div align="center">
  <img src="resource/docs/Settings.png" width="100%" alt="">
  <p><em>图：丰富自定义组件</em></p>
</div>

<div align="center">
  <img src="resource/docs/Stickcontrol.png" width="100%" alt="">
  <p><em>图：兼容手柄控制</em></p>
</div>

<div align="center">
  <img src="resource/docs/Details12.png" width="100%" alt="">
  <p><em>图：美化一二级详情页</em></p>
</div>

<div align="center">
  <img src="resource/docs/Potplayer.png" width="100%" alt="">
  <p><em>图：支持调用 PotPlayer / MPV 外链播放</em></p>
</div>

<div align="center">
  <img src="resource/docs/BiliDanmu.png" width="100%" alt="">
  <p><em>图：丰富 B 站弹幕获取</em></p>
</div>

<div align="center">
  <img src="resource/docs/Actor.png" width="100%" alt="">
  <p><em>图：支持一键查询参演作品（是否入库检测）</em></p>
</div>

<div align="center">
  <img src="resource/docs/Watchhistory.png" width="100%" alt="">
  <p><em>图：本地化记录观影历史</em></p>
</div>

---

## 🍴 项目缘起与独立声明

> **本项目受 [QiaoKes/fntv-electron](https://github.com/QiaoKes/fntv-electron) 启发创建，现已作为独立仓库独立发展。**
>
> - **启发来源**：[QiaoKes/fntv-electron](https://github.com/QiaoKes/fntv-electron) 是基于飞牛影视（fnOS TV）Web 端封装的 Electron 桌面客户端，其项目思路与部分基础模块为本项目提供了起点与参考。
> - **原项目版权**：归原作者 [QiaoKes](https://github.com/QiaoKes) 所有，遵循 [GPL-3.0](LICENSE) 许可证，本项目沿用 GPL-3.0 并保留其版权与致谢。
> - **独立发展**：本仓库于 2026 年 9 月 9 日脱离上游 fork 网络，此后与上游各自演进、互不同步。当前仓库 **80% 以上代码为本项目自研**——冷调渐变玻璃 / 云母增强界面、原生窗口交互、侧栏设置面板、沉浸式剧集详情页、3D 首页轮播、豆瓣 · Bangumi · Trakt 同步、B 站弹幕、手柄控制、观影记录、年度观影报告等功能均为本项目独立实现；飞牛 API 封装、日志、播放器抽象、Go 本地代理等基础模块在早期版本基础上经大量重构与增强（preload 注入与 main 主进程均有深入修改）。
> - **许可证**：本仓库沿用 GPL-3.0 许可证，完整条款见 [LICENSE](LICENSE) 文件。

> **⚠️ 免责声明**：本项目为第三方客户端，与飞牛影视官方无关。本项目仅为作者本人**个人练手 / 学习用途**的开源项目，不代表任何官方立场，亦与飞牛影视官方不存在任何关联或合作关系。使用前请确保遵守相关服务条款与版权规定，因使用本项目产生的任何后果由使用者自行承担。

---

## ✨ 主要功能

> 每个功能点下面补充了具体场景与操作步骤说明，方便上手。

### 首页与界面

- **🏠 全新首页 3D 轮播** — 用自绘的立体 3D 旋转木马替换飞牛原生首页大图区，海报更大更聚焦，切换带流畅的 3D 纵深动画；也可在设置中切换为滑动 / 卡片堆叠等其它样式：
  - **多样式可选**：默认立体堆叠 3D 旋转木马，另有滑动、卡片堆叠等布局，设置面板一键切换。
  - **视觉聚焦**：海报更大、边缘渐隐与文字区自然融合，整体更通透；左上角浮动剧集 Logo 水印。
  - 💡 打开客户端首页即自动轮播「最近更新」；鼠标悬停暂停，可手动切换；想直接看某部，点「开始观看」即跳转到对应详情播放页，无需先点进列表。

- **🌈 冷调渐变玻璃 / 云母增强** — 整体采用冷调渐变玻璃视觉风格，并叠加云母（Mica）磨砂质感，让界面更具层次（取代旧版的粉紫亚克力，默认开启）：
  - 💡 喜欢更通透的玻璃质感就保持默认；觉得太透或太实，去设置面板拖「透明度 / 模糊」滑块实时调整，不重启生效。云母增强默认开启，可在设置中关闭。

- **🌗 深浅色主题切换** — 支持浅色 / 深色 / 跟随系统三种模式，深度适配各组件 UI（浅色主题为 3.6.0 起默认）：
  - 💡 白天用浅色、晚上用深色；选「跟随系统」后客户端随 Windows / macOS 的明暗自动切换，不用手动改。

- **🔥 每日放送浮窗** — 首页右下角悬浮「每日放送」浮窗，支持多数据源切换查看每日新番 / 热门影视：
  - **三数据源可切换**：Bangumi 每日放送（动画向）、TMDB（电影 / 剧集）、**豆瓣**（国内直连、免 Token，**默认源**）；设置面板可切换。
  - **仅在首页显示**：切到详情 / 播放 / 搜索 / 列表等页面自动隐藏，避免遮挡内容。
  - **接口限流保护**：每日磁盘缓存（24h 内至多请求一次），底部显示「数据更新于 HH:MM」，并提供「↻ 刷新」按钮手动强制刷新，避免被数据源限流 / 封禁。
  - 💡 追番党把数据源切到「Bangumi」看当天新番；想看电影剧集更新切「TMDB」；懒得配置就用默认「豆瓣」。只在首页出现，进其他页面自动收起，不挡内容；数据每天最多拉一次，急看当天更新点浮窗里的「↻ 刷新」强制更新。

- **🎬 沉浸式剧集详情页（一级 / 二级）** — 剧集页与季页采用 Netflix 风格的两栏布局：左侧选集、右侧剧集信息与演员墙，并配有全屏背景海报：
  - **剧照可放大**：右侧剧照支持点击放大灯箱，左右切换浏览。
  - **一键补全简介**：选集标题 / 简介缺失时，可从 TMDB 一键补回（季页选集标题旁「⟳」按钮）。
  - 💡 点进任意剧集即进入两栏沉浸式布局，左侧选集、右侧看演员与简介，背景是全屏海报；想细看某张剧照点一下放大，缺简介的集点「⟳」从 TMDB 补回。

- **🎭 演员信息页「一键查作品 + 是否入库」** — 在演员页面一键查询该演员的全部影视作品，并标记是否已收入你的影视库：
  - **是否已入库标记**：库中作品带绿色徽章可点进库内详情；未入库作品灰显并提示去 TMDB 查看。
  - **只看未入库**：支持筛选，快速找出还没收进库里的作品。
  - 💡 在演员页点「TMDB 完整作品」，全部作品按是否已入库高亮区分；只关心没收录的，开「只看未入库」一键过滤。

- **📊 年度观影报告** — 生成可分享的年度观影总结，类似 Spotify Wrapped 的翻页报告：
  - **多维度**：年度总时长 / 部数 / 观影天数 / 看完数 / 月度节奏 / 观影时刻 / TOP5 等。
  - **导出长图**：一键导出为 PNG 长图分享。
  - 💡 从侧栏观影记录面板点「✨ 年度报告」，翻看这一年你的观影画像，喜欢就导出长图分享。

### 设置面板（侧栏「⚙ 设置」入口，居中半透面板）

- **🎬 播放器设置** — MPV、PotPlayer 外部播放器支持（含续播与逐集连播，进度实时回传）；MPV 画质三档预设（性能 / 均衡 / 高画质）+ 着色器方案（含 Anime4K 等）+ 进度条悬停缩略图预览：
  - 💡 在「播放器」分类里选默认用 MPV 还是 PotPlayer；看完一集想自动播下一集、并让进度回到飞牛，把「续播 / 逐集连播」打开即可。MPV 画质档位（性能 / 均衡 / 高画质，含 Anime4K 等预设）在这里选；悬停进度条还会预览缩略图。

- **🔍 B 站弹幕自动获取** — 扫码登录 B 站，一键自动获取对应番剧弹幕，追番无忧；无法匹配时支持手动搜索。弹幕获取支持填写专属 API 凭证，避免公共接口限流：
  - 💡 设置里用 B 站 App 扫码登录一次（Cookie 本地加密保存）；之后用 MPV 看番，客户端会按「番名 + 集数」自动匹配并加载 B 站弹幕。弹弹 play 弹幕支持在设置里填写专属 AppId / Secret，公共接口被限流（404）时改用自有凭证。

- **📺 豆瓣同步** — 播放进度自动标记豆瓣「在看」；飞牛「已观看列表」自动标记豆瓣「看过」。
  - 💡 开启后在飞牛里开始看一部片子，豆瓣对应条目自动标「在看」；看到飞牛「已观看」状态后，豆瓣自动标「看过」。适合用豆瓣当个人影视档案的人，不用手动维护。

- **📊 Bangumi 自动点格子** — 播放进度达阈值（默认 80%）自动标记该集为 Bangumi「看过」+ 条目标「在看」；末集自动标整部「看过」。
  - 💡 追番时打开此功能，每看完一集的 80% 进度，Bangumi 上那集自动变「看过」、整部标「在看」；看到最后一集自动把整部标「看过」。不用每集去 Bangumi 手动点，进度由飞牛播放回传驱动。

- **🐛 调试日志** — 控制台日志级别开关 + 按组件单独控制；「打开日志文件」与「导出日志文件」快捷操作。
  - 💡 播放 / 弹幕 / 同步等某个功能不正常时，到「调试日志」把对应组件的级别调到 DEBUG，复现一次问题，点「导出日志文件」把日志发给开发者排查；平时保持默认级别不影响性能。

- **🧩 插件面板** — 把 MPV 内置脚本能力封装成 GUI 可控插件；内置「跳过片头片尾」开关（自动加载飞牛 / theintrodb / AniSkip 跳过数据，可显示跳过按钮或自动跳过）。使用与开发详见本地 `resource/wiki/插件开发与使用文档.md`。
  - 💡 打开「跳过片头片尾」后，有片头片尾数据的剧集会在播放时自动（或显示按钮让你点）跳过；数据来自飞牛自带、theintrodb 与 AniSkip，无需自己手填时间点。

- **🖼️ 主界面 Logo 自定义** — 首页顶部 Logo 支持切换为内置的多种海内外流媒体品牌标识，也可自行上传图片：
  - **内置多平台**：Netflix、Disney+、HBO 等海内外流媒体透明底 Logo 预设。
  - **自定义上传**：可上传自己的图片，并一键恢复默认。
  - 💡 想让客户端顶栏换个味儿，去设置面板外观区挑个内置 Logo 或传自己的图，不满意随时「恢复默认」。

- **🎛️ 设置面板全面升级** — 分类更清晰、采用 iOS 风格开关、支持搜索，并新增浅色主题与界面语言切换：
  - **设置搜索**：顶部搜索框跨分类实时匹配设置项，点结果直达。
  - **浅色主题 / 多语言**：新增浅色主题（默认），以及简体中文 / 英文界面切换。
  - 💡 设置项太多找不到？面板顶部搜一下关键字直接定位；喜欢亮色就在主题里切浅色，需要英文界面在语言里切 English，整页即时生效。

- **🌐 TMDB 国内免梯子直连** — 内置 TMDB 国内可直连的真实边缘 IP 快照，并自动定时刷新，让元数据（演员作品 / 简介补全 / 每日放送）在国内无需梯子即可加载：
  - **可手动覆盖**：设置面板可自定义直连 IP，或点「更新 IP」立即拉取最新可用节点。
  - 💡 之前 TMDB 在国内常被 DNS 污染导致加载不出，现在默认内置可用 IP 自动直连；万一某个节点失效，去设置里点「更新 IP」或自己填一个即可，不用挂代理。

### 播放与媒体

- **🎯 字幕自动选择** — 自动匹配最佳一条中文外挂字幕（按 lang / title / 评分排序），MPV 与 PotPlayer 均支持。
  - 💡 影片带多语言外挂字幕时，客户端按「中文 > 标题匹配 > 评分」自动挑一条挂上，不用每次手动选；想换条也能在播放器内手动切。

- **💬 B 站弹幕自动匹配** — MPV 播放器自动按番名 / 集数匹配加载 B 站弹幕；无法匹配时支持手动搜索。进度条叠加弹幕密度热力条，一眼看出高能名场面：
  - 💡 用 MPV 播放番剧时，弹幕会随视频自动按「番名 + 集数」匹配浮现；命名对不上时支持在弹幕面板手动搜索补全。点开弹幕后，进度条上方会出现密度热力条，亮段就是弹幕密集的高能处，拖动时心里有数。

- **🎮 手柄控制** — 支持使用游戏手柄在应用内导航与操控播放：
  - **焦点导航**：以高亮白框替代鼠标指针，方向键移动焦点、A 键确认（等效点击），无需鼠标即可完成界面操作。
  - **媒体控制**：通过手柄即可控制播放 / 暂停、快进快退、音量等。
  - **自定义映射**：设置面板新增「手柄」分类，可对手柄按键进行个性化映射与高级参数调节。
  - 💡 把 Xbox / PS 等手柄接上（USB 或蓝牙），在沙发上也能用——方向键移动屏幕上的「高亮白框」（等同于鼠标焦点），A 键等于点击，B 键返回 / 关弹窗；进播放页后可直接用手柄控制暂停、快进快退、音量。按键不顺手就去设置「手柄」分类重新映射，还能调摇杆死区、连跳速度等高级参数。

- **📺 PotPlayer 外链播放器** — 支持调用系统 PotPlayer 播放，带续播和逐集连播；每 5 秒读取播放进度回写飞牛，实现进度同步。
  - 💡 在影片详情页点「PotPlayer 播放」按钮（与原生播放按钮并排），即用你系统里的 PotPlayer 打开；关掉窗口前客户端每 5 秒把进度回写给飞牛，下次在飞牛任意端都能续上。适合习惯 PotPlayer 快捷键 / 滤镜的用户。

- **🎨 MPV 着色器 / ICC** — 画质三档渲染预设（性能 / 均衡 / 高画质）+ 10 档预设着色器方案（含 Anime4K）+ ICC 校色开关，设置面板即时生效。
  - 💡 动画党选 Anime4K 相关预设提升锐度 / 降噪；有校色文件的显示器开 ICC 开关让颜色更准确。选完即时生效，不用重启播放器。

- **🔗 直链 / NAS 代理双模式** — 支持 302 重定向直链与 NAS 代理两种播放链路，可在设置面板切换。
  - 💡 默认直链（302 跳转）最快；若家里 NAS 是自建证书、或某些片源直链在弱网下黑屏缓冲，切到「NAS 代理」模式让客户端自带 Go 代理中转流媒体，避开直链兼容 / 缓冲问题。

- **📼 观影记录** — 新增「观影记录」面板，集中回顾观看足迹：按「已看完 / 在观看」分区，含封面、标题、总时长与最后观看时间；已打分作品显示五星评分；支持年 / 季 / 月 / 周多范围观影活动热力图；可跳转飞牛对应作品详情页。
  - 💡 从侧栏入口打开「观影记录」，一眼看到「在看到哪 / 已看完哪些」；打过分的作品封面顶部显示五星。点顶部的「年 / 季 / 月 / 周」切换，下方方格热力图会显示你每天看片的密度（没看的日期留白），回看自己的观影习惯很直观。想重看某部，点条目里的「查看详情」直接跳回飞牛对应播放页。

- **🔁 自动连播与「下一集」倒计时** — 看完一集自动提示并播放下一集，体验对标主流流媒体：
  - **UP NEXT 卡片**：剩 60 秒浮现下一集海报与信息，剩 20 秒倒计时，可立即播放或取消。
  - 💡 追剧时看到最后一集快结束，右下角会自动冒出「下一集」卡片并倒计时，不想等就点立即播放，进度自动切到下一集。

- **🔗 Trakt 观影记录同步** — 将观影记录同步到 Trakt，跨平台统一记录：
  - **同步内容**：已看完的电影、已看过的剧集集数，都会写入你的 Trakt 历史；播放中实时打点（scrobble）。
  - 💡 在设置面板连接 Trakt 账号后，用客户端看完的电影、看过的剧集会自动进 Trakt 历史，配合 Trakt 跨端记录很方便。

- **⏭️ 智能跳过（多数据源）** — 自动跳过片头 / 片尾 / 前情，覆盖章节检查、theintrodb、AniSkip 多数据源与手动设置：
  - **更广覆盖**：接入 AniSkip 后，OP / ED / 前情（Recap）自动识别跳过，新番覆盖更全更准。
  - 💡 嫌每集开头广告 / OP 烦，开启自动跳过（按章节、theintrodb 或 AniSkip 数据）；没有数据也能自己设片头片尾时间点，或播放时按快捷键跳固定时长。前情回顾也能一键跳过。

- **🎚️ 播放体验提升** — 倍速与音量跨集记忆、进度条悬停缩略图预览、MPV 画质预设等细节打磨：
  - 💡 换集后倍速 / 音量自动恢复你上次的设置；鼠标悬到进度条会预览该时刻缩略图，找位置更直观。

### 系统与体验

- **📋 托盘菜单精简** — 托盘右键菜单只保留「退出」，其余功能全部收进侧栏设置面板。
  - 💡 右下角托盘图标只用来退出程序，避免误点弹一堆选项；所有功能（设置、观影记录等）都从应用内左侧「⚙ 设置」侧栏进，路径统一。

- **🔧 侧栏实时调节** — 侧栏内透明 / 模糊滑块，实时调节客户端玻璃强度。
  - 💡 打开左侧设置侧栏，拖「透明 / 模糊」滑块即可边拖边看效果，马上套用到整个窗口，不用保存或重启。

- **🪟 无边框窗口与自定义标题栏** — 采用无边框（frameless）窗口，自带自定义标题栏与窗口控制，贴合桌面原生体验：
  - **窗口控制**：标题栏提供最小化 / 最大化 / 还原 / 关闭按钮；拖拽标题栏即可移动窗口。
  - **原生交互补位**：在无原生标题栏的页面（如登录页）也注入拖拽区，保证任意页面都能拖动窗口。
  - 💡 客户端默认是无边框的沉浸式窗口，右上角有标准的「最小化 / 最大化 / 关闭」按钮；想移动窗口直接拖顶部标题栏即可，和原生桌面程序一致。

- **🔐 FN ID 远程登录** — 使用 FN Connect 实现远程访问，独立 OAuth 窗口 + Cookie 持久化，支持多账户管理。
  - 💡 不在家想访问家里 NAS 影视时，用 FN ID（FN Connect）登录，会弹出独立授权窗口，登录后 Cookie 本地保存，下次自动连；家里有多台飞牛 / 多账号可在登录管理里切换。

- **♿ 无障碍与多语言** — 提升可访问性并支持多语言：
  - **键盘焦点高亮**：Tab 键导航显示焦点环，无需鼠标即可操作。
  - **屏幕阅读支持**：主要界面补充 aria 标签。
  - **简体中文 / 英文**：设置面板可切换界面语言。
  - 💡 习惯键盘操作的开 Tab 看焦点高亮；需要英文界面在设置语言里切 English，整页即时生效。

- **🔔 自动更新检测与热补丁** — 启动后自动检查新版本，并支持热补丁免重启生效：
  - **双更新通道**：按版本后缀区分全量（`-full`）/ 热补丁（`-hotfix`）通道，应用内弹窗提示，点击即可应用。
  - **热补丁免重启**：热补丁包下载后重载即生效，无需重新安装全量包。
  - 💡 新版本发布后客户端会自动弹窗提醒；小修复走热补丁，重载一下就生效，不用下载整个安装包。需要时可到设置里手动「检查更新」。

### 源自上游的基础能力

- **原生桌面体验** — 基于飞牛影视 Web 端构建的桌面应用，提供类原生体验。
  - 💡 直接当独立桌面程序用，比开浏览器标签页更顺手，窗口、托盘、快捷键都是桌面级的。
- **多账户管理** — 支持自动登录，支持多账户管理，自由切换账户和服务器。
  - 💡 多个飞牛账号 / 多台服务器可在登录处添加并一键切换，重启后自动登录。
- **远程访问** — 支持使用 FN Connect，通过 FN ID 登录实现远程访问。
  - 💡 见上方「FN ID 远程登录」，出门也能看家里 NAS 的片。
- **硬解播放** — 使用 MPV 播放器，支持 H264 / HEVC / VP9 / AV1 等编码格式。
  - 💡 4K / 高码率影片交给 MPV 硬解，CPU 占用低、不卡顿，显卡支持即可。
- **进度回传** — MPV / PotPlayer 播放器支持实时将进度回传到飞牛服务器。
  - 💡 用外部播放器看到哪，飞牛网页 / App / 电视端都能接着看，进度自动同步。
- **弹幕支持** — MPV 播放器支持弹幕自动匹配加载，无法匹配时支持手动搜索。
  - 💡 见上方「B 站弹幕自动匹配 / 获取」。
- **视频增强** — 内置 Anime4K 着色器以及对应预设模式。
  - 💡 见上方「MPV 着色器 / ICC」，动画画质一键增强。
- **跨平台支持** — 支持 Windows、macOS 和 Linux。
  - 💡 同一套仓库出三平台安装包，Windows 手动上传、macOS / Linux 由 GitHub Actions 自动构建，去 Releases 下对应包即可。

---

## 📁 项目结构

```text
Fntv-Plus/
├── src/                          # 源码（TypeScript）
│   ├── main/                     # Electron 主进程
│   │   ├── main.ts               # 程序入口：窗口创建、生命周期、托盘、单实例锁
│   │   ├── common/               # 主进程公共工具与类型
│   │   ├── patchOverlay.ts       # 热补丁文件级覆盖钩子（Module._resolveFilename）
│   │   └── handlers/             # IPC 处理器
│   │       ├── core/             # 核心 IPC（窗口、导航、配置读写、登录拦截）
│   │       └── plugins/          # 功能 IPC（豆瓣 / Bangumi / 弹幕 / 播放器 / patch 等）
│   ├── preload/                  # 预加载脚本（隔离上下文桥接飞牛 Web 与 Node）
│   │   ├── index.ts              # preload 入口
│   │   ├── core/                 # 注入飞牛 Web 的钩子 / 工具 / 类型
│   │   └── plugins/              # 注入侧功能模块（embyWall / gamepad / glassUI / watchHistory / customLogo ...）
│   ├── modules/                  # 可复用业务模块
│   │   ├── cert_trust/           # 证书信任（NAS 自签 https）
│   │   ├── danmaku/              # B 站弹幕：获取 / 合并 / 叠层 / 字幕合并
│   │   ├── fn_api/               # 飞牛影视 API 封装（api / request / types）
│   │   ├── fn_config/            # 配置持久化（AES-256 加密，存 userData/config.json）
│   │   ├── logger/               # 分级日志 + 敏感信息脱敏
│   │   ├── players/              # 播放器抽象层（factory / index / types / impl: mpv & potplayer）
│   │   ├── proxy/                # NAS 代理服务（Go 源码，构建为 proxy[.exe]）
│   │   ├── proxyAgent.ts         # 代理客户端封装
│   │   ├── patcher/              # 热补丁解析与覆盖逻辑
│   │   └── updater/              # 更新检查（Gitee 公开 raw 检测 + 镜像兜底）
│   └── public/                   # 静态资源（注入 HTML / CSS 模板）
├── third_party/                  # 第三方依赖（仅文本 / 配置入库，二进制由 CI / go build 生成）
│   ├── fntv-mpv/                 # MPV 便携配置（uosc 脚本 / 着色器 / mpv.conf / 字体）
│   ├── potplayer/                # 内置便携版 PotPlayer（运行时复制，不入库）
│   ├── anime/                    # 番剧匹配辅助资源（anime.min.js）
│   └── proxy/                    # Go 代理源码（proxy[.exe] 构建时生成）
├── resource/                     # 文档与图片
│   ├── docs/                     # README 截图（simple / Settings / Detailsettings / Potplayer / login / hotlist）
│   ├── logos/                    # 内置流媒体 Logo 预设（首页 Logo 自定义用）
│   ├── login/                    # 登录相关资源
│   └── wiki/                     # 使用手册 / 插件文档 / 更新检测源（update-check.json）
├── scripts/                      # 构建辅助脚本（图标生成 / potplayer 复制 / 发布等）
├── build/                        # 打包资源（icon / entitlements.mac.plist，供 electron-builder）
├── .github/workflows/            # 自动构建（release.yml：macOS / Linux 自动，Windows 手传）
├── package.json                  # 依赖与打包配置（artifactName = Fntv-Plus_*）
├── tsconfig.json                 # TypeScript 配置
├── dev.cmd                       # 开发调试（taskkill → tsc → electron）
└── README.md                     # 本文件
```

---

## 📦 安装与下载

### 预编译版本（推荐）

前往 GitHub [Releases 页面](https://github.com/YDMY007/Fntv-Plus/releases) 下载最新版本（国内 Gitee 不提供大文件托管，发行包统一托管于 GitHub）：

| 平台 | 文件类型 | 说明 |
|------|----------|------|
| 💻 Windows | `Fntv-Plus_<ver>_win_x64.exe` | **由维护者手动上传至本 Release**（不通过自动构建）。NSIS 安装包，支持自定义安装路径、创建桌面 / 开始菜单快捷方式。 |
| 🍎 macOS | `Fntv-Plus_<ver>_mac_<arch>.dmg` | 磁盘镜像，拖入 Applications 即可。Intel & Apple Silicon 双架构。安装后执行：`sudo find "/Applications/Fntv-Plus.app" -exec xattr -d com.apple.quarantine {} \; 2>/dev/null` |
| 🐧 Linux | `Fntv-Plus_<ver>_linux_<arch>.AppImage` | 便携应用，添加执行权限后直接运行。弹幕与播放器配置已内置，仅需自行安装 mpv（要求版本 > 0.37.0）。x64 & ARM64。 |

> 包命名形如 `Fntv-Plus_3.6.0_win_x64.exe`（含版本 / 系统 / 架构）。热补丁包标识 `-hotfix`（如 `patch-3.6.0-hotfix.json`），由应用内弹窗获取、重载即生效，无需下载全量包。

### 本地构建

```bash
# 1. 克隆仓库
git clone https://gitee.com/YDMY007/fntv-plus.git
cd Fntv-Plus

# 2. 安装依赖（Node.js 18+ 与 Go 工具链）
npm install

# 3. 调试运行（编译 TypeScript + 编译 Go 代理 + 启动 Electron）
npm start

# 4. 打包安装包
npm run build:win     # Windows
npm run build:mac     # macOS
npm run build:linux   # Linux
```

> **调试提示**：本客户端使用单实例锁 + 系统托盘，**关闭窗口 ≠ 结束进程**。修改代码后重新调试前，先结束残留的 `electron.exe`：
> ```powershell
> taskkill /f /im electron.exe
> ```
> 然后执行 `npm start` 即可看到最新改动。

---

## 🙏 特别感谢

本项目的上游与依赖参考以下开源项目：

**项目启发来源**
- [QiaoKes/fntv-electron](https://github.com/QiaoKes/fntv-electron) - 受其启发创建本项目，现已完全独立发展
- [QiaoKes/fntv-mpv-config](https://github.com/QiaoKes/fntv-mpv-config) - MPV 配置与预设着色器方案来源（本项目的 `portable_config` 基于此管理）
- [fnos-tv](https://github.com/thshu/fnos-tv) - 支持弹幕的飞牛影视
- [fnToPotplayer](https://github.com/gudqs7/fnToPotplayer) - 飞牛影视调用 PotPlayer 的集成逻辑

**播放内核 / 解码补丁**
- [mpv](https://github.com/mpv-player/mpv) - 内置 MPV 播放内核
- [PotPlayer](https://potplayer.daum.net/) - 内置 PotPlayer 播放器（Kakao/DAUM）
- [enable-chromium-hevc-hardware-decoding](https://github.com/StaZhu/enable-chromium-hevc-hardware-decoding) - Chromium HEVC 硬解码支持
- [electron-media-patch](https://github.com/5rahim/electron-media-patch) - Electron 硬解码补丁

**弹幕 / 画质（MPV 脚本与着色器）**
- [tomasklaen/uosc](https://github.com/tomasklaen/uosc) - MPV 现代化 UI 框架（uosc_danmaku 弹幕插件基于此构建）
- [Tony15246/uosc_danmaku](https://github.com/Tony15246/uosc_danmaku) - 基于 uosc 的 B 站 / 弹弹 play 弹幕插件
- [bloc97/Anime4K](https://github.com/bloc97/Anime4K) - Anime4K 超分辨率 / 降噪着色器（画质增强模式核心）
- [弹弹 play 开放弹幕网络](https://www.dandanplay.com) - 番剧识别与弹幕匹配 API（[开放平台文档](https://doc.dandanplay.com/open/)）
- [Bangumi API](https://bangumi.github.io/api/) - 番剧条目与单集同步 API（[api.bgm.tv](https://api.bgm.tv)，支撑「Bangumi 自动点格子」集数级同步）
- [huangxd-/danmu_api](https://github.com/huangxd-/danmu_api) - 弹幕聚合 API 参考（借鉴其官方番剧直达思路与 WBI 搜索 / pgc 解析逻辑，用于本项目原生 B 站弹幕通道；本项目零新增依赖、未整包引入）

**跳过数据 / 元数据 API**
- [theintrodb](https://api.theintrodb.org) - 跳过片头片尾数据 API（本项目「智能跳过」功能的数据源之一）
- [AniSkip](https://aniskip.com/) - 社区维护的片头片尾 / 前情跳过数据 API（本项目「智能跳过」增强数据源）

**影视数据源（每日放送浮窗）**
- [The Movie Database (TMDB)](https://www.themoviedb.org/) - 电影 / 剧集元数据 API（每日放送浮窗数据源之一）
- [豆瓣（Douban）](https://movie.douban.com/) - 国内影视数据库（每日放送浮窗默认数据源，国内直连免 Token）
- [Trakt](https://trakt.tv/) - 观影记录同步平台（本项目「Trakt 同步」目标服务）
- *Bangumi 见上方条目，同样作为「每日放送」浮窗的动画数据源之一。*

---

## 📄 许可证

本项目采用 [GPL-3.0 许可证](LICENSE)。

- **原项目版权**：Copyright (c) 原作者 [QiaoKes/fntv-electron](https://github.com/QiaoKes/fntv-electron)
- **本仓库修改署名**：YDMY007（受上游启发的独立增强版，含冷调渐变玻璃 / 云母增强界面 / 沉浸式剧集详情页 / 3D 首页轮播 / 侧栏设置面板 / 豆瓣 · Bangumi · Trakt 同步 / B 站弹幕 / 手柄控制 / 观影记录 / 年度观影报告等增强）