m10v

From the project's README ("开始使用"):

1. 准备环境

需要 Node.js ≥ 20、Python 3 和 LLVM clang。Node 服务使用内置模块，无需 npm install。

git clone https://github.com/zhaoo/m10v.git cd m10v git switch develop python3 -m venv .venv

macOS 可通过 Homebrew 安装 LLVM：

brew install llvm

开关机图片的预览与压缩需要 Pillow：.venv/bin/python -m pip install pillow。

GR IV 参考编辑器还需要 LLD：brew install lld。导入后可在设置中查看编译、链接和 ARM ELF 预检结果。

构建器会查找 Homebrew 的 LLVM；其他安装位置可用 M10VLLVMCLANG 指定 clang 的完整路径。

1. 放入官方固件

官方固件不随仓库分发。自行准备与当前核验样本完全匹配的官方文件：

bin/ ├── fwdc239b-gr3-official.bin # GR III Street Edition 2.10 ├── fwdc243b-gr3x-official.bin # GR IIIx 1.60 ├── fwdc248b-gr4-officical.bin # GR IV 1.11，保留现有本地文件名 ├── rg2v003.frm # GR II 3.00 └── rg1v051.frm # GR 5.01（逆向研究输入）

部分历史测试仍读取根目录别名，可创建符号链接：

ln -s bin/fwdc239b-gr3-official.bin fwdc239b-offical.bin ln -s fwdc239b-offical.bin fwdc239b.bin

1. 打开工作台

npm start

按终端显示的地址打开浏览器。macOS 也可双击 start.command。

导入固件 → 设置方案 → 保存固件

先选槽位，再选胶卷与质感。点击「保存固件」时阅读风险提示，明确确认后才会开始构建。取消或按 Esc 不会生成文件；每次保存都要重新确认。

> 服务器监听 loopback；配置 M10VPORT 和 M10VPUBLICORIGIN 后可通过 Nginx 反向代理。不能只上传静态 web 目录。Ubuntu 24.04 + 宝塔的具体步骤见 部署指南。

GR III 原厂工具的可选兼容运行时

原生胶卷库采用本仓库 C/ARM 实现，不依赖外部胶卷包或 GRLife 兼容运行时。部分原厂工具仍使用锁定的兼容运行时，它不纳入源码仓库：

node scripts/sync-grlife-runtime.mjs

该路径需要 Python 3.12；可通过 M10VPYTHON 指定解释器。GR IV 参考核心及其 Python 依赖保留在 vendor/gr4/。为保持源码仓库轻量，三份大体积 GR IV 校准 DNG 样片留在本机，不随 Git 分发；启用相关校准测试前，需从参考项目恢复，文件名与哈希见 vendor/gr4/PROVENANCE.json。各模块来源与许可见 第三方说明。

GR III 固件桥接 …

Read the full instructions