gr-custom-tool 是一款在本机浏览器中运行的编辑工具。公开版负责固件容器读取、写入、版本策略和回退文件生成；在已核验的 GR IV 布局上，也可写入裁切、关机画面和滤镜资源。XMP 解析与颜色拟合沿用研究版规则。
快速开始 · 使用指南 · 校色说明 · 常见问题 · 支持作者 · 使用协议
本项目完全免费，如果你在其他地方收费获取了该项目，请退款并联系原作者。
上述免费与退款表述是作者渠道说明和倡议；GPL 允许合规收费分发，不限制第三方依法享有的 GPL 权利。
| 功能 | 当前状态 |
|---|---|
| 裁切比例 | 新增自定义比例、预览、命名和排序 |
| 关机画面 | 导入图片、预览、选择显示方式、管理图案 |
| 编辑记录 | 保存草稿、导入与导出编辑备份 |
| 版本历史 | 查看版本与来源、载入编辑、生成回退文件 |
| 低版本固件更新 | 生成时可选择支持刷回低版本固件；默认开启 |
| 滤镜与 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 用于本地近似校色。
- **可生成：**通过完整容器、节布局、版本一致性和校验核验的 GR4
1.11.10.xBIN 均可导入并生成保留资源的版本/回退候选；已适配的官方原版1.11.10.7与当前公开版候选还支持裁切、关机画面和滤镜资源写入。 - **1.20：**支持官方原版
1.20.10.11（相机显示 1.20）及本版编辑器生成的1.20.10.x产品固件。首次生成只需要用户自己的官方 1.20，无需另找旧官方固件或作者客制包；产物可在全新数据目录重新导入、继续编辑。研究版候选与未知布局不自动取得产品续编权限。 - **功能差异：**未登记布局的输入仍可保存、改版本和生成候选，但会保留原有裁切、关机、图标和无法识别的版本策略，不开放未经核验的原生写入。已识别的版本策略才会响应“支持刷回低版本固件”开关。
- **电脑：**Windows x64、macOS Apple Silicon / Intel；均需 64 位 Python 3.12。
官方输入按文件内容识别，仅版本号相同不足以确定兼容性。当前公开版尚未完成独立端到端及实机验收，macOS 尚未实机验证；文件生成成功不代表刷入、启动或设备功能正常。
安装 64 位 Python 3.12，下载源码并解压到可写目录。GitHub 发布后，可在仓库页面选择 Code → Download ZIP 获取源码。
生成文件还需要 LLVM 工具链，首次配置方法见使用指南。编辑前不必先配置 LLVM。
| 系统 | 操作 |
|---|---|
| Windows x64 | 双击项目目录中的 start.cmd |
| macOS | 在项目目录打开终端，运行 sh start.sh |
首次启动会自动创建 .venv 并安装固定版本的 Python 依赖，需要联网。滤镜本地校色还需要 numpy、rawpy、opencv-python-headless 和 capstone；启动器会检查这些模块。随后自动打开浏览器；默认地址为 http://127.0.0.1:8787，端口被占用时会更换，请以启动窗口显示的网址为准。
关闭启动窗口或按 Ctrl+C 停止服务。下次运行同一启动器即可继续使用。
- 点击右侧 导入固件，选择通过完整结构校验的 GR4
.bin文件。 - 在左侧选择 裁切比例 或 关机图案，完成编辑。
- 点击 保存修改。修改比例后，须先点击比例旁的 确认。
- 首次生成前，打开 更多 → 生成设置，配置 LLVM 并点击 检查并保存。
- 点击 生成固件，阅读并确认使用要求，再下载固件与构建清单。
导入前可选择 自动识别 / 1.11 / 1.20；选择与文件不符时会拒绝导入，不会只修改版本号。1.20 的背景、裁切和滤镜操作沿用同一界面，官方原有及新增功能保留。
先导入自己的 1.11 客制固件，或打开已保存的 1.11 编辑记录，点击 一键迁移到 1.20 并选择官方原版 1.20 BIN。工具保存当前草稿，读取滤镜颜色、图标和参数、裁切配方与历史身份、关机图片与列表，再新建 1.20 项目。检查后点击 生成固件 即可。
迁移不复制 1.11 原生程序或地址，实际固件以官方 1.20 为基底重新编译。原 1.11 项目保留。评分、影集、AF 实验及柔光不在此公开适配范围内。详细兼容边界见 双版本与迁移说明。
生成栏的 支持刷回低版本固件 默认开启。点击开启时会提示：刷入低版本回退固件前，请先在相机执行 相机设置 → 重设 → 重设为出厂设置，否则功能丢失可能导致菜单卡死。该选择只作用于新生成的固件，须先成功安装带此改动的固件才可能影响后续更新；离线检查不代表实机刷入成功。
公开版的 XMP 规则与研究版一致：支持包含完整颜色数据的 Adobe Camera Raw Look/Profile，包含全局曲线和颜色表；普通 Develop 调整、只引用外部 Stubbed Look 的文件，以及局部蒙版、修复、镜头模糊等内容会被标记为不完整。打开 滤镜 后先点击 新增滤镜，从原厂滤镜复制一个模板创建可编辑槽位；原厂槽位保持只读。先在色彩区 设置 → 转换方式 选好链路，再在自定义槽位点击 导入 XMP，导入即启动转换；已有 XMP 切换链路时须点击 重新转换。全新安装会自动把仓库内置的 3 张 GR IV DNG 复制到本机用户数据目录，并指定 R0000398.DNG 为独立检查样片；已有校色数据不会被覆盖，仍可在校色设置中换成自己的样片。样片合计约 97 MiB，会随源码下载；原始文件不会上传。
“转换方式”默认 本地模拟，使用 LibRaw/OpenCV 近似渲染；Windows 还可选择 Lightroom Classic 作为目标渲染链路。选择 Classic 后，需自行安装并打开 Lightroom Classic，在 增效工具管理器 启用 GR4 Firmware Bridge；程序会准备桥接请求，不会自动启动 Classic。两种目标随后都进入软件域拟合，生成候选机内颜色资源。目前尚未完成真实 Lightroom 渲染或相机实测，结果不能当作机内效果验证。详细步骤见校色说明。理光 GR IV 产品页和规格页说明相机可记录 14 位 DNG，但目前公开页未提供可直接下载的 GR IV DNG 样片；旧 GR DIGITAL IV 样片页提供的是旧机型 JPEG。仓库内置样片是作者提供的 GR IV 文件，不是理光官方样片，也不代表官方色彩结果。请为其他 DNG 和 XMP 确认使用、修改和再分发权利。
柔焦／柔光专项按维护约定冻结，不随公开版滤镜和校色链路启用；公开版不承诺该专项功能。
操作示例、图片显示方式和备份恢复步骤见完整使用指南。
| 问题 | 处理方法 |
|---|---|
| 提示 Python 版本不正确 | 使用 64 位 Python 3.12；当前启动器不接受其他版本 |
| 浏览器没有自动打开 | 手动打开启动窗口显示的网址，并保持该窗口运行 |
| “生成固件”不可用 | 确认输入兼容、所有比例已确认，并完成 LLVM 配置 |
缺少 llvm-objcopy、llvm-nm 或 ld.lld |
安装包含这些组件的完整 LLVM 工具链，见使用指南 |
| 导入编辑备份失败 | 先导入备份对应、SHA-256 完全一致的输入 BIN；备份本身不含该文件 |
| XMP 转换后生成提示“共享入口不是已知 ARM 分支” | 旧公开版遗漏官方输入的滤镜入口初始化；更新源码并重启编辑器后重新生成。已完成的 XMP 转换可以沿用，该错误不是版本号限制 |
| 导入滤镜后提示“当前滤镜布局沿用公开版固件资源” | 更新源码并重启编辑器；已核验布局的滤镜、裁切和关机图案支持在同一项目一起生成，已有草稿可沿用 |
| 视频设置里的滤镜图标跟着拍照滤镜变化 | 更新源码、重启编辑器并重新生成固件；修复后的摘要读取视频自己的选择，并使用新增滤镜实际分配的图标 |
| 关机图片出现黑边或被裁掉 | “完整显示”保留内容并补黑边；“铺满画面”填满区域并裁掉超出部分 |
首次生成的版本为什么是 .10 |
本项目预留 .8 / .9；后续按当前输入与本机版本记录的最高编号加一 |
更多说明见故障排查。
欢迎反馈使用问题、提出功能建议，或提供设备帮助作者验证新机型。GitHub 仓库发布后，可通过 Issues 提交反馈，也可使用下方联系方式。
反馈时请提供操作系统、Python 版本、输入版本与 SHA-256、复现步骤及错误信息。请勿公开上传未核实权利的原厂固件、完整修改固件或含第三方材料的备份。
当前公开仓库用于发布稳定快照；维护与发布约定见发布说明。
如果你支持该项目，欢迎自愿捐赠，帮助作者继续开发、维护和适配更多设备。捐赠完全自愿。
如果你希望自己的机型也得到适配，可以提供设备供作者验证，欢迎联系。
扫码捐赠。工具顶部和导出确认中，也提供捐赠入口。
GitHub 的 Sponsor 入口由 .github/FUNDING.yml 配置，指向本节。仓库发布到 DoYitNow/gr-custom-tool 后，在 Settings → General → Features → Sponsorships 启用即可。配置方式见 GitHub 官方说明。
本次 main 发布快照中，作者有权授权的原创代码、界面和文档采用 GPL-2.0-only。 完整许可见根目录 LICENSE，授权范围与例外见作者声明。GPL 允许商业使用和收费分发；分发时须遵守源码提供、保留许可与权利声明等要求。
作者保留的非商业使用及免费、退款表述为自愿倡议，不是 GPL 的附加限制。当前生成流程实际依赖 Unicorn（GPLv2），Pillow、工具链及其他第三方内容仍遵守各自许可；本次选定源码许可不代表已完成全部第三方材料与输出固件的权利审查，详见第三方材料说明。
请先阅读使用协议与风险说明、作者声明和第三方材料说明。第三方固件、图片与组件的权利属于各自权利人，本项目不授予这些材料的修改后分发或商业使用权利。
自行刷入生成文件可能导致设备故障，并影响保修、官方支持及稳定性。发现异常应停止继续使用该文件或反复刷写，保留版本、SHA-256 和操作记录后联系作者。