stateofpixel 免费线报 | 截图对比也能免费、MIT 全栈开源

壹贰线报 · 第 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 分片

✅ 支持(--shard 2/4 或 --shard auto + finalize)

多套件

✅ Storybook + Playwright 同仓库各自基线

Partial runs 部分跑

✅ --subset(测试失败自动识别)

Squash/Rebase 合并

✅ 自动关联 PR、标记未审批变更

Flaky 截图识别

✅ 标记 + 修复指引,默认抗锯齿忽略+颜色阈值

新 push/变基审批

✅ 已审批图片保持 Approved、拒绝的回 pending

平台宕机

默认 warn+exit 0(CI 不红),--strict 才失败

权限

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 分片上传,最后一份到了才报 check

  • Storybook + 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 个避坑必看

  1. GitLab/Bitbucket 目前不支持——官方 FAQ 明说 "No. stateofpixel is GitHub only",仓库必须在 GitHub(其他 CI 可通过 project token 上传);

  2. 超 10GB 不会立刻阻断:80% 告警,超量 14 天后新图不入库但 CI 仍 pass(绿勾但有提示),别误以为被限流了;

  3. 平台自身不提供浏览器——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 按张+按人收费的模式,长期大项目成本可控。

  1. 你现在用什么做前端视觉回归? Percy / Chromatic / Argos / Playwright 原生 toHaveScreenshot / 还是人工点?在评论区聊聊踩过的坑(尤其是"CI 里和本地颜色不一样"这种渲染差异误报)。

  2. 你觉得视觉回归应该"阈值自动过"还是"必须人批每张变化"? stateofpixel 走的是后者路线(人工逐张批),和 Chromatic 的阈值机制不同,你更站哪种?


文中规则以官方定价页与 FAQ 为准(核实时点:2026-11-19,免费 10GB/无席位/MIT 全栈开源/GitHub-only 均来自 stateofpixel.com 本次实际核实 + github.com/VaibhavAcharya/stateofpixel 仓库)。

版权声明

本文仅代表作者观点,不代表本站立场。
本文系作者授权发表,未经许可,不得转载。