Phoenix 1.3.0 基于小米 17 Ultra OS4 官方相机，主要在小米 14 Ultra（aurora）上验证。工程包含相机补丁、LSPosed 扩展、根模块资产和统一构建工具，可生成 Camera APK、LSP APK 与 All-in-One 安装包。

• 相机界面与拍摄功能适配，包括普通视频模式的 Leica Looks 选择器。
• 专业录像中两个世代的滤镜/LUT 入口及已验收的注入修复。
• 电影画幅与滤镜快门抽动修复、相机备份/恢复适配。
• 普通徕卡经典风格管理、自定义 LUT 与滤镜资产同步。
• “小米ASD”开关：普通拍照默认遵循相机原生状态，手动切换后固定开启或关闭并保存选择。
• 徕卡经典暗角着色器作为可选的独立 AUTHVignette Addon 提供，不随主包安装。
• 本地水印、色卡与签名模板，以及 by Leica、Leitz 机型水印。
• 独立的图片元数据和水印元数据写入开关。
• KernelSU、Magisk、APatch 模块安装与 ODM 资产挂载脚本。

徕卡一瞬不在支持范围内。普通徕卡经典、生动、自定义滤镜和水印是不同功能，不应与徕卡一瞬混同。

暗角 Addon 的源码和独立安装包随 V1.3.0 发布附件提供；历史着色器说明见 vignette-shader.md。该功能调整经典后处理中的一个着色器节点，0% 不代表消除传感器及其它处理阶段形成的全部暗角。

Addon 独立于 Phoenix 主线发布并使用自己的版本号。每个 Addon 目录提供正式产物、README、源码和所需参考材料。

澎湃 OS4 用户可尝试自行降级“小米相册-编辑”至 2.4.0.4.3 以兼容相册注入功能；降级不代表 OS4 的全部功能均已验证。

上述兼容范围不代表全部机型、系统和管理器组合均已逐一实测。设备验证以小米 14 Ultra（aurora）为基础。KernelSU 已完成实际安装与开机验证；Magisk、APatch 已通过设备隔离测试，实际管理器安装与开机兼容性待验证。具体范围见 verification.json。

目前已知最大的机型适配问题是：小米 14 Ultra 之前的机型，“徕卡经典风格切换”功能失效。 除此之外尚未发现较大的不兼容问题，不同机型仍可能存在细微适配风险。

开启“图片元数据”会影响人像照片在相册中重新编辑虚拟光圈。 需要重编辑光圈时，请在拍摄前关闭“图片元数据”。关闭该选项不会自动修复已经拍摄的照片。

“水印元数据”是独立选项，用于记录重建水印所需的机型身份；上述人像问题的处理方式不要求关闭它。

官方 APK 由使用者自行提供，不包含在源码中。仅支持以下底包，文件名可以不同，内容须匹配：

构建器按 supported-camera.json 校验底包内容。

• Python 3.11 或更新版本；构建脚本只使用标准库。
• JDK 17，终端中可调用 java 和 keytool。
• Apktool 2.12.1。
• Android SDK Build-Tools 35.0.0。

构建已在 Windows 11 验证，其他操作系统尚未实测。Android SDK 路径可通过 ANDROID_HOME、ANDROID_SDK_ROOT 或 --android-sdk 指定；Windows 默认路径为 %LOCALAPPDATA%/Android/Sdk。

在工程根目录执行：

python tools/bootstrap.py
python tools/build_phoenix.py --camera-apk "D:/camera/new.apk"

bootstrap.py 下载固定版本的 Apktool 到 tools/vendor/。也可通过 --apktool 指定已有的 2.12.1 JAR。Android SDK Build-Tools 需要通过 SDK Manager 安装：

sdkmanager "build-tools;35.0.0"

单独构建相机或 LSP：

python tools/build_phoenix.py --mode camera --camera-apk "D:/camera/new.apk"
python tools/build_phoenix.py --mode lsp

LSP 单独构建不需要官方相机 APK。

产物位于 dist/Phoenix-1.3.0/：

work/ 保存解包树、编译缓存和本地开发密钥。重复构建会复用缓存，产物通过临时文件完成后替换。需要重新建立缓存时，应先备份 work/keys/ 中需要保留的签名密钥。

Camera APK 使用官方底包的 OEM Signing Block。搬运签名块不等于重新获得有效的小米签名，修改后的 APK 不能据此通过标准官方签名验证。

LSP 使用 apksigner 签名并验证。默认开发密钥在首次构建时生成于 work/keys/development.keystore，别名为 androiddebugkey，开发密码为 android。持续更新已安装 LSP 必须使用与已安装版本相同的签名密钥；默认新密钥不能直接覆盖官方发布的 LSP。

使用自有密钥：

$env:PHOENIX_STORE_PASSWORD = "your-store-password"
$env:PHOENIX_KEY_PASSWORD = "your-key-password"
python tools/build_phoenix.py --camera-apk "D:/camera/new.apk" --keystore "D:/keys/phoenix.keystore" --key-alias "phoenix"

密码通过环境变量传给签名工具，源码归档不包含密钥。

从 Phoenix 1.0.x 升级时保留应用数据。 ASD 旧设置会自动迁移：旧版明确关闭 ASD 的选择继续保持关闭；未禁用时默认遵循原生状态。

首次从原厂相机安装 Phoenix，按下列初始化步骤操作；升级已有 Phoenix 时跳过清除数据步骤。安装后保留应用数据。

安装顺序：

1. 准备 ROOT、LSP 和核心破解环境，并将“小米相册-编辑”调整为 2.4.0.4.3。
2. 清除“相机”和“小米相册-编辑”的应用数据。
3. 安装 Phoenix，按安装器提示启用模块并重启。
4. 安装完成后保留两个应用的数据，严禁再次清除。

All-in-One 可通过所用根管理器安装。KernelSU 命令行示例：

adb push "dist/Phoenix-1.3.0/Phoenix_Phoenix-1.3.0_AllInOne.zip" /data/local/tmp/Phoenix-1.3.0.zip
adb shell su -c "ksud module install /data/local/tmp/Phoenix-1.3.0.zip"

按安装器提示启用模块并重启。安装脚本写入 APK 和资产；开机脚本配置 LSPosed 作用域并启动资产同步。模块目录内的 开机日志.txt、mount.log 和 watermark-cache.log 可用于检查初始化结果。

单独更新 LSP 后，新建的目标应用进程即可加载新版本。结束旧进程、显式启动目标应用并检查 hook 日志，可确认更新是否生效。

LSP 的完整可编译输入是 smali 与资源。tools/feature_sources/ 中的 Java 文件提供可读实现参考；正常构建使用对应的 smali，不要求额外的 Java 项目环境。

1.3.0 的变更见 CHANGELOG.md。tools/feature_sources/ 提供可读 Java 参考；构建以相应 smali 为准。

生成源码归档：

python tools/package_source.py

输出为 dist/Phoenix-1.3.0-source.zip，包含构建输入和文档，不包含 APK、下载工具、编译缓存或签名密钥。

Phoenix 自有代码及有权授权的修改采用 GNU GPL v3.0（GPL-3.0-only）。相机补丁、LSP 和模块资产包含第三方内容，它们保留各自的许可证与权利，不因本项目的 GPL 声明而统一改授。组件来源及尚未明确的授权范围见 third-party.json。