调用 muapi/Nano-Banana 生成图像时…

适用于使用 muapi.ai 的 Nano-Banana/Gemini 3 风格图像生成前，将用户提示整理成包含主体、动作、环境、构图、光照、风格及物理/文本/光学约束的推理简报。

适用场景

解决思路

1. 使用推理驱动提示：用自然语言逻辑定义物理、光照和空间关系。
2. 使用结构化创意简报：实现 “Perfect Prompt” 公式：`Subject + Action + Context + Composition + Lighting + Style`。
3. `Subject`：填写详细实体描述。
4. `Action`：填写动态交互。
5. `Context`：填写环境与氛围。
6. `Composition`：填写相机与镜头选择。
7. `Lighting`：填写情绪与方向。
8. `Style`：填写美学锚点。
9. 文本渲染精度：明确指定排版和标识符，以便文本清晰整合。
10. 上下文接地：使用 “Search Grounding” 逻辑（模拟），将生成锚定到现实准确性。
11. 负向约束逻辑：不要写 “no blurry”，改写为 “Ensure sharp focus on the subject's eyes.”。
12. 身份一致性：模拟 “Maintain consistent facial structure across variations.”。
13. 文本集成：用双引号指定具体文本，例如 `The sign reads "OPEN 24/7"`。
14. 调用脚本前，Agent 必须将用户提示改写为逻辑驱动的 Reasoning Brief。
15. 禁止关键词堆砌：移除 “8k, masterpiece, ultra-detailed.”，使用完整、描述性的句子。
16. 物理一致性：描述元素如何交互，例如 “The light from the crystal shards casts caustic patterns across the obsidian floor”。
17. 文本精度：如果用户想要文本，精确定义，例如 `featuring a sign that says "STORE NAME" in a weathered serif font`。
18. 光学指令：指定镜头行为，如 Shallow Depth of Field (f/1.8)、Macro Lens、Anamorphic Flare。
19. Step 1：定义创意逻辑：向 agent 提供主体和具体场景。
20. Step 2：调用脚本：`generate-nano-art.sh` 将逻辑转换为结构化 Gemini 3-style prompt。
21. 执行命令：`bash scripts/generate-nano-art.sh --subject "a glass chess piece" --action "shattering into liquid shards" --context "on a obsidian table" --style "macro photography"`。
22. 强制禁止关键词堆砌：不要使用 “trending on artstation, masterpiece, 8k”，使用自然语言描述。
23. 物理逻辑：确保提示描述物理上可能的光照和反射交互。
24. 完整句子：模型解析关系；使用 “light reflecting off the water” 而不是 “water, reflection”。
25. 实现细节：在 `core/media/generate-image.sh` primitive 外层应用 “Logic Wrapper”，将碎片化输入转换为连贯、可推理的叙事提示。

适用边界 · 注意事项

• 不适用于不使用 muapi.ai、Nano-Banana 或 `generate-nano-art.sh` 的图像生成流程。
• 不适用于不需要物理一致性、文本渲染精度、镜头/光照控制或身份一致性的简单图像生成。
• 未配置 `generate-nano-art.sh`、`core/media/generate-image.sh` 或 muapi.ai 访问权限时。