audit-accessibility-figma

audit-accessibility-figma — 单个组件无障碍评分卡

对单个组件或组件集进行深入的无障碍审计，并获取加权的 0–100 分评分卡及按优先级排序的修复建议。lint-design-figma 会扫描整棵树以查找多项规则违规，而此技能会深入检查单个组件：它能够识别变体轴，将组件分类为交互型或展示型，并据此为各项无障碍维度评分。

所有操作均通过 use_figma 完成，适用于任何套餐 — 它会检查真实的变体树、填充、描边、效果和组件描述。

技能边界

• use_figma 规则 — 请先加载官方的 figma-use 技能；它是完整的 Figma Plugin API 参考。这些脚本依赖的基本规则：使用带顶层 await 和 return 的纯 JS（不要使用 IIFE 或 figma.closePlugin()；console.log 不会作为返回值），在每个脚本顶部以内联 const 定义输入，颜色值范围为 0–1，在执行任何文本操作前加载字体，使用 await figma.getNodeByIdAsync(...)，并遵循原子错误原则（脚本失败时不会应用任何内容 — 阅读错误、修复后重试）。
• 整棵树的 WCAG 和设计系统检查 → 使用 lint-design-figma。
• 代码侧无障碍检查（对 HTML 使用 axe-core）→ 使用 scan-code-accessibility-figma。
• 设计与代码的偏差 → 使用 check-design-parity-figma。

工作流

1. 指定组件。 将 NODE_ID 设为 COMPONENT_SET、COMPONENT 或 INSTANCE 的 ID（脚本会自动沿 INSTANCE → 主组件 → 父级组件集遍历）。设为 null 可审计当前的单个选区。
2. 设置点击目标最小尺寸。 TARGET_SIZE 默认为 24（WCAG 2.5.8 的最低要求）；如需更严格的移动端目标尺寸，可传入 44 或 48。
3. 运行 scripts/audit-accessibility.js，通过 use_figma 执行（skillNames: "audit-accessibility-figma"）。
4. 阅读评分卡。 overallScore 是六个类别得分按分类权重加权后的综合分数。各类别、对应权重及提升分数的方法，请参阅 references/audit-categories.md。
5. 落实建议。 recommendations[] 已按 priority（high/medium/low）排序，并注明相应的 WCAG 成功标准（SC）。完成修复后重新运行，以确认分数有所提升。

关键规则

• 交互型与展示型会根据组件名称和变体轴自动判定。这会影响参与评分的类别及其权重 — 徽章不会因为缺少焦点状态而被扣分，按钮则会。
• 颜色值为 0–1 浮点数。 对比度计算使用 sRGB 相对亮度；色盲模拟使用 Brettel/Viénot 二色视觉矩阵。
• 覆盖度对于交互型组件指交互状态覆盖情况；对于展示型组件则指变体轴完整性（实际变体数 ÷ 预期组合数）。
• 此审计为只读操作 — 请使用 manage-variables-figma / figma-use 应用修复，然后重新审计。