生圖全流程
SUMLINK 視覺產線的「Telegram 一句話 → 出圖回群」管道。整合 brand-visual-spec（視覺規範）、sample-matrix（樣本矩陣）與 A2A 調用契約，是 admin（運營腦）執行生圖任務的標準流程。
呼叫鏈
老闆 Telegram 一句話（例：「生成一張酒店 2700K 場景圖」）
① 路由：skill_router.py 關鍵字匹配 → 命中「圖像素材」skill
② 映射：運營腦把需求對映成五維參數（不確定先問老闆，不猜）
③ 派發：A2A bridge :8756 → Codex 在本機執行 generate.py
④ 出圖：generate.py 按 brand-visual-spec 自動組裝 prompt → 調 GCP Gemini 生成
⑤ 留痕：PNG + 同名 JSON（prompt/seed/model/cost）
⑥ 回傳：Codex 回報路徑 → 運營腦發圖回群（>10MB 轉 WebP）
⑦ 審核：Claude 過 asset-qc-checklist，P0=0 才通過，否則 ≤3 輪重出
五維參數（generate.py 指令契約）
| 參數 | 取值 | 預設 | 說明 |
|---|---|---|---|
--space |
hosp/resi/offc/retl |
retl |
酒店餐飲／高端住宅／極簡辦公／精品零售藝廊 |
--cct |
5000k/4000k/2700k |
4000k |
晨間／中性／夜間（已統一偏暖描述） |
--visibility |
A/B |
A |
C 檔鎖定；B 檔配 --lens t |
--lens |
w/n/t/m |
w |
24-35mm／35-50mm／85-100mm／macro |
--ratio |
16x9/4x3/1x1/191x100 |
16x9 |
191x100 API 層映射 16:9 |
執行環境：E:/AIagent/venv-media/Scripts/python + scripts/media/generate.py，輸出 assets/golden/ondemand/{space}-{cct}-{visibility}-{lens}-{時間戳}.png/.json
硬規則
- C 檔禁止：工廠原圖到位前，不生成可辨識型號的燈具主體圖（偽造外觀）
- 留痕強制：無 JSON 的圖不進評審；PNG 與 JSON 同名同目錄
- 迭代上限：同參數格 ≤3 輪，超限回 brand-visual-spec 對齊，禁第 4 輪賭運氣
- 色溫不可造假：靠 prompt 呈現，禁後製調色；內建負面串不可刪
- prompt 不手寫：由腳本按規範自動組裝，需定制先
--dry-run
相關文檔
- brand-visual-spec — 視覺規範（色票、紅線、負面串、三檔可見度）
- sample-matrix — 樣本矩陣（五維度批次生成設計 + 驗收閘）
docs/a2a-generate-call-contract.md— A2A 調用契約（S 級，指令 + 回傳）docs/asset-qc-checklist.md— 出圖 QC 檢查表（P0/P1）skills/admin/admin-內容-圖像素材.md— 生圖 skill（路由觸發）