Nano Img CLI

适用场景

当任务明确涉及本仓库中的本地 nano-img 或 nano-image CLI 工具，或其在用户主目录下的默认配置路径 ~/.nano-img 时，请使用该技能。

包命名说明：

• NPM 包名：nanobana
• 安装后可用命令：nano-img、nano-image

典型触发语句：

• “使用 nano-img 生成一张图像”
• “设置 nano-img 使用的模型”
• “将图像保存至默认文件夹”
• “使用 ~/.nano-img/assets 中的 refs”
• “查看 nano-img 支持的功能”
• “修复或检查 nano-img 的配置”

请勿将此技能用于与该 CLI 无关的通用 Gemini API 设计讨论。

执行模式

优先使用已安装的二进制命令（如存在）：

• nano-img
• nano-image

若你在本仓库内开发，且不希望依赖全局软链接，则可使用：

• npm run dev --
• npm run nano-img --

核心工作流程

1. 首先检查确切的命令接口，而非假设参数标志。使用 nano-img help 获取全局帮助，或使用 nano-img --help 获取具体子命令的帮助信息。
2. 若任务涉及图像生成，请先检查相关已保存的默认配置（如有必要）。运行 nano-img config --json 查看当前配置。
3. 若任务依赖已保存的模型或输出目录，请优先使用专用命令进行设置，而非手动编辑配置文件：
   • nano-img model ...
   • nano-img save-dir ...
4. 若任务依赖可复用的提示词（prompt）或风格定义，请使用主目录下的对应文件：
   • ~/.nano-img/INSTRUCTION.md
   • ~/.nano-img/STYLE.md
   • ~/.nano-image/STYLE.md
5. 若任务使用默认参考图像，请检查 ~/.nano-img/assets 目录，并通过 nano-img refs --json 验证其状态。
6. 完成行为变更后，请用一个具体 CLI 命令验证效果，并记录生成的输出路径或配置状态。

图像生成

有关生成细节及命令示例，请参阅 references/command-reference.md。

关键规则：

• 除非用户明确要求使用简写 prompt 形式，否则请显式使用 generate 子命令。
• 尊重 ~/.nano-img/config.json 中保存的默认配置。
• 若用户传入 --save-to 或 --output 参数，则覆盖已保存的默认输出目录。
• 仅指定宽度或高度时，本地缩放将保持原始宽高比。
• 同时指定宽度和高度时，最终图像将被强制调整为所请求的确切尺寸。
• 图像格式默认为 png；jpg、jpeg 和 webp 格式可通过本地转换支持。

配置默认值

有关持久化设置与文件布局，请参阅 references/defaults-and-files.md。

推荐通过命令方式修改配置：

• 保存模型：nano-img model
• 交互式选择模型：nano-img models
• 设置默认输出目录：nano-img save-dir --set ""
• 清除已保存的输出目录：nano-img save-dir --clear-save-dir

除非用户明确要求手动编辑配置文件，否则请避免直接修改 ~/.nano-img/config.json。

故障排查

出现以下情况时，请查阅 references/troubleshooting.md：

• 图像生成失败
• 无法列出可用模型
• 模型选择器或配置显示异常
• 输出路径或 refs 未被正确使用

验证

完成配置更改或提供使用指导后，请执行以下验证步骤：

• 运行一条预期必然成功的典型命令
• 需要机器可读确认时，添加 --json 参数
• 在相关场景下，报告当前已保存的模型名称、输出目录路径或生成图像的具体文件路径