accessibility-scan

审计一个正在运行的页面，并报告每项违规及其位置。只定位，不修复。

共享的依据与诚实性约定：../shared/methodology.md。

$ARGUMENTS 是 URL、配置目标名称（dev、storybook 等），也可以为空；为空时审计 accesslint.config.json 中的默认目标。如果为空且不存在配置文件，请索要 URL，或建议运行 npx @accesslint/cli init。

1. 审计

PORT=$(npx -y @accesslint/chrome@latest ensure | node -e 'process.stdin.on("data",d=>process.stdout.write(""+JSON.parse(d).port))')
npx -y @accesslint/cli@latest scan <target> --port "$PORT" --format json

<target> 是 $ARGUMENTS 中的 URL 或配置目标名称。若要审计配置中的默认目标，请省略它（不要传入 ""）。根据需要添加标志：--selector、--wait-for "<selector>"、--include-aaa、--disable <rules>，或在 accesslint.config.json 中按目标固定这些标志。

2. 报告

先按影响程度统计数量，再为每项违规分别列出一条：

• 位置：原样提供选择器；如果存在 source，还要提供 file:line (symbol)。不要编造。如果没有任何违规包含 source，请注明“source 映射不可用；仅通过选择器定位”。
• 证据：对比度、缺失的属性、空名称。
• 修复：机械性更改，或 NEEDS HUMAN。

不要编辑。对于修复，请应用机械性修复并重新运行以验证；如需批量处理，请交由 accesslint:accessibility-fix。

3. 清理

npx -y @accesslint/chrome@latest stop --all  # skip if ensure reported "managed":false

说明

• ensure 决定端口；不要将 9222 写死。
• CLI 退出码 2 表示 URL 或目标无效，或页面始终未能加载；请检查开发服务器。目标名称未知时，CLI 会列出 accesslint.config.json 中可用的目标。