使用 imagegenkit 的影像處理
imagegenkit 由 ImageGenKit 應用程式或安裝程式置於 ~/.local/bin/imagegenkit。提供者、金鑰、預設值以及哪個提供者處理哪項任務，皆為使用者在 ImageGenKit 中的設定。除非使用者指定提供者名稱，否則請勿硬編碼特定提供者。
選擇任務
imagegenkit draft "提示詞" -o out.jpg # 快速模擬、創意構想、草稿（最便宜）
imagegenkit final "提示詞" -o out.png # 最終設計與最終等級的模擬圖
imagegenkit edit "提示詞" -i in.png -o out.png # 編輯或改善影像（重複 -i 可結合多張）
imagegenkit transparent "提示詞" -o out.png # 透明 PNG：Logo、貼紙、去背圖
常用選項：--aspect 16:9、-n 2、-i ref.png、-f prompt.txt、--dry-run。執行 imagegenkit <任務> -h 取得更多資訊。
僅在使用者要求特定提供者時：imagegenkit openai|grok|codex|xai|gemini|<其他> "提示詞" 或 imagegenkit draft -p openai ...
規則
- 會話開始時： 執行一次
imagegenkit providers。如果沒有任何提供者就緒，請使用者開啟 ImageGenKit › 設定 › 提供者。絕對不要在聊天中要求 API 金鑰、不要列印金鑰，也不要把金鑰寫入檔案。 - 選擇最低成本且適合的任務。 創意與草稿使用
draft。僅在完成作品時使用final。預設使用-n 1，若一次超過約 6 張付費影像，請先詢問使用者。 - 將草稿轉為最終成果： 使用
-i將草稿傳入edit或final。 - 精確文字、數字或 UI 文案： 若需完全精確（圖表、示意圖、真實 UI），請改用 HTML/SVG 建構。
- 先檢查再回報： 開啟影像檢查拼字、手部、臉部、Logo、裁切與畫面比例。如有需要，使用
edit修正。回報儲存路徑並稱之為已產生的草稿。 - 專案資產： 直接寫入專案的資產資料夾，並使用合理名稱。除非使用者要求，否則不要覆寫現有檔案。現有輸出絕不會被覆寫；
imagegenkit會自動加上-2、-3等後綴。 - 提示詞： 2–5 句平實散文，涵蓋主體、場景、風格、構圖與光線。將需要出現的文字放在引號中。對於編輯任務，需說明哪些部分應保持不變。
- 錯誤處理： 閱讀提供者的訊息並據此調整；不要盲目重試。若遇到內容審核封鎖，應停止操作並告知使用者。
- 每月限制： 使用者可在 ImageGenKit 中設定花費或影像數量限制。若
imagegenkit顯示已達限制，請告知使用者且不要繞過限制（不要使用-p切換提供者，也不要直接呼叫原始 API）。訂閱制服務（Grok、Codex）會繼續運作；任務指令會自動切換到這些提供者。執行imagegenkit usage可查看本月花費與限制。
輸出
儲存路徑會輸出到標準輸出，每行一個。若未指定 -o，檔案會儲存到 ~/Pictures/ImageGenKit/<日期>/。每次執行都會記錄到 ~/.config/imagegenkit/log.jsonl，使用者可在 ImageGenKit 中查看使用量、成本及所有產生的內容。當使用者說「像上次一樣」時，可從日誌中重複使用提示詞。