# Scipop Comic Xinghe

> 科普连环画自动生成工具 - 基于百度星河社区 API 的三阶段闭环创作系统。 TRIGGER when: 用户想要将科普文章/科学内容转化为连环画、漫画、视觉叙事； 用户提到"连环画"、"科普漫画"、"可视化科普"、"科学故事画"； 用户有科普内容需要视觉化呈现；用户提到"星河API"或"Ernie-image"生图。 不要触发: 用户只是想生成单张图片（非连环画）、用户要处理非科普类内容。

- Skill: `agenticaiplan/scipop-comic-xinghe` (Agent Skill, multi-file: 10 files)
- Install (CLI): `npx skillmds@latest add agenticaiplan/scipop-comic-xinghe`
- Raw SKILL.md: https://api.skillmd.com/api/skills/agenticaiplan/scipop-comic-xinghe/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: agenticaiplan (https://skillmd.com/u/agenticaiplan)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/agenticaiplan/scipop-comic-xinghe

---


# SciPop Comic Orchestrator（科普连环画编排器）

基于百度星河社区 API 的自动化科普连环画生成工具，实现多模态解析 × 单 Panel 精修 × N×N 全局合成的三阶段闭环创作。

---

## 环境配置

> 📖 详细 API 文档参见 [references/api_reference.md](references/api_reference.md)

### 必需条件

| 项目 | 要求 |
|------|------|
| **API Key** | 星河社区 API Key，环境变量 `AISTUDIO_API_KEY` |
| **API 端点** | `https://aistudio.baidu.com/llm/lmapi/v3/chat/completions` |
| **分析模型** | `ernie-5.0-thinking-preview`（原生全模态大模型） |
| **生图模型** | `ernie-image-turbo`（图像生成 API） |

### 配置验证

```bash
# 设置 API Key
export AISTUDIO_API_KEY="your-key"

# 验证连通性
curl -s https://aistudio.baidu.com/llm/lmapi/v3/chat/completions \n  -H "Content-Type: application/json" \n  -H "Authorization: Bearer $AISTUDIO_API_KEY" \n  -d '{"model": "ernie-5.0-thinking-preview", "messages": [{"role": "user", "content": "ping"}], "stream": true, "max_completion_tokens": 100}'
```

---

## 参考文档

| 文档 | 用途 |
|------|------|
| [references/api_reference.md](references/api_reference.md) | 星河社区 API 详细参考 |
| [references/article_analysis_prompts.md](references/article_analysis_prompts.md) | 文章解析提示词模板 |
| [references/ernie_image_prompt_guide.md](references/ernie_image_prompt_guide.md) | ERNIE-Image 提示词撰写指南 |
| [references/style_guide.md](references/style_guide.md) | 连环画风格设计指南 |

---

## 工作流程

### Phase 1: 文章解析与 Prompt 建模

**目标**: 将科普文章拆解为 4-6 个视觉场景，生成风格一致的图像 Prompt。

> 📖 详细规范参见 [references/article_analysis_prompts.md](references/article_analysis_prompts.md)

#### 提示词结构规范

**系统提示词模板**:

```
你是一位科普连环画脚本编写专家。分析文章并根据内容的丰富程度和结构确定最合适的 Panel 数量（4-6个）。输出一个 JSON 对象，包含四个字段："recommended_panels"（整数，4-6），"recommendation_reason"（一句话中文解释为什么这个 Panel 数量适合该文章），"style_seed"（简短的中文风格描述，在所有 Panel 中复用），"panels"（与推荐数量匹配的对象数组，每个对象包含 "id"、"scene" 中文场景描述、"image_prompt" 中文图像生成提示）。仅输出原始 JSON，不要使用 markdown 代码块。
```

**image_prompt 撰写规范**（详见 [references/ernie_image_prompt_guide.md](references/ernie_image_prompt_guide.md)）：

```
{主体特征}，{动作姿态}，{环境背景}，{细节元素}，{风格关键词}，{质量标签}
```

**示例**：
```
一位戴眼镜的女科学家，穿着白色实验服，正激动地指着屏幕，现代实验室背景有显微镜和电脑，屏幕上显示橙红色的黑洞光环图像，扁平插画风格，清晰轮廓，科学配色，高质量，连环画
```

#### Panel 数量决策规则

| Panel数 | 适用场景 |
|--------|---------|
| 4 | 内容简洁，结构清晰，有明确的起承转合 |
| 5 | 内容适中，需要一个过渡或高潮格 |
| 6 | 内容丰富，知识点多，需要完整叙事链 |

#### 风格种子设计规范

> 📖 详细规范参见 [references/style_guide.md](references/style_guide.md)

**格式**: `{画风}，{色调}，{线条/质感}，{氛围}`

| 主题类型 | 推荐风格种子 |
|---------|-------------|
| 天文/物理 | 扁平插画风格，深邃太空蓝配色，清晰轮廓，科学严谨氛围 |
| 生物/医学 | 可爱卡通风，柔和粉彩配色，圆润造型，温馨友好 |
| 环境/生态 | 水彩手绘风，清新自然色调，柔和笔触，生态感 |
| 科技/AI | 赛博朋克风格，霓虹光效，高科技质感，未来感 |
| 科学史 | 复古连环画风，怀旧暖色调，经典漫画风格 |

**步骤**:
1. 接收用户提供的科普文章全文
2. 调用 `ernie-5.0-thinking-preview` 进行解析
3. 向用户展示推荐的 Panel 数量及理由，获取确认

**API 调用模板**:

```bash
curl -s https://aistudio.baidu.com/llm/lmapi/v3/chat/completions \n  -H "Content-Type: application/json" \n  -H "Authorization: Bearer $AISTUDIO_API_KEY" \n  -d '{
    "model": "ernie-5.0-thinking-preview",
    "messages": [
      {
        "role": "system",
        "content": "你是一位科普连环画脚本编写专家。分析文章并根据内容的丰富程度和结构确定最合适的 Panel 数量（4-6个）。输出一个 JSON 对象，包含四个字段："recommended_panels"（整数，4-6），"recommendation_reason"（一句话中文解释为什么这个 Panel 数量适合该文章），"style_seed"（简短的中文风格描述，在所有 Panel 中复用），"panels"（与推荐数量匹配的对象数组，每个对象包含 "id"、"scene" 中文场景描述、"image_prompt" 中文图像生成提示）。仅输出原始 JSON，不要使用 markdown 代码块。"
      },
      {
        "role": "user",
        "content": "【科普文章全文】"
      }
    ],
    "stream": true,
    "response_format": {"type": "json_object"},
    "max_completion_tokens": 65536
  }'
```

**返回结构**:

```json
{
  "recommended_panels": 5,
  "recommendation_reason": "文章涵盖五个层次，5格可完整呈现叙事弧线。",
  "style_seed": "扁平插画风格，柔和粉彩配色，清晰轮廓，2D矢量艺术",
  "panels": [
    {
      "id": 1,
      "scene": "场景描述",
      "image_prompt": "中文图像生成提示，描述画面内容、风格、构图等"
    }
  ]
}
```

**用户确认**: 展示 `recommended_panels` 与 `recommendation_reason`，询问用户是否采用。若不同意，询问期望数量（4-6），调整 `panels` 数组。

---

### Phase 2: 单 Panel 图像生成与迭代

**目标**: 为每个 Panel 生成图像，支持用户反馈迭代优化。

> 📖 详细规范参见 [references/ernie_image_prompt_guide.md](references/ernie_image_prompt_guide.md)

#### 提示词撰写核心原则

1. **中文优先**: `ernie-image-turbo` 对中文 Prompt 效果最佳
2. **结构化描述**: 采用 `主体 → 动作 → 环境 → 风格` 的顺序
3. **具体胜于抽象**: 明确描述细节，避免模糊表述

#### Phase 2a: 图像生成

**关键规则**: 将 `style_seed` 追加到每个 `image_prompt` 末尾，保证风格一致。

```
{panel_image_prompt}，{style_seed}，高质量，连环画
```

**提示词长度建议**: 单 Panel 以 80-150 中文字符为宜

**API 调用模板**:

> 📖 详细 API 参数参见 [references/api_reference.md](references/api_reference.md#图像生成-api)

```bash
curl -s https://aistudio.baidu.com/llm/lmapi/v3/images/generations \n  -H "Content-Type: application/json" \n  -H "Authorization: Bearer $AISTUDIO_API_KEY" \n  -d '{
    "model": "ernie-image-turbo",
    "prompt": "【拼接后的完整Prompt】",
    "n": 1,
    "response_format": "b64_json",
    "size": "1024x1024",
    "use_pe": true,
    "num_inference_steps": 8,
    "guidance_scale": 1.0
  }'
```

**返回格式**: 图像以 base64 编码返回。

```json
{
  "created": 1234567890,
  "data": [{
    "b64_json": "iVBORw0KGgoAAAANSUhEUgA..."
  }]
}
```

**保存图像**:

```bash
# 从 JSON 提取 base64 并保存
echo "iVBORw0KGgoAAAANSUhEUgA..." | base64 -d > panel_01.png
```

#### Phase 2b: 多模态反馈迭代

若用户不满意，将图像 base64 + 用户反馈文字传入多模态模型获取改进建议。

**常见问题改进策略**（详见 [references/ernie_image_prompt_guide.md](references/ernie_image_prompt_guide.md#常见问题与解决方案)）：

| 问题类型 | 改进策略 |
|---------|---------|
| 风格不一致 | 强化 style_seed 关键词，添加"保持风格统一"指令 |
| 细节缺失 | 添加具体细节描述，如"带有XX标识"、"背景显示XX" |
| 角色变形 | 添加"比例协调"、"人体结构正确"等约束 |
| 色彩偏差 | 明确色调描述，如"主色调为深蓝色" |
| 构图混乱 | 添加构图指令，如"居中构图"、"三分法构图" |

```bash
IMAGE_B64=$(base64 -i panel_01.png | tr -d '\n')

curl -s https://aistudio.baidu.com/llm/lmapi/v3/chat/completions \n  -H "Content-Type: application/json" \n  -H "Authorization: Bearer $AISTUDIO_API_KEY" \n  -d "{
    "model": "ernie-5.0-thinking-preview",
    "messages": [{
      "role": "user",
      "content": [
        {"type": "image_url", "image_url": {"url": "data:image/png;base64,${IMAGE_B64}"}},
        {"type": "text", "text": "用户反馈：【用户反馈】\n\n分析图像与反馈之间的差距，仅返回改进后的中文图像生成提示，不需要解释，不要使用 markdown。"}
      ]
    }],
    "stream": true,
    "max_completion_tokens": 65536
  }"
```

**迭代循环**: 用改进后的 Prompt 重新执行 Phase 2a，直至用户满意。

---

### Phase 3: N×N 全局合成

**目标**: 将所有 Panel 合成为一张完整连环画长图。

> 📖 详细规范参见 [references/style_guide.md](references/style_guide.md)

#### Phase 3a: 布局确认

根据 Panel 数量推荐布局：

| Panel 数 | 推荐布局 | 说明 |
|---------|---------|------|
| 4 | `2×2` | 正方形，视觉均衡 |
| 5 | `2×3`（空出右下角）| 横向阅读，留白收尾 |
| 6 | `2×3` | 标准竖向长图 |

**阅读顺序**: 中文连环画采用从左到右、从上到下的阅读顺序。

向用户展示推荐布局，获取确认或自定义布局。

**布局合法性**: `行数 × 列数 ≥ Panel数`

#### Phase 3b: 全局 Prompt 构建

**提示词长度建议**: 全局合成以 200-400 中文字符为宜。

```
{grid} 格连环画，共 {num_panels} 格，{style_seed}，
每格之间用粗黑边框清晰分隔，按阅读顺序排列：
第1格：{panel_1_image_prompt}
第2格：{panel_2_image_prompt}
...
第N格：{panel_N_image_prompt}
```

若有空余格，末尾追加"剩余格子留白"。

#### Phase 3c: 大图生成

```bash
curl -s https://aistudio.baidu.com/llm/lmapi/v3/images/generations \n  -H "Content-Type: application/json" \n  -H "Authorization: Bearer $AISTUDIO_API_KEY" \n  -d '{
    "model": "ernie-image-turbo",
    "prompt": "【全局Prompt】",
    "n": 1,
    "response_format": "b64_json",
    "size": "2048x2048",
    "use_pe": true,
    "num_inference_steps": 8,
    "guidance_scale": 1.0
  }'
```

#### Phase 3d: 大图反馈迭代（可选）

若用户对大图有整体调整意见，使用多模态反馈路径重新生成。

---

## Style Seed 一致性机制

`style_seed` 由 Phase 1 生成，在后续所有调用中**保持原文不变**：

```
{panel_image_prompt}，{style_seed}，高质量，连环画
```

Phase 3 全局合成时，`style_seed` 置于 Prompt 首部强调，防止风格漂移。

---

## 错误处理

| HTTP 状态码 | 含义 | 处理策略 |
|------------|------|---------|
| `401` | API Key 无效 | 检查 `AISTUDIO_API_KEY` |
| `402` | 余额不足 | 登录星河社区控制台充值 |
| `429` | 请求频繁 | 指数退避重试：1s → 4s → 16s，最多3次 |
| `5xx` | 服务端错误 | 指数退避重试3次 |

---

## 执行检查清单

创建连环画时，按以下顺序执行：

1. **环境检查**: 确认 `AISTUDIO_API_KEY` 已设置
2. **Phase 1**: 解析文章 → 确认 Panel 数量 → 保存 `style_seed`
3. **Phase 2**: 逐个生成 Panel → 展示给用户 → 收集反馈 → 迭代优化
4. **Phase 3**: 确认布局 → 构建全局 Prompt → 生成大图 → 可选迭代
5. **交付**: 保存所有 Panel 图像及最终大图

---

## 常见问题

**Q: 多张图像风格不统一？**
检查每次调用是否将 `style_seed` 原文追加至 Prompt 末尾。

**Q: 支持中文 Prompt？**
`ernie-image-turbo` 对中文 Prompt 效果最佳。

**Q: base64 在 Windows 处理？**
PowerShell: `[Convert]::ToBase64String([IO.File]::ReadAllBytes("panel_01.png"))`