聊天串
端點現在接受 referenceAssetKind 為空字串或 null。管理後台表單仍然送出空字串。
合約偏移：schema 預期 image、video、audio、null，或保留空字串相容性。 呼叫端影響：管理後台表單依賴空字串處理。 驗證缺口：分別測試 null 和空字串。 發布備註：在讀取邊界正規化為 null。 風險：嚴格解析器可能拒絕既有草稿記錄。
提示詞庫
端點現在接受 referenceAssetKind 為空字串或 null。管理後台表單仍然送出空字串。
合約偏移：schema 預期 image、video、audio、null，或保留空字串相容性。 呼叫端影響：管理後台表單依賴空字串處理。 驗證缺口：分別測試 null 和空字串。 發布備註：在讀取邊界正規化為 null。 風險：嚴格解析器可能拒絕既有草稿記錄。
計畫是在將提示詞內容移入已審查的發布檔案後，移除線上資料庫寫入。舊資料列仍保留在生產環境。
資料遺失風險：如果讀取不再依賴舊資料表，風險較低。 回填順序：停用寫入前，先確認發布檔案覆蓋完整。 回滾限制：重新啟用資料庫寫入不一定能重建遺漏的編輯。 驗證查詢：比對已發布檔案範本數量與舊資料列數量。 決策：保留舊資料列為唯讀，直到至少一個發布版本通過。
請求：整理素材歸屬、退役舊相容路徑、更新文件，並改進稽核腳本。
工單 1：稽核目前素材路徑與臨時連結引用。 工單 2：替換最終 URL 並驗證公開頁面。 工單 3：只有在範例覆蓋穩定後，才移除相容路徑。 工單 4：更新治理文件與發布檢查清單。 驗證：提示詞檢查、媒體稽核、typecheck 與 build。
提示詞側欄的 Use 按鈕會更新 URL 查詢參數，但用戶端導航後 textarea 仍保留前一個 prompt。
症狀：URL 變更，但 textarea 狀態沒有重新整理。 可能過期的狀態：查詢參數 hydration 只在首次掛載時執行。 重現：在同一個模型頁點擊兩張 prompt 卡片。 最小修復：觀察搜尋參數，並只在相關值變更時同步。 測試：直接載入和同頁導航都能重新填入 textarea。
未登入使用者造訪 /zh/studio/image 時，應該進入登入頁，並返回本地化 studio 路徑。
重新導向迴圈風險：登入頁不應重新導向到自己。 語系處理：返回路徑保留 zh。 受保護路由外洩：studio 內容保持 noindex，且受登入門檻保護。 測試案例：未登入的本地化 studio 請求。 回歸檢查：預設語系和 zh 應有一致行為。
需要從 result_urls_json 為舊 AI 任務回填 result_primary_url，同時不改變新任務的寫入。
真相來源：狀態為 completed 的舊任務的 result_urls_json 第一項。 試跑：依 status 統計缺少主要 URL 的數量。 寫入順序：只處理狀態為 completed 的舊任務，並依 ID 分批。 驗證：比較前後計數。 回滾限制：只有在原始 JSON 保持完整時，才能清空主要 URL。
某個上游服務商的影片任務失敗，但日誌只顯示通用上游錯誤，支援團隊看不到服務商錯誤代碼。
缺少的日誌：服務商錯誤代碼與 request ID。 缺少的指標：依服務商與模型區分的失敗率。 缺少的追蹤：從上傳到生成交接的流程。 告警缺口：沒有服務商專屬的失敗突增告警。 下一步：為支援視圖持久化標準化後的上游錯誤來源與代碼。
Playwright 版本變更後，截圖失敗，因為尚未安裝相符的 Chromium 版本修訂。
API 變更：目前尚未確認。 生成檔案：安裝瀏覽器不應改動應用程式檔案。 瀏覽器要求：安裝相符的 Chromium 版本修訂。 回退計畫：只有版本相符時，才使用既有快取版本修訂。 驗證：安裝後執行截圖命令並記錄版本修訂。
發布變更了提示詞靜態路徑，並新增 58 個對話模板。沒有 schema 變更。建置必須包含新頁面。
切換點：部署前回滾是 git revert；部署後回滾是重新部署上一個建置版本。 資料風險：schema 沒有風險，但 sitemap 數量會變更。 負責人：發布工程師負責部署；內容負責人負責模板驗證。 驗證：prompts:check、i18n 檢查、typecheck、build。 中止條件：缺少本地化檔案或提示詞靜態路由失敗。
新增大量模板後，提示詞列表頁感覺變慢。伺服器渲染是靜態的，但用戶端篩選要處理更多項目。
可能原因：用戶端篩選和卡片渲染會隨項目數量增加而變重。 測量計畫：比較變更前後的用戶端水合時間和篩選輸入延遲。 安全實驗：先記憶化搜尋值，只有必要時再做虛擬化。 回滾觸發條件：中階行動裝置上的互動延遲超過目標。 不要改動：沒有伺服器瓶頸證據前，不要改 SEO 靜態生成。
提示詞卡片現在有緊湊的對話預覽，動作按鈕位於被截斷的對話區塊下方。
焦點順序：卡片連結不應困住動作按鈕。 目標尺寸：複製和執行按鈕需要至少 24px 的目標尺寸或等效間距。 減少動態效果：懸停掃光效果應只作為裝飾。 標籤檢查：按鈕需要可見或可存取的動作名稱。 行動版風險：對話泡泡文字不得與動作按鈕重疊。
使用者打開模型頁，點擊相關的對話提示詞，執行面板應該預先填入該提示詞。
使用者路徑：模型詳情頁到相關提示詞，再到執行面板。 資料邊界：提示詞文字透過客戶端導覽傳遞。 失敗模式：文字輸入區保留舊提示詞。 測試案例：點擊兩張不同的提示詞卡片，並斷言最新值。 驗證目標：URL 和文字輸入區保持同步。
支付完成事件會新增點數。重試事件可能重複送達。錢包頁讀取點數帳本。
冪等性：寫入點數前，事件 ID 必須保持唯一。 重放安全：驗證簽章並檢查時間戳容忍範圍。 點數寫入：帳本項目應參照支付工作階段。 客戶可見失敗：如果付款成功但點數寫入失敗，應顯示待人工檢查狀態。 測試缺口：重複事件與亂序事件案例。
需要先對齊 Rivya 與相鄰種子腳本的模型配置，但暫時不改變執行時行為。
順序：審計目前配置、比較生成的模型事實，然後更新種子腳本。 契約：model slug、category 與 provider ID 必須保持穩定。 驗證：執行時變更前先做一致性檢查。 回滾邊界：配置生成可獨立於介面內容回滾。 風險：變更展示欄位可能影響 SEO 頁面。
只變更了提示詞模板內容。既有文件已有未提交編輯。需要下一位負責人審查 SEO 文案。
觸及檔案：提示詞模板來源與語系檔案。 不變條件：沒有改變程式碼路徑或路由行為。 已知風險：新頁面會增加靜態提示詞數量。 驗證：prompts:check 與 SEO 標題稽核。 下一位負責人的決策：合併前是否執行完整建置。
功能允許使用者上傳參考圖、保留歷史，並跨工作室工作階段重複使用提示詞。
驗證問題：誰可以存取重複使用的提示詞與上傳參考圖。 儲存問題：參考素材存放在哪裡，以及何時過期。 使用者資料問題：提示詞是否可能包含私人客戶資料。 濫用途徑：公開分享可能暴露私人媒體。 審閱負責人：安全與產品需要在上線前確認保留規則。
prompts:check 通過，但生成的訊息檔案在工作區變更後，i18n:check 失敗。
變更檔案失敗：先檢查 locale JSON 結構。 環境失敗：如果 prompts:check 已通過，環境問題可能性不高。 不穩定測試：對於確定性的 i18n:check 來說不太可能。 下一個命令：執行 i18n:generate，然後再次執行 i18n:check。 不要做：在不理解來源差異前，不要還原生成檔案。
決策：在發布前先審查可重複使用的提示詞模板，而不是直接在即時管理後台畫面中編輯它們。
脈絡：公開提示詞頁面需要靜態且可審查的內容。 選項：資料庫 CMS、檔案來源，或混合回寫。 決策：採用檔案來源，管理後台只做診斷。 後果：編輯需要部署，但 SEO 和審查保持穩定。 重新檢視觸發條件：營運需要安全的非開發寫入流程。