做這條生產線的過程中，最難纏的不是「機器亮紅燈」，而是機器一路綠燈，貨卻是錯的。這篇把我們踩過的十個這種坑整理成一份指南。它們分屬四個地方：原料（3D 檔案）、規格表（契約）、AI 助手、生產線上的工具。

每一個都附上「現在的狀態」：已經修好、已經繞開，還是仍然開著。每個我都在這次重新跑過或讀過現在的程式，不是憑記憶寫的。

一、原料：3D 檔案的悄悄話

坑 1：焊接指令靜靜地什麼都沒做。
把一個方塊零件的接縫「焊起來」，理論上 24 個點會剩 8 個。開發筆記記載，當時在某種貼了材質資訊的零件上，焊接指令不報錯、也不焊，點數還是 24，後面的品管就一路判不合格，自癒迴圈也救不了，因為根本沒有旋鈕能讓一個「沒焊過」的東西變焊過。
現況：程式裡仍保留當時的修法（明確要求焊接）。但我這次用現在的檔案重跑，連不加參數也焊得起來（24 變 8），所以這個坑的現場我沒能重現，只能引用當時的筆記。

坑 2：存檔會偷偷丟掉備註。
我們在 3D 檔案的檔頭寫了一條備註：「單位已換成公尺」。但用某個工具打開、再存檔，備註就不見了，而且沒有任何警告。品管員就是靠這條備註判斷單位換算過沒。
現況：這是外部工具的行為，已繞開：要造「有備註」的測試檔，得直接改檔案內容，不能經過存檔。

坑 3：「沒寫」跟「寫了空的」，工具回答一模一樣。
那個工具讀一個沒有備註的檔案，回傳的是「空的備註」，跟「有備註、內容是空的」長得一樣。所以測試如果只問「備註是不是空的」，就分不出這兩種情況。
現況：改成直接讀檔案原始內容，確認那個欄位根本不存在。

二、規格表：格式對，不代表內容對

坑 4：叫 AI 照規格表交作業，建立時一切正常，送出時才炸。
我們把規格表（平面圖清單的格式）直接交給 AI 工具，當成「請照這個格式回答」。建立 AI 工頭的那一步完全沒報錯，一直到真的要送出請求，才發現格式裡有 AI 服務不接受的寫法。如果沒有特地去測，會拖到申請到金鑰的那一天才發現。
現況：另外做了一份簡化版格式專門給 AI 用，並且有離線測試在「還沒送出」就驗證能轉換。

坑 5：清單通過格式檢查，內容仍然是錯的。
我拿平面圖清單，故意改成：兩面牆用同一個編號、一面牆長 8 公里。格式檢查全過，蓋牆的工人也照蓋了。
現況：仍然開著，沒有任何關卡擋這兩種情況。

三、AI 助手：寬容的預設值

坑 6：欄位多一個問號，缺值就不會出聲。
給 AI 的工作說明裡可以貼入「前一位同事交接的參數」。貼的時候如果寫「參數：{x}」，缺值會立刻報錯；如果寫成「參數：{x?}」，缺值就悄悄變成空白，AI 會在沒有參數的情況下開工。
現況：這是設計如此，我們刻意在交接欄位用問號。要知道：空白不會報錯。

坑 7：標著「離線」的測試，其實會打電話給 AI。
我們有一條「離線評測」指令，用意是不碰 AI 服務。但申請金鑰、放進設定檔之後，評測工具會自動讀到金鑰，於是「離線」評測真的去呼叫 AI，並且撞到每日免費額度（紀錄是 429）。
現況：已修。指令現在會先把金鑰清空再跑。我這次重跑，5 題全過，沒有碰任何 AI 服務。

四、生產線上的工具

坑 8：篩選條件悄悄永遠成立。
挑熱點時有一條規則：「角色不是分類標籤」。但轉檔時從來沒有填過「角色」這欄，全是空的，所以這條規則對每個零件都成立，等於沒有篩。
現況：已修。轉檔現在會填角色，demo 資產讀回來是 13 個零件、5 個分類標籤。

坑 9：守則寫「3 到 8 個」，程式沒數。
策展人挑熱點，守則說 3 到 8 個，但程式收了 2 個；同一個熱點編號寫兩次也收，導覽路線就多出重複的一站。
現況：已修。現在 2 個會被拒絕；重複編號也會被拒絕（要三筆以上才看得出，兩筆時會先撞到數量規則）。

坑 10：看照片的人扣的分，被下一次檢查蓋回去。
看照片的人說「不合格」，把整體狀態往下扣；但接著品管員重新檢查一次，狀態依規則重算，扣分就消失了。
現況：已修。視覺的意見現在是一條正式的警告，品管員重跑之後仍在。我這次實測，重跑前後都是黃燈，警告都還在。副作用是意義改了：視覺最多讓合格變成警告，不再能直接判不合格。

這十個坑的共通點

• 預設值太友善：缺值給空白、讀不到給空物件、沒寫過給預設值，每一個都是「為了方便」，也都是「為了方便而不出聲」。
• 「通過」只代表它檢查的那一層通過：格式對了，不代表內容對；建構成功了，不代表送得出去。
• 驗「沒做」比驗「做了」難：要看原始內容，不能信包裝過的回答。
• 要在還沒花錢、還沒上場的時候就測：能離線驗的，不要拖到有金鑰、有實機那天。

狀態一覽