\r \r

Midjourney → Instagram（linkmidjourneyinstagram）\r

\r

專案根目錄\r

\r 自動化程式在 repository root（與 skills/ 同層、含有 main.py 的那個資料夾）。 \r 透過 exec 執行指令時，必須先 cd 到該目錄；不要只在 {baseDir}（此 skill 資料夾）底下跑 python main.py。\r \r

何時用這份 skill\r

\r

• 使用者要「從 Midjourney 產圖 → 自動發四則 IG 貼文」。\r
• 需要選擇 caption 來源：captions.txt、與 MJ 相同的 prompt、或 vision API。\r
• Troubleshooting：首次登入、Playwright、HEADLESS、POST_DELAY、Gemini 區域限制等。\r \r

前置條件\r

\r

• Python 3.10+，python 在 PATH。\r
• Midjourney 有效訂閱（Google / Discord OAuth，由瀏覽器手動完成首次登入）。\r
• Instagram 帳號；.env 內需 INSTAGRAM_USERNAME、INSTAGRAM_PASSWORD（見 .env.example）。\r
• 依賴：pip install -r requirements.txt，並執行 python -m playwright install chromium。\r \r

安裝與設定（一次性）\r

\r 於 repository root：\r \r

python -m venv .venv\r
```\r
\r
啟用 venv 後（Windows：`.venv/Scripts/activate`；macOS/Linux：`source .venv/bin/activate`）：\r
\r
```bash\r
pip install -r requirements.txt\r
python -m playwright install chromium\r
cp .env.example .env\r
```\r
\r
編輯 `.env` 填入 IG 帳密；其餘選項見 `.env.example` 註解。\r
\r
## 首次執行（務必可視瀏覽器）\r
\r
- 維持 `HEADLESS=false`（預設），讓 Chromium 視窗開著。\r
- Midjourney：完成 Google/Discord 登入與驗證；session 會存到 `browser_data/midjourney/`。\r
- Instagram：完成網頁登入與可能的 2FA；session 會存到 `browser_data/instagram/`。\r
- 之後可視需求改 `HEADLESS=true`。\r
\r
## 執行 pipeline（給 agent 用 `exec`）\r
\r
預設讀取 `prompt.txt` 與 `captions.txt`：\r
\r
```bash\r
python main.py\r
```\r
\r
常用選項：\r
\r
```bash\r
python main.py --prompt "your midjourney prompt here"\r
python main.py --skip-instagram\r
python main.py --headless\r
python main.py --post-delay 60\r
python main.py --use-prompt-caption\r
python main.py --use-vision-caption\r
```\r
\r
行為摘要：\r
\r
| 模式 | 條件 |\r
|------|------|\r
| Vision caption | `--use-vision-caption` 或 `.env` 中 `INSTAGRAM_USE_VISION_CAPTION`；若設了 `GEMINI_API_KEY`/`GOOGLE_API_KEY` 且未明確關閉，預設會開 vision |\r
| Prompt 當 caption | `--use-prompt-caption` 或 `INSTAGRAM_USE_PROMPT_CAPTION=true`（vision 開啟時會被蓋過） |\r
| `captions.txt` | 上述皆否時，依 `---` 分區塊，每張圖一則；區塊不足則用最後一則重複 |\r
\r
Vision：`GEMINI_API_KEY` / `GOOGLE_API_KEY`，或 `VISION_CAPTION_PROVIDER=openai` 搭配 `OPENAI_API_KEY`。詳見 `.env.example`。\r
\r
## 編輯輸入檔\r
\r
**`prompt.txt`**：以 `# `（井號+空白）或單獨 `#` 開頭的行為註解並忽略；`#midjourney` 這類標籤保留。非註解行會用空白串成一句送進 Midjourney。\r
\r
**`captions.txt`**：四個（或多個）區塊，區塊之間一行 `---`。註解規則同 `prompt.txt`。\r
\r
## 輸出與安全\r
\r
- 圖片：`outputs/mj_\x3Ctimestamp>/image_1.png` … `image_4.png`。\r
- **勿** commit `.env`、`browser_data/`（含 session cookie）；已應在 `.gitignore`。\r
- 自動發文可能觸發平台風控；善用 `--post-delay`（預設對應 `POST_DELAY_S`），勿過度密集發送。\r
\r
## OpenClaw 載入後\r
\r
必要時請使用者 `/new` 或重啟 gateway；可用 `openclaw skills list` 確認 skill 名稱 `link-midjourney-instagram` 已載入。\r