banana-cog

香蕉齿轮 × CellCog。通过 CellCog 的推理和编排层在 Nano Banana 上执行复杂的多图像作业。一次提示即可显示 10-20 个连贯图像、跨场景的字符一致性以及生产级构图 - 任何 OpenClaw 代理都可以访问。 Nano Banana AI、Nano Banana Pro、Gemini 图像生成。

# Banana Cog — Nano Banana × CellCog

**Nano Banana × CellCog.** Complex multi-image jobs, executed perfectly, from a single prompt.

Nano Banana is an incredible image model. CellCog makes it do things you can't do by calling it directly — orchestrating 10, 20, even 30 coherent images in one request with consistent characters, planned compositions, and intelligent scene progression. Not single images — complete visual projects.

**What CellCog adds on top of Nano Banana:**

```
Reasoning → Scene Planning → Character Design → Image Generation
    → Consistency Verification → Composition Review → Delivery
```

CellCog's reasoning layer plans scenes before a single pixel is generated — selecting optimal parameters, maintaining character identity across sequences, and orchestrating complex multi-image workflows. This is the difference between "generate an image" and "execute a visual project."

---

## Prerequisites

This skill requires the `cellcog` skill for SDK setup and API calls.

```bash
clawhub install cellcog
```

**Read the cellcog skill first** for SDK setup. This skill shows you what's possible.

**Quick pattern (v1.0+):**
```python
result = client.create_chat(
    prompt="[your image request]",
    notify_session_key="agent:main:main",
    task_label="image-task",
    chat_mode="agent"
)
```

---

## What You Can Create

### Photorealistic Image Generation

Create stunning images from text descriptions:

- **Portraits**: "Create a professional headshot with warm studio lighting"
- **Product Shots**: "Generate a hero image for a premium smartwatch on a dark surface"
- **Scenes**: "Create a cozy autumn café interior with morning light"
- **Food Photography**: "Generate an overhead shot of a colorful Buddha bowl"

### Character Consistency

Nano Banana excels at maintaining character identity across multiple images — and CellCog's orchestration takes this further by planning entire character arcs:

- **Character Series**: "Create a tech entrepreneur character, then show them in 4 different scenes"
- **Brand Mascots**: "Design a mascot and generate it in multiple poses and contexts"
- **Story Sequences**: "Create a character and illustrate them across 5 story beats"

### Multi-Image Composition

Blend elements from multiple reference images:

- **Style Fusion**: "Combine the color palette of image A with the composition of image B"
- **Character Placement**: "Place this person into a new environment while preserving their likeness"
- **Product Mockups**: "Put this product into a lifestyle setting"

### Image Editing

Transform and enhance existing images:

- **Style Transfer**: "Transform this photo into a Studio Ghibli illustration"
- **Background Swap**: "Place this product on a clean marble surface"
- **Enhancement**: "Add dramatic lighting and cinematic color grading"
- **Modification**: "Change the season from summer to winter in this landscape"

---

## Image Specifications

| Aspect | Options |
|--------|---------|
| **Aspect Ratios** | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 |
| **Sizes** | 1K (~1024px), 2K (~2048px), 4K (~4096px) |
| **Styles** | Photorealistic, illustration, watercolor, oil painting, anime, digital art, vector |

---

## Chat Mode

| Scenario | Recommended Mode |
|----------|------------------|
| Single images, quick edits | `"agent"` |
| Character-consistent series, complex compositions | `"agent"` |
| Large sets with brand guidelines | `"agent team"` |

**Use `"agent"` for most image work.**

---

## Tips for Better Images

1. **Be descriptive**: "Woman in office" → "Confident woman in her 40s, silver blazer, modern glass-walled office, warm afternoon light"

2. **Specify style**: "photorealistic", "digital illustration", "watercolor", "anime"

3. **Describe lighting**: "Soft natural light", "dramatic side lighting", "golden hour glow"

4. **For character consistency**: Describe the character in detail first, then reference "the same character" in subsequent prompts.

5. **Include composition**: "Rule of thirds", "close-up portrait", "wide establishing shot"

---

## 中文说明

# Banana Cog — Nano Banana × CellCog

**Nano Banana × CellCog。** 复杂的多图像作业，从单一提示词完美执行。

Nano Banana 是一个出色的图像模型。CellCog 让它做到直接调用所无法实现的事情——在一次请求中编排 10、20 甚至 30 张连贯的图像，具有一致的角色、规划好的构图和智能的场景推进。不是单张图像——而是完整的视觉项目。

**CellCog 在 Nano Banana 之上增加的内容：**

```
Reasoning → Scene Planning → Character Design → Image Generation
    → Consistency Verification → Composition Review → Delivery
```

CellCog 的推理层在生成任何一个像素之前就规划好场景——选择最优参数、跨序列保持角色身份一致，并编排复杂的多图像工作流。这就是"生成一张图像"与"执行一个视觉项目"之间的区别。

---

## 前置条件

此技能需要 `cellcog` 技能来进行 SDK 设置和 API 调用。

```bash
clawhub install cellcog
```

**请先阅读 cellcog 技能** 以了解 SDK 设置。本技能向你展示有哪些可能性。

**快速模式（v1.0+）：**
```python
result = client.create_chat(
    prompt="[your image request]",
    notify_session_key="agent:main:main",
    task_label="image-task",
    chat_mode="agent"
)
```

---

## 你可以创建什么

### 照片级真实感图像生成

从文本描述创建惊艳的图像：

- **肖像**："Create a professional headshot with warm studio lighting"
- **产品照片**："Generate a hero image for a premium smartwatch on a dark surface"
- **场景**："Create a cozy autumn café interior with morning light"
- **美食摄影**："Generate an overhead shot of a colorful Buddha bowl"

### 角色一致性

Nano Banana 擅长跨多张图像保持角色身份一致——而 CellCog 的编排通过规划整个角色弧线将这一点进一步提升：

- **角色系列**："Create a tech entrepreneur character, then show them in 4 different scenes"
- **品牌吉祥物**："Design a mascot and generate it in multiple poses and contexts"
- **故事序列**："Create a character and illustrate them across 5 story beats"

### 多图像合成

混合来自多张参考图像的元素：

- **风格融合**："Combine the color palette of image A with the composition of image B"
- **角色放置**："Place this person into a new environment while preserving their likeness"
- **产品样机**："Put this product into a lifestyle setting"

### 图像编辑

转换并增强现有图像：

- **风格迁移**："Transform this photo into a Studio Ghibli illustration"
- **背景替换**："Place this product on a clean marble surface"
- **增强**："Add dramatic lighting and cinematic color grading"
- **修改**："Change the season from summer to winter in this landscape"

---

## 图像规格

| 方面 | 选项 |
|--------|---------|
| **宽高比** | 1:1, 16:9, 9:16, 4:3, 3:4, 3:2, 2:3, 21:9 |
| **尺寸** | 1K (~1024px), 2K (~2048px), 4K (~4096px) |
| **风格** | 照片级真实感、插图、水彩、油画、动漫、数字艺术、矢量 |

---

## 聊天模式

| 场景 | 推荐模式 |
|----------|------------------|
| 单张图像、快速编辑 | `"agent"` |
| 角色一致的系列、复杂构图 | `"agent"` |
| 带品牌指南的大型图集 | `"agent team"` |

**大多数图像工作请使用 `"agent"`。**

---

## 获得更佳图像的技巧

1. **要有描述性**："Woman in office" → "Confident woman in her 40s, silver blazer, modern glass-walled office, warm afternoon light"

2. **指定风格**："photorealistic"、"digital illustration"、"watercolor"、"anime"

3. **描述光照**："Soft natural light"、"dramatic side lighting"、"golden hour glow"

4. **为保持角色一致**：先详细描述角色，然后在后续提示词中引用 "the same character"。

5. **包含构图**："Rule of thirds"、"close-up portrait"、"wide establishing shot"