Cổng kiểm tra fingerprint trong CI (fingerprint-ci-gate)
Dùng liarjs để đo điểm fingerprint trình duyệt trong CI và làm hỏng build khi điểm tụt so với baseline.
Lập trìnhTrung cấp★ 237⑂ 0Điểm AI 8/10Cập nhật lần cuối: 6 thg 8, 2026
Kỹ năng này làm gì
- Chạy CLI
liarjsđể quét fingerprint của trình duyệt headless và lưu kết quả ra JSON. - Cung cấp hai cơ chế cổng chặn: ngưỡng tuyệt đối (
--min-score) và so sánh với baseline (diff). - Sinh cấu hình sẵn dùng cho GitHub Actions, GitLab CI, Docker và assertion trong Playwright.
- Gắn mã thoát (0 sạch / 1 dưới ngưỡng / 2 lỗi) vào luồng pipeline để job fail đúng lúc.
- Hướng dẫn chế độ
--offlinecho runner cách ly mạng hoặc--endpointtrỏ về worker riêng.
Phù hợp với ai
- Đội vận hành crawler/bot muốn phát hiện sớm hiện tượng bị chặn nhiều hơn.
- Kỹ sư build Chromium nội bộ cần bắt hồi quy fingerprint trước khi phát hành.
- DevOps được yêu cầu thêm bước kiểm tra headless-detection vào pipeline.
Ví dụ sử dụng
- "Thêm bước fail build nếu điểm fingerprint dưới 60 vào GitHub Actions" → tạo workflow với setup-node,
npx liarjs@0.3 --headless --json scan.json --min-score 60và upload artifact. - "IP datacenter luôn rớt check tz, làm sao đặt ngưỡng?" → chuyển sang so sánh
baseline.jsonvớiscan.jsonthay vì ngưỡng cứng. - "Theo dõi điểm thay đổi qua từng commit" → lưu scan.json làm artifact và quy ước commit riêng khi cập nhật baseline.
· · · Hướng dẫn cài đặt · · ·
Dùng thử ngay, không cần cài
Dán đoạn dưới vào Claude là dùng được skill này mà không cần cài đặt.
Hãy đọc hướng dẫn trong tệp này và làm theo để giúp mình: https://raw.githubusercontent.com/liarjsdev/liarjs-skills/HEAD/skills/fingerprint-ci-gate/SKILL.md Mình muốn: (viết việc bạn cần ở đây)
Nếu Claude không mở được liên kết, hãy mở liên kết và copy nội dung vào rồi dán.
↓ Thấy hữu ích thì tải ZIP bên dưới và cài. Sau đó skill tự chạy, không phải dán lại mỗi lần.
Cài vào ứng dụng Claude (không cần terminal)
- Tải tệp ZIP bằng nút bên dưới.
- Trong Claude, mở Settings → Capabilities và bật 'Code execution and file creation'. (chỉ một lần)
- Vào Customize → Skills → + → 'Upload a skill' rồi tải tệp ZIP lên.
Cài vào Claude Code
Để Claude làm — dán câu dưới đây vào Claude Code
Hãy cài skill mình tìm thấy trên Claude Skill Mart. Copy thư mục skills/fingerprint-ci-gate từ repo GitHub liarjsdev/liarjs-skills vào ~/.claude/skills/fingerprint-ci-gate/ của mình. Sau khi cài xong, cho mình biết skill này làm được gì trong một câu.
Cài bằng lệnh thủ công
git clone https://github.com/liarjsdev/liarjs-skills.git && mkdir -p ~/.claude/skills && cp -r liarjs-skills/skills/fingerprint-ci-gate ~/.claude/skills/⚠ Đây là skill do người khác tạo. Hãy kiểm tra repo gốc trước khi cài.
- Mở terminal và kiểm tra Node.js phiên bản 22 trở lên:
node -v - Tải kho skill:
git clone https://github.com/liarjsdev/liarjs-skills.git - Tạo thư mục skill:
mkdir -p ~/.claude/skills - Sao chép skill:
cp -r liarjs-skills/skills/fingerprint-ci-gate ~/.claude/skills/ - Khởi động lại Claude Code và thử yêu cầu: "Thêm cổng kiểm tra fingerprint vào CI của tôi".
- Môi trường chạy thật cần có Chromium; với Docker nhớ thêm
--shm-size=1g.
Xem mã nguồn trên GitHub ↗Giấy phép: MIT