一次真實的查詢:哪些頁面是彈窗
從一句話,到一個可以貼回 Figma 的答案。中間每一次工具呼叫、每一組數字,都是實際跑出來的。
1 · 任務
先確認一件事:「彈窗」是指版面上有遮罩層,還是設計師分類為 dialog?前者可以從資料算出來,後者需要標註。
同時我不會一頁一頁猜 ID。先看看工具有沒有「列舉」能力。
Enumerate screens with their layout archetype and count them by archetype. Default unique:true keeps one row per (structure hash + headline), so 512 duplicated screens collapse to 291.
專案規範也寫了同一件事:「有多少」一律先 list_screens,不要自己遍歷資料庫。
2 · 選工具
任務問的是「哪些、多少」,這是列舉問題,不是「這一頁長什麼樣」。
| 如果選錯 | 後果 |
|---|---|
screen_sheet | 一次只回一頁,要先知道 ID;拿它回答「有多少」只能靠猜 |
| 直接查資料庫 | 把版面判斷搬進模型,結果不可重跑 |
所以選 list_screens:它一次回全部,而且數字是 server 算的。
3 · 第一次查詢
total 291 page 172 overlay-panel 87 overlay 32
回傳裡還有一筆明細,長這樣:
{ "id": "1:102753", "name": "Dialog-page", "page": "Withdraw",
"archetype": "overlay-panel", "nodes": 51,
"family": "d4319d6dc784" }
4 · 解讀
三個數字放在一起,答案的形狀就出來了:
291 是「不同畫面」的數量(結構 + 標題去重),不是節點數,也不是原始畫面總數(512 張含複本)。
如果你說的是「設計師分類為 dialog」,目前只有 42 個畫面有標註,其餘無法判定——我不會用結構答案冒充語意答案。
5 · 追問
1:102753 算彈窗?它裡面有文字啊。
有文字,但文字在面板那一層,不在遮罩。判斷的是遮罩層。
它在資料庫裡的三個直接子節點:
| child_index | 型別 | 名稱 | 尺寸 | 子樹文字節點 |
|---|---|---|---|---|
| 0 | SLOT | page-slot | 390 × 844 | 0 |
| 1 | INSTANCE | mask | 390 × 844 | 0 |
| 2 | SLOT | Dialog-Slot | 280 × 276 | 7 |
三個同時成立 → overlay-panel。
為什麼要檢查文字?如果一個整頁大小的圖層上面浮著小元件(例如 Toast),沒有這條檢查就會被誤判成彈窗。遮罩是純色/半透明矩形,不該有文字。
對照:1:102743(Withdraw 頁)的子節點是狀態列 47、導覽列 44、內容 492、Home indicator 34、Toast 96——沒有任何一個是 844,所以是 page。
6 · 家族
要確認「這頁有幾個複本」,再查一次:
hash d4319d6dc784
members 1:103166, 1:102908, 1:102765, 1:102761 …
每個都是 51 個節點、Dialog-page
這就是「相似」在離散資料上的樣子:不是像素接近,是同一組結構關係。同一個彈窗被複製 20 次,在資料裡就是同一個 hash 出現 20 次。
hash 的算法是 md5(型別 + 依序的子節點 hash),子樹被壓成 32 字元。所以比對結構不必比 16 萬個節點,只比 hash。
7 · 答案
如果你指的是「設計師分類為 dialog」,目前只有 42 個畫面有標註,其餘無法判定。
例:
1:102753 是帶面板的彈窗(51 個節點,家族 d4319d6dc784)。
要清單就再往下鑽(list_screens 帶 archetype);要確認就開複審看板,設計師勾選後把判斷寫回 labels。
整個流程裡,我只做了三件事:讀懂任務、選對工具、把數字翻譯成答案。計數、分群、判斷,全部在資料層完成。
| 情況 | 結果 |
|---|---|
| 遮罩被畫進元件內部,沒有獨立圖層 | 可能判成 page,需要人工複審 |
| 全螢幕但沒有遮罩(例如引導頁) | 落在 page,這是對的 |
| 畫布尺寸不是 390×844 | 要改掃描尺寸,否則一頁都掃不到 |
所以我剛才說的是「結構上的彈窗有 87 個」,不是「彈窗有 87 個」。