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` 会显示两个提供商各自剩余的可用额度。