App-first 排錯手冊：先定位，再求救
從 Claude App、Preview、GitHub 網頁、Vercel 到 Firebase 依序定位，並整理不含敏感資訊的求救包；不靠隨機貼指令。
25
學完這一課，你會做到
- 依層次而非隨機嘗試進行排錯
- 使用症狀表快速找到下一個安全檢查
- 產生不含個資與秘密、可供助教重現的求救資訊
開始前先定位
你在這裡詞彙、排錯與隨查手冊
用白話詞彙表與固定排錯順序支援自助處理；Terminal 指令只放在選修附錄。
完成證據升級求助條件
同一個安全檢查做過兩次仍無進展、錯誤涉及權限／資料遺失／秘密洩漏，或 AI 建議破壞性命令時，立即停止並交給助教或合格維護者；附上已去敏的求救包。
本課先不做守住小步與資料界線
不使用真實病人資料，也不在尚未驗收時一次交付多個大型修改。
本課名詞排錯builddeploymentpermissions求救包
五層排錯順序
- Claude App：Code 工作階段上方的資料夾名稱是否為正確 repo；第一個錯誤或權限要求是什麼。
- Preview：能否開啟、重現哪一步、畫面第一個可見錯誤是什麼。
- GitHub 網頁：Owner／repo 與分支是否正確；最新 commit、訊息與檔案是否已同步。
- Vercel 網頁：部署對應哪個 commit，Build Logs 第一個失敗點是什麼。
- Firebase：使用合成資料重現，檢查網路與 Rules 拒絕訊息；不以關閉規則來「修好」。
常見症狀與安全下一步
| 症狀 | 先檢查 | 不要做 |
|---|---|---|
| Code 分頁找不到專案 | 是否選 Local、是否重新開啟含 README 的實際 repo 資料夾 | 把整個硬碟授權給 Claude |
| Preview 無法開啟 | Claude App 第一個錯誤、README 與權限要求 | 亂貼網路安裝腳本 |
| Preview 新、線上舊 | commit 與 push 是否分別完成、GitHub 最新 commit、Vercel deployment | 反覆重建帳號 |
| Vercel build failed | 對應 commit 與第一個 Build Logs 錯誤 | 把秘密公開到 repo |
| Missing permissions | 合成重現、登入狀態、規則與路徑 | 改成 allow read, write: if true |
| 多裝置不同步 | 是否同一網址、同一 Firebase 專案、寫入是否成功 | 改用真實資料測試 |
可複製的求救包
環境：［Claude App／瀏覽器、作業系統］
目標：［一個小任務］
重現步驟：1…2…3…
預期／實際：［文字］
第一個錯誤：［已去除個資、email、token、cookie、金鑰與私密網址］
Review changes 摘要：［檔名與變更目的，不貼私人路徑］
最近成功 checkpoint／commit：［GitHub 網頁的分支與 commit 訊息］
請先診斷，不要關閉安全控制、不要刪資料、不要強制重置。升級求助條件
同一個安全檢查做過兩次仍無進展、錯誤涉及權限／資料遺失／秘密洩漏，或 AI 建議破壞性命令時，立即停止並交給助教或合格維護者；附上已去敏的求救包。
參考資料
介面與方案會改版；實際操作仍以各工具官方頁面為準。延伸資料用來幫助理解，不取代本課安全原則。
低壓力自我檢查
看到 Firestore Missing permissions 時，最不應該做的是？
準備好再標記完成完成狀態會留在這台裝置，下次回來可接著學。