MDHan / a7c2-fl23-macos

# Mac 给 A7C II 安装 FL2 / FL3
用 Mac 给 **索尼 A7C II（ILCE-7CM2）、2.01 版系统**加入 FL2 / FL3 两种创意外观，可选择同时跳过开机时的 NTSC 提示。当前工具版本：**0.2.2**。
## 可以做什么
| 功能 | 说明 |
| --- | --- |
| 添加 FL2 / FL3 | 在相机内直接选择两种创意外观，用于拍照 |
| 修复卡上预设调出报错 | 处理 FL2 / FL3 保存到存储卡 M1–M4 后，调出时提示“文件错误”的问题 |
| 可选跳过开机提示 | 如果相机开机会出现 NTSC 提示，可以选择安装跳过提示的版本 |
| 备份、安装和升级 | 保存自己的原始备份；已装旧版 FL2 / FL3 的用户可以升级 |
| 安装后检查 | 检查安装是否完整，以及重新开机后是否已经生效 |
| 恢复原版 | 提供恢复功能，但实际恢复尚未测试，不能保证遇到故障时能救回相机 |
**M1–M4 在存储卡上，机身内的 1 / 2 / 3 是另一组位置。两个版本都包含卡上预设的报错修复。**
## 两个版本怎么选
| 你需要的功能 | 选择 |
| --- | --- |
| 只要 FL2 / FL3，保留原来的开机提示 | **FL2 / FL3 版（默认）** |
| 要 FL2 / FL3，也想跳过 NTSC 开机提示 | **FL2 / FL3＋跳过提示版** |
这个选项负责跳过提示，照片和视频的设置仍由你在相机里选择。已经装好本次版本、使用正常的用户，**不用为了更新电脑上的工具再刷一次相机**。
## 开始前看这里
- **只支持 A7C II 的 2.01 版系统。** 不支持 A7CR、其他机型或其他系统版本。
- 需要一台 Mac、一根能传数据的 USB 线；实际测试用的是 MacBook Air M4，其他 Mac 尚未测试。
- 写入前相机实际电量至少 **50%**，Mac 接好电源。不要估算电量。
- 备份要保留在自己的电脑上，不要删除，也不要发到公开网站。
- **这是实验改装，有无法正常开机的风险。备份不保证能救回相机。** 从未改装的相机仍有已知安装中断问题，建议这类用户暂缓尝试。
目前，一台相机已经完成“旧 FL2 / FL3 升级到跳过提示版”，使用者确认拍摄回放、M1–M4 保存调出和开机提示表现正常。**0.2.1 新增的自动完成升级流程，只做了电脑端测试，尚未重新在相机上完整测试。** 详细范围见验证记录。
## 最省事的用法：让本地 AI 帮你操作
如果 Mac 上装了能访问本机文件和 USB 的 Codex、Claude Code 等工具，可以把下面这段复制给它，并补充你选的版本：
 [code] 
普通网页聊天不能直接操作本机相机。AI 也不能代替你取电池、看相机屏幕或试拍。
下面是自己操作的方法；不熟悉终端时，优先使用上面的方式。
## 自己操作：先下载工具
打开 Mac 的「终端」，先检查 Python：
 [code] 
需要 Python 3.10 或更新版本。不知道怎么安装时，让前面的本地 AI 帮忙准备。
然后运行：
 [code] 
这一步不需要输入相机电量，也不需要连接相机。已有工具文件夹时先保留原文件，更新到最新版本，不要删除旧备份。后面的命令都在 `a7c2-fl23-macos` 文件夹里运行。
## 连接与冷启动
**连接相机：** 用数据线直连 Mac，在相机上选择 **第 2 项「影像传输（MSC）」**。不要选实时流式传输或电脑遥控。后续再次询问连接方式时，也选这一项。
**需要冷启动时：** 拔下 USB，正常关机，等存取灯熄灭，取出电池约 **10 秒**，再装回开机，然后重新连接相机。只关机再开机不算完成这一步。
**只有工具明确完成、相机没有错误时，才按提示关机和取电池。正在写入、报错或结果不明时，先停下查看说明，不要直接拔线或重刷。**
## 首次安装
仅适用于**从未改装、仍为原版 2.01** 的相机。首次安装的已知中断问题尚未解决，以下供了解风险后选择尝试的用户使用。装过旧版的相机请走旧版升级。
### 1. 连接并检查
按上面的方法连接相机，然后运行：
 [code] 
如果没有识别到相机磁盘，先检查数据线和连接方式，不继续安装。
### 2. 选一个版本并备份
下面两条**只选一条**。备份会保存在「图片」文件夹下的 `A7C2-work`，这个文件夹必须是新的；如果已经存在，先保留并查看原来的记录。
 [code] 
 [code] 
看到 `Password:` 时，只在终端输入 Mac 管理员密码。输入时没有字符显示是正常现象，不要把密码发到聊天里。
**等到命令结束，看到 `RESULT: prepared`，再进行下一步。** 这时备份和安装前检查已完成，还没有写入相机。
### 3. 开始安装
复制整段，按提示输入相机屏幕显示的当前电量，只输入数字：
 [code] 
安装期间保持连接，不关机，不同时打开其他相机工具。看到 `RESULT: installed_pending_cold_start`，表示这一轮安装已完成，接着做冷启动与验证。
没有看到这个完成结果，或出现 `STOPPED`，不要重跑安装，先看状态与报错。
## 旧版升级
适用于**已装旧版 FL2 / FL3，并保留原来完整备份和安装文件夹**的用户。原来的安装必须已经完成并检查通过。旧版跳过提示版、其他改装、没有备份或上次没完成的情况，目前不能直接用这个流程。
### 1. 准备新的升级文件夹
下面的 `A7C2-old-work` 代表你原来的安装文件夹，**要换成自己的实际位置**。如果不知道在哪里，用前面的本地 AI 方式协助查找，不要随便填。
原文件夹会保留，新内容放在「图片」下的 `A7C2-upgrade`。新文件夹必须尚不存在。下面两条同样**只选一条**：
 [code] 
 [code] 
这一步不用连接相机，也不加 `sudo`。必须确认提示“离线升级目录已准备”，再继续。
### 2. 连接并升级
先完成一次取电池冷启动，再连接相机，选择第 2 项 MSC。然后复制整段，输入当前实际电量：
 [code] 
0.2.1 已处理本次遇到的中途检查卡住情况；**符合检查条件时，这条命令会直接完成升级，不需要再单独运行收尾命令。** 如果还有其他异常，仍会停止，不会强行继续。
看到 `RESULT: installed_pending_cold_start` 后，按下一节操作。以后检查和恢复都用**新的升级文件夹**，原文件夹保留，不要混用。
## 冷启动与验证
安装或升级明确完成后：
1. 拔 USB、正常关机，等存取灯灭，取电池约 10 秒，再装回开机。
2. 用 ST、FL2、FL3 各拍新照片并回放。
3. 把 FL2 / FL3 保存到空闲的 M1–M4 位置，再调出，检查是否还有“文件错误”。不要覆盖需要保留的预设。
4. 如果安装了跳过提示版，检查原来开机会出现的 NTSC 提示是否不再出现。
5. 重新