四家浏览器联手给 AI 发的这份"教材",我装上实测了
- 2026-11-20 20:16:07

上周的 GitHub 盘点(第 2 期)里,我把一个项目放在了"官方亲自下场"分类的第一个:GoogleChrome/modern-web-guidance(下称 MWG)——Chrome、Edge、Firefox、MDN 四家罕见联名,给 AI 编程助手写的"现代 Web 教材"。
文章发出去后,好几个朋友来问:听着挺唬人,到底有没有用?
所以这篇不是转述,是我拿它在自己电脑上真跑了一遍的结果——三条命令全部实测,包括一个我故意挖坑的测试。先说结论:值得装,但要装对预期。

一、它治的是什么病:AI 的前端停留在 2018
先说一个你大概率踩过的坑。
让任何一个主流 AI 写一个"带淡入动画的确认弹窗",你八成会拿到这样的东西:一个手写的遮罩 div、一堆 addEventListener、手动锁 body 滚动、顺手再引入一个八年没更新的动画库。
不是模型笨——浏览器早就原生支持、Popover API 和 View Transitions,这些能力写出来代码量只有手写方案的三分之一,还自带无障碍支持。
问题的根源是训练数据的时间差:模型是从历史代码里学出来的,GitHub 上十年积累的"老写法"数量,远远碾压最近一年才成为浏览器标配的新 API。统计上,它就是更倾向给你吐 2018 年的代码。
MWG 就是冲着这个来的:一套直接装进 AI 编程助手的技能包,把"2026 年的 Web 该怎么写"注入给模型。
二、先看背景,这个项目为什么特殊
三个数字摆一下(截至 11 月中旬):
主仓库 21k+ Star,发布 10 天冲上过 GitHub Trending 日榜第一 联合维护方:Google Chrome、Microsoft Edge、Mozilla Firefox、MDN——平时在标准问题上互相较劲的几家,罕见地共同署名一套"给 AI 的标准答案"(顺带一提,Apple 的 WebKit 没有席位) 贡献者名单里有 Paul Irish、Lea Verou、Philip Walton、Bramus——做前端的应该都读过这些人的东西
体量方面:约 210 份指南、覆盖 250 个现代 Web 特性,按 17 个分类组织(交互行为、性能、UI 组件、CSS、表单、安全等)。
三、机制拆解:它是字典,不是文档搬家
MWG 最聪明的设计是克制。
装上之后,常驻你 AI 上下文的只有一个约205 token的技能说明——不是把 210 份指南全塞给模型。真实工作流是四步:
1. Agent 遇到前端任务,先执行 search(本地离线搜索)2. retrieve 取回命中的指南全文3. 按指南写代码 + 验证(含旧浏览器回退)4. 回复末尾强制”披露”:用了哪几份指南、为什么
搜索是离线的(嵌入模型 + BM25),零网络调用、不要 API Key。第 4 步的"披露"很有意思:AI 每次用了什么现代写法都要列出引用来源,等于逼着它把决策摆到台面上——你顺便就学会了。
还有一个容易被忽略的细节:实验性 API 默认上锁。那些只在单一引擎实现、或还在 Origin Trial 的新特性,Agent 搜得到但取不到,必须你在项目里写个 .mwgrc 显式解锁。这是在防止 AI 拿半成品 API 给你的生产代码埋雷。
四、我的实测:三条命令,一个意外发现
环境:Windows,Node v22.22.2(官方要求 ≥22),2026.11.20 实测。
实测 1:search 搜索。搜"弹窗动画"(animate a dialog modal backdrop),12.4 秒返回(含首次 npx 下载),给出 10 条结果,全部精准命中——dialog、light-dismiss、top-layer 动画、防滚动穿透,一条不相关的都没有。
实测 2:retrieve 取指南。取回 top-layer 动画指南,10.7KB、244 行。质量确实高:完整的 @starting-style + transition-behavior: allow-discrete 方案,每一处都标注了"必须这样做"的原因(比如 transition 简写会重置 allow-discrete,要分开写),还强制带 prefers-reduced-motion 无障碍适配——这些恰恰是模型自己不会主动做的。
实测 3:legacy-scan 扫老代码——意外发现在这。我故意手写了一个 2018 画风的 HTML:div 手搓弹窗、手动锁 body 滚动、scroll 监听吸顶、setInterval 轮询,共 5 处老写法。扫描 4.4 秒跑完,只揪出了 1 处(CDN 引用没加完整性校验 SRI)。
为什么?扫描器自己交代了:它只用确定性规则扫了 38 份指南,约占整个指南库的 20%。所以结论很清楚——legacy-scan 是个"试吃装",真正的主菜是把它装进 Agent 的工作流,让 AI 写代码的瞬间去查这 210 份指南。别指望拿它当老项目的体检工具。
"披露"长什么样?官方文档给过一个真实例子。让 AI 写一个弹窗动画,装了 MWG 的回复末尾会自动多出这样一段:
### Modern Web Guidance- dialog:用原生 声明式打开(Invoker Commands),背景滚动锁定用 overscroll-behavior: contain,不再用 overflow: hidden 锁 body> ”DON'T lock scrolling with overflow: hidden on body”- animate-to-from-top-layer:入场动画用 @starting-style,离场用 transition-behavior: allow-discrete,并尊重 prefers-reduced-motion 用户偏好
也就是说,AI 不但换了写法,还必须交代"为什么这么写、引用了哪条规则"。每让 AI 写一次前端,你就免费上了一堂 2026 年的现代 Web 课——这也是很多开发者把它当学习工具用的原因。

五、官方评测 + 什么人该装
MWG 团队自己跑了一套相当硬的评测:215 个真实前端任务,提示词故意不提任何 API 名字(考 Agent 能不能自己发现并查对指南),用 Playwright 在真浏览器里验收。11 月 8 日的快照:

Claude Code:57% → 88%(+31pp) Codex CLI:54% → 82%(+28pp) Antigravity:58% → 94%(+36pp)
当然这是官方自测,数字要打折扣看。但三个不同模型系全部涨 28 个百分点以上,说明补的是共性知识缺口,不是对某一家的过拟合——这个可信度还不错。
该装的人:日常让 AI 写前端的(Claude Code / Codex / Cursor / Copilot 都支持),安装就一条命令:
npx modern-web-guidance@latest install可以不装的人:项目还要兼容很老的浏览器(先看每份指南的回退说明);纯后端/脚本工作(它只管 HTML/CSS/客户端 JS)。
两个注意点:CLI 默认向 Google 发匿名遥测(不含你的提示词),介意就设 DISABLE_TELEMETRY=1;另外它需要 Node 22+。
六、比工具更值钱的,是它验证的方法论
最后说点工具之外的。MWG 跑通了一个三件套:权威内容 + 检索式注入 + 评测驱动修剪——评测里发现模型已经会的部分,直接从指南里删掉,只保留模型不会的盲区。
这套思路不止适用于前端。任何"模型知识过时、试错成本高"的领域——你们公司的内部框架、行业规范、平台的运营规则——都可以照着做自己的技能包。从这个角度看,四家浏览器联手发的这份教材,其实是替整个 AI 工具生态打了样。
写在最后
从「GitHub 月度盘点」到实测系列,这个号的节奏是:盘点负责发现,实测负责验证。下一篇盘点(12 月中旬)已经在攒货了,中间会再插一篇实测——上一期你们在评论区问得最多的 apkstart(Windows 直接跑 APK)呼声很高,我会找时间安排。
你的 AI 还在写哪些"考古现场"级别的老代码?评论区交换情报,点赞最高的我写进下期实测选题。