用途:审计 iOS、macOS、tvOS、watchOS、visionOS 上的视图代码,判断文字与 UI 元素是否满足 Apple「足够对比度」营养标签所依据的 WCAG 2.1 对比度要求。适用于用户要求检查颜色对比度、验证该营养标签、或在无障碍审查中一并检查对比度时。
主要能力:读取源码识别文字元素、前景色、背景色、字号、语义/动态颜色与透明度;解析硬编码颜色与已知语义色默认值;在可用时渲染 SwiftUI #Preview 截图辅助核对;按 WCAG 2.1 公式计算对比度并套用阈值(普通文字 4.5:1,大号文字 3:1,UI 组件边界 3:1,装饰元素豁免);涉及透明度时先做 alpha 合成再计算。
输出方式:给出明确的 Verdict 行,取值为 PASS、FAIL 或 NEEDS VERIFICATION。颜色可确定时直接判定 PASS 或 FAIL,不使用模糊措辞;无法确定颜色(如运行时动态色、资源目录颜色、计算主题)时不猜测、不判失败,而是标记 NEEDS VERIFICATION,说明未解析的颜色、原因及开发者自行验证的方法。修复建议会引用实际代码中的颜色名、修饰符与行号。
限制:无法解析的颜色不能给出结论;无预览渲染工具或渲染失败时仅做源码分析并注明未做视觉验证;若文件没有可审计的文字或 UI 元素,则报告 PASS 并说明未发现可审计元素。具体安装与调用命令资料未提供。