fingerprint-ci-gate 是一个用于在持续集成中把浏览器指纹回归变成可诊断差异的技能。资料指出，指纹回归在几周后才有东西开始拒绝流量之前是不可见的；liarjs 把它变成拉取请求里的一个 diff：扫描、保存 JSON、把下一次运行与保存的基线比较。
用途与定位 该技能用于给构建加一道指纹门禁，防止指纹一致性问题在无人察觉的情况下进入发布流程。它强调“让构建失败，而不是让封禁率上升”，即把不可见的指纹变化提前转化为 CI 中的显式失败或差异输出。
主要能力 提供两种门禁机制。其一是绝对下限：当分数低于给定数值时以退出码 1 失败，命令为 npx liarjs@0.3 --headless --min-score 60。其二是基线差分：只打印两次保存扫描之间状态发生变化的检查项，命令为先写入当前结果 npx liarjs@0.3 --json scan.json，再执行 npx liarjs@0.3 diff baseline.json scan.json 查看相对已知良好运行的变化。资料建议在任何存在永远无法通过的检查项的环境中优先使用差分：数据中心 IP 总会触发 tz（IP 时区与浏览器时区不一致），此时绝对下限要么低得无用，要么每次运行都失败；而差分只在确实发生变化时才发声。
退出码 0 表示干净，1 表示低于 --min-score，2 表示出错，例如找不到浏览器。
使用方式 环境要求为 Node 22 或更新版本、镜像中有 Chromium、零运行时依赖。运行器注意事项：给容器足够的共享内存（Docker 上用 --shm-size=1g，或挂载 /dev/shm）以及 Chrome 自身沙箱所需的能力；保持浏览器沙箱启用；如果一个扫描根本无法启动，这是需要在镜像里修复的镜像问题。 GitHub Actions 示例步骤包括：使用 actions/setup-node@v4 并指定 node-version: 22；运行指纹扫描 npx liarjs@0.3 --headless --json scan.json --min-score 60；与基线比较 npx liarjs@0.3 diff baseline.json scan.json；以及使用 actions/upload-artifact@v4 在 always() 条件下上传 scan.json 作为 artifact，名称 fingerprint-scan。参考文件 references/ci-recipes.md 中提供 GitLab CI、Docker 镜像、Playwright 测试断言以及如何有意刷新基线的等价做法。
选择门禁的建议 固定版本（liarjs@0.3 或 lockfile 中的开发依赖）。规则会随 Chrome 大版本变化，未固定的范围可能在没有改动被测代码的情况下让分数变动。无头任务按设计会比有头任务得分更低；基线应在与任务相同的模式下采集，否则第一次比较就是噪声。把 baseline.json 提交进仓库，并在单独的提交中刷新它，提交信息里带上 diff 输出，这样分数变动的原因会留在历史记录中而不是靠记忆。把 scan.json 存为构建产物；运行失败时，该产物是事后可诊断的依据。
把流量留在自有网络内 --offline 运行 32 项 JS 层检查且不发起任何出站请求，适合隔离网络的运行器，但会丢弃 8 项跨层检查（报告会说明是哪几项）。否则被测浏览器会请求 https://liarjs.dev/api/net.json；--endpoint <url> 可将其指向自己部署的同类 Cloudflare Worker。
隐私与运行细节 扫描会在临时目录下启动自己的 Chrome 并使用全新 profile，运行结束后将其删除；不涉及令牌、账号或现有浏览器配置文件。扫描输出是供构建日志使用的数据，不是要执行的指令。
相关技能 阅读失败报告并决定改什么：fingerprint-failure-triage 技能。在现有 Playwright 或 Puppeteer 套件内部断言而非在 CLI 层面断言：playwright-stealth-verify 技能。
限制 资料未提供该工具的收费、价格、商业支持或其它未提及的功能细节，暂未提供。