gemini-image

Gemini Image Generation Skill（CLI）

CamoFox CLI コマンドのみを使用する Gemini の画像生成ワークフローで、このスキルを使用してください。curl は、ローカルの CamoFox ダウンロード API からファイルを取得する場合にのみ使用してください。

1. 前提条件

• CamoFox サーバーがポート 9377 で実行されている必要があります。
• Gemini を利用できる Google アカウントが必要です。
• 初回ログインでは、メールアドレスとパスワードの入力、およびスマートフォンでの 2FA 承認が必要です。
• 初回ログイン後は、セッションプロファイルを保存して再利用してください。

2. クイックスタート（最短手順 — 認証済み）

有効な Gemini セッションがすでに保存されている場合：

以下のコマンドはすべて --user gemini を指定していることを前提とします。複数のセッションを使用する場合は、明示的に追加してください。

# Load saved session and open Gemini
camofox open https://gemini.google.com/app --user gemini

# Load saved profile
camofox session load <profile-name> --user gemini

# Verify auth (check for profile avatar, no "Sign in" button)
camofox snapshot --user gemini

# Type image prompt
camofox type <prompt-ref> "your image description here" --user gemini

# Submit prompt
camofox press Enter --user gemini

# Wait for image generation to complete (15-180 seconds)
camofox wait 'mat-icon[fonticon="download"]' --timeout 180000 --user gemini

# Download the generated image
camofox click 'mat-icon[fonticon="download"]' --user gemini

# Cleanup
camofox close --user gemini

3. 認証フロー

ステップ 3.1：認証状態を確認する

camofox open https://gemini.google.com/app --user gemini
camofox snapshot --user gemini
# Look for: "Sign in" button -> NOT authenticated
# Look for: Greeting text "Xin chào..." -> authenticated

ステップ 3.2：ログインする（必要な場合）

# Navigate to Google login
camofox navigate https://accounts.google.com --user gemini

# Enter email
camofox fill '[e1]="[email protected]"' --user gemini
# OR
camofox type e1 "[email protected]" --user gemini
camofox click e4 --user gemini  # Next button

# Wait for password page
camofox wait 'input[type="password"]' --user gemini
camofox snapshot --user gemini

# Enter password
camofox type e2 "password" --user gemini
camofox click e4 --user gemini  # Next button

セキュリティに関するヒント： 本番環境のワークフローでは、認証情報を CamoFox Auth Vault に保存してください。

camofox auth save google-gemini
# Follow interactive prompts to save credentials securely
camofox auth load google-gemini --user gemini

ステップ 3.3：2FA（プッシュ通知）

パスワードを入力した後、Google から 2FA を求められる場合があります。

• プッシュ通知：スマートフォンのアプリで「はい」をタップします。
• リダイレクトを待ちます。

camofox wait 'a[href*="myaccount.google.com"]' --timeout 90000 --user gemini

• または、accounts.google.com から URL が変わるまで待ちます。

camofox wait navigation --timeout 90000 --user gemini

ステップ 3.4：セッションを保存する

camofox session save <profile-name> --user gemini
# Reuse next time with: camofox session load <profile-name> --user gemini

4. 画像生成

# Navigate to Gemini (if not already there)
camofox navigate https://gemini.google.com/app --user gemini

# Snapshot to find prompt input ref
camofox snapshot --user gemini
# Prompt textbox is typically the main textarea element

# Type your image description
camofox type <prompt-ref> "Generate an image of a cute red fox wearing sunglasses in digital art style" --user gemini

# Submit the prompt
camofox press Enter --user gemini

# Wait for generation to complete (15-180 seconds)
# The download button appears when generation is done
camofox wait 'mat-icon[fonticon="download"]' --timeout 180000 --user gemini

# Verify the result
camofox snapshot --user gemini
# Key refs after generation:
# - Download button (mat-icon fonticon="download")
# - Like (mat-icon fonticon="thumb_up")
# - Dislike (mat-icon fonticon="thumb_down")
# - Redo
# - Share

5. 生成した画像をダウンロードする

# Click download button (locale-independent CSS selector)
camofox click 'mat-icon[fonticon="download"]' --user gemini

# Check download status
camofox downloads --format json --user gemini
# Parse `downloadId` from JSON output (for example with `jq -r '.[0].id'`)

# Retrieve the file via REST API
# The click response or downloads command shows the download ID
curl -o "generated-image.png" "http://localhost:9377/downloads/<download-id>/content?userId=gemini"

# Cleanup
camofox close --user gemini

6. ヒントとベストプラクティス

• セッションの再利用：ログイン後は必ずプロファイルを保存してください。実行のたびに読み込めば、ログインを省略できます。
• ロケールに依存しないセレクター：テキストラベルではなく、mat-icon[fonticon="..."] を使用してください。
• 固定時間の待機ではなく、条件を待つ：固定の遅延ではなく、CSS セレクターを指定して camofox wait を使用してください。
• 操作後にスナップショットを再取得する：ナビゲーションや操作の後は、要素参照（eN）が変わります。
• 画像生成プロンプト：詳しく記述してください。Gemini は詳細なプロンプトでより良い結果を出します。
• レート制限：無料プランでは、1 日あたりの画像生成回数に上限があります。上限に達した場合は、待つか別のアカウントに切り替えてください。

7. エラーからの復旧

エラー	解決方法
セッション読み込み後も「ログイン」が表示される	セッションの有効期限が切れています（24～48 時間）。メールアドレスとパスワードを入力して、2FA で再ログインしてください
ダウンロードボタンの wait がタイムアウトする	画像生成に失敗した可能性があります。camofox snapshot を実行して、エラーテキストを確認してください
「今は作成できません」	認証されていません。認証状態を再確認し、もう一度ログインしてください
「画像生成の上限に達しました」	1 日あたりの上限に達しています。24 時間待つか、別のアカウントを使用してください
TAB_NOT_FOUND	タブが無効になっています。camofox open で新しいタブを開いてください
type でテキストを入力できない	Gemini はカスタムエディターを使用している可能性があります。代替手段：camofox eval 'document.querySelector(".ql-editor").innerHTML = "prompt"'

8. 検証済みテスト結果

• アカウント：[email protected]（ユーザー）
• プロファイル：gemini-sky（Cookie 52 個）
• テストプロンプト：Generate an image of a cute red fox wearing sunglasses in digital art style
• 結果：8.1MB PNG（Gemini_Generated_Image_ecu3ujecu3ujecu3.png）
• 生成時間：約30秒
• ダウンロード方法：click mat-icon[fonticon="download"]