VTR Access for macOS  ——  首次打开必读
========================================

版本：5.1.1（构建号 20261020）
系统要求：macOS 12.0 或更高（已在 macOS 15.1 上实测）
架构：通用二进制（universal），Apple 芯片与 Intel 芯片共用这一个包，
      不必挑包 —— 在 Apple 芯片上以 arm64 运行，在 Intel 上以 x86_64 运行。


一、第一次打开"闪退"？—— 先看这一节
------------------------------------
双击后图标在程序坞弹一下就消失、或者提示"无法打开"、或者提示
"已损坏，应该移到废纸篓"—— 这三种都是同一件事，不是软件坏了，
也不是文件没下载全，而是 macOS 的 Gatekeeper 拦截。

原因：本应用没有购买 Apple 的开发者签名（Developer ID），属于未公证应用。
只要文件是从网上下载或从聊天软件接收的，macOS 就会给它打一个叫
com.apple.quarantine 的"隔离标记"。带这个标记启动时，系统会在程序真正
运行起来之前就把它杀掉。把标记去掉即可，做一次就永久生效。

下面三种方法任选一种，做完正常双击使用。


二、方法一：双击"首次打开.command"（最省事）
--------------------------------------------
在本文件夹里双击「首次打开.command」。

如果系统连它也一起拦，就右键点它 → 选"打开" → 在弹窗里再点一次"打开"。

脚本会自动去掉隔离标记并启动 VTR Access。
（脚本和 VTR Access.app 要在同一个文件夹里；只把 app 拷走的话，
 用方法二。）


三、方法二：终端一行命令（最稳，一定有效）
------------------------------------------
1) 把 VTR Access.app 拖进「应用程序」文件夹
2) 打开「终端」：启动台里搜索"终端"或"Terminal"，或
   访达 → 应用程序 → 实用工具 → 终端
3) 把下面这一整行复制进去，回车，然后输入你的开机密码再回车
   （输入密码时屏幕不显示任何字符，这是正常的）：

   sudo xattr -dr com.apple.quarantine "/Applications/VTR Access.app"

4) 之后正常双击图标启动即可。


四、方法三：在"系统设置"里放行
------------------------------
先双击一次 app，被拦下后：
  系统设置 → 隐私与安全性 → 向下滚动到"安全性"一栏
  → 会看到关于 VTR Access 的提示 → 点"仍要打开" → 再确认一次

注意：macOS 15 起，旧的"右键 → 打开"绕过方式已被苹果取消，
      所以此处必须走"系统设置"这条路（方法一、二不受影响）。


五、常见疑问
------------
Q：闪退之后什么都没发生，怎么确认是这个问题？
A：看那个 app 有没有被系统拦住。最直接的办法就是走方法二，
   一条命令下去必定解决；如果命令跑完仍打不开，请把终端里的报错发我们。

Q：每次打开都要做一遍吗？
A：不用。隔离标记去掉一次就永久生效。

Q：提示"VTR Access 已损坏，应该移到废纸篓"？
A：这是隔离标记 + 未公证签名共同导致的同一类拦截，不是文件真的损坏，
   千万别点"移到废纸篓"。用方法二（终端命令）一定能解决。

Q：这个包在 Intel 机器和 Apple 芯片机器上都能用吗？
A：都能用，本包是通用二进制，同一个包两种机器都能跑。
   （早期版本分 arm64 / amd64 两个包，本版已合并为一个，不用再挑。）

Q：能做到不弹任何提示、双击即用吗？
A：可以，但需要购买 Apple 开发者账号（每年 99 美元）并做公证（notarization），
   把签名信息换成正式的 Developer ID。目前本包是本地 ad-hoc 签名，
   所以必须走上面的"去隔离"步骤。这是苹果的分发策略，非应用本身问题。

Q：打开后连不上、提示没有权限？
A：首次启动时 macOS 会问"是否允许 VTR Access 使用网络/VPN 配置"，
   要选"允许"；装了本应用后如需开启 TUN 模式，也会请求权限，同样要允许。
   若当时点了"不允许"，到 系统设置 → 隐私与安全性 里重新打开即可。
