WeTV 如何使用代理專用 Chrome 開發人員工具和 Modern Web Guidance,將效能偵錯時間縮短 87%

Junhey
Junhey Software Engineer, WeTV (Tencent)
Stephani Kurniawan
Stephani Kurniawan
Cecilia Cong
Cecilia Cong

發布日期:2026 年 11 月 10 日

WeTV 是騰訊的國際影片串流平台,為東南亞和其他全球市場的觀眾提供戲劇、動畫和綜藝節目。對於以影片為主的網站,效能決定了觀眾是否會留下來、搜尋引擎是否會顯示內容,以及播放是否流暢。

WeTV 網頁工程團隊不會發布未達效能目標的程式碼。長期以來,為了維持這條線,開發人員必須在每次建構失敗時,停止手邊的工作,開啟 Chrome,然後手動剖析網頁。追蹤並修正一個迴歸問題大約需要四小時。

現在,AI 程式設計代理會在 CI/CD 管道中執行這項工作。透過代理專用 Chrome 開發人員工具,代理會在實際運作的瀏覽器中檢查頁面。在 Modern Web Guidance 的協助下,代理會根據目前的網路平台標準編寫修正程式。現在,工作流程會自動診斷並解決 90% 的失敗效能測試,從檢查失敗到驗證修正的時間也從四小時縮短到 30 分鐘,包括完整建構和手動評估。

挑戰:開發人員在編輯器和瀏覽器之間來回切換

WeTV 工程師已在 IDE 中使用 AI 程式設計工具。這些工具可以編寫程式碼,但無法查看程式碼在瀏覽器中執行後的結果。因此,工作分為兩部分。工程師在編輯器中編寫程式碼,然後切換至 Chrome 部署、檢查及驗證程式碼。每次修正都必須手動重複這個循環。

在發布階段,拆分作業造成的影響最大。WeTV 的 CI/CD 管道會對每個版本執行效能追蹤,並將 Cumulative Layout Shift (CLS) 保持在 0.1 以下。當建構作業超過該行時,管道會標記該作業,但仍需手動找出原因。工程師必須開啟 Chrome 開發人員工具、記錄追蹤記錄、找出移動的元素、將結果帶回編輯器、編寫修正程式,然後再次執行檢查。單一 CLS 迴歸大約需要四小時的工程時間。

原始工作流程的流程圖。在 IDE 中使用 AI 程式設計代理編寫的程式碼會進入手動驗證階段,開發人員會在瀏覽器中開啟頁面,並記錄效能追蹤。如果效能未達門檻,工作就會回到 IDE。如果符合,系統就會釋出代碼。
原始工作流程:開發人員在每次發布前手動驗證效能。

團隊需要一個能同時處理這兩項工作的代理:查看執行中的網頁,然後根據已知標準修正程式碼。

解決方案:將代理連結至瀏覽器和網路標準

WeTV 將效能驗證納入合併要求 (MR) 流程。開發人員開啟 MR 時,CI/CD 管道會啟動環境,讓 AI 程式設計代理在本機執行,並提供團隊 IDE 工具所缺乏的兩項功能:

  • 代理專用 Chrome 開發人員工具:執行 Model Context Protocol (MCP) 伺服器,並將代理連至實際運作的 Chrome 執行個體。代理程式可以記錄效能追蹤記錄 (以及其他 Chrome 開發人員工具功能),並檢查前端程式碼的實際算繪方式,就像開發人員在開發人員工具中操作一樣。
  • Modern Web Guidance:這項代理技能包含網頁平台最佳做法和瀏覽器相容性資料。它會引導代理程式遠離舊版模式,並採用以現代網路平台功能建構的修正程式。

代理專用開發人員工具會告訴代理哪裡出錯,Modern Web Guidance 會決定修正方式。

實際範例:單集播放頁面的版面配置位移

在一次合併要求中,代理在電腦版集數播放頁面上執行 performance_start_trace 工具。追蹤記錄顯示 CLS 為 0.39,幾乎是 0.1 限制的四倍。

要求代理先診斷再編輯

WeTV 不允許代理即興發揮。驅動工作流程的提示會指示代理在接觸任何程式碼之前先診斷問題,並根據 Modern Web Guidance 檢查發現結果,而不是依賴模型預設生成的任何內容。

以下是 WeTV 團隊使用的提示範例:

Context:
"The CLS (Cumulative Layout Shift) of this page needs inspection. Diagnose
first, then modify the code, do not guess."

Mandatory Execution Steps:

1. Performance Trace: Use Chrome DevTools for agents to run performance traces
   on both Desktop and Mobile views.

2. Identify Culprits: Use CLSCulprits insight to pinpoint the exact DOM elements
   causing shifts (capture class/id, timing, and score).

3. Use web best practices for performance and CSS to optimize CLS.

4. Multi-Agent Parallelism: Enable parallel agents for efficiency:
   - Agent A: Investigate Player/Main Layout SSR placeholders.
   - Agent B: Investigate Sidebar Ads, VIP buttons, Tabs, and late-injected
     lists.
   - Agent C: Investigate Fonts and other minor factors.
   Constraint: Each agent modifies only files within its scope to prevent
   conflicts.

5. Root Cause Confirmation: Confirm the root cause before applying fixes.
   Prioritize reserving space over changing interaction semantics just to fix
   CLS.

6. Verification: After modification, re-test CLS via equivalent CSS injection
   or local build. Target: CLS < 0.1.

這則提示有兩個部分最重要。「先診斷,再修改程式碼」可避免代理只修補症狀。步驟 2 會指示代理程式搭配 insightName: 'CLSCulprits' 使用 performance_analyze_insight,以便回報確切的元素、時間和分數,而非一般可疑項目。

在下方影片中,執行提示詞後,代理會搜尋 Modern Web Guidance 中的相關指南,使用與 CLS 相關的新型網路功能實作修正,並使用代理專用 Chrome 開發人員工具開啟 Chrome 瀏覽器執行個體,並記錄效能追蹤。

影片:代理式效能偵錯工作流程。

結合執行階段診斷和結構化指引,可自動修正複雜的版面配置位移。以下是自動化工作流程修正問題的範例。

找出根本原因

追蹤結果指向影片播放器。WeTV 在伺服器上算繪播放器,但播放器的容器並未預留任何高度。用戶端補充網頁內容時,容器高度會擴大,周圍內容也會隨之移動。

套用標準修正

修正方法是在伺服器端算繪期間預留空間,讓容器在凍結前就具有正確的高度。以下是代理依據 Modern Web Guidance css-layout 指南編寫的修正範例:

.play__block--player .play__aside--left {
  inline-size: 100%;
  block-size: auto;
  aspect-ratio: 16/9;
}

代理套用 CSS 後,管道會重新建構頁面,代理則會再次執行相同的追蹤。只有在 CLS 低於 0.1 時,修補程式才會進入人工審查階段。

影響:更快發布版本,版面配置更穩定

WeTV 在 CI/CD 工作流程中加入代理專用 Chrome 開發人員工具和 Modern Web Guidance 後,工程效率和版面配置穩定性都有顯著提升:

  • 端對端偵錯和解決時間縮短 87% (從 4 小時縮短至 30 分鐘)。
  • 90% 的週期性效能迴歸問題會自動診斷並解決。

工程師不必再花半個工作天進行剖析。當建構作業超過門檻時,代理會讀取追蹤記錄、編寫修正程式、進行測試,並將經過驗證的修補程式交給人工審查員。雖然最終決定權仍在人類手中,但他們可以從已通過失敗檢查的修正開始。

由於 CLS 迴歸問題會在合併要求中修正,因此不會進入正式環境。這樣一來,網頁就能維持在 0.1 的目標值以下,保護 WeTV 的搜尋能見度,並移除在週期後期封鎖發布的常見原因。

團隊課程

WeTV 的設定是針對其堆疊,但其背後的模式適用於大多數根據效能限制發布的團隊:

  • 在發生失敗的位置執行代理程式。WeTV 會透過合併要求觸發代理,因此不必有人注意到檢查失敗,並手動啟動工作階段。
  • 讓代理在編輯前先診斷。先要求追蹤記錄和具體原因,就能針對實際元素進行修正,而非憑空猜測。
  • 將執行階段資料與標準配對。追蹤記錄會告訴代理哪個元素移動了。Modern Web Guidance 會指出哪項修正符合目前的平台做法。
  • 要求提供證明。重新執行失敗的追蹤記錄,是服務專員證明修正有效的依據。P2ER 在強制性經驗驗證規則中也遵循相同原則。
  • 落實人工介入迴路。代理會進行調查,工程師則會審查已通過檢查的修補程式。

意見回饋和未來計畫

WeTV 發現,將代理專用 Chrome 開發人員工具的即時執行階段遙測資料,與 Modern Web Guidance 的標準化規則搭配使用,可將手動效能分析從發布程序中移除,同時確保代理的程式碼變更符合目前的網路平台標準。

「無論是速度還是品質,結果都非常有效。代理專用 Chrome 開發人員工具和 Modern Web Guidance 提供的診斷洞察,為我們修正複雜的版面配置問題提供了可靠的參考依據。每次修正後,我們都會進行嚴格驗證,目前的成功率和穩定性大幅提升了我們對發布版本的信心。」

— WeTV (騰訊) 工程主管鄭陽傑

接下來,WeTV 工程團隊計劃在即將推出的程式碼版本中,將代理專用 Chrome 開發人員工具和 Modern Web Guidance 導入端對端測試。

資源

如要設定類似的工作流程,請參閱下列資源: