# Codex 訂閱生圖：說明與邏輯原理

> 此資料夾**不含實作 skill**，只附概念與運作原理說明。  
> 需要實際使用需自備 ChatGPT Plus / Pro 訂閱 + Codex CLI 安裝。

## 為什麼這個 skill 不直接打包？

`codex-image:generate` / `codex-image:edit` 透過 Codex CLI 呼叫 OpenAI 內建 `imagegen` 工具（GPT Image 2）。**這需要 ChatGPT 訂閱**才能用，且額度算在 ChatGPT Plus / Pro 上。

直接打包給同學沒有意義 — 同學沒有訂閱也跑不動，有訂閱的話直接從官方安裝 Codex CLI 就行。

## 運作原理

```
[使用者]
   ↓ 自然語言 prompt (中文 + 寫實/編輯指令)
[Claude Code 對話]
   ↓ 觸發 codex-image:generate / edit skill
[skill 內部 node 腳本]
   ↓ 呼叫 Codex CLI
[OpenAI Codex CLI]
   ↓ 載入 imagegen skill (built-in)
[GPT Image 2 模型]
   ↓ 生成 PNG
[檔案系統]
   ↓ ./codex-images/<utc-ts>-edit-N.png
[Claude 回傳路徑給使用者]
```

## 提示詞設計 18 原則（GPT Image 2）

1. **明確主體**：人物 / 場景 / 物品先說
2. **構圖視角**：正面 / 側面 / 俯瞰 / 仰角
3. **鏡頭距離**：特寫 / 半身 / 中景 / 全身
4. **光線氣氛**：晨光 / 黃昏 / 室內 / 工作室
5. **顏色基調**：暖色 / 冷色 / 黑白 / 飽和度
6. **材質質感**：寫實 / 油畫 / 水彩 / 動漫
7. **景深控制**：背景虛化 / 全景清晰
8. **動作/姿勢**：站姿 / 坐姿 / 走動 / 靜止
9. **表情情緒**：微笑 / 嚴肅 / 沉思 / 驚訝
10. **服裝細節**：材質 / 顏色 / 風格
11. **環境元素**：家具 / 植物 / 背景物品
12. **時代風格**：現代 / 復古 / 未來 / 古典
13. **氛圍情境**：寧靜 / 熱鬧 / 神祕 / 溫暖
14. **構圖比例**：黃金比例 / 三分法
15. **顏色對比**：高對比 / 柔和對比
16. **細節層次**：精細 / 簡約 / 抽象
17. **整體風格**：cinematic / documentary / illustration
18. **比例與尺寸**：9:16 / 16:9 / 1:1 / 4:3

## 編輯既有圖的關鍵句法

```
請保留人物臉部、五官、髮型完全不變，只更換以下元素：
[衣服描述]、[場景描述]、[手上物品]、[光線氣氛]。

[構圖描述：第三人稱中景、雙手位置、視線方向]

整張圖必須是寫實照片風格 photorealistic cinematic shot of a real
[人物描述], [構圖類型], NOT a selfie, NOT vlog pov，絕對不要動漫風
no anime no illustration no cartoon，背景全部真實質感、真實光影。

畫面比例 9:16 直式（或 16:9 橫式）。
```

**雙保險原則**：中文先給情境，英文負面詞鎖死「不要動漫」— 因為純英文 prompt 容易觸發 anime 預設。

## 安裝指南（需 ChatGPT 訂閱）

1. 安裝 Codex CLI：`npm install -g @openai/codex`
2. 登入：`codex login`（會跳瀏覽器到 ChatGPT 登入）
3. 確認 imagegen skill 可用：`codex skills list`
4. 從 [官方範例](https://github.com/openai/codex) 取得 wrapper 腳本，或自己寫一個包裝節點。

## 限制與注意

- 額度：吃 ChatGPT 訂閱（不是 API key 計費）
- 每張圖約 10-30 秒生成
- 解析度上限：1024x1024 或對應比例
- 編輯既有圖：必須先上傳到 Codex CLI 的 sandbox
- 不要把敏感人物照片送上去（OpenAI policy）

---

如果想看完整實作參考，可以查看主人開放的 skill 結構，但需要自己 build 一個能呼叫 Codex CLI 的 wrapper。
