SuperAPI AI 工具集

android-ux-audit

通用与其它

查看项目

更新于 10-16 03:15

技能介绍

用途:对运行中的 Android 应用做 UX/UI 启发式审计,依据固定评分框架产出有证据支撑、按严重度分级的问题登记表。它比通用应用评审更具体,是整体评审中的“UX 步骤”。

主要能力:scripts/uxcheck.py 从 android-ui-driver 快照计算两项代理检查——无可访问名称的可操作控件、以 dp 计的触控目标尺寸,输出为疑似问题与临时优先级;其余类别(首次运行、信息架构、表单、内容、状态、暗黑模式、对比度、屏幕阅读器流程)依据 references/heuristics.md 的评分框架人工判断。严重度采用 Nielsen 0–4(频率×影响×持续性),uxcheck 只给临时优先级,不给严重度。

使用方式:先界定 3–5 条关键旅程,按 Material 3 而非 iOS 对齐来评判。逐屏采集与测量:

uia.py snap --json --all > screen.json uia.py shot screen.png uxcheck.py audit screen.json

uxcheck audit 会标记快照中无可访问名称的可操作控件(高)与低于 48dp 的目标(中)或远低于者(高),给出元素、边界与验收标准修复建议;退出码 1 表示有问题。需用 TalkBack 确认名称、用真实命中区域确认目标。对比度与拥挤度需人工判断。用 assets/finding-register.md 汇总登记表与严重度×工作量待办。

适用场景:明确的 UX/可用性/无障碍请求;也可作为 android-app-review 的 UX 步骤。不同屏幕尺寸、横屏、200% 文字等用 android-device-matrix,其每格快照可用 uxcheck.py audit <cell>.json --density <dpi> 审计。

限制:uxcheck 只是可测量子集,干净运行不等于 UX 合格;对比度仅能人工初筛,不得编造比值;无障碍树不等于屏幕阅读器体验;模拟器上的响应时间感受不具设备级精度;Canvas/Flutter 屏幕暴露元素少,本身即为无障碍问题;脚本输出优先级而非严重度,严重度需由评分框架判定。