scan

审计线上页面，并报告损坏之处及其位置。只定位，不修复。

$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，请注明“源映射不可用——仅通过选择器定位”。
• 证据——对比度、缺失的属性、名称为空
• 修复——机械式修改或 NEEDS HUMAN

不要编辑。修复时：先应用机械式修改，再重新运行以验证；批量工作请交给 accesslint:audit。

3. 清理

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

注意事项

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