Chrome 开源了 modern-web-guidance,用浏览器平台规则引导 Coding Agent 少写 JavaScript,少装依赖。这对你的直接关系是:Agent 生成前端代码时,可能少复制旧版弹窗、高亮和表单逻辑。
模型知道 CSS.highlights、<dialog>、showModal() 这些名字。
但让它改一个文本高亮、一个弹窗、一个自动增高的输入框,它仍可能写出一大段 JavaScript,再顺手加一个依赖。
这不是模型不会 API。
更像是训练数据里的旧习惯太重。
Google Chrome 团队开源了 modern-web-guidance,目标就是给 Coding Agent 补充现代 Web 平台知识。项目摘要写得很直接:
“We started an effort in Chrome to supplement coding agents with this key domain knowledge.”
它不是新框架,也不是新的运行时。它更像一层面向 Agent 的领域规则:先告诉 Agent 哪些事情浏览器已经能做,再让它生成代码。
模型知道 API,却不用
Coding Agent 的常见路径不是“不知道”,而是“知道但不用”。
项目观察到,模型即使知道一些现代 API 的名称,也经常不选择平台原生方案,而偏向既有的 JavaScript 模式。
这和人类开发者的惯性很像。
2019 年处理文本选中样式,常见做法是监听 selectionchange,遍历 DOM 节点,再手动维护高亮状态。2026 年,浏览器已经有 CSS.highlights,但旧代码仍然占训练数据的大多数。
模型做代码补全时,最容易延续的不是“最佳实践”,而是“出现频率最高的模式”。
于是我们看到一种很具体的浪费:
- 文本高亮逻辑散落在多个 JavaScript 回调里;
- 模态框自己管理遮罩、关闭按钮和焦点;
textarea高度靠监听input、读取scrollHeight、再写回style.height;- 为这些小功能引入 Popper、Headless UI 或其他依赖。
生成结果能跑。
但代码更重,状态更多,浏览器兼容边界也更多。
Chrome 正在补领域知识
modern-web-guidance 的定位很克制:它不替 Agent 写应用,而是补充浏览器平台这一块领域知识。
这点很重要。
通用模型会写 React、Vue、Node.js,也知道大量 JavaScript 惯用法。但一个模型如果缺少足够明确的平台规则,就容易把“能调 API”和“应该优先用 API”混为一谈。
这个项目采用结构化指南。目录按领域和具体能力组织,Agent 可以在写代码前读取对应规则,而不是把一整本 API 文档塞进上下文。
它解决的不是上下文长度问题。
恰恰相反,它试图改变上下文的内容和优先级。
过去,给 Agent 追加 API 文档,常见效果是让它多知道一些选项。现在 Chrome 团队尝试把“默认选择”写清楚:遇到文本范围高亮,先看 CSS.highlights;遇到模态对话框,先看 <dialog> 与 showModal();遇到输入框自适应高度,先看 field-sizing。
规则比示例更接近约束。
示例告诉 Agent“可以这样写”;规则告诉 Agent“优先这样写”。
三个能力,三份代码
下面这组例子来自项目列出的能力方向。它们不是完整框架代码,但足以说明“交给浏览器”和“自己维护状态”的差别。
1. 文本范围高亮
旧模式通常需要自己监听选择变化、计算范围、应用样式,再处理清除。
现代方案使用 CSS.highlights,并通过 Highlight 注册文本范围:
const highlight = new Highlight();
CSS.highlights.set('search-results', highlight);
const range = document.createRange();
range.selectNodeContents(document.querySelector('#result'));
highlight.add(range);
项目对这项能力的描述是:用 CSS.highlights 做文本范围高亮,不必再把相同逻辑散落到各处 JavaScript。
浏览器负责维护高亮集合。JavaScript 只需要提供范围,样式则可以放在 CSS 中:
::highlight(search-results) {
background-color: #fde68a;
color: #111827;
}
对于 Coding Agent,这是很具体的默认项切换:不是把原来的状态管理改写得更漂亮,而是尽量删除状态管理。
2. 模态对话框
手写弹层时,遮罩、滚动锁定、焦点移动和关闭后的焦点恢复,很容易变成项目里的隐形基础设施。
HTML 原生方案是 <dialog> 配合 showModal():
<dialog id="settings-dialog">
<form method="dialog">
<h2>Settings</h2>
<button value="close">Close</button>
</form>
</dialog>
const dialog = document.querySelector('#settings-dialog');
openButton.addEventListener('click', () => {
dialog.showModal();
});
项目对它的说明包括两个具体收益:原生 backdrop,以及更理想的焦点管理。
也就是说,遮罩不再需要额外 div;焦点进入弹窗、限制在模态上下文中,以及关闭后的恢复,都有浏览器语义可承接。
Agent 如果能在遇到“模态框”时默认选择 <dialog>,一个小型交互组件就可能从几十行 JavaScript 变成几行调用。
3. 自动增高的 textarea
旧代码很熟悉:监听 input,读取 scrollHeight,设置高度。
现代 Web 平台提供了 field-sizing:
<textarea rows="3" field-sizing="content"></textarea>
用户输入时,textarea 会自动增高。
项目把这项能力概括为:让 textarea 随用户输入自动增高。
没有 resize 监听,没有高度缓存,也不需要在框架状态里保存一个派生值。
这个例子最能说明这类指南的价值。它未必让 Agent 学会一种全新架构,只是让它别再复制一段存在了多年的样板代码。
Agent 的缺口不是上下文
很多人看到 Coding Agent 写得很保守,第一反应是“再塞一些现代 JavaScript 教程进去”。
这通常不够。
因为问题不是 API 说明缺失,而是默认选择被旧代码压住。
模型见过大量 GitHub 项目:这些项目有历史包袱,有兼容需求,也有作者个人偏好。模型从统计上复现这些代码很正常。
但如果任务是“实现一个现代 Web 交互”,最佳答案不一定是复现最常见的旧实现。
modern-web-guidance 试图在生成前加入浏览器团队维护的领域约束。约束的对象不是语法,而是选型:
- 平台有原生能力时,优先不用 JavaScript 重做;
- 原生元素能覆盖语义时,优先使用语义元素;
- 平台已经处理焦点、尺寸或高亮时,不再维护重复状态。
这类规则还有一个工程上的好处:它们比“请遵循最佳实践”更容易验收。
你可以检查生成的代码里有没有手写 textarea 拉伸,有没有用 div 模拟 dialog,有没有为简单高亮引入依赖。
编辑思考
这件事重要,不是因为 Chrome 又开源了一个仓库,而是因为平台团队开始直接维护“给 Coding Agent 的约束层”。过去,框架团队靠文档、示例和 lint 规则影响生成代码;现在,浏览器团队也可以把自己的能力边界编码成 Agent 可读取的指南。
我的判断是,未来有效的 Agent 规则不会主要来自更大模型,而会来自更靠近运行平台的约束。模型负责写代码,平台团队负责规定什么不该重写。
它和过去不同的地方在于:RAG 通常负责补充事实,指南则要改变默认动作。事实回答“field-sizing 是什么”,约束要回答“什么时候必须优先用它”。
不过,效果还不能只看规则写得多漂亮。浏览器版本支持、项目兼容范围、框架水合行为,以及真实代码库里的历史约束,都会影响结论。尤其是 dialog、Popover API 和 field-sizing 的兼容情况,不能用一个新浏览器演示代替生产验证。我会关注两件事:生成代码的依赖是否真的下降,以及指南进入 Agent 工作流后是否会被项目级规则覆盖。约束是否有用,最终要看它是否减少了代码,而不只增加了知识。
来源
https://github.com/GoogleChrome/modern-web-guidance