冬瓜TV MAX：一个为大陆用户深度优化的现代流媒体聚合播放器

冬瓜TV MAX 是对原版“冬瓜TV”的全面重构与升级，基于 Node.js + Vue 3 构建，融合高质量内容元数据、智能多源聚合、沉浸式界面与本地化优化，打造真正“开箱即用、流畅稳定”的流媒体体验。

• dongguaTV：https://github.com/Minerchu/dongguaTV
• 冬瓜TV MAX：https://github.com/EdNovas/dongguaTV

它不只是一个播放器，更是一个面向中文用户的流媒体聚合平台，尤其针对网络环境复杂、资源分散、加载缓慢等现实痛点做了系统性改进。

✨ 核心特性

1. 🎬 双引擎数据驱动：内容与资源分离，品质与可用兼顾

• TMDb 元数据引擎
  接入 The Movie Database (TMDb) v3 API，提供高分辨率海报、背景图、评分、剧情简介、演职员表等专业影视信息，构建 Netflix 式内容卡片。
• 48+ CMS 聚合源
  集成超 48 个基于 Maccms 的第三方资源站 API，覆盖电影、剧集、综艺、动漫。
  系统自动对所有源进行实时测速，智能过滤失效或高延迟线路，优先推荐可用资源。

2. 🔍 智能搜索与聚合：边搜边显，结果实时融合

• 流式搜索（SSE）
  采用 Server-Sent Events 技术，用户输入后，各资源站结果即时推送、逐条显示，告别“等待 loading”的焦灼。
• 自动聚合与动态更新
  同一部影片来自不同源的线路，会自动合并到同一卡片。新发现的可用源实时追加，卡片右上角的“源数量”会动态跳动更新。
• 高性能本地缓存
  内置 SQLite 数据库 作为永久缓存层，支持无限存储，读写性能远超 JSON 文件。热搜词、热门影片实现秒级响应。

3. 📺 沉浸式播放体验：影院级细节，故障自动兜底

• 影院模式详情页
  暗色系 UI，全屏背景图 + 高斯模糊遮罩，剧集以网格形式展示，支持遥控器方向键快速选择。
• 双模式线路测速
  • 直连测速：由用户设备直接探测，反映真实播放体验
  • 代理测速：由服务器代为探测，用于评估源可用性
    二者互补，结果更准确。
• 自动故障转移
  播放失败时，系统自动切换至下一可用线路，无需用户手动干预。
• 本地投屏支持
  集成 DLNA / AirPlay 投屏协议（需浏览器支持），一键将内容推送到电视或投影设备。

4. 🌏 专为大陆用户优化：抗干扰、免配置、秒启动

• 智能 IP 检测
  采用 Cloudflare Trace + ipapi.co 双重检测机制，精准识别大陆用户，无 API 限频风险，自动启用 TMDb 反代模式。
• 核心资源本地化
  Vue 3、Bootstrap 5、DPlayer、HLS.js 等关键库均本地部署，彻底规避 CDN 劫持、资源加载慢或被污染的问题，首次打开即流畅。
• 一键安装脚本
  提供交互式部署脚本，引导用户配置 TMDb API Key、反代地址、运行端口等，5 分钟完成部署。

5. 📱 多端无缝体验：电视、手机、桌面全覆盖

• Android TV / 电视盒子
  提供专属 APK，完美适配遥控器操作，支持 Leanback Launcher，可直接从电视桌面启动。
• 移动端 Web App
  基于现代 Web 技术封装，支持手势操作、横屏播放，体验接近原生应用。
• PWA 支持
  可“添加到主屏幕”，离线启动，即点即用，无需安装商店应用。

6. 🔒 安全与管理：轻量但不失控

• 全局访问密码
  可设置访问密码，并支持记住登录状态长达 1 年，兼顾隐私与便利。
• 远程配置支持
  支持从 URL 动态加载 db.json 配置文件，便于多设备或家庭成员统一管理源站与 UI 设置。

UI/UX 全面升级：从“能用”到“好用”

技术栈