使用 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 <task> -h 获取更多信息。
仅当用户要求特定提供商时使用:imagegenkit openai|grok|codex|xai|gemini|<other> "提示词" 或 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 中看到使用情况、花费和所有生成的内容。当用户说“像上次一样”时,从日志中复用之前的提示词。