pixellab-cli

pixellab-cli 是用於生成 2D 遊戲素材的命令列工具。它通過 PixelLab 的 REST v2 API 生成精靈圖、八方向旋轉的角色、動畫、圖塊集、UI 面板、畫素字型和肖像，而概念圖和包裝盒美術則來自 fal 上的 GPT Image 2.5。該工具需要 uv 和 Python 3.12 或更高版本，使用 `uv tool install pixellab-cli` 安裝。設定由 `pixellab-cli setup` 完成，它會列出檢測到的智慧體框架（如 Claude Code、Codex 和 opencode），把技能安裝到各框架讀取的位置，並詢問尚未設定的憑據。憑據來自兩個提供商：來自 PixelLab 賬號頁面的 PIXELLAB_SECRET，以及來自 fal 控制台的 FAL_KEY。二者既可放在環境變數中，也可放在 .pixellab.json 檔案中，每個憑據會依次查詢四個位置，先找到者優先。每次產生費用的呼叫都會在發起前估算費用，在完成後記錄，並寫入磁碟，旁邊附有說明檔案如何生成的清單。沒有 --yes，任何付費路徑都不會執行；若不帶它，命令會列印將要呼叫什麼、將要傳送什麼以及預估費用，但不會發送任何內容。該工具可以建立角色、為其製作動畫、生成圖塊集、物件、UI 面板、字型和包裝盒美術，並支援在兩個提供商之間按順序串聯步驟的配方。輸出會放入 pixellab-out 目錄，其中包含 ledger.jsonl 和每次執行的清單，且絕不會覆蓋任何內容。賬本在每次呼叫發起前和完成後都會各記錄一次，`pixellab-cli balance` 會顯示兩個提供商各自剩餘的可用額度。