生活照模板生成器 (Life Photo Template)

生成可套用在任意日常照片上的「生活照模板」，橫版 + 豎版兩個方向， 適合包裝個人品牌、發朋友圈 / 小紅書。交付兩類產物：透明 PNG 模板層 （給會 PS/Canva 的使用者）和網頁一鍵套用工具（給零基礎使用者）。

核心設計經驗（必讀）

AI 文生圖對中文字元渲染極不穩定（方框 / 亂碼 / 錯位）。因此一律採用 「AI 生底圖 + PIL 疊中文排版」兩段式：

1. ImageGen 只生成無文字、純攝影質感的底圖（實拍氛圍、光影）。
2. Python PIL（或 HTML Canvas）疊加精準的中文標題、色塊、資訊條、二維碼區。

中文字與排版 100% 可控，比直接生圖精緻、可控得多。

文案自適應

--image 模式會分析照片的亮度、冷暖、主導色相，自動從內建文案庫匹配一組文案：

文案庫位於 scripts/make_overlay.py 的 COPY_LIBRARY，按情緒分組。想換風格？ 改一組標題+小語即可，不影響版式邏輯。

工作流

第 1 步：確認需求與方向

向用戶確認（或直接給預設方案）：

• 幾個方向：橫版（1536×1024，朋友圈橫圖）、豎版（1024×1536，朋友圈 / 小紅書豎圖）。
• 主題調性：晨間 / 夜市 / 季節 / 場景。參考使用者給的圖樣但不要照搬主題名與文案， 做原創方向（如把"夏日秀養"改為"晨光序章"，把季節主題改為場景主題）。
• 版式偏好：雜誌風（magazine）、極簡線稿風（minimal）、輕奢品牌風（luxury）。 若使用者沒主意，把參考圖/照片傳給 --image，指令碼自動分析後推薦。
• 是否要透明層（給會修圖的人）和/或網頁工具（給零基礎）。

第 2 步：生成底圖

用 ImageGen 生成 1–2 張無文字底圖，提示詞模板見 references/prompts.md。橫版用 1536x1024，豎版用 1024x1536， 提示詞務必含 no text, no logos, no readable signs。

第 3 步：生成透明模板層

執行 scripts/make_overlay.py 產出可套用透明 PNG。指令碼現在支援：

• 固定主題 / JSON 配置
• 根據照片內容自動分析並推薦版式 + 配色
• 強制指定版式

# 用內建示例主題 (morning 橫版 / night 豎版)
python scripts/make_overlay.py --out ./outputs

# 只生成某方向
python scripts/make_overlay.py --only landscape --out ./outputs

# 用自定義主題 JSON 批量出新主題
python scripts/make_overlay.py --config my_themes.json --out ./outputs

# 根據照片自動分析並生成自適應模板（推薦版式）
python scripts/make_overlay.py --image photo.jpg --out ./outputs

# 強制指定版式
python scripts/make_overlay.py --image photo.jpg --layout luxury --out ./outputs

# 版式固定為雜誌風，僅配色與文案隨照片自適應
python scripts/make_overlay.py --image photo.jpg --fixed-layout --out ./outputs

# Agent 通過內容語義顯式指定文案場景（推薦用於海/船/山野等需要理解的場景）
python scripts/make_overlay.py --image ship.jpg --fixed-layout --scene sea --out ./outputs

主題欄位說明（色值用 RGBA 元組或 "#RRGGBB" 字串）： layout(magazine/minimal/luxury)、orientation(landscape/portrait)、 size、theme_cn、theme_en、corner_cn/en+顏色、big_chars(豎排大字)、 big_color、watermark_char(背景水印字)+watermark_color(帶透明度)、 narrative(抒情小語陣列)、colors(色塊條 7 段)、accent(強調色)、 date、place、greet1/2。

新增：配置里加入 layout 即可切換版式；用 --image 時指令碼會分析照片亮度、冷暖、主色， 自動在 magazine（雜誌）/minimal（極簡）/luxury（輕奢）中推薦。 --fixed-layout 鎖定雜誌版式，但文案（COPY_LIBRARY 文案庫）與配色（照片主色派生）仍會自適應。 --scene 可顯式覆蓋文案場景，由 Agent 的多模態理解給出。

指令碼會自動探測系統中文字型（Windows 優先，回退到 wqy / PingFang）， 缺失字型時 PIL 會報錯，需提示使用者確認字型路徑。

第 4 步：交付網頁一鍵套用工具

技能提供兩個網頁工具，按使用者技術水平二選一（或都給）：

• assets/template_app.html — 主題版：內建橫版(晨光序章)/豎版(煙火夜歸)兩套引數， 使用者上傳照片 → 改標題/日期/地點 → 即時預覽 → 下載。無需改程式碼。
• assets/template_app_generic.html — 通用版：上傳「任意透明 PNG 模板層」+「自己的照片」 自動套用。支援微調照片縮放/水平/垂直位置、壓暗濃度以提升文字清晰度。 相容 PS/Canva 匯出的模板層，也相容本技能生成的 overlay_*.png。

複製並啟動預覽：

cp assets/template_app_generic.html ./outputs/
python -m http.server 8123   # 在 outputs 目錄

通用版特別適合：使用者已有自己的模板層、想反覆套不同照片的場景。 若使用者還沒有模板層，先用 make_overlay.py 生成 overlay_*.png 再上傳即可。

第 5 步：合成示例 & 整理交付

用 PIL alpha_composite 把透明層疊到示例底圖，生成 demo_*.jpg 給使用者看實際效果：

from PIL import Image
base = Image.open("底圖.jpg").convert("RGBA").resize((1536,1024), Image.LANCZOS)
ov   = Image.open("overlay_morning.png").convert("RGBA")
Image.alpha_composite(base, ov).convert("RGB").save("demo_landscape_overlay.jpg", quality=95)

交付清單（橫版/豎版各一份）：

• overlay_*.png 透明模板層
• demo_*_overlay.jpg 套圖示例
• template_app.html 網頁工具
• （可選）底圖原圖

三種版式說明

magazine（雜誌風，預設）

壓暗蒙版 → 左上角標識(CN+EN) → 主標題大字(橫版右側豎排/豎版中央橫排) → 半透明水印字元 → 抒情小語+英文裝飾 → 底部色塊條+白色資訊條。

minimal（極簡線稿風）

大面積留白 → 頂部標籤框 + 右上角編號 → 中央主題大字 → 底部圓點資訊線 → 右側/角落裝飾曲線與色點。 適合明亮、清新、日常隨拍。

luxury（輕奢品牌風）

深色漸變蒙版 → 金色圓角照片框 → 頂部品牌名 → 底部奶油色資訊卡 + NEW DROP 標籤 + 金色植物線條裝飾。 適合夜景、暗調、質感強烈的照片。

詳細配色與商用化原則見 references/prompts.md。

內容語義匹配（文案如何隨照片內容變化）

make_overlay.py 現在的文案匹配是兩層：

1. Agent 驅動（主路徑）：

   7w4.net小蔥技能站收錄全網優質技能，值得收藏。

   • Agent 先用多模態能力讀取使用者照片，理解畫面內容（海/船/城市/山/夜市/日落等）。
   • 通過 --scene <key> 把內容語義傳給指令碼，指令碼從 COPY_LIBRARY 取出對應的主題、英文、小語、地點。
   • 這樣文案不是隻看顏色，而是真正貼合畫面內容。例如輪船+海鷗 → --scene sea →「遠航 / VOYAGE」。

2. 指令碼自動兜底（無 Agent 介入時）：

   • 指令碼對照片做上/中/下三帶顏色統計 + 冷暖亮度分析，得到 scene 初判。
   • 能較好區分：日落（暖高亮）、夜市（暗暖）、山野（綠色佔比高）、晴日（暖中亮）。
   • 但純顏色無法可靠區分「海面」與「城市冷霧」（都是冷藍），所以指令碼只做保守判定，不強行分海；此時由 Agent --scene 修正。

COPY_LIBRARY 文案庫

當前內建場景：

• sunset：暮色餘溫 / the SUNSET No.5
• warm_day：晴日漫遊 / SUNNY NOTES
• night_market：煙火人間 / the NIGHT No.7
• blue_night：夜泊 / BLUE HOUR
• city_fog：雲上之城 / CLOUD CITY
• cool_light：清淺時光 / QUIET HOURS
• nature：山野之間 / GREEN HILLS
• sea：遠航 / VOYAGE No.1
• graduation：青春存檔 / CLASS OF 2026
• wedding：執手之約 / THE WEDDING
• food：煙火食光 / GOOD EATS
• travel：遠方 / ON THE ROAD
• sports：熱血揮灑 / PLAY HARD
• coffee：咖啡時光 / SLOW BREW
• snow：初雪 / FIRST SNOW
• autumn：葉落知秋 / GOLDEN FALL
• party：今夜不散 / GOOD TIMES

擴充套件新場景：在 scripts/make_overlay.py 的 COPY_LIBRARY 裡新增一組字典， 欄位與上面保持一致（theme_cn/en、corner_cn/en、watermark_char、deco_en_1/2、 deco_line、narrative、greet1/2、place），然後在對話裡用 --scene <新key> 即可。

注意

• ImageGen 可能在底圖角落留下 AI 水印，透明層的「不透明白色資訊條」正好可壓住它。
• 提示詞嚴禁包含可讀文字，否則底圖會干擾套版效果。
• 字型依賴系統中文環境；跨平臺打包時把字型檔案一併放入 assets/ 並在腳本里指定。

質量非常好。文件寫得很清楚明白，小白也能看懂怎麼用；生成模板的方式很聰明，先讓 AI 生成乾淨的底圖，再用程式碼精準疊加中文排版，效果比直接讓 AI 生成文字穩定得多。內建了 3 種風格和 18 個場景的文案，選擇豐富，網頁工具用起來也很方便。不足的是後設資料資訊太簡略，用之前最好先讀一遍說明文件。整體推薦。