用途:对 Penpot 设计稿做 WCAG 2.1/2.2 AA(可选 AAA)无障碍审计,产出结构化、按严重程度排序的报告,供交接使用。
主要能力:读取对象树(penpotUtils.shapeStructure/analyzeDescendants),从已解析的填充色计算 WCAG 对比度,检查尺寸与语义命名,并输出严重程度分级报告。检查项包括文本与背景对比度、UI 组件对比度、交互目标尺寸、标题层级、标签/替代文本(来自语义命名)以及键盘/焦点顺序启发式推断。
使用方式:通过 execute_code 执行只读脚本,主要脚本有 scripts/collectAccessibilityData.js、scripts/checkColorContrast.js、scripts/checkTouchTargets.js、scripts/generateReport.js;用 export_shape 导出证据。流程分阶段:检查、对比度、尺寸、语义、报告。报告须同时按 shared/report-schemas/accessibility-report.schema.json 输出 JSON,并镜像到运行账本。
阈值与规则:普通文本 4.5:1,大文本与 UI 组件 3:1;目标尺寸 ≥24×24(WCAG 2.2,主要控件建议 44×44)。每条问题包含严重程度(High/Med/Low)、问题、影响、修复建议与置信度。
适用场景:设计稿无障碍评审、交付前验收、幻灯片(scope:deck)审计等。
限制:本技能只读,绝不修改画布;不自动修复,修复需路由到对应技能并人工复核。若图层未按语义命名,标题层级检查不可靠,建议先用 penpot-rename-layers。键盘顺序为启发式,需标注置信度。若抽样检查须明确说明,不得静默缩小范围。具体安装与调用细节暂未提供。