工程 · 2026.10.10 · 3 min
全站換一套視覺:AI 評分當不了門檻,先換 token 再重排
EZLO 從深色圓角卡片換成紙色底、方角墨線的工程藍圖風格。AI 評審的分數只適合當回歸清單,落地時先換 token 的值,一支 PR 就換掉九成畫面。
閱讀設定
2026 年 9 月,我把 EZLO 的官網、儀表板、後台和 email 一起換成一套工程藍圖風格的視覺。過程裡學到兩件事。AI 評審的分數不能拿來當「到幾分才能過」的門檻,它每一輪列出的問題拿來當回歸清單才有用。落地時第一支 PR 只換 token 的值,不動 class 和變數名,54 個檔案一行都不用改,九成畫面就換了皮。
原本的視覺是深藍灰底加圓角卡片,我一直覺得它很平庸。只換落地頁的話,app、後台和 email 還是舊識別,會跟首頁脫節,所以範圍是全站。
AI 評分當不了門檻
我沒有直接改程式,先在 Claude 的 Design 畫布上探索風格。第一輪四種方向收斂成兩個,各做第二版,再用 codex 拿固定的提示詞逐輪評分,最後定案工程藍圖這個方向(D2),把全站 96 張畫板畫完。
D2 評了七輪,分數一直卡在 6.2 到 6.4。為了校準,我拿同一個提示詞去評 Stripe 和 Linear 的網站,分別是 7.8 和 7.2,這個評審給知名產品的分數也就七分多。

更麻煩的是,評審每一輪指出的頭號問題會互相矛盾。上一輪說權限核對圖太小,放大之後下一輪嫌它搶戲。分數不會因為大改而明顯變動,當門檻沒有意義;但每一輪列出的問題,照著一條一條修很有用。
先換 token,再逐區重排
D2 的規則寫得很死,每個顏色都有用途:紙色底、墨色字,鈷藍給連結和品牌,萊姆只給主要動作而且一頁最多一顆,琥珀只給資金流和極值。形狀全部方角,1px 墨線,硬邊位移陰影。驗收條件裡另外有兩條可及性規則:亮暗兩版每個文字 token 的對比要 ≥ 4.5:1,prefers-reduced-motion 下不能有 transform 動畫。
落地的第一支 PR 只換 token 的值和字型,不動 .ez-* 的 class 和變數名。九成畫面直接換了皮,之後的 PR 只需要處理重排:首頁、登入與 onboarding、儀表板外框、公開頁共用版型,最後是儀表板分頁、後台和 email。

重排是平行做的。主 checkout 加兩個 worktree,各自跑一個 next dev,一支 PR 交給一個 Claude Code agent,共同規則寫在一份 brief 裡,畫板截圖當設計來源。衝突只出在 globals.css 的檔尾和幾份文件。後來規定新的 CSS 插在各自區塊的尾巴,不要插在檔尾,衝突就少了大半。
Review 抓到的事
每支 PR 都讓 codex review 一次,另外用真瀏覽器登入我自己的 STG 帳號做 QA。兩邊的發現合成一支修正 PR,例如通知抽屜沒有 focus trap、背景 shader 離開視窗後沒有停掉 rAF、同一頁出現兩顆萊姆按鈕。
其中一條是我自己算錯的。文件裡寫 --fg-dim 的對比是 4.6:1,codex 實際算出來是 3.81:1。之後對比一律真的算,不憑感覺填。

另一條規則是不做假按鈕。畫板上有些功能後端其實沒有,例如「保持登入 30 天」或後台的角色邀請分頁,一律不做成假按鈕。權限清單也一樣,畫板上畫的權限項目跟 onboarding 實際要求的不完全一樣,以 onboarding 為準。
這條規則後來還是漏了一句。儀表板改版時,設定頁的 2FA 提示寫了後端沒有做的保護,兩天後才修掉,這件事我在帳號安全那篇另外寫。
小結
- 換全站視覺,先只換 token 的值、不動 class 名,一支 PR 就能換掉大部分畫面,後面的 PR 只處理重排。
- AI 評審的分數不適合當門檻,它列的問題適合當回歸清單。評分前先拿知名網站校準。
- 平行開 agent 做的時候,共用檔案的寫入位置要先規定好。
- 畫板上有、後端沒有的功能,不做假按鈕。
- 對比要算,不要估。

工程
一個數字輸入框能出幾種錯:清空變成 0、按 e 會清空
放貸設定頁的保留額清空後會靜靜存成 0,這篇整理修這張表單時遇到的數字輸入框問題,包括草稿存字串、上下限分開擋、type=number 的 e 鍵,以及 jsdom 測不到的逐字輸入。
留言
載入留言中…