跳到主要內容

Modern Web Guidance 是什麼?AI 改版網站後怎麼驗收 SEO

Modern Web Guidance 管的是前端程式碼寫法與瀏覽器相容性;內容、檢索與索引另由 Google 搜尋中心的規則決定。附職責對照表、安裝指令與改版後的 SEO 驗收清單。

Modern Web Guidance 是什麼?AI 改版網站後怎麼驗收 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。

Chrome 官方 Modern Web Guidance Get started 文件的重要提醒,說明沒有設定 Baseline 目標時預設採 Baseline Widely available
圖 6:官方文件寫明未設定目標時,預設採 Baseline Widely available(來源:developer.chrome.com,2026-11-17 截圖)

它真正的作用,是把「資深前端會怎麼寫」提前塞給代理。前沿模型通常能生出可以跑的程式碼,但請一個懂網頁的人來看,幾乎總能找到讓它更快、更容易操作或更安全的地方,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 管什麼?:分工很單純:Modern Web Guidance 管前端程式碼怎麼寫、能不能在目標瀏覽器跑
圖 1:現代 HTML、CSS 與 Web API 的…|Baseline 相容目標|結構化資料要與使用者看得到的內容一致
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 版多了什麼,跟 5 月的預覽版差在哪?:2026 年 11 月 10 日發布的 1.0 是穩定版
圖 4:會掃描既有程式碼的翻新流程|擴充數百個專家審核跨瀏覽器解法的指南庫|涵蓋所有指南的公開評估資訊主頁

新增的四項

最核心的是會掃描既有程式碼的翻新流程,代理會主動挑出專案裡能安全現代化的地方,不再只是被動答題;指南庫也擴充了數百個經專家審核的跨瀏覽器解法。每份指南另有更深的人工審核,包含領域技術主管簽核,使用者指南還多一道無障礙審查。最後是涵蓋所有指南的公開評估資訊主頁,可以直接看到有裝與沒裝的代理差多少。

變成跨瀏覽器計畫

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)數」和用「發現項目」去數,會得到完全不同的印象。

Chrome 官方 MetaMask 案例頁的發現統計表,列出 Modern Web Guidance 審查機器人提出的 102 項發現與修正、部分修正、未處理數量
圖 5:案例頁表格把功能與修正 PR 上的 102 項發現拆成修正 54、部分修正 3、未處理 24 等類別(來源:developer.chrome.com,2026-11-17 截圖)
官方公布的成效數字,口徑差在哪?:引用這類數字前,先看那份文件怎麼數
圖 3:案例頁:全部被提出 122 項|公告:前五週審查約 480 個 PR|43 與 54 各自統計,不能互相換算

通過率與 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 搜尋中心的文件。代理動過的頁面,每一處都要有對應的檢查結果,勾完才算改版完成。

代理改完之後,SEO 要驗哪些項目?:照清單勾,一項一項對回 Google 搜尋中心的文件
圖 2:頁面還查得到(測試實際網址)|索引狀態沒變(canonical|Core Web Vitals 沒退步(LCP

頁面還查得到。用 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 相容性資料,會依支援目標給建議。客群還大量停在舊瀏覽器時,這些建議就不適合直接套用。

分享這篇文章 X Facebook LINE
合作下一步

想把這篇內容放回自己的網站?

留下 Email,我會寄出合作方式與價格範圍;看完工作範圍與適用條件後,再決定是否回覆。

我會寄出這次索取的資料;由 AK 親自回覆,可隨時退訂。

十年 SEO 實戰 · Threads 公開研究 · 隱私權政策

你可能也會想看

← 回到研究文章