# GoogleChrome/modern-web-guidance 调研

调研日期：2026-11-13（北京时间）｜方式：GitHub API + 仓库 tarball 实测（664 KB 下载，301 个文件，本地解包读完）+ 官方博客 + npm registry，全部经代理 `127.0.0.1:7890`。**未安装、未改配置、未接入。**

## 一句话结论

**它是一个标准的「Agent 技能包」（SKILL.md + 209 篇 markdown 指南）配一个 npx CLI 做本地检索，专治 AI 写前端时爱用老旧写法的问题；质量是真的，官方背景也是真的，但它是给「浏览器里的现代 Web 前端」用的——对微信小游戏（Canvas + JS，没有 DOM/CSS）几乎没用，只用得上 NAS 上那几个网页服务的前端。**

---

## A. 它到底是什么形态

**逐条回答：不是 MCP 服务器，不是编辑器插件，不是 Cursor 规则文件集合。**

1. **形态**：一个 **Agent 技能（skill）** + 一个 **npm 分发的 CLI**。技能本体就是 `skills/modern-web-guidance/SKILL.md`（9,793 字节），正文里教 agent 在动手写前端前先跑三条命令：`search`（本地语义检索）→ `retrieve`（取回具体指南塞进上下文）→ `legacy-scan`（扫旧写法）。真正的知识内容是 `guides/` 下 209 篇 markdown。
   - 同时附带一堆不同生态的插件清单文件（`.claude-plugin/`、`.codex-plugin/`、`.cursor-plugin/`、`.grok-plugin/`、`gemini-extension.json`、`kimi.plugin.json`、VS Code 的 `package.json`），所以它**能投喂给几乎所有主流编程 agent**——这也是它「看起来有很多形态」的原因。
   - 仓库自己的 `CONTRIBUTING.md` 明说：**这个仓库只是发布目标（publish target）**，源码/评测/issue 都在 `GoogleChrome/modern-web-guidance-src`。

2. **目录结构与体量**（实测 tarball 解包，压缩包 664 KB，解包 2.9 MB）：
   ```
   skills/
     modern-web-guidance/SKILL.md           9.8 KB
     modern-web-guidance/guides/            209 篇 .md，合计 1,926 KB，17 个分类
       css 18 / forms 19 / ui-behaviors 40 / performance 26 / ui-components 22
       visual-design 22 / security 17 / ui-atoms 13 / html 8 / built-in-ai 5 / js 5
       accessibility 4 / user-experience 3 / webmcp 3 / pwa 2 / privacy 1 / wasm 1
     chrome-extensions/                     另一个技能包（MV3 浏览器扩展），122 KB
   .claude-plugin/ .codex-plugin/ .cursor-plugin/ .grok-plugin/ .github/plugin/ .agents/
   gemini-extension.json  kimi.plugin.json  plugin.json  package.json  policies/
   ```
   - 文件格式：**236 个 md、11 个 json、1 个 toml**，仓库里**没有一行可执行 JS**（CLI 的 `modern-web.mjs` 只在 npm 包里，不在本仓库）。
   - 单篇中位数 7.3 KB；最大是 `guides/accessibility/accessibility.md` 51.7 KB（≈1.6 万 token），这也是 CLI 设计「超过 9.5 KB 就落盘让 agent 自己分段读」的原因。
   - 203/209 篇带可运行代码块，71 篇有明确的 **DO / DON'T** 条款，136/209 篇嵌入了 Baseline 兼容性标注。

3. **README 自述解决什么问题**（原文要义）：AI 的训练语料里堆满旧代码，导致它「用一堆 JS 去实现现在原生一行就能做的事」，而且即便知道某个 API 存在，也缺生产级实现细节。目标是**把 agent 从旧写法掰到现代 Web 平台能力上**，并且给的回落方案要轻（<50 行自定义回落，或按需加载 polyfill），不要重型三方库。
   目标用户：**用 AI 编程 agent 写网页的开发者**（README 原话：「Regardless of what models or agent harnesses you're using, if you're building for the web…」）。

---

## B. 怎么用

4. **官方接入方式**（全部来自 README 原文）：

   | 方式 | 命令 | 说明 |
   | :--- | :--- | :--- |
   | npm 向导（主推） | `npx modern-web-guidance@latest install` | 交互式，自动识别本机装了哪些 agent 并落盘 |
   | 只想试用（不装） | `npx modern-web-guidance@latest search "animate a dialog modal backdrop"` / `retrieve "animate-to-from-top-layer"` / `legacy-scan .` | 三条命令直接出内容 |
   | Vercel skills CLI | `npx skills add GoogleChrome/modern-web-guidance` | 通用技能安装器 |
   | GitHub CLI | `gh skill install GoogleChrome/modern-web-guidance` | |
   | Claude Code | `/plugin marketplace add GoogleChrome/modern-web-guidance` → `/plugin install modern-web-guidance@googlechrome` → 在 `/plugin` 里开 AutoUpdate → `/reload-plugins` | 四步 |
   | OpenAI Codex | `codex plugin marketplace add GoogleChrome/modern-web-guidance` → `codex plugin add modern-web-guidance@googlechrome` | 两步 |
   | GitHub Copilot CLI | `/plugin marketplace add …` → `/plugin install modern-web-guidance@googlechrome` | |
   | Google Antigravity | `agy plugin install https://github.com/GoogleChrome/modern-web-guidance` | |
   | Grok Build CLI | `grok plugin install … --trust` | |
   | Kimi Code | `/plugins install https://github.com/…` | |
   | VS Code | 仓库根 `package.json` 声明 `contributes.chatSkills` + `engines.vscode ^1.90` | 以扩展/技能形式被 VS Code chat 读取 |
   | Cursor | 有 `.cursor-plugin/plugin.json`，且 Cursor 市场已上架（cursor.com/marketplace/google-chrome/modern-web-guidance） | README 未列步骤 |

5. **支持的客户端**：Claude Code、OpenAI Codex CLI、GitHub Copilot CLI、Google Antigravity、Grok Build CLI、Kimi Code、Cursor、VS Code、以及任何认 SKILL.md 的 agent（通过 `npx skills add` / `gh skill install`）。
   - **Windsurf / Zed：README 没有提，未核实。**

6. **本机 Hermes 能不能用：能，而且它是「技能」，不是 MCP——不需要配 MCP server。**
   - 事实依据：Hermes 原生读 SKILL.md 技能目录（本机 `/vol1/ai/agents/hermes/skills/` 下已有第三方软链技能，如 `nature-academic-search -> /vol1/ai/third-party/nature-skills/...`）。
   - 前置条件已满足：`node -v` = **v24.15.0**、`npx -v` = **11.12.1**（仓库要求 node ≥22），npm registry 经 7890 代理可达（我用 `npm view` 实测通了）。
   - 要配的话是这么配（**仅说明，未执行**）：
     1. 把仓库里的 `skills/modern-web-guidance/` 整个目录放进技能目录（或软链）：
        `ln -s <解包路径>/skills/modern-web-guidance /vol1/ai/agents/hermes/skills/modern-web-guidance`
     2. 确认 `~/.hermes` 所在会话能跑 `npx`（首次要网络，代理 `http://127.0.0.1:7890`）。
     3. 可选：`export DISABLE_TELEMETRY=1` 关掉谷歌的匿名埋点。
     4. 重启/刷新会话让技能列表重载。
   - 也可以「不常驻、按需用」：不入技能目录，遇到具体前端任务时我直接跑 `npx -y modern-web-guidance@latest search "..."` + `retrieve "<id>"`。这条路**零常驻 token**，只在实际用时付成本。

7. **版本与更新机制**：
   - npm 包 `modern-web-guidance`，当前 **1.0.0**（registry 显示 2026-11-10 发布/更新，解包 **16.5 MB**——离线 embedding 模型 + BM25 索引都在包里，无外部依赖、可离线跑、不发查询到外部）。
   - 更新：`npx modern-web-guidance@latest update`；用插件方式的靠市场 AutoUpdate（Claude Code 明确写了要手动开）。
   - 内容版本是**锁进 SKILL.md 的**：技能正文里的命令带 `--skill-version 2026_11_09-5bcc021b`，所以「技能文本」和「指南内容」版本对得上。
   - 仓库活跃度：创建 2026-03-23，最近推送 2026-11-10，open issues 仅 **1**，是活跃维护状态。

---

## C. 内容质量

8. **覆盖主题与抽样判断：是真干货，不是泛泛而谈。** 17 个分类、README 自称覆盖 250 个现代 Web 特性（CSS 140 / HTML+DOM 36 / JS+API 74）。抽了三篇：
   - `security/validate-origins.md`（对比同源/同站点）：直接点出四种真实翻车——前缀欺骗（`https://app.example.com.attacker.example`）、未归一化端口、公共后缀表（`.co.uk`、`.github.io`）、sandbox iframe 与 `data:` 的 `"null"` 源撞车；然后给 `Origin.from()` / `isSameOrigin()` / `isSameSite()` 的选型表和可抄代码，还解释了单测里 `new MessageEvent()` 拿不到内部源要 fallback。**这种细节只有真踩过坑的人才写得出来。**
   - `ui-components/dialog.md`：按「会不会打断用户」分三条规则（modal / `dialog popover` / 普通 popover），明确禁止 `role="dialog"`、自造焦点陷阱、`overflow:hidden` 锁滚动，并给出 `dialog:modal{overscroll-behavior:contain}` + `::backdrop{overflow:hidden}` 这一对**很冷门的必配**。属于「照抄就比大多数人写得好」的水平。
   - `performance/optimize-preload-priority.md`：讲清 preload 继承资源类型默认优先级、图片默认偏低，用 `fetchpriority` 抬/压，并提醒字体本来就是高优先级。偏短但准确。
   - 结论：**是专家编写的实操手册，不是 checklist 复读**。但要有心理准备——它写的多是「最近几年才 Baseline」的 API，个别条目针对还在试验阶段的能力（README 自述：Origin Trial 与「单引擎、发布 3 个月内的易变特性」默认被闸门挡住，要 `npx … set-allow-origin-trials` / `.mwgrc` 才解锁）。**落地前仍要自己确认目标浏览器/运行环境支不支持。**

9. **跟常见来源的差异**：

   | 来源 | 定位 | 差别 |
   | :--- | :--- | :--- |
   | **MDN / web.dev** | 给人看的权威文档 | 内容更全更权威，但不会自动进 agent 上下文，也不教「哪种做法该优先」 |
   | **Baseline（web-platform-dx）** | 兼容性数据 | 只是数据；MWG 是**建立在 Baseline 之上**的「怎么用」层，136/209 篇嵌了兼容性标注 |
   | **Vercel `web-interface-guidelines`** | 约百条检查清单 | 只**审**不改（review-only），每次要联网抓 `command.md`；MWG 有可抄代码、回落策略、还能 `legacy-scan` 改代码，且可离线 |
   | **Anthropic `frontend-design` 技能** | 审美/设计流程 | 管「好不好看、别做出模板味」，不管平台 API 与兼容性，两者互补不冲突 |

10. **可对比的同类项目（挑了两个）**：
   - **vercel-labs/agent-skills 的 `web-design-guidelines`**（+ 源规则 `vercel-labs/web-interface-guidelines`）：轻量、纯检查清单、适合当「上线前 UI 体检」。和 MWG 是「体检表 vs 施工规范」的关系。
   - **Anthropic 官方 `frontend-design` 技能**：解决「AI 做出来的界面很模板」，和 MWG 的「AI 用旧写法」正好是两件不同的病。

---

## D. 对主人的实际价值

11. **技术栈匹配度：分两块看，别一概而论。**

   **① 微信小游戏（Three.js + TypeScript，程序化低模）——基本没用。**
   - 硬事实：小游戏产物 `frontend-rebuild-hm02/dist/wechat/` 里只有 `game.js / game.json / project.config.json`，**一行 HTML/CSS 都没有**。
   - 小游戏跑在 Canvas/WebGL 上，没有 DOM、没有 CSS 布局、没有 `<dialog>`、没有表单、没有 Service Worker、没有 `<link rel=preload>`。而 MWG 的 209 篇里，CSS 布局 18 篇 + 视觉 22 篇 + UI 组件 22 篇 + UI 行为 40 篇 + 表单 19 篇 ≈ **121 篇（58%）在这个环境里无从谈起**。
   - 剩下的性能/安全条目也大多依赖浏览器 API（`fetch`、`fetchLater`、CSP、Passkeys），小游戏走的是 `wx.*` 自有接口，套不上。
   - 一句话：**它是给「浏览器里的现代 Web」写的，微信小游戏不是浏览器。这块别指望它。**

   **② NAS 上的 Web 服务（Python aiohttp / Node 后台 + 前端页面）——有真活可干。**
   - 随手查了 `nas-console/static`（index.html 5.9 KB + style.css 11.6 KB + app.js 28 KB + sw.js）：`innerHTML` 用了 **27 处**、`aria-*` 只出现 **2 次**、`<dialog>` 0 处、深色模式 0 处、PWA service worker 有但没配套的 manifest 优化。
   - 这正好落在 MWG 的强项上：`sanitize-untrusted-html` / Trusted Types（堵 innerHTML 的 XSS）、原生 `<dialog>`/`popover`（省掉手写遮罩层）、`light-dark()`/`color-scheme`（一行的深色模式）、PWA 与无障碍规范。
   - 同类的还有：fc6 百科站、账本网页、成果库/交付页、chatd、chatgpt-bridge 的界面——都是「自己写的小前端，没设计师、没严格审过」，收获空间最大。

12. **接入成本 / 维护成本 / 副作用：**
   - **成本**：安装本身 **2~5 分钟**（一条 `npx … install`，或我手工软链技能目录 1 分钟）；想让它真正生效，得再花 **半小时**把 `.mwgrc` 里的目标浏览器策略定一下（否则它默认按「Baseline 广泛可用」来决定要不要写回落代码）。
   - **维护**：几乎为零——`@latest` 每次拿最新的，指南内容由 Chrome/Edge/Firefox/MDN 维护；不用我们跟浏览器版本。
   - **副作用（三条，都是真的）**：
     1. **常驻 token**：SKILL.md 的描述约 906 字节 ≈ **280 token**，只要装了就会进每次会话的技能清单。
     2. **按需 token**：每次 `retrieve` 拉一篇，中位数 ≈ **2.3k token**，最大的 accessibility 全篇 ≈ 1.6 万 token（CLI 会落盘让我分段读，避免一次性爆）。
     3. **可能过度触发**：它的描述写得很强势（「MANDATORY: Execute FIRST for all HTML/CSS and clientside JS tasks」），容易在不相关的任务上也让我先跑一次 `search`，多花工具轮次和时间。小游戏那种前端任务尤其容易误触。
     4. **遥测**：谷歌收集匿名使用信息（安装数、调用方 agent 名、取回的 guide id、搜索词），**不收集原始提示词**；`DISABLE_TELEMETRY=1` 可关。CLI 本身离线可跑，查询不出网。

---

## E. 事实核查

### E-1「56% → 88%」这个数字

**有原始出处，但这个具体数对是拼接错的。**

- **原始出处**：仓库 README 的 `### Recent eval results snapshot` 表（带 `<!-- INJECT_EVAL_RESULTS_START -->` 自动注入标记），数据同源公开看板 `https://googlechrome.github.io/modern-web-guidance-src/`（要 Google 登录看逐 guide 明细），官方博客 `developer.chrome.com/blog/modern-web-guidance-v1`（2026-11-10，作者 Philip Walton）也写「our evals show…」并链到看板。
- **README 表里逐行原文**（我原样抄）：

  | 日期 | Agent + 模型 | 任务 / 断言 | 无引导 → 有引导（提升） |
  | :--- | :--- | :---: | :---: |
  | Nov 8 | antigravity_cli (gemini-4-argon) | 214 / 1673 | 58% → 94% (**+36pp**) |
  | Nov 8 | codex_cli (gpt-6.1-sol) | 215 / 1795 | 54% → 82% (**+28pp**) |
  | Nov 8 | claude_code (opus-5-5) | 215 / 1801 | **57% → 88%** (**+31pp**) |
  | Nov 6 | codex_cli (gpt-6.1-sol) | 212 / 1773 | 53% → 86% (**+33pp**) |
  | Nov 6 | claude_code (opus-5-5) | 212 / 1773 | **56% → 90%** (**+34pp**) |
  | Nov 6 | antigravity_cli (gemini-4-argon) | 212 / 1722 | 60% → 96% (**+36pp**) |
  | Nov 4 | codex_cli (gpt-6.1-sol) | 209 / 1743 | 52% → 85% (**+33pp**) |
  | Nov 4 | claude_code (opus-5-5) | 209 / 1743 | 57% → 90% (**+33pp**) |
  | Nov 4 | antigravity_cli (gemini-4-argon) | 207 / 1722 | 60% → 96% (**+36pp**) |
  | Nov 2 | codex_cli (gpt-6.1-sol) | 205 / 1729 | 55% → 82% (**+27pp**) |

- **判定**：**没有任何一行是「56% → 88%」。** 那个 AI 回答是**把两行拼在一起**了：11-06 的起点 56% + 11-08 的终点 88%。最接近的正确表述是：
  - 11-08 · Claude Code：**57% → 88%（+31pp）**
  - 11-06 · Claude Code：**56% → 90%（+34pp）**
- **量级是对的**：真实提升区间约 **+27 ~ +36 个百分点**，所以「加载指南后通过率明显提高」这个结论**成立**；但「56→88」这个精确数字**不存在**，属于引用串行。
- **口径要说清（重要）**：
  - 度量是 **Playwright 断言通过率**（checks passed ÷ checks run），样本 205~215 个任务、约 1,700~1,800 条断言，不是「56% 的网站变好了」。
  - 位于看板说明里的话：「任务提示词从不提 MWG，所以 agent 得自己意识到该查指南」；崩溃/超时的运行与其配对运行一起剔除。
  - 模型名（`opus-5-5` / `gpt-6.1-sol` / `gemini-4-argon`）是他们的内部代号，**无法对应到我们手上的具体模型版本**。
  - **这是项目方自评自测（自己出题、自己写评分器、自己跑）**，不是第三方独立评测。可信度：中上（评测代码和任务库开源、评分器有「金标准必须 100% 过 / 原始应用必须 0% 过」的双向校准），但**不能当成外部学术结论引用**。

### E-2 项目是 Chrome 官方团队做的吗

**是，官方背景成立，而且是跨浏览器共管。** 证据链四条：
1. 仓库在 **GoogleChrome** 组织下，许可证 Apache-2.0，文档正文 CC-BY 4.0（README「License」节明写）。
2. 官方博客 `developer.chrome.com/blog/modern-web-guidance-v1`（2026-11-10，作者 **Philip Walton**，就是 web-vitals 那套东西的作者），自述 2026 年 5 月 Google I/O 上先出预览版，本次为 1.0 稳定版。
3. README 首屏原话：「*Stewarded by the Google Chrome, Microsoft Edge, Mozilla Firefox, and MDN teams, alongside the web development community.*」——博客里也确认 **Firefox 和 Edge 已加入**。
4. Cursor 官方市场上架（`cursor.com/marketplace/google-chrome/modern-web-guidance`），npm 包 publisher 为 `GoogleChrome`。

另外，README 里写着部分文档「derived from MDN Web Docs by Mozilla Contributors」——所以它不是凭空造的，是站在 MDN + 各家规范上做的「面向 agent 的施工化改写」。

---

## 接入方式对比表

| 客户端 | 方式 | 步骤 | 难度 |
| :--- | :--- | :--- | :--- |
| **Hermes（本机）** | 技能目录软链（不依赖任何插件生态） | ① `ln -s <解包>/skills/modern-web-guidance /vol1/ai/agents/hermes/skills/` ② 确认会话能跑 `npx`（node 24.15 已 OK，首次走 7890 代理）③ 可选 `export DISABLE_TELEMETRY=1` ④ 刷新技能列表 | **低（1 分钟，但需手工，官方没给 Hermes 一键命令）** |
| Hermes（按需，不常驻） | 我临时跑 CLI | 任务来临时执行 `npx -y modern-web-guidance@latest search "..."` → `retrieve "<id>"` | **最低（零常驻 token），每次多一轮工具调用** |
| Claude Code | 插件市场 | `/plugin marketplace add GoogleChrome/modern-web-guidance` → `/plugin install modern-web-guidance@googlechrome` → `/plugin` 里开 AutoUpdate → `/reload-plugins` | 低（4 步） |
| OpenAI Codex CLI | 插件市场 | `codex plugin marketplace add GoogleChrome/modern-web-guidance` → `codex plugin add modern-web-guidance@googlechrome` | 低（2 步） |
| GitHub Copilot CLI | 插件市场 | `/plugin marketplace add …` → `/plugin install modern-web-guidance@googlechrome` | 低 |
| Google Antigravity | 插件 | `agy plugin install https://github.com/GoogleChrome/modern-web-guidance` | 低 |
| Grok Build CLI | 插件 | `grok plugin install … --trust` | 低 |
| Kimi Code | 插件 | `/plugins install https://github.com/…` | 低 |
| Cursor | 市场/`.cursor-plugin` | 市场一键装（README 未给命令） | 低（未实测） |
| VS Code | 扩展式 chatSkills | 由 `package.json` 的 `contributes.chatSkills` 提供，需 VS Code ≥1.90 | 低（未实测） |
| Vercel skills CLI | 通用安装器 | `npx skills add GoogleChrome/modern-web-guidance` | 低 |
| GitHub CLI | 通用安装器 | `gh skill install GoogleChrome/modern-web-guidance` | 低 |
| Windsurf / Zed | — | README 未提及 | **未核实** |

---

## 对微信小游戏场景的适用性判断（具体版）

**结论：不合适，别为小游戏接它。** 四条具体理由：

1. **运行环境不同**：小游戏是 Canvas/WebGL 上的 JS 运行时（产物只有 `game.js` + `game.json`），没有 DOM、没有 CSS 引擎。它整库 58% 的篇幅（CSS 布局 18 + 视觉 22 + UI 组件 22 + UI 行为 40 + 表单 19 = 121 篇）在这个环境**没有可作用的对象**。
2. **API 层不对接**：指南讲的是 `fetch` / `fetchpriority` / `link rel=preload` / CSP / Trusted Types / Passkeys / View Transitions / `showModal()`；小游戏对应的是 `wx.request` / 自绘 UI / 微信自有登录。**同名能力，不同实现，套不上。**
3. **Three.js + 程序化低模的真正瓶颈不在 Web 规范**：是顶点数/绘制调用/内存、纹理压缩（ASTC/ETC2）、`wx` 生命周期与包体限制。这些 MWG 一篇都不讲（wasm 1 篇、performance 26 篇全是页面性能：LCP/INP/CLS/任务调度）。
4. **反而有负面风险**：它的 SKILL.md 描述带「MANDATORY: HTML/CSS/客户端 JS 任务必须先跑搜索」的强指令，小游戏任务很容易被它误伤——多做一轮 `npx search`、拉回一堆用不上的 DOM 规范，白烧时间和 token。

**它真正能帮到主人的地方是另一块**：NAS 上那几个自己写的小前端（nas-console 的 `innerHTML` 27 处 / 无 dialog / 无深色模式、fc6 百科站、账本页、成果库页）。那里无障碍、安全清洗、原生弹窗、PWA 的改进空间是实打实的。

---

## 未核实项（单独列，别当成已知）

1. **`npx modern-web-guidance@latest install` 向导具体往哪些路径写文件**——我没跑（禁止安装），只从 README 与技能文本推断。
2. **CLI 实跑延迟**：`search` / `retrieve` 单次耗时、离线模式是否真的一次网络都不发——未实测（跑一次就会往 npm 缓存落包，算安装）。
3. **评测逐条原始数据**：看板背后的 Google Cloud Storage 桶 `guidance-evals` 匿名不可列举（401），我只拿到看板汇总与 README 表，**逐条 run 未取到**。
4. **`Origin.from()` / `isSameOrigin()` 这类 API 目前的实际浏览器支持度**——指南里写得像已成型，我没查 Baseline 状态；属「落地前必须自查」的条目。
5. **Windsurf / Zed / JetBrains 支持**：README 未提。
6. **star 数**：我经代理拉到的是 **9,864 star / 338 fork / open issues 1 / Apache-2.0 / 创建 2026-03-23 / 最近推送 2026-11-10**（与你给的 9,863 差 1，属实时波动，正常）。
7. **`chrome-extensions` 包（MV3 扩展开发）质量**：只看了目录与体量（122 KB），没抽读。

---

## 建议：接 / 不接 / 只挑一部分用

**建议「只挑一部分用」，而且不是现在装技能，而是「按需调用」。**

1. **微信小游戏：不接。** 明确无收益，还有误触发拖慢的风险。
2. **NAS Web 前端：接，但用最轻的方式**——不常驻技能，改成我在改那些页面（nas-console / fc6 百科站 / 账本页 / 交付页）时，按需 `npx -y modern-web-guidance@latest search/retrieve` 取对应几篇。好处：零常驻 token、不误触小游戏任务、只在前端活儿上花钱；坏处：得我记得用（可以写成一行规则挂在技能或备忘里）。
3. **将来若要常驻**（比如要长期维护那批网页），再软链进技能目录，并顺手做两件事：`export DISABLE_TELEMETRY=1`、项目根写 `.mwgrc` 把目标浏览器钉死（别让它默认按 Baseline 广泛可用去写回落代码）。
4. **那个「56% → 88%」的来源 AI 回答**：结论方向没错（真实提升 +27~36pp），**但数字引用是错的**（拼接了两行），以后看到具体百分比要留个心眼。
5. **`chrome-extensions` 那个包**：主人不写浏览器扩展，现在用不上，装了纯占位。

---

### 附：本次实测用的命令（可复现）

```bash
export https_proxy=http://127.0.0.1:7890 http_proxy=http://127.0.0.1:7890
curl -s https://api.github.com/repos/GoogleChrome/modern-web-guidance          # star/fork/license/时间
curl -sL -o mwg.tar.gz https://codeload.github.com/GoogleChrome/modern-web-guidance/tar.gz/refs/heads/main
npm view modern-web-guidance version dist-tags time.modified dist.unpackedSize --registry=https://registry.npmjs.org
curl -s https://raw.githubusercontent.com/GoogleChrome/modern-web-guidance-src/main/README.md
curl -s https://developer.chrome.com/blog/modern-web-guidance-v1               # 官方 1.0 公告（作者 Philip Walton）
curl -s https://googlechrome.github.io/modern-web-guidance-src/                # 评测看板
```
