Modern Web Guidance 是什麼?AI 改版網站後怎麼驗收 SEO
Modern Web Guidance 管的是前端程式碼寫法與瀏覽器相容性;內容、檢索與索引另由 Google 搜尋中心的規則決定。附職責對照表、安裝指令與改版後的 SEO 驗收清單。
禮拜五下午,工程師在群組丟一句「我用 AI 把首頁那一段重寫過了,看起來順很多」,你點開網站,畫面確實變快了,心裡想的卻是另一件事:這樣改,搜尋還認得這個頁面嗎?Modern Web Guidance 是一組安裝進 AI 編碼代理的技能包,把網頁平台的專業知識、最佳做法與瀏覽器相容性資料直接放進代理的工作脈絡,讓代理寫 HTML、CSS 與 Web API 時有現成的現代寫法可依,不必回頭翻訓練資料裡的舊慣例。它管的是前端程式碼怎麼寫,不管你的內容、檢索與索引。所以改完之後,SEO 要驗的是五件事:頁面還查得到、索引狀態沒變、結構化資料仍對得上內容、Core Web Vitals 沒退步、手機版內容與互動正常。
這些改動通常落在很底層的地方:一段收合問答、一張圖片的載入順序、一個表單的驗證時機。在程式碼層面它們是加分,但同一個改動也可能動到會被爬取與索引的東西,驗收因此不能省。
Modern Web Guidance 是什麼?
它是一包給 AI 編碼代理的網頁開發知識,不是裝在網站上的掃描外掛,也不是搜尋分析工具。2026 年 5 月的 Google I/O 先以預覽版登場,同年 11 月進入 1.0。

它真正的作用,是把「資深前端會怎麼寫」提前塞給代理。前沿模型通常能生出可以跑的程式碼,但請一個懂網頁的人來看,幾乎總能找到讓它更快、更容易操作或更安全的地方,Modern Web Guidance 就是把這些地方整理成代理讀得懂的技能。
代理預設會漏掉哪四類事
Chrome 的官方評估指出,前沿模型仍有四類重點常失手。這四類各有常漏的地方:無障礙是鍵盤焦點與 inert 管理、減少動態效果的支援、表單驗證;使用者體驗是滑動與觸控手勢、對話框與彈出式視窗轉場、明暗主題;效能卡在主執行緒工作排程、螢幕外算繪隔離與版面位移預防;安全則是 HTML 清理、嚴格的內容安全政策與 passkey 憑證管理。官方特別點名無障礙,因為寫壞的 ARIA 會讓頁面比完全不用 ARIA 更難操作。
它也會把代理推向「用對的功能」。同樣一個彈出選單,用 JavaScript 手刻可以動,用瀏覽器原生的 HTML 與 CSS 寫通常程式碼更少、效能更好,還自帶無障礙行為。原生寫法也不是每次都該取代團隊現有的元件:note inc. 的做法是在代理的指示裡寫明優先使用既有元件,指南只透過元件支援的屬性與參數套用。指南內嵌了 Baseline 與瀏覽器相容性資料,會照你的支援需求推薦功能;Baseline 目標由你自己選,並寫進專案的 AGENTS.md 或 CLAUDE.md,所以團隊最好把支援目標寫明。
不少開發人員把它當學習資源用:直接讀指南,或用 CLI 搜尋用途,看看專案還缺哪些現代技術。對非工程背景的人來說,這至少讓你聽得懂代理為什麼要改那一行。
任何支援技能的程式碼代理都能裝,只要團隊是在做網頁,就不必先換掉現有的工具鏈。
Modern Web Guidance 管什麼、Google Search Central 管什麼?
分工很單純:Modern Web Guidance 管前端程式碼怎麼寫、能不能在目標瀏覽器跑;Google Search Central 管內容、檢索與索引的規則。改版後你要做的,是拿代理動過的每一處,回頭對搜尋中心的文件逐項驗收。

| Modern Web Guidance 管什麼 | Google Search Central 管什麼 | 改版後要檢查什麼 |
|---|---|---|
| 現代 HTML、CSS 與 Web API 的寫法,以及該用原生功能還是自訂 JavaScript | 內容品質,以及哪些頁面該被檢索 | 用 Search Console 網址檢查抓一次頁面,確認渲染後的主要內容還在 |
| Baseline 相容目標,依專案的瀏覽器支援範圍給建議 | 檢索與索引規則:robots、canonical、noindex 這幾處設定 | 對照 Search Console 的索引狀態與 canonical,是否與改版前一致 |
| 舊碼掃描與翻新,找出可以安全升級的舊版模式 | 結構化資料要與使用者看得到的內容一致 | 重跑結構化資料測試,確認標記對得上改過的文案 |
| 無障礙、效能與安全的前端實作細節 | Core Web Vitals 的門檻與報表 | 對照 CWV 報表,確認沒有新出現的 LCP、INP 或 CLS 問題 |
| 不負責內容、檢索與索引 | 不負責你的 CSS 寫法與框架選擇 | 手機版內容與互動再走一次,含收合元素與表單 |
表上兩邊沒有誰補誰的關係。代理把彈出選單換成原生寫法,不會讓這個頁面自動被索引;你把 title 與描述改好,也不會讓收合問答在鍵盤上可用。左邊做完,右邊才算開始。
實務上會出問題的,多半是兩邊交界的少數幾處:JavaScript 渲染的內容有沒有留在 HTML、改寫文案後結構化資料還對不對得上、換掉某個元件後手機版互動有沒有壞。
分工定好之後,你有兩條路:自己照表逐項勾,或把搜尋層那一欄交給 AK SEO Labs 的顧問服務接手盤點與驗收。
1.0 版多了什麼,跟 5 月的預覽版差在哪?
2026 年 11 月 10 日發布的 1.0 是穩定版。1.0 的四項主要更新如下,已裝舊版的人要更新才拿得到。

新增的四項
最核心的是會掃描既有程式碼的翻新流程,代理會主動挑出專案裡能安全現代化的地方,不再只是被動答題;指南庫也擴充了數百個經專家審核的跨瀏覽器解法。每份指南另有更深的人工審核,包含領域技術主管簽核,使用者指南還多一道無障礙審查。最後是涵蓋所有指南的公開評估資訊主頁,可以直接看到有裝與沒裝的代理差多少。
變成跨瀏覽器計畫
1.0 同時把專案推向跨瀏覽器:Firefox 與 Edge 加入 Chrome,一起支援、改善跨瀏覽器相容性並貢獻內容,整個計畫建構在 Baseline 之上。對非 Chrome 體系的團隊來說,這代表它的建議可以當成跨瀏覽器的參考,而不是只在單一瀏覽器成立的寫法。
怎麼安裝,怎麼叫代理開始翻新?
安裝與更新
在專案目錄執行 npx modern-web-guidance@latest install;已經裝過舊版的,用 npx modern-web-guidance@latest update 更新到最新版。這件事不用改你的部署流程,裝的是代理讀的技能檔,不是網站上的程式。
叫代理開始翻新
要翻新既有程式碼,必須是 1.0 以上版本,然後在提示裡指名範圍並要求檢查舊版模式。例如請代理掃描前端檔案裡的舊版模式、驗證找到的項目,並在動任何程式碼之前先提出翻新計畫;也可以只指定某個資料夾,例如表單元件所在的位置。只講一個元件名稱時,代理會改跑一般的指南查詢,不會啟動掃描。
掃描本身不呼叫 LLM。它用抽象語法樹、DOM 與 CSS 剖析器,在本機讀 HTML、CSS、JavaScript 或 TypeScript、特定框架元件與 package.json,所以掃描這一步不會吃掉你的模型額度;後續讓代理驗證、規劃與改碼,仍會用到模型。第一版涵蓋範圍刻意壓小,只掃約 200 個指南裡的兩成左右,留下的是在沒見過的程式碼上仍能維持精確度的規則。
官方公布的成效數字,口徑差在哪?
引用這類數字前,先看那份文件怎麼數。同一批發現,用「留言過的 pull request(PR)數」和用「發現項目」去數,會得到完全不同的印象。


通過率與 LCP 優先序
note inc. 的數字條件寫得清楚:在正式版程式碼集跑 180 次評估,其中 Agent A 在明確要求使用指南的條件下,新式網頁檢查的通過率從 61% 提高到 94%;另外在 431 個合併 PR 中,LCP 圖片優先序的採用率提高了 28%。這裡量的是檢查通過率與圖片優先序,不是流量或排名。
同一家公司,兩份文件兩種數法
MetaMask 就得分兩份文件看。1.0 公告寫的是前五週審查約 480 個 pull request(PR)、對其中 64 個留言、工程師修正 43 項發現、從留言到修正的中位數是 15 分鐘。MetaMask 案例頁的表格則把功能與修正 PR 上的 102 項發現拆成修正 54、部分修正 3、遭拒或偽陽性 16、未處理 24、不明 5。
兩份一起看,43 與 54 其實都在講「修好的」項目,只是各自的統計不同,不能互相換算;被提出來的全部是 122 項,其中 102 項落在功能與修正的 PR 上。對內簡報或提案引用時,把分母一起寫出來,讀的人才判斷得出這套工具在你的團隊會產生多少雜訊。
代理改完之後,SEO 要驗哪些項目?
照清單勾,一項一項對回 Google 搜尋中心的文件。代理動過的頁面,每一處都要有對應的檢查結果,勾完才算改版完成。

頁面還查得到。用 Search Console 網址檢查的「測試實際網址」(Test live URL)抓一次,確認渲染後的主要內容還在。這只能證明當下抓得到,不代表 Google 已選用這個網址或已收錄。收合問答這類改動最容易在這裡出問題:答案如果被條件渲染移出 DOM,頁內搜尋和輔助技術都找不到它。
索引狀態沒變。canonical、meta robots、sitemap 這幾處有沒有被順手改掉,對照 Search Console 的索引狀態與改版前是否一致。
結構化資料仍對得上內容。改文案時把問答的答案刪掉一半,標記還留著就對不上,上線前重跑一次結構化資料測試。
Core Web Vitals 沒退步。LCP、INP、CLS 對照改版前的報表看。Search Console 的報表看的是過去 28 天的真實使用者資料,上線當天看不出結果,所以上線前先用相同裝置與網路條件測一次。翻新流程常把 JavaScript 換成原生 CSS 或 HTML,這一欄可能變好,也可能出現細微退步,仍要看實際報表,而不是看程式碼的長相。
手機版內容與互動正常。收合元素、表單驗證、彈出視窗這幾種改動,在手機上各走一次,包含用鍵盤操作。
索引或效能這一欄出現你判斷不了的變化時,可以參考技術 SEO 服務的流程與交付物,看這類檢查通常怎麼拆解。
FAQ
Modern Web Guidance 要付費嗎?
免費;程式碼採 Apache-2.0,指南內容採 CC BY 4.0。套件裝好後,CLI 搜尋在本機執行、不需要 API 金鑰,代理本身用掉的模型與 token 費用另計。
它會在我的 PR 上留言,甚至擋下合併嗎?
裝了不會自動留言。MetaMask 是自己設了審查機器人,它只在有可執行項目時留言,不阻擋合併,作者自己決定要不要採納。它的定位是建議審查,工程師之所以還是會讀留言,是因為沒有問題時它會保持安靜。
收合起來的問答內容,用了它之後還找得到嗎?
用原生 details 與 summary 元素,或 hidden="until-found" 的寫法,答案會留在 DOM 裡,瀏覽器的頁內搜尋找得到;輔助技術在收合狀態下讀不讀得到,要自己實測。MetaMask 那個用 React 狀態條件渲染的問答就是被這樣點出來,作者在 13 分鐘後改成原生元素。
可以放進 CI 自動跑嗎?
官方的 CI/CD 整合還在開發中。現階段可以先請代理用自然語言啟動掃描、看完計畫再決定改哪些;MetaMask 則是自己用 Cursor Automation 接了一支 PR 審查機器人。
除了命令列,還能從哪裡安裝?
多數熱門代理的外掛市集都能裝,包括 Claude Code、Codex、Cursor、Antigravity、Copilot、WebStorm、Kimi Code 與 Grok Build。先確認你的代理在清單裡,再決定要不要另外跑 CLI。
代理只用現代語法,會不會讓舊瀏覽器的使用者看不到?
要看專案設定的支援範圍。指南內嵌了 Baseline 相容性資料,會依支援目標給建議。客群還大量停在舊瀏覽器時,這些建議就不適合直接套用。
想把這篇內容放回自己的網站?
留下 Email,我會寄出合作方式與價格範圍;看完工作範圍與適用條件後,再決定是否回覆。
十年 SEO 實戰 · Threads 公開研究 · 隱私權政策