YuKi

项目概述

YuKi 是一个面向桌面的影视聚合应用：Electron 负责界面与系统宿主，独立的 FastAPI / Python 进程运行 CatVod 与 Kazumi 两套内容引擎，播放和下载交给 mpv、aria2c 与 ffmpeg。它坚持本地优先、无追踪，所有个人数据都不上传。

两套引擎一个界面，看片、下载、追番记录全都留在本机。

主要功能

• 双内容引擎：CatVod 配置源支持聚合搜索、详情与播放，Kazumi 规则支持导入、商店、编辑、测试与真实流提取
• mpv 播放：自动连播、续播、Anime4K 实时超分、截图与智能跳过片头片尾
• 外部播放器：可指定本机 mpv，也可用 VLC、PotPlayer 接管播放
• 原生播放列表：在线整季经本地代理交给 mpv 队列连播，同源同集自动去重
• 直播：支持 txt 与 m3u 地址的 IPTV 频道浏览与播放
• 下载体系：aria2c 直链下载、ffmpeg HLS 下载，按番剧建文件夹并推送系统通知
• 数据同步：收藏、历史、观看统计，支持 Bangumi 账号同步与 WebDAV 备份
• 界面定制：中性灰阶加主题色，背景图支持拖动定位、缩放、透明度与模糊调节

适用人群

• 想在桌面上统一管理多个影视源的用户
• 有本地媒体文件夹、希望边下边播的追番用户
• 在意隐私、不希望观看数据上传的用户

快速上手

1. 到 Releases 下载 YuKi-Setup-x.y.z.exe 并双击安装
2. 在「设置 → CatVod 源设置」粘贴一个 TVBox 配置地址载入视频源
3. 在「设置 → Kazumi 规则 → 规则商店」一键安装番剧源
4. 观看网盘类源前，先在「设置 → 网盘账号」配置 Cookie 或扫码登录

核心优势

• 引擎齐全：CatVod 与 Kazumi 两套生态在同一个界面里可用，配置与规则都能自己添加
• 播放器强大：内置 mpv 支持超分、连播与跳片头片尾，也可换成你熟悉的播放器
• 隐私可控：无埋点、无统计、无崩溃上报，所有数据只保存在本机
• 边下边播：在线整季交给 mpv 原生队列，下载与播放可以同时进行

系统要求

项目	要求
操作系统	Windows 10 及以上 x64，macOS 与 Linux 打包验证中
开发环境	Node.js 20 及以上、Python 3.14
外部组件	mpv、ffmpeg 可自动下载，aria2c 需自行准备

注意事项

• 应用不提供、不存储任何影视内容，可播放资源均来自你自行添加的配置源或本地文件
• 部分源包含广告、跳转或 Cookie 验证，请审慎添加来源不明的配置
• 网盘类源建议保持逐集连播，避免触发风控
• 软件按现状提供，源可用性与解析成功率不作保证