decant 开源工具：把 Apple 编译图标还原成可编辑源文件，下载使用指南

decant 是一个面向 macOS 开发者的开源命令行工具，专门用来把 Apple 在 iOS 26 / macOS 26 之后引入的「Liquid Glass」应用图标（即编译后的 .icon 格式）逆向还原成可编辑的 .icon 源文件包。它直接从已安装的 iOS 模拟器运行时或挂载的 IPSW 中读取编译好的图标，借助私有 CoreUI 框架逐层拆解，恢复矢量 SVG 与位图 PNG 图层，以及混合模式、透明度、半透明、高光、阴影、模糊、折射、玻璃质感、浅色/深色/着色三套外观填充、图层变换和画布背景等完整材质参数，最终重新组装出 icon.json 与 Assets 文件夹，并可用 Icon Composer 打开继续编辑。项目地址为 github.com/kylebshr/decant。

痛点是什么

在 iOS 26 与 macOS 26 之前，开发者想研究或复刻系统图标，往往只能拿到一张扁平截图，图层结构、材质参数全部丢失。Apple 新的 .icon 格式虽然带来了 Liquid Glass 效果，但它是编译后的封闭产物，无法直接打开编辑。想模仿官方图标的玻璃质感、折射与高光，只能靠肉眼反复试参数，既费时又难以还原。更麻烦的是，App Store、Podcasts 等部分图标并不在模拟器运行时里，普通手段根本取不到，开发者缺少一个能完整拆解并验证还原度的工具。

主要功能特点

decant 把「拆解—还原—验证」串成一条命令即可完成的流程，让封闭图标重新变成可编辑素材。

一键导出全部图标

运行 ./decant 即可把模拟器运行时中所有可提取图标导出到 icons 目录。

完整还原材质图层

逐层恢复 SVG/PNG 与混合、折射、高光、阴影等参数，生成 icon.json。

支持 IPSW 取图

用 --root 指向挂载的 IPSW，补齐 App Store 等模拟器缺失的图标。

导出结果自动校验

每次导出都会用 actool 重新编译比对，确保还原值与 Apple 原版一致。

为什么值得关注

它把 Apple 未公开的图标格式变成可读可改的工程文件，对做图标、做主题、做设计系统的人都很有参考价值。

逆向与校准并重

项目通过往返校准逐项比对参数，还原结果经得起重新编译验证。

贴合新系统生态

面向 iOS 26 的 Liquid Glass 图标，是研究新视觉规范的实用入口。