SuperAPI AI 工具集

appkit-accessibility-auditor

测试与质量

查看项目

更新于 10-15 22:09

技能介绍

用途:审计 macOS AppKit 界面的辅助功能问题,覆盖 VoiceOver 朗读、键盘优先导航与焦点行为、语义结构(角色、标签、分组、表格/大纲视图)、对比度与非颜色提示,以及屏幕/内容变化的播报等。输出形式为按优先级排序的审计结果与可直接粘贴的补丁片段。

主要能力:按 P0(阻断核心使用)、P1(明显影响可发现性/理解/操作性)、P2(改进与一致性)分组给出问题,每条含问题说明、影响原因与确切修复;提供最小化 diff 建议并标明改动位置(如 viewDidLoad、awakeFromNib、自定义视图初始化处);附手动测试清单,涵盖 VoiceOver 导航与阅读顺序、Tab/Shift-Tab 与方向键、状态可发现性、动态更新播报、Voice Control 与 Switch Control 检查。必要时用 Accessibility Inspector 检查元素树;若已有 UI 测试目标,可考虑 XCUIApplication.performAccessibilityAudit(for:_:)(需确认平台可用性并排查误报)。

使用方式:把 NSViewController、NSView、NSWindowController、自定义控件、NSTableView/NSOutlineView 代码或界面描述交给它,并说明约束(如不改布局、不改文案、不重构)。它会优先做局部最小改动,不发明 API,尊重部署目标并标注新 API 的可用性;上下文缺失时明确假设。

适用场景:审阅或修复 AppKit 界面的无障碍问题;检查自定义控件的角色/状态/动作;表格与大纲视图无障碍;阅读类文本体验;内容变化播报;发布前辅助功能评估(将核心任务映射到 Accessibility Nutrition Labels 标准)。

限制:不重写界面或重构架构,不无理由添加辅助功能属性,不破坏布局、事件处理或已有快捷键;自动化审计不能验证完整的辅助技术体验,需保留手动检查并说明实际执行项、待办项与所用系统/设备;版本中未提供具体价格、收费或平台支持范围等信息。