大家好，之前开源了一个自己做的 macOS 视频客户端 OKVideoMac。
第一版出来的时候，其实基本功能已经能用了：
- TVBox / CatVod 一类配置
- CatPawOpen / MiraPlay 一类 Node 源
- 直播
- 搜索
- 详情
- 收藏 / 历史
- libmpv 播放
但自己连续当主力软件用了一个月以后，越来越觉得：
“能跑”和“真正好用”之间，还有很长一段距离。
所以过去这一个月，我基本没有继续堆新功能，而是把大量时间花在重新整理 UI 、交互、播放链路、源兼容和底层生命周期上。
现在正式发布 OKVideoMac 0.4.0 （ Build 94 ）。
先简单介绍一下项目
OKVideoMac 是一个用 Swift / SwiftUI 开发的原生 macOS 视频与直播客户端。
播放器使用 libmpv。
它不是 Android App 移植，也不是把 TVBox 界面直接搬到 Mac 上。
我的目标一直是：
保留 TVBox / CatVod / CatPawOpen 这类生态比较开放的“壳与源分离”能力，但把客户端真正按照 macOS 软件重新做一遍。
目前支持的主要路径包括：
- Native CMS JSON
- 部分 CMS XML
- QuickJS Spider
- CatVod / FongMi 风格 JS
- CatPaw 风格 Node
.js.md5 - 部分 Java / Dex
csp_Spider - M3U / TXT / JSON 直播
- XMLTV EPG
其中绝大部分路径都不需要 Android 。
只有部分传统 Java / Dex csp_ Spider ，会通过可选的 Android Bridge 兼容。
并不是声称“所有 TVBox 源全部兼容”，实际兼容性还是取决于源格式、运行时、接口实现和具体 Spider 。
0.4.0 我主要重新做了什么？
1. UI 基本重新设计了一遍
这是这一版最直观的变化。
首页、分类、搜索、详情、收藏、历史、设置等页面都重新统一了一遍。
包括：
- Sidebar
- Toolbar / Titlebar
- 筛选器
- 选中状态
- 弹窗
- 滚动区域
- 字体层级
- 间距
- 深色模式
- 窗口尺寸变化
都尽量回归 macOS 自己的交互方式。
第一版多少还有一点“把电视端软件搬到电脑上”的感觉。
这一版我越来越明确一个原则：
既然它运行在 Mac 上，那它首先应该是一个 Mac App ，其次才是一个影视客户端。
所以现在很多地方都改成了 SwiftUI / AppKit 更自然的交互，而不是照着 Android TV 的思路做。
2. 播放器还是 libmpv ，但底层改了很多
播放器核心没有换，依然是 libmpv 。
但这一轮真正花时间的，其实不是“能不能播放”，而是大量播放器生命周期问题。
比如：
- 首帧什么时候真正 ready
- 播放器打开 / 退出的资源释放
- 连续切集
- 快速拖动进度条
- 播放到结尾
- 用户主动快进到结尾
- 自动下一集
- 直播连续换台
- 播放失败后的清理
- 窗口关闭后的 teardown
- mpv 与 Swift 状态同步
这些东西单独看都不算什么大功能，但叠起来以后，非常影响一个播放器到底“顺不顺手”。
我这一轮最大的感受也是：
做出一个能播放视频的 Demo 不难，难的是把播放器真正打磨到你每天愿意用。
3. TVBox 和 CatPawOpen 两条兼容链路重新梳理
这个项目现在其实有两套比较不同的源运行逻辑。
一类是传统的：
TVBox / CatVod / FongMi
包括 CMS 、QuickJS 、Java / Dex csp_ Spider 等。
另一类是：
CatPawOpen / MiraPlay 风格的 Node 视频接口
这一轮我花了很多时间去研究这两类项目原本的行为，然后尽量避免在 Mac 端“拍脑袋兼容”。
比如：
- 首页到底什么时候重新请求
- 分类切换是否应该缓存
- detail 请求如何调度
- Node runtime 是否重复初始化
- Spider 生命周期
- 搜索并发
- 超时隔离
- 播放地址解析
- 网盘类源的处理
- Action / Dialog 回调
- Java Spider 与原生运行时之间如何隔离
现在整体架构比第一版清楚很多。
4. Android 现在只是兼容层，不是软件运行基础
这个也解释一下。
有些传统 TVBox Java Spider 本质上就是 Android / Dex 生态，如果完全不提供 Android 兼容层，就没办法做到比较完整的兼容。
所以项目里有一个可选的 Android Bridge 。
但现在它的定位非常明确：
Native 优先，Android fallback 。
也就是说：
普通 CMS 、QuickJS 、Node .js.md5、直播、XMLTV 、正常播放都不需要 Android 。
只有确实遇到 Java / Dex csp_ Spider 时才会启动这个兼容环境。
这一点我后面还会继续优化。
长期方向肯定是：
能原生处理的全部原生处理，Android 只留给无法替代的兼容场景。
5. 这次反而砍掉了一些“想做的功能”
比如 TMDB 详情增强，我原本准备放进 0.4.0 。
后来做着做着决定先停下来。
一方面是国内网络环境下 TMDB API 的可用性问题，另一方面我觉得这一版继续加功能，意义已经不大了。
所以最后选择：
先把现有东西做好，再增加下一层能力。
TMDB 、详情信息增强之类的东西，准备留到后面的版本。
项目不提供什么
这个还是需要明确说明一下。
OKVideoMac 本身：
不内置任何第三方影视源、账号、Cookie 、解析服务或者 DRM Key 。
项目提供的是客户端、Provider 运行能力和播放器。
请只使用自己有权访问的配置和内容。
目前版本
OKVideoMac 0.4.0 （ Build 94 ）
系统要求：
- Apple Silicon Mac
- macOS 12.0+
- arm64
正式 DMG 已完成：
- Developer ID 签名
- Apple Notarization
- Staple
Release 里除了 DMG ，也提供了对应源码、第三方源码和许可证归档、SBOM 、Notices 、Manifest 、SHA256SUMS 等发布材料。
GitHub：
https://github.com/yaolin-dev/OKVideoMac
0.4.0 Release：
https://github.com/yaolin-dev/OKVideoMac/releases/tag/v0.4.0
项目采用 GPL-3.0 开源。
最后
这个项目最开始其实就是因为一直没找到一个自己真正喜欢的 macOS 客户端，所以决定自己写。
做第一版的时候觉得：
“功能跑通应该就差不多了。”
真正连续用了一个月以后才发现，大量工作其实发生在功能跑通之后。
状态管理、播放器生命周期、缓存、并发、异常路径、源兼容、窗口行为、UI 一致性……
这些东西很难截图展示，但可能才是一个软件从 Demo 变成日常工具真正需要花时间的地方。
0.4.0 对我来说更像是 OKVideoMac 第一个真正成型的版本。
项目还比较年轻，肯定还有不少问题。
如果有 Apple Silicon Mac ，欢迎试一下。
尤其如果你也在做 SwiftUI 、libmpv 、播放器、TVBox / CatVod / CatPaw 相关的东西，也很欢迎交流实现思路。
Bug 或兼容性问题可以直接提 Issue 。
另外也很好奇 V2EX 上有没有人在做类似的：
“把原本偏 Android / TV 的开放源生态，重新做成原生桌面应用”
这类项目。
感觉这里面其实还有很多挺有意思的问题可以继续折腾。
Select Language