大家好，之前开源了一个自己做的 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 我主要重新做了什么？
- UI 基本重新设计了一遍 这是这一版最直观的变化。首页、分类、搜索、详情、收藏、历史、设置等页面都重新统一了一遍。
包括： Sidebar Toolbar / Titlebar 筛选器 选中状态 弹窗 滚动区域 字体层级 间距 深色模式 窗口尺寸变化 都尽量回归 macOS 自己的交互方式。第一版多少还有一点“把电视端软件搬到电脑上”的感觉。
这一版我越来越明确一个原则： 既然它运行在 Mac 上，那它首先应该是一个 Mac App ，其次才是一个影视客户端。所以现在很多地方都改成了 SwiftUI / AppKit 更自然的交互，而不是照着 Android TV 的思路做。
- 播放器还是 libmpv ，但底层改了很多 播放器核心没有换，依然是 libmpv 。但这一轮真正花时间的，其实不是“能不能播放”，而是大量播放器生命周期问题。
比如： 首帧什么时候真正 ready 播放器打开 / 退出的资源释放 连续切集 快速拖动进度条 播放到结尾 用户主动快进到结尾 自动下一集 直播连续换台 播放失败后的清理 窗口关闭后的 teardown mpv 与 Swift 状态同步 这些东西单独看都不算什么大功能，但叠起来以后，非常影响一个播放器到底“顺不顺手”。我这一轮最大的感受也是： 做出一个能播放视频的 Demo 不难，难的是把播放器真正打磨到你每天愿意用。
- TVBox 和 CatPawOpen 两条兼容链路重新梳理 这个项目现在其实有两套比较不同的源运行逻辑。一类是传统的： TVBox / CatVod / FongMi 包括 CMS 、QuickJS 、Java / Dex csp_ Spider 等。
另一类是： CatPawOpen / MiraPlay 风格的 Node 视频接口 这一轮我花了很多时间去研究这两类项目原本的行为，然后尽量避免在 Mac 端“拍脑袋兼容”。比如： 首页到底什么时候重新请求 分类切换是否应该缓存 detail 请求如何调度 Node runtime 是否重复初始化 Spider 生命周期 搜索并发 超时隔离 播放地址解析 网盘类源的处理 Action / Dialog 回调 Java Spider 与原生运行时之间如何隔离 现在整体架构比第一版清楚很多。
- Android 现在只是兼容层，不是软件运行基础 这个也解释一下。有些传统 TVBox Java Spider 本质上就是 Android / Dex 生态，如果完全不提供 Android 兼容层，就没办法做到比较完整的兼容。
所以项目里有一个可选的 Android Bridge 。但现在它的定位非常明确： Native 优先，Android fallback 。
也就是说： 普通 CMS 、QuickJS 、Node .js.md5 、直播、XMLTV 、正常播放都不需要 Android 。只有确实遇到 Java / Dex csp_ Spider 时才会启动这个兼容环境。
这一点我后面还会继续优化。长期方向肯定是： 能原生处理的全部原生处理，Android 只留给无法替代的兼容场景。
- 这次反而砍掉了一些“想做的功能” 比如 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： /ai-market-guide/ 0.4.0 Release： /ai-market-guide/ 项目采用 GPL-3.0 开源。最后 这个项目最开始其实就是因为一直没找到一个自己真正喜欢的 macOS 客户端，所以决定自己写。
做第一版的时候觉得： “功能跑通应该就差不多了。真正连续用了一个月以后才发现，大量工作其实发生在功能跑通之后。
状态管理、播放器生命周期、缓存、并发、异常路径、源兼容、窗口行为、UI 一致性…… 这些东西很难截图展示，但可能才是一个软件从 Demo 变成日常工具真正需要花时间的地方。 0.4.0 对我来说更像是 OKVideoMac 第一个真正成型的版本。
项目还比较年轻，肯定还有不少问题。如果有 Apple Silicon Mac ，欢迎试一下。
尤其如果你也在做 SwiftUI 、libmpv 、播放器、TVBox / CatVod / CatPaw 相关的东西，也很欢迎交流实现思路。 Bug 或兼容性问题可以直接提 Issue 。
另外也很好奇 V2EX 上有没有人在做类似的： “把原本偏 Android / TV 的开放源生态，重新做成原生桌面应用” 这类项目。感觉这里面其实还有很多挺有意思的问题可以继续折腾。