Modern Web Guidance:给编程助手装一套浏览器官方写的 Web 规范

一、这个项目解决的是什么问题

编程助手写前端代码有个稳定的坏习惯:明明浏览器原生已经能做,它还是给你引一个库、写一段三百行的 JavaScript。原因不神秘——训练数据里遗留写法占多数,模型只是照着概率最高的路走。就算它知道某个新 API 存在,也往往不知道生产环境里该怎么用。

Modern Web Guidance 是给编程助手补这一课的。它是一套技能包,装到你的助手(Claude Code、Codex、Cursor、Copilot 等)里,之后助手遇到 Web 平台相关的问题会先去查它,再回答。维护方是 Google Chrome、Microsoft Edge、Mozilla Firefox 和 MDN 四个团队共同署名。项目是 Apache-2.0,2.37 万星,当前版本 1.0.1。

二、核心设计机制

它的第一条设计原则是「为 token 效率而设计」。一个技能包如果塞进去几万字,助手的上下文直接被吃掉一半,反而变笨。所以它做了两件事:一是靠评测把模型已经会的常识剪掉,只留真正会被写错的部分;二是把内容切成一篇篇独立的指南,按需检索而不是全量注入。

它的第二条原则是「本地检索」。你装完之后,助手调用它的命令行去查,检索用的是离线的零依赖嵌入模型加关键词匹配,全程不联网、不需要 API key。这个设计在隐私和延迟上都有意义——查一次规范不该产生一次网络往返。

它的第三条原则是「实验性 API 默认门控」。近三个月才发布、只有一个引擎支持、或者还在稳定过程中的特性,在搜索里能被发现,但在取全文时会被拦住,除非你在项目配置里显式打开开关。这是为了防止助手未经你同意就把不稳定的 API 用到生产代码里。

三、功能拆解

覆盖范围:262 个特性,分三类——CSS 与布局 140 个、HTML 与 DOM 37 个、JavaScript 与 API 85 个。

六个核心方向:用户体验(视图过渡、进出场动画、视差滚动、滚动条配色)、CSS 布局(容器查询、subgrid、oklch 色彩空间、文本换行调优)、性能(即时预加载、交互延迟诊断、任务调度让步)、表单与界面(锚点定位做提示框、Popover API、dialog 元素、用户输入校验)、无障碍(读屏与键盘可操作、内容导航)、内置 AI(本地客户端模型:翻译、摘要、语言检测)。

检索命令:`search` 用一句话描述你要做什么,它返回最匹配的指南;`retrieve` 按 ID 取全文,把代码范式、暗坑、降级方案直接塞进上下文。

遗留扫描:`legacy-scan` 扫一个目录,找出还在用老写法的代码。

项目配置:`.mwgrc` 文件,可以放在项目根(提交给团队共享),也可以放在用户目录做兜底。两个开关分别解锁实验性特性和易变的单引擎特性。

遥测:默认收集匿名使用信息(安装次数、调用的助手名、取过哪些指南、搜索查询文本),不收集你的原始提示词。想关掉就在 shell 配置里设一个环境变量。

四、适合谁,不适合谁

适合的是:用编程助手写前端、受够了「一个下拉菜单引一个库」的人;团队里想让助手输出统一到现代写法的人;做 Web 性能优化、需要助手知道现代 API 的人;在意「查规范不该联网」的人。

不适合的是:不写前端的人——这套东西对后端、脚本、系统编程没有内容;用非常老的浏览器目标(比如还要兼容 IE)的项目,它的建议方向是反的;以及期待「装上助手就变聪明」的人,它补的是具体知识,不是推理能力。

五、几个需要提前知道的限制

第一,它是给助手用的,不是给你读的。你装完之后不会看到界面,只能通过助手的回答质量感受到差别。想验证是否生效,可以问助手一个具体的现代 API 用法,看它是不是直接给原生方案。

第二,安装方式是给具体助手定制的。一条 npx 命令是通用向导,此外还有 Vercel 的技能命令行、GitHub CLI、Google Antigravity、Claude Code 和 Copilot 的插件市场、Codex 的插件命令、Kimi Code、Grok 等各自的方式。装错通道不会报错,但也不会生效。

第三,内容会过时。指南跟着浏览器版本走,所以它提供了更新命令,建议隔一段时间跑一次。

第四,遥测默认开着。介意的话设一个环境变量关掉。

六、项目现状

当前版本 1.0.1,2026 年 11 月 16 日发布。2.37 万星说明它在发布后传播很快,四大浏览器团队共同署名这件事本身也说明了行业对「让助手写现代代码」这个问题的共识。项目有独立的评测看板,公开每个指南的命中率——这也是它敢说「为 token 效率设计」的依据。

七、常见问题

问:它是给谁用的?

答:给编程助手用的。你装它,助手用它,你受益。

问:要联网吗?

答:检索全程本地,不联网、不需要 key。只有安装和更新需要网络。

问:支持哪些助手?

答:Claude Code、Codex、Cursor、Copilot、Gemini CLI、Antigravity、Kimi Code、Grok 等,README 里逐个列了命令。

问:会拖慢助手吗?

答:综合包大约 205 token,比一篇长文档小得多。它按需检索,不是全量注入。

问:怎么知道它生效了?

答:让助手做一个具体的现代实现,比如「用 popover 做一个下拉菜单,不要引库」。它直接给原生方案就是生效了。

问:能关掉遥测吗?

答:能。在 shell 配置里设一个环境变量就行。

下载地址

夸克网盘(永久有效):https://pan.quark.cn/s/6aeaa13bcc5d

本教程由「宝藏星球屋」整理,更多软件、游戏、开源项目都在 https://cbge.top。

本站全部免费,如果觉得内容有用,可打赏支持服务器续费打赏支持
固定文章缩略图

新人必看的入站详细说明指南

解决的你的各种疑难杂症以及各种相关教程

前往查看 »
© 版权声明
THE END
喜欢就支持一下吧
点赞44 分享
评论 抢沙发
头像
欢迎您留下宝贵的见解!
提交
头像

昵称

取消
昵称表情代码图片

    暂无评论内容