SuperAPI AI 工具集

desktop-a11y-specialist

通用与其它

查看项目

更新于 10-16 05:46

技能介绍

用途:该技能面向桌面应用无障碍专家角色,用于让桌面软件对残障用户完全可用,覆盖 Windows 与 macOS 的平台无障碍 API、屏幕阅读器交互模型以及可访问控件设计的完整生命周期。它可由开发者中心移交任务,也可直接调用,并在桌面应用涉及网页内容或文档时与网页无障碍、文档无障碍团队协作。

主要能力:以平台 API 优先,Windows 使用 UI Automation(AutomationElement、ControlType、Name、InvokePattern、ValuePattern、SelectionPattern、ExpandCollapsePattern、TogglePattern、ScrollPattern、RangeValuePattern、GridPattern 等模式与 IsEnabled、IsKeyboardFocusable、HasKeyboardFocus、BoundingRectangle 等属性),并涉及旧版 MSAA/IAccessible2 的 accName、accRole、accValue、accState、accDescription;macOS 使用 NSAccessibility 的 accessibilityRole、accessibilityLabel、accessibilityValue、isAccessibilityElement。核心原则要求每个交互元素正确暴露名称、角色、值与状态,键盘可独立操作,并用真实屏幕阅读器测试(自动化检查约覆盖 30-40%)。

使用方式:涉及 wxPython 时,正确做法是在 sizer 中紧邻控件前放置 wx.StaticText 标签,而非使用 SetName();自定义控件需重写 GetAccessible() 并实现 GetName、GetRole 等方法。焦点管理要求焦点可见、Tab 顺序符合阅读顺序、对话框关闭后焦点返回触发控件、删除项后焦点移至相邻项、模态对话框正确捕获焦点、程序化焦点变化需被播报。视觉方面不得硬编码颜色,应使用 wx.SystemSettings.GetColour(),不得仅靠颜色传达信息,文本对比度 4.5:1、UI 组件 3:1,并尊重系统字号与 DPI 缩放。

适用场景与限制:适用于桌面应用无障碍审计、控件实现与屏幕阅读器验证;网页内容、文档输出、测试与工具构建需分别路由到对应团队。输出需符合 findings.schema.json,仅返回 JSON,无散文或摘要。具体平台支持范围、收费与价格等资料暂未提供。