超然求索媒体播放器 Mac 使用说明

版本：1.0.21

这个压缩包是给 Mac 电脑打包使用的项目文件。Windows 电脑不能直接生成 macOS 可独立运行的 .app，所以请把这个压缩包发到 Mac 上解压，然后在 Mac 上完成打包。

一、Mac 上需要先准备

1. 安装 Python 3。
2. 安装 VLC for macOS。
   默认位置建议保持为：
   /Applications/VLC.app

二、解压后怎么打包

1. 在 Mac 上解压这个压缩包。
2. 打开“终端”。
3. 进入解压后的文件夹，例如：

   cd ~/Downloads/chaoran-media-player-mac-package

4. 运行：

   bash build_macos.sh

三、打包后的软件在哪里

打包成功后，会在 dist 文件夹里生成：

   超然求索媒体播放器_v1.0.21.app

这个 .app 就是 Mac 上可以双击运行的软件。

四、如果 VLC 不在默认位置

如果 VLC 没有安装在 /Applications/VLC.app，可以这样运行：

   VLC_APP_PATH=/你的/VLC.app/路径 bash build_macos.sh

五、软件主要功能

这个媒体播放器支持播放视频、浏览图片，并会自动读取同一文件夹里的同类媒体文件列表。特别适合剪视频前筛选素材：

- 可以边播放、边查看素材。
- 有“分拣1号”和“分拣2号”两套保存位置。
- 可以把当前正在看的视频或图片一键复制到指定文件夹。
- 也可以一键剪切到指定文件夹。
- 两套分拣操作都可以设置快捷键。

这样剪视频前挑素材时，不用反复在播放器和文件管理器之间切换。

六、注意

- 第一次打包会安装 Python 依赖，需要联网下载依赖包。
- 打包完成后的 .app 包含 VLC 播放核心和插件，适合在 Mac 上独立运行。
- 如果 macOS 提示来自未识别开发者，需要在系统设置的“隐私与安全性”里允许打开。
