一、这个项目解决的是什么问题
编程助手写前端代码有个稳定的坏习惯:明明浏览器原生已经能做,它还是给你引一个库、写一段三百行的 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。






















暂无评论内容