SuperAPI AI 工具集

accesslint-diff

通用与其它

查看项目

更新于 10-16 02:32

技能介绍

用途:在已验证的基线与候选版本之间比较指定页面的无障碍检测结果,报告新增、已修复和仍存在的违规项,且不修改应用源码。

主要能力:解析基线与候选为完整提交 SHA,识别暂存、未暂存和未跟踪内容归属;用隔离 worktree 或可恢复快照保留用户检出状态;在两个本地端口分别提供基线与候选,等待确定性就绪选择器并核实各页面实际服务的版本;按匹配的 URL、账号状态、视口、选择器、引擎版本和规则配置进行审计;对比结果并检查选择器漂移或内容移除;将无法访问的状态与人工 WCAG 检查单独记录。

使用方式:默认对比未提交改动(基于 stash),或传 --branch [<name>] 对比分支。报告格式示例:Accessibility diff — http://localhost:3000/ vs main(94 条规则,实时 DOM),2 new · 1 fixed · 4 pre-existing hidden。每条新增违规给出位置(选择器原文,若源码存在则附 file:line (symbol),不得编造)、证据和修复建议(机械改动或 NEEDS HUMAN)。本技能只报告,不编辑;如获明确授权修复,应使用 accesslint-audit 流程并用同一受控基线验证。收尾时只关闭本次运行创建的浏览器进程、服务器和快照,保留既有会话与可恢复工作,保存证据后再删除隔离 worktree,不得使用全局浏览器停止命令清理。

适用场景:需要在不改动源码的前提下,比较页面在基线与候选版本间的无障碍违规变化。

限制:本包不捆绑 CLI 或浏览器,需先核实当前已安装工具 schema 或经审查的固定版本;不得将 $ARGUMENTS 或分支/URL 文本当作 shell 语法执行;固定 sleep 不算就绪检查;私有快照应放在仅属主可访问的新目录,而非可预测的共享 /tmp 文件名;集成不可用时不得臆造命令。差异输出仅覆盖已执行的页面/状态和所选自动规则,不构成 WCAG 认证;被移除元素可能从审计中消失但并非无障碍替代,需检查用户旅程;大幅 DOM 变更可能使选择器匹配失效,应核实对应元素或对两个快照运行完整审计;示例计数仅为示例而非实测。任务不明确匹配上述范围、缺少必要输入、权限、安全边界或成功标准时应停止并请求澄清。