CineFlow 影流

CineFlow 影流是什么

CineFlow 是一款面向 Windows 桌面的电影 / 节目推荐应用，主打简洁高级的界面、灵动岛模式与外部片源导入。它基于 Electron + Vite 构建，使用 TMDB 作为元数据源，覆盖电影、电视剧、节目、演员、关键词与类型发现。

核心功能

发现与推荐

• 每日推荐：首页展示今日电影 / 节目，包含海报、评分、类型与简介。
• 电影 + 节目双检索：同时覆盖 TMDB 的 movie 与 tv，电视剧、综艺、节目都能搜索。
• 自然语言搜索：支持心情、天气、上班等场景描述，也能用片名、演员、题材等关键词，并自动扩展相关推荐。
• 风格探索：动作、科幻、爱情、悬疑、动画、恐怖、喜剧、剧情等类型快速发现。
• 个性化推荐：基于本机点击、收藏与搜索偏好调整推荐内容。

详情与收藏

• 介绍页：海报、简介、评分、上映 / 首播信息、季数、集数、主演、主创与相似推荐一屏展示。
• 收藏面板：顶栏「收藏」按钮，详情页从左侧拉出，可一键直达介绍页播放。

播放与片源

• 应用内播放：支持 HLS / DASH / FLV，电视剧资源可在播放器内显示本季剧集并切集。
• 外部资源导入：支持自定义导入外部影视源并即时刷新配置。
• 广告分片过滤：三级过滤播放资源广告，异常时自动回退原始清单。
• 播放优化：窗口态拖动进度条抑制加载圈，全屏播放优先尝试 4K 并自适应回退。

桌面交互

• 灵动岛模式：最小化后切换为灵动岛，支持拖动、展开搜索、贴边吸附与一键恢复主窗口。
• 网络加速：元数据经加密解析并在启动时预热建立本机索引；播放流量可选跟随代理 / 强制代理 / 直连，代理断开时播放不中断。

快速上手

1. 前往 GitHub Releases 下载最新版本（Windows 10 / 11，x64）。
2. 首次启动后点击右上角设置按钮，填入 TMDB v3 API Key 或 Read Access Token，保存并测试连接。
3. 如遇网络失败，可在设置页配置代理，例如：

system
http://127.0.0.1:7890
socks5://127.0.0.1:7890
direct

• system：使用系统代理
• direct：强制直连
• http:// / socks5://：使用指定本地代理

开发模式下也可复制 .env.example 为 .env 并填写：

TMDB_API_KEY=
TMDB_READ_TOKEN=

两者任选其一即可，仓库内附有申请 TMDB API 的中文图文说明。

项目结构

CineFlow/
├─ build/       # 应用图标等构建资源
├─ electron/    # Electron 主进程与 preload
├─ scripts/
├─ src/
├─ index.html
├─ package.json
├─ vite.config.mjs
├─ 申请API.md
└─ README.md

适合谁用

• 想在 Windows 桌面上获得更顺手的找片 / 追剧体验的用户。
• 希望把外部片源统一导入并集中管理的用户。
• 想学习 Electron 桌面应用、TMDB 接入与推荐逻辑的开发者。

注意事项

• 仅支持 Windows 10 / 11 x64。
• 需要自行申请并配置 TMDB API Key。
• 外部片源由使用者自行导入，请确保内容来源合规。
• 项目基于 MIT License 开源。