先选对入口
这是 索尼 A7R V / A7R5，机身型号 ILCE-7RM5 的项目。A7M4、A7R IV、A7C II 不能套用。下面把固件、滤镜和电脑工具分开介绍，第一次来不必全部安装。
原项目 GitHub：Hearts-Ace / sony-a7r5-custom-firmware。原作者的更新、源码和发布记录都在这里；本站提供固定版本的源码镜像与中文上手说明。
| 你的目的 | 先看哪里 |
|---|---|
| 看看这个项目能做什么 | 下方「版本与功能」 |
| 已经有兼容固件，想用现成的 12 款滤镜 | 「导入现成滤镜」 |
| 想在电脑上制作自己的色彩效果 | 图形工具二：R5ColorLab |
| 想研究相机网格对颜色的影响 | 图形工具三：R5GridCalibrator |
| 想用 Mac 准备更新文件、备份更新器 | 图形工具一：R5 刷写工作台，先核对版本 |
本页下载的 ZIP 是源码，不是完整固件，也不是双击即可安装的 Mac 应用。它包含固件构建源码、刷写台源码、说明和滤镜 BIN；不包含 BODYDATA.DAT、完整 AP / CP、签名私钥或机身备份。
01 / 版本与功能：这几个数字不是一回事
内容核对日期：2026-11-04。本页固件仓库快照为 06aff1e。
| 名称 | 当前对应版本 | 你需要注意什么 |
|---|---|---|
| 主仓库固件源码 | 4.48 | 从指定原厂 R5 4.00 输入构建；仓库不提供完整 DAT |
| R5 刷写工作台 | 0.2.1，仍以 4.36 为目标 | 当前提交只有源码，未重打应用包；不能当成 4.48 通用刷写器 |
| R5ColorLab | v4.5 色卡，当前共享 C1 训练源码 | 已迁到独立色彩仓库；v4.5 是色卡版本，不是固件版本 |
| 滤镜文件格式 | BIN v4 | 指文件结构版本，不是「固件 4.00」 |
| 本页介绍的现成滤镜 | 2026-11-04 共享 C1 批次 | 与刷写台目录附带的旧批次不同，按下面的路径取文件 |
4.48 的主要内容包括：自定义滤镜和网格、固定 C.Look 图标、自定义滤镜 Fn 手动注册、R6 ST 参数、FL2 / FL3 参数保留、白平衡优先参数调整，以及快门声和十档音量。新拍一张时可以打断旧快门声，清理完成后从头播放最新一拍；快速连拍保留最新待处理触发。
这里说的是项目的实现和离线验证结果。作者仍将 4.48 实体安装、扬声器与连拍时序、LCD、冷启动等列为待机身验收，不能据此理解为所有机身已经实测通过。刷写有无法开机、设置或校准丢失的风险。近期有重要拍摄任务，先把工作拍完再研究。
02 / 图形工具一：R5 刷写工作台
它是一个 Mac 原生 SwiftUI 应用，用于整理更新文件、导出滤镜、查看任务记录，以及通过普通 USB / MSC 准备更新信任。它不是滤镜训练工具。
先确认能不能运行
- 面向 Apple Silicon Mac，最低编译目标为 macOS 14；Intel Mac、Windows 和 Linux 不在此工作台的支持范围。
- 当前公开的是 0.2.1 源码，固件目标仍是 4.36。本页 ZIP 中没有已经打包好的
.app，也没有.dmg。 - 原作者对完整打包应用的说明是：备份、校验和导出使用随包 Python / libusb，不需要额外安装 Python、Homebrew 或 Node；这不代表源码 ZIP 已带齐该运行环境。
- 从源码打包需要按作者说明另行准备编译工具、运行组件和外部公钥等材料，新手不建议把它当作一键安装包。
界面里这几个按钮怎么理解
| 入口 | 作用 | 不代表什么 |
|---|---|---|
| 导出最新滤镜 | 把该应用实际附带的 R5NATIVE.BIN 放到选定目录或存储卡 | 不会自动联网取得本页介绍的新批次 |
| 固件＋滤镜一起准备 | 核对适配 DAT，再复制到目标目录并读回检查 | 文件准备成功不等于相机已经升级 |
| 离线自检 | 检查本地应用和材料的完整性 | 不代表机内功能已经实测 |
| USB 维护 → 备份更新器分区 | 对更新器分区读取两遍并核对，保存回执 | 不是整机备份，不覆盖全部机身数据 |
| 安装更新信任 | 在满足原像与备份条件时准备该工作台的签名信任 | 不是通过 USB 直接刷入完整 AP / CP |
| 任务记录 | 查看日志、完成状态和失败现场 | 不能通过删除记录或锁来强行重试 |
如果你已经另有可信、完整且版本匹配的应用，操作顺序应是：离线自检 → 核对固件目标 → 按需备份更新器 → 核对回执 → 按需准备信任 → 准备存储卡文件 → 在相机菜单中执行更新。设备操作涉及管理员授权，以完整提示为准。出现未知原像、回读不一致或事务未完成时，保留日志后停止重复写入。
工作台没有整机备份、自动回滚或强制安装入口，作者也明确说明它尚未完成真实 USB 接管、信任安装、卡刷和拍摄验收。不要拿当前 4.36 工作台直接处理 4.48 文件，也不要把 A7M4 教程里的工具拿来替代。
「AI 助手」是什么
它会复制一份操作说明，供外部本地 AI 调用应用内的 r5wb 接口。工作台本身没有内置大模型，也不需要填 API Key。可以先生成计划、导出文件和查看回执；这不等于给 AI 自动操作相机的授权。
03 / 图形工具二：R5ColorLab 色彩工作台
这是做滤镜的工具。程序在自己电脑上运行，操作界面在浏览器里打开；不需要把照片上传到本站，也不会给相机刷固件。
GitHub：独立色彩仓库 · 工作台使用说明 · 下载对应版本完整源码（GitHub）
第一次启动
安装 Python 3.12，下载并解压上面的色彩仓库。在解压目录里找到 R5ColorLab 文件夹；它不在本站的固件源码 ZIP 中。
Windows：进入 R5ColorLab 文件夹，在地址栏输入 powershell 并回车，然后逐行执行：
py -3.12 -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
.\.venv\Scripts\python.exe launcher.py
Mac：在终端进入该文件夹，逐行执行：
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python launcher.py
浏览器打开 http://127.0.0.1:4180。这是你自己电脑的地址，程序只监听本机。使用时保持终端开着，结束后在终端按 Ctrl+C。若提示端口占用，可以在启动命令末尾加 --port 4181，然后访问对应地址。
仓库也提供 Windows 的「启动R5色彩工作台.bat」和 Mac 的同名 .command。先按文档安装依赖，不能把启动脚本理解为已打包的安装器。首次安装依赖需要联网。
打开界面后做什么
- 先确认色卡版本。当前默认是 v4.5、5300K 的合成色卡，界面提供 Sony ARW、DNG 和 GFX100S II RAF。不要混用旧 v4 目标图。
- 准备目标效果。按作者说明导出同尺寸 TIFF，推荐 16 位；也支持 JPG 或
.cube目标。保留方向和拍摄白平衡，不裁切、不缩放。 - 建立配置。导入目标，设置配置编号、简称和全称，再选择训练设置。第一次先用默认 CPU；Apple Silicon 的 Metal / MPS 加速需要额外依赖，不是打开页面就自动启用。
- 训练后查看评估。工具拟合相机原生参数和网格，不是把普通
.cube原样塞进相机。低误差不保证每个真实场景都与目标效果相同。 - 导出 BIN v4。导出前还要满足原厂网格来源或网格拟合条件。得到的 R5NATIVE.BIN 供兼容固件导入，不能在原厂固件里直接安装。
只想用现成滤镜，不必训练。直接看下一节的导入方法即可。
04 / 导入现成的十二款滤镜
前提：相机已经安装支持本项目 BIN v4 的兼容固件。普通原厂固件不会因为卡里多了一个 BIN 就自动出现滤镜菜单。
本页介绍的新批次包含：AS、CC、EBB、ET、NC、NH、PV、RA、VN、正片、负片、Portra400。名称用于说明模拟目标，不是相关品牌的官方滤镜，也不保证还原所有场景。
- 下载本页的固件仓库源码 ZIP 并解压。
- 找到
filters/FUJ_12_v45/R5NATIVE.BIN。也可以从原作者当前滤镜目录取得同一文件。 - 先保留自己原有的滤镜文件，再把这份 R5NATIVE.BIN 放到存储卡根目录。根目录就是打开卡后直接看到的位置，不是 DCIM 文件夹。
- 按所用兼容固件的正常关机／冷启动导入流程加载配置；恢复启动不扫描卡。一次导入的是整套配置，先保留旧配置再替换。
- 打开相机自定义滤镜菜单检查名称，拍照、保存、回放。正式拍摄前，在自己常拍的光线和白平衡条件下试几张。
这份 BIN 为 29,552 字节，SHA-256：
2e9c60c1f7858940e366aa1b0f2c0c089347445c9c286c0c938a40a35610caee
别选错同名文件：R5FlashWorkbench/engine/filters/R5NATIVE.BIN 是工作台附带的较早批次，校验值以 19e020fa 开头；它与上面这份 2e9c60c1 开头的新批次不同。旧 Release 的附件也不能只凭同名判断是最新文件。
05 / 图形工具三：R5GridCalibrator 网格反推工具
它也是本地浏览器界面，用于拍摄探针照片、拟合相机网格的响应，主要面向愿意做标定实验的人。只用现成滤镜，不需要做这一步。
需要 Python 3.11–3.13，推荐 3.12。进入独立色彩仓库中的 R5GridCalibrator，按它自己的 requirements.txt 建立环境并启动 launcher.py，方法与上一节相同，不要误装成 R5ColorLab 的依赖。默认地址是 http://127.0.0.1:4190；目录里也有对应的 .bat 和 .command。
当前正式拟合设置还涉及 PyTorch 和 requirements-gpu.txt，默认设备为 Apple MPS。普通 CPU 或 Windows 环境需要按作者说明选择可用设备并安装求解器依赖；仅能打开页面，不代表训练所需环境已齐全。
实际流程是：
- 上传已有的 BIN v4，选择源配置，生成含 12 个探针的文件包。
- 先保存原 BIN，再按兼容固件流程导入探针 BIN；它会完整替换原自定义配置集。
- 固定机位、光线、曝光、ISO、白平衡和其他调节，按 1–12 顺序各拍一张 JPG。
- 在页面选择拍摄文件夹，先核对照片与探针编号的对应，再上传并训练。
- 导出响应 JSON 和误差报告，最后重新导入自己的原 BIN 恢复滤镜。
导出的 JSON 是电脑预测模型，不是固件，也不是能直接导入相机的滤镜 BIN。一次标定不能自动代表其他光线、ISO、白平衡和场景。
06 / 想换快门声：先在电脑转成 R5S
本仓库提供的是 命令行转换器，不是独立图形声音编辑器。声音文件需要先在电脑从 WAV 转成 .R5S，再供对应固件冷启动导入。
在解压后的固件仓库根目录运行：
python3 firmware/r5/host/prepare_sound.py convert "声音.WAV" -o "声音.R5S"
python3 firmware/r5/host/prepare_sound.py inspect "声音.R5S"
Windows 把 python3 换为 py -3。转换需要 Python 3.9+ 和可用的 clang 或 gcc；检查已有 R5S 只需 Python。仅接受 整数 PCM WAV，最多 1 MiB、最长 2 秒，不支持 MP3 改后缀。确认转换和校验都成功后，按匹配固件说明把 R5S 放到 SD 卡根目录。
一个 R5S 包含 10%–100% 十档音量。R5 的文件格式、路径和时长条件与 A7M4 不同，不要照搬 A7M4 的 WAV 文件夹导入步骤。
07 / 为什么没有完整固件？能不能自己构建？
作者沿用源码发布方式，不分发完整 BODYDATA.DAT、AP / CP、原机镜像和签名私钥。主仓库的当前构建入口是 firmware/r5/build.py，需要匹配 SHA-256 的原厂 R5 4.00 输入、外部签名材料和工具链。输出目录必须是新的目录。
有 build.py 不等于下载后就能一键刷机。从源码成功构建、文件复制到卡里、相机安装完成，是三件不同的事。本文不把未经验证的第三方包推荐给新手，也不承诺任意版本可降级或恢复。
4.48 构建要求 · 作者发布范围与验证边界 · GitHub Releases（历史附件）
本页 ZIP 是 GitHub 对应提交的原始源码归档，未经额外捆绑。展开上方「文件信息与校验」，可核对文件名、大小和 SHA-256。Windows PowerShell 中执行：
Get-FileHash -Algorithm SHA256 .\sony-a7r5-source-06aff1e.zip
校验一致表示下载文件与本站镜像相同，不表示任何固件都适合你的机身。
08 / 遇到问题，带这些信息来交流
QQ 交流群：824558022。页面下方可以复制群号或扫描二维码。
提问时带上：机身型号和当前固件、电脑系统与 CPU 类型、使用的是哪个工作台、工具版本或源码提交、完整报错，以及卡在了哪一步。USB 操作失败时保留任务记录，不公开机身备份、校准数据、私人照片或密钥。
只是电脑界面打不开，先看终端是否还在运行、依赖是否安装成功、地址和端口是否正确；相机正在写入或更新时，按对应工具和机身提示处理，不要为了排查电脑问题随意断电、拔线。
拍完照片后，也可以看看镜笺 Mark的拍摄参数展示，或者用光轴脚本 LCT安排日出日落的拍摄时间。其他教程放在光子方程工具箱。
来源、许可与更新
本页由光子方程依据原作者文档与界面源码整理，未进行相机实刷。原项目与本站没有隶属关系。
- 固件与 Mac 刷写台：Hearts-Ace/sony-a7r5-custom-firmware，对应完整提交 06aff1e06e2be730de1e39f52febdc4c797d4c68。
- 色彩与网格工具：Hearts-Ace/sony-r5-colorlab，本页说明对应 5bd1841d8e7f82b5ae4009a61d81a11d97c5ba0e。
- 仓库原创部分与各第三方组件分别保留许可；Mac 刷写台带有个人非商业研究使用限制，不能据根目录 MIT 将其解释为可收费代刷或商业整合。色彩与网格工作台使用 AGPL v3。
- 镜像保留
LICENSE、THIRD_PARTY_NOTICES.md、各目录许可及来源说明，不额外打包 Sony 固件或签名私钥。
后续有新版本，优先查看上面的 GitHub。教程的适用条件随具体提交而定，不按相近的版本号推定兼容。
