固件编辑器

From the project's README ("快速开始"):

1. 准备环境

安装 64 位 Python 3.12，下载源码并解压到可写目录。GitHub 发布后，可在仓库页面选择 Code → Download ZIP 获取源码。

生成文件还需要 LLVM 工具链，首次配置方法见使用指南。编辑前不必先配置 LLVM。

1. 启动工具

系统	操作
Windows x64	双击项目目录中的 start.cmd
macOS	在项目目录打开终端，运行 sh start.sh

首次启动会自动创建 .venv 并安装固定版本的 Python 依赖，需要联网。滤镜本地校色还需要 numpy、rawpy、opencv-python-headless 和 capstone；启动器会检查这些模块。随后自动打开浏览器；默认地址为 http://127.0.0.1:8787，端口被占用时会更换，请以启动窗口显示的网址为准。

关闭启动窗口或按 Ctrl+C 停止服务。下次运行同一启动器即可继续使用。

1. 完成第一次编辑

2. 点击右侧 导入固件，选择通过完整结构校验的 GR4 .bin 文件。

3. 在左侧选择 裁切比例 或 关机图案，完成编辑。

4. 点击 保存修改。修改比例后，须先点击比例旁的 确认。

5. 首次生成前，打开 更多 → 生成设置，配置 LLVM 并点击 检查并保存。

6. 点击 生成固件，阅读并确认使用要求，再下载固件与构建清单。

导入前可选择 自动识别 / 1.11 / 1.20；选择与文件不符时会拒绝导入，不会只修改版本号。1.20 的背景、裁切和滤镜操作沿用同一界面，官方原有及新增功能保留。

将 1.11 客制配置迁移到 1.20

先导入自己的 1.11 客制固件，或打开已保存的 1.11 编辑记录，点击 一键迁移到 1.20 并选择官方原版 1.20 BIN。工具保存当前草稿，读取滤镜颜色、图标和参数、裁切配方与历史身份、关机图片与列表，再新建 1.20 项目。检查后点击 生成固件 即可。

迁移不复制 1.11 原生程序或地址，实际固件以官方 1.20 为基底重新编译。原 1.11 项目保留。评分、影集、AF 实验及柔光不在此公开适配范围内。详细兼容边界见 双版本与迁移说明。

生成栏的 支持刷回低版本固件 默认开启。点击开启时会提示：刷入低版本回退固件前，请先在相机执行 相机设置 → 重设 → 重设为出厂设置，否则功能丢失可能导致菜单卡死。该选择只作用于新生成的固件，须先成功安装带此改动的固件才可能影响后续更新；离线检查不代表实机刷入成功。

导入 XMP 并生成滤镜

公开版的 XMP 规则与研究版一致：支持包含完整颜色数据的 Adobe Camera Raw Look/Profile，包含全局曲线和颜色表；普通 Develop 调整、只引用外部 Stubbed Look 的文件，以及局部蒙版、修复、镜头模糊等内容会被标记为不完整。打开 滤镜 后先点击 新增滤镜，从原厂滤镜复制一个模板创建可编辑槽位；原厂槽位保持只读。先在色彩区 设置 → 转换方式 选好链路，再在自定义槽位点击 导入 XMP，导入即启动转换；已有 XMP 切换链路时须点击 重新转换。全新安装会自动把仓库内置的 3 张 GR IV DNG 复制到本机用户数据目录，并指定 R0000398.DNG 为独立检查样片；已有校色数据不会被覆盖，仍可在校色设置中换成自己的样片。样片合计约 97 MiB，会随源码下载；原始文件不会上传。 …

Read the full instructions

From the project's README ("功能"):

功能	当前状态
裁切比例	新增自定义比例、预览、命名和排序
关机画面	导入图片、预览、选择显示方式、管理图案
编辑记录	保存草稿、导入与导出编辑备份
版本历史	查看版本与来源、载入编辑、生成回退文件
低版本固件更新	生成时可选择支持刷回低版本固件；默认开启
滤镜与 XMP	导入完整 Look/Profile XMP；默认本地模拟，Windows 可选 Lightroom Classic 生成目标，再拟合候选颜色资源
固件系列	选择或自动识别 1.11 / 1.20，按实际输入布局编译
一键迁移	读取已识别的 1.11 客制配置，迁移到用户提供的官方 1.20，保留原编辑记录
画意摄影	1.20 提供独立实验开关，默认关闭；原厂未开放完整效果，目前使用 Mono Standard 灰度路径

本工具只生成文件，不会自动刷写设备。仓库不提供原厂固件、JPEG 样片或第三方 XMP；作者提供的 3 张 GR IV DNG 用于本地近似校色。

Read the full instructions