壹贰线报 · 第 20261119 期发布在「壹贰云测评」壹贰线报板块 核实时点:2026-11-19 文 / 壹贰线报 · 官方定价页 + GitHub 仓库双重核实
🎯 开头一句话
stateofpixel——在合并前拦截 UI 回归:由 CI 用 Playwright、Storybook 等工具截图,人在 PR 上逐一审批变化。开源可自托管,免费 10 GB。
📌 上手前要看的 3 个细节
"10 GB"是存储配额,不是次数/人/项目数——snapshot/builds/projects/reviewers 全不额外收费;超过 80% 告警,超量 14 天后新图不入库但 CI 仍 pass(不卡流水线,这是比 Chromatic/Argos/Percy 友好的点);
只支持 GitHub(GitLab/Bitbucket 暂不支持),其他 CI 可用项目 token 接入,只要仓库在 GitHub;审批权跟随 GitHub 写权限,没有 seats 席位收费,整个团队都能 review;
本地 CI 截图 + 云 diff——截图在你自己的 CI 里跑(用你选的浏览器/分辨率/字体),不被平台云浏览器渲染差异坑到;CLI 自动忽略抗锯齿+颜色阈值,避免误报。
🎁 两个隐藏福利
PR 图像默认保留 60 天,够日常开发回溯;单 PNG 最大 25MB,metadata 4KB/snapshot 够用;
CLI、server、web app 全 MIT 开源(github.com/VaibhavAcharya/stateofpixel),可以 fork 自托管到内网/自有存储,敏感项目不用出公网。
💎 免费版真实能做什么(来自官方 pricing+FAQ)
能力项 | Free 免费版 |
|---|---|
价格 | $0 永久 |
存储额度 | 10 GB(PNG + hash + diff + metadata + git metadata 总计) |
信用卡 | 无需 |
Projects 项目数 | 不限 |
Reviewers 审核人 | 不限(无席位费,跟随 GitHub Write 权限) |
Builds 构建数 | 不限 |
Snapshots 截图数 | 不限(按存储计费,不是按张) |
PR 图保留期 | 60 天(默认) |
单图最大 | 25 MB / PNG |
单 snapshot metadata | 4 KB |
Test runners | Playwright / Cypress / Storybook / BackstopJS / 原生 App 截图(凡是写 PNG 的都支持) |
浏览器 | 你自己 CI 的浏览器(Chromium/Firefox/WebKit 自己装) |
Sharding 分片 | ✅ 支持( |
多套件 | ✅ Storybook + Playwright 同仓库各自基线 |
Partial runs 部分跑 | ✅ |
Squash/Rebase 合并 | ✅ 自动关联 PR、标记未审批变更 |
Flaky 截图识别 | ✅ 标记 + 修复指引,默认抗锯齿忽略+颜色阈值 |
新 push/变基审批 | ✅ 已审批图片保持 Approved、拒绝的回 pending |
平台宕机 | 默认 warn+exit 0(CI 不红), |
权限 | GitHub OAuth 最小化(Statuses write / PR read / Contents read / Email read) |
开源 | ✅ MIT,CLI+Server+Web App 全开源可自托管 |
🛠️ 核心能力:6 张卡片看懂它
1️⃣ 你自己的 CI 截图,云端只做 diff
不像 Chromatic/Argos/Percy 把渲染搬到云端(云浏览器和你本地字体/DPI/抗锯齿不一致容易误报)——stateofpixel 截图完全在你 CI 里跑,上传 PNG 之后云端做哈希对比+diff 渲染+PR Check,像素一致性完全由你控制。官方文档原话:"Nothing to wait for. One CLI step after your tests. Your runner does the work."
2️⃣ PR 可视化 review:键盘 j/k/a/r 批量过
打开 PR 详情页逐张审批:j/k 上下切换、a 接受(Approve)、r 拒绝(Reject),diff 滑杆可拖动看前后对比+差异像素高亮。有 Write 权限的团队成员都能审批,没有 seat 席位费。
3️⃣ 全 runner 兼容:Playwright/Storybook/Cypress/BackstopJS/原生App
官方 tab 直接给了 Playwright / Storybook / GitHub Actions / Other CI / Local 五段 config 示例;任何能写 PNG 的工具都接入(Cypress cy.screenshot、BackstopJS、iOS/Android 原生 App 截图都行),CLI 甚至能自己抓 Storybook。
4️⃣ Sharding/多套件/Partial/Squash/Rebase 全场景兜底
--shard 2/4分片上传,最后一份到了才报 checkStorybook + Playwright 同仓库各自 baseline(互不干扰)
--subset部分跑(单测失败不会报"截图被删了")squash/rebase 后自动找到对应 PR,未审批变更不会偷偷合入
新 push 已审批过的图保持 Approved、拒绝的回 pending 重新审
5️⃣ 抗锯齿+颜色阈值默认开启,Flaky 图自动标记
默认 odiff/pixelmatch 做 diff,自动忽略抗锯齿抖动,带颜色阈值(threshold);一张图在 main 上来回翻转/同 commit 两次构建结果不同,会被标记为 "looking flaky" 并附修复指引(推荐 Playwright Docker 镜像+禁用动画锁死渲染环境)。
6️⃣ MIT 全栈开源,可自托管
github.com/VaibhavAcharya/stateofpixel 是完整仓库(CLI + 后端 Server + Web App),MIT 许可,可 fork 到内网接 MinIO/S3 自建存储,敏感业务零数据出公网。
⚠️ 3 个避坑必看
GitLab/Bitbucket 目前不支持——官方 FAQ 明说 "No. stateofpixel is GitHub only",仓库必须在 GitHub(其他 CI 可通过 project token 上传);
超 10GB 不会立刻阻断:80% 告警,超量 14 天后新图不入库但 CI 仍 pass(绿勾但有提示),别误以为被限流了;
平台自身不提供浏览器——Chromium/Firefox/WebKit 自己在 CI 装(Playwright 用
playwright install --with-deps即可),好处是渲染完全由你控制,坏处是要自己维护 Docker 镜像锁字体/DPI。
✅ 适合 / ❌ 不适合
✅ 适合:
用 Playwright/Storybook/Cypress 做前端自动化测试、想补视觉回归门禁
团队 review 视觉变化、不想被 Percy/Chromatic/Argos 按快照/席位收费
想把视觉回归接在 PR 合并前,人来批变(而不是阈值一刀切)
开源项目/小团队/对成本敏感、需要自托管能力
❌ 不适合:
用 GitLab/Bitbucket 做仓库(目前只支持 GitHub)
需要平台提供云端浏览器跨浏览器矩阵(免费版是你自己 CI 截图)
需要 AI 视觉差异判断/语义 diff(stateofpixel 只做像素级,没 AI 智能判定)
需要 1 年以上长留存(免费 PR 图 60 天,更长要付费)
🚀 4 步上手(可直接复制进你的项目)
第 1 步:GitHub App 一键安装
打开 https://stateofpixel.com → "Start free",用 GitHub 账号授权安装 stateofpixel App 到目标仓库(权限最小化,只写 Commit statuses/读 PR/读 Contents/读 Email)。
第 2 步:Playwright 配置(playwright.config.ts 示例)
import { defineConfig } from '@playwright/test';export default defineConfig({ testDir: './tests', reporter: [ ['html'], // stateofpixel reporter 会在测试结束自动收集截图+元数据 ['@stateofpixel/playwright', {}], ], use: { screenshot: 'on', // 每张失败/对比图都存 PNG trace: 'retain-on-failure', },});
第 3 步:GitHub Actions CI(.github/workflows/vr.yml)
name: Visual Regressionon: [pull_request, push]jobs: vr: runs-on: ubuntu-latest steps: - uses: actions/checkout@v4 - uses: actions/setup-node@v4 with: { node-version: 20 } - run: npm ci && npx playwright install --with-deps chromium - run: npx playwright test - name: Upload to stateofpixel run: npx @stateofpixel/cli upload env: STATEOFPIXEL_TOKEN: ${{ secrets.STATEOFPIXEL_TOKEN }}
第 4 步:PR 审批
下一次 push 到 PR,GitHub Check 会显示 "5 changes waiting",点进 stateofpixel review 页逐张 j/k 切图、a 接受 r 拒绝,全部 Approved 后 Merge 按钮解锁。
📊 横向对比:8 款视觉回归工具一眼看懂(2026-11)
工具 | 开源协议 | 免费额度 | 云浏览器 | 自托管 | PR审批 | 席位费 |
|---|---|---|---|---|---|---|
stateofpixel | MIT(全栈) | 10GB 永久 | ❌(你CI截图) | ✅ | ✅ | 无 |
Lost Pixel | MIT | 开源免费自托管/云付费 | ❌ | ✅ | 部分 | 无 |
Playwright toHaveScreenshot | Apache-2.0(内置于Playwright) | 无限本地 | ❌ | - | ❌(纯代码阈值) | 无 |
Percy (BrowserStack) | 闭源 | 5,000 快照/月(带水印) | ✅ | ❌ | ✅ | 按用户 |
Chromatic (Storybook官方) | 部分开源 | 5,000 快照/月 | ✅(Chromium) | ❌ | ✅ | 按 reviewer |
Argos | MIT(CLI) | 5,000 截图/月 | ✅ | 部分 | ✅ | 部分 |
Applitools Eyes | 闭源 | 100 checkpoints/周 | ✅+AI | ❌ | ✅ | 按用户 |
BackstopJS | MIT | 完全开源免费本地 | ❌ | ✅ | ❌ | 无 |
一句话定位:stateofpixel = 不锁云浏览器 + 按存储计费不按张/按人 + MIT 全栈可自托管 + PR review 体验对标付费工具。
💰 付费档参考(按需升级,不是必须)
档位 | 月付 | 年付(省10%) | 存储 |
|---|---|---|---|
Free | $0 | $0 | 10 GB |
Team 25 | $15/月 | ≈ $13.5/月 | 25 GB |
Team 100 | $100/月 | ≈ $90/月 | 100 GB |
Team 500 | $500/月 | ≈ $450/月 | 500 GB |
Enterprise | 联系hello@stateofpixel.com 定制 | - | SSO/私有部署/99.9% SLA |
官方定位:"Pay for storage, nothing else."——只按存储计费,快照数/builds/项目/评审人都不另收费,对比 Percy/Chromatic 按张+按人收费的模式,长期大项目成本可控。
你现在用什么做前端视觉回归? Percy / Chromatic / Argos / Playwright 原生 toHaveScreenshot / 还是人工点?在评论区聊聊踩过的坑(尤其是"CI 里和本地颜色不一样"这种渲染差异误报)。
你觉得视觉回归应该"阈值自动过"还是"必须人批每张变化"? stateofpixel 走的是后者路线(人工逐张批),和 Chromatic 的阈值机制不同,你更站哪种?
文中规则以官方定价页与 FAQ 为准(核实时点:2026-11-19,免费 10GB/无席位/MIT 全栈开源/GitHub-only 均来自 stateofpixel.com 本次实际核实 + github.com/VaibhavAcharya/stateofpixel 仓库)。