面向 Nikon Z30 C 1.20 的实验性底层宿主与固件扩展研究项目，尝试构建类似 Magic Lantern 的机身端扩展能力。当前仓库是 Z30 专用原型，不是通用底层开发模板。
- 直方图＋水平仪同屏：扩展 DISP 可见性判断，保留原厂模式条件和显示顺序。
- 自定义电子快门声音：从 SD 卡读取 WAV；提供声音开关、文件选择、预听和重新加载。选择页以
*标记当前选项，按一次 OK 应用。 - M 档 900 秒曝光：启用固件已有的长曝光路径，保留原厂 M 档判断。
- MTP 属性列表加速：保留返回数据语义，减少属性列表查询耗时。
- SD 模块宿主（实验性）：从 SD 卡加载并运行 ZMOD，自动包含快门声音框架。
- 视频自动方向：根据开始录制时的姿态写入视频轨方向元数据，录制期间保持锁定。
- 高码率与慢动作扩展：提高 1080p 24–60p 高画质码率，将慢动作录制上限从 3 分钟延长到 25 分钟，并支持 FAT32 分段或 exFAT 单个大文件。
仅支持 Z30 C 1.20。维护者已确认独立 EG 模块可在该版本机身安装，并已实机测试 SD 宿主与 ZMOD 加载、运行；其他功能的实机覆盖范围见验证说明。
第一次使用请看简单 patch 指引。需要 Python 3.10+、完整项目源码和未经修改的 Z_30_0120.bin。
python -m pip install '.[sound]'
New-Item -ItemType Directory -Force output | Out-Null
python patch.py --source "Z_30_0120.bin" --output "output/EG209020.BIN"程序先检查原始包的 SHA-256，再解包并核对 EG 模块。随后按 offset 检查并替换原字节、追加功能代码、重建 CRC，输出独立 EG 模块 EG209020.BIN 和 JSON 构建报告。该模块已在 Z30 C 1.20 实机安装测试；程序不会重建完整 Nikon 更新包。原始文件不会修改，已有输出不会覆盖。
在终端运行且未指定预设时，程序显示菜单，可输入多个编号或名称（用空格或逗号分隔）。直接回车选择 full，包含全部七项功能：同屏、快门声音、M 档长曝光、MTP 属性列表加速、实验性 SD 模块宿主、视频自动方向和高码率与慢动作扩展。各功能仍可单独选择或自由组合，重复选择的功能只应用一次。
菜单为完整组合 full 加七个功能入口：liveview-dual、shutter-sound、m900、mtp-fast、module-host、video-rot、bitrate-slowmo-uncap。module-host 为实验性功能，自动包含它依赖的快门声音框架；旧组合名 modular 仍接受手动输入，但不在菜单中显示。full 已包含视频方向及高码率与慢动作扩展，额外选择对应预设不会重复应用。
预设 video-rot 实现 issue #3 第二阶段：新录像的封装对象配置成功后读取原厂姿态，锁定为 0°、90°、270° 或 180°，未知姿态回退 0°。仅改变视频轨方向元数据，不改变像素；录制期间姿态变化不更新当前对象的方向。共享矩阵、电影头和音轨保留原厂行为。默认 full 已包含它，也可单独选择 video-rot；旧别名 modular 不包含它。用户已反馈横拍、两侧竖拍及录制期间方向锁定实机正常，详见构建说明。
默认 full 也会启用 bitrate-slowmo-uncap：1080p 60/50p 高画质平均码率为 90 Mbps，30/25/24p 为 60 Mbps；慢动作上限为 25 分钟，FAT32 最多 8 个文件，exFAT 使用单个大文件。4K、120p/100p、慢动作和标准画质的码率保持原厂值，其他模式的 125 分钟时长上限保留。作者报告已用包含该功能的 full 完成实机录像与文件检查；独立预设尚未单独刷机，普通模式 MP4、MP4/FAT32 分段和其他码率尚未测试。具体结果见视频码率与慢动作限制。
也可直接在命令行指定组合，例如：
python patch.py liveview-dual m900 mtp-fast --source "Z_30_0120.bin" --output "output/EG209020.BIN"
python patch.py full --source "Z_30_0120.bin" --output "output/EG209020.BIN"以上为两种替代用法，每次构建请使用不存在的输出路径。重定向输入或脚本调用时，省略预设仍默认 full；加 --interactive 可强制显示选择菜单。具体输入哈希和实现方式见构建说明。
设置菜单中的 Shutter sound 提供开关和声音文件选择。支持 SD 卡根目录 SHUTTER.WAV，以及 SHUTTER/1.WAV 至 SHUTTER/4.WAV。声音格式为 8000 Hz、单声道、16 位 PCM，最长 1.08 秒，详见声音说明。
根目录的 SHUTTER.WAV 是启用该功能的必需文件；SHUTTER 子目录及其中的编号声音文件可以缺省。
转换短 PCM WAV：
python tools/prepare_wav.py input.wav SHUTTER.WAV转换器使用线性插值；高采样率音频可先用带抗混叠滤波的重采样器处理。仓库不附第三方音频，脚本中的 example(slot) 可生成合成示例。
- 简单 patch 指引
- 构建说明
- 声音菜单与文件格式
- 离线验证方法与限制
- SD 原生模块宿主与接口（实验性）：
module-host入口、模块 ABI 和已完成的实机加载/运行验证。 - 视频自动方向与实机验证
- 视频码率与慢动作限制及实机测试记录
- 许可证范围与第三方说明
除声音实现的四个文件外，本项目原创代码与文档采用 MIT。声音实现采用 Wonder Lantern Community License，包含免费分发等条件；使用或分发组合代码时须同时遵守相应条款。
本项目属于 WonderLantern 组织，是面向 Z30 的独立实验项目，不代表 Nikon 支持或认可。部分声音实现遵循随附的 Wonder Lantern Community License。许可证要求衍生版本不得自称为官方 Wonder Lantern 发布；该要求针对许可证覆盖的软件发布身份，不改变本仓库属于 WonderLantern 组织这一事实。许可证不授予 Nikon 固件、原厂资源或商标的权利。