返回资讯中心
外部精选
软件工程
#开发者实时流

开源工具 inp-analyser 可诊断并修复页面 INP 性能问题

来源标题:Show HN: Inp-analyser skill – analysis and fix your Interaction to Next Paint

一个名为 inp-analyser 的开源技能工具发布,能定位页面 Interaction to Next Paint 表现差的原因,而非只给出分数。它针对每次点击、点按和按键的三个阶段进行分析,专为大型广告密集型网站的真实 INP 审计打造,只输出诊断证据,具体修复由使用者决定。

Hacker News 最新franze2026/11/11 · 6 天前30 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

判断一个页面为什么 Interaction to Next Paint 表现差,而不只是知道它差。

网站 · 快速开始 · 命令 · 工作原理 · Agent skill

它做的是诊断。它从不输出修复建议:该改什么由你决定,依据证据来判断。

为大型、广告密集站点的真实 INP 审计而打造,并经过实战检验。

什么是 INP? 它能发现什么 安装 快速开始 字段数据设置 命令 示例:真实运行 输出 解读 report.json 工作原理 方法与统计 礼貌与安全 Agent skill 常见问题 限制 参与贡献 许可证 什么是 INP?

Interaction to Next Paint 是衡量响应性的 Core Web Vital。每次页面访问中,浏览器会测量每次点击、轻触和按键直到下一帧绘制所花的时间;页面的 INP 是(接近)其中最慢的那一次。Google 报告的是 28 天内真实 Chrome 用户的第 75 百分位数:

每次交互都有三个阶段,每个阶段的成因各不相同(Optimize INP):

Lighthouse 和 PSI 给你一个数字。这个工具给你原因。

报告中的每个问题都带有同一组事实。以下示例来自 examples/test-site-third-party(自带的测试站点,一个会给每次点击增加 200 ms 的第三方脚本)和 examples/wikipedia-united-states 的真实输出:

它检查的规则(每条规则在报告中都会链接到其规范或引擎源码):

要求:Node.js >= 26、git,以及大约 500 MB 磁盘空间用于固定的 Chrome for Testing 构建。

git clone https://github.com/franzenzenhofer/inp-analyser.git cd inp-analyser npm ci npm run chrome:install # 将固定的 Chrome for Testing 下载到 .chrome/ npm run build npm link # 将 inp 放入 PATH

如果不使用 npm link,也可以直接从源码运行 CLI:

npx tsx src/cli.ts --help

所有测量都运行在一个固定的 Chrome 构建上,因为 INP 的语义在不同 Chrome 版本之间发生了变化(INP changelog)。Chrome 始终以 headless 模式运行。

1. 真实的 INP,如 PSI 所示(不加载页面,需要 API key)

inp field https://en.wikipedia.org/wiki/Main_Page

2. 分析器会点击什么,以及它拒绝点击什么

inp discover https://en.wikipedia.org/wiki/Main_Page

3. 快速初看:只运行筛查

inp analyse https://en.wikipedia.org/wiki/Main_Page --quick

4. 完整分析:筛查、深入分析、第三方因果测试

inp analyse https://en.wikipedia.org/wiki/Main_Page --out wiki-main

然后可以在浏览器中打开 wiki-main/report.html,或阅读 wiki-main/report.json。

还没有 API key?给 analyse 加上 --no-field,只做 lab 运行。

字段数据需要一个 Google Cloud API key,并在其项目上启用以下两个 API:

在 APIs & Services > Credentials 下创建 key,并将其设置为 INP_GOOGLE_API_KEY:

cp .env.example .env # .env 已被 git 忽略;把 key 放进去 set -a && . ./.env && set +a # 或者:export INP_GOOGLE_API_KEY=...

CLI 只读取环境变量;它不会自行加载 .env。切勿提交真实的 key。

每个设备(手机、桌面)获取的内容:

当 CrUX 有数据时,标题显示的是 URL 级别的 p75,否则显示源级别的 p75,并始终像 PSI 那样标注其级别。

inp <command> [options]

命令 作用 inp field <url> 手机和桌面的 CrUX + PSI 字段 INP。不加载页面。写入 field.json。 inp discover <url> 列出 analyse 会测量的交互目标(两轮,仅稳定目标)、它们的安全类别、被排除的目标及原因,以及全局第三方监听器。 inp analyse <url> 完整流水线:预检、发现、筛查、深入分析、第三方因果测试、诊断、报告。 inp report <dir> 从运行目录(runs.jsonl + meta.json)重建 report.json 和 report.html。 inp trace <file> 对现有 DevTools Performance 记录(.json 或 .json.gz)中的问题进行分析。一次记录就是一个样本:没有统计。 inp compare <before> <after> 对两个运行目录进行前后对比:Hodges-Lehmann 位移 + 95% CI、Mann-Whitney p(Holm 校正)、每个共享场景的 Cliff's delta。 inp calibrate 测量此机器上每种 CPU 节流速率下的 Lighthouse BenchmarkIndex,并命名每种速率达到的设备类别。 inp analyse 选项 选项 默认值 含义 --device <mobile|desktop> mobile 带触摸的移动模拟,或带鼠标的桌面 --cpu <rate> 4 CPU 节流速率(Lighthouse 默认值)。用 inp calibrate 来选择。 --quick off 筛查后停止(不做深入分析,不做因果测试) --max-targets <n> 12 要测量的交互目标 --phases <list> boot,idle idle = 页面加载并安静后轻触一次;boot = 页面仍在启动时轻触 --budget <minutes> 120 所有阶段的时间预算;如果耗尽,报告会说明 --seed <n> random 随机运行顺序的种子(会打印在报告中,因此运行可以重复) --out <dir> inp-report-<host>-<timestamp> 输出目录 --no-field field on 跳过 CrUX/PSI(仅 lab,不需要 API key) --entity-map <file> none 额外的脚本所有者:{"entities":[{"name","category","domains"}]} --allow-mutations <regex> none 允许通过请求守卫的第一方非 GET URL --min-load-interval <seconds> 10 礼貌:同一源两次加载之间的最小秒数 --consent-state <file> none 将已接受的同意状态(cookies + localStorage)注入每次加载;用 scripts/capture-consent-state.ts 捕获一个 --max-load <n> 一半核心数 启动门的繁忙机器限制(1 分钟负载平均值) --proxy-server <url> none 用于页面流量的 Chrome 代理,例如 socks5://localhost:1080 --host-resolver-rules <rules> none Chrome 主机解析器规则(仅用于本地测试站点) 其他选项:field --out <dir>、discover --device <d> --max-targets <n>、trace --entity-map <file>。

$ inp field https://en.wikipedia.org/wiki/Main_Page phone : INP p75 130 ms (url level, 2026-10-12..2026-11-08) good 86.5% / needs improvement 9.7% / poor 3.9% | PSI: equal desktop: INP p75 61 ms (url level, 2026-10-12..2026-11-08) good 96.8% / needs improvement 2.3% / poor 0.9% | PSI: equal

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →