# Image Render

配图出图 - 给文章配图：定好每张图讲什么、图上逐字写什么，用你的默认风格（第一次从带样张的风格库里看图选）为每张图设计画面，交给 Codex 内置 imagegen...

- Repository: https://github.com/yunshu0909/yunshu_skillshub (788 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-11
- Runs scripts: yes, review before use

## Install

Claude Code: `npx skills add yunshu0909/yunshu_skillshub --skill image-render -g -a claude-code -y`
Codex: `npx skills add yunshu0909/yunshu_skillshub --skill image-render -g -a codex -y`
Cursor: `npx skills add yunshu0909/yunshu_skillshub --skill image-render -g -a cursor -y`
Gemini CLI: `npx skills add yunshu0909/yunshu_skillshub --skill image-render -g -a gemini-cli -y`

## Description

配图出图 - 给文章配图：定好每张图讲什么、图上逐字写什么，用你的默认风格（第一次从带样张的风格库里看图选）为每张图设计画面，交给 Codex 内置 imagegen 原样出图，生成可标记喜欢的对比页。支持探索（一张图试几种风格）、量产（默认风格出整套）和新增自己的风格。当用户说「给这篇文章配图」「出几张图」「用 XX 风格出图」「换默认风格」「加个新风格」时触发。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 配图出图（image-render）

把文章变成一套风格统一的配图。Claude 负责想清楚画什么、图上写哪些字；Codex 只负责把提示词原样交给 imagegen 出图；脚本负责检查和核对。

下文 `S` 指本 skill 的脚本目录（本文件所在目录下的 `scripts/`）：

```bash
S=<本 SKILL.md 所在目录>/scripts
```

## 第一次用

1. `python3 $S/doctor.py`：环境自检（Codex 装没装、登没登录、Python）。有 ✗ 先按提示补。
2. 没有默认风格时，开风格选择页让用户看图选（见下面「默认风格」）。

## 默认风格

风格 = 有样张的风格，用户看图选。选一次存成默认，之后每次直接用，不再每次问。

| 用户说 | 怎么做 |
|---|---|
| （开工时） | `python3 $S/settings.py get style`。打印出编号 → 告诉用户「本次用默认风格 X（编号 · 名字），要换说一声」，直接往下做。**什么都没打印 = 还没设**，走「第一次选」 |
| 第一次选 / 「换默认风格」 | 先把画面单给用户确认，再 `python3 $S/style_picker.py <任务目录>/风格选择.html` 并打开；用户报编号（或贴回 ♡ 复制的内容）就视为选定默认 → `python3 $S/settings.py set style <编号>` |
| 「这次用 N42」 | 只这一次用，**不改设置**：adapt 文件名里写这个编号（如 `1-N42.txt`）。**真正决定用哪张风格卡的是文件名里的编号**；`scenes.md` 顶部写一行「本次风格：N42」只是备忘 |
| 「给我几个风格看看」 | 探索：选 3, 4 种（`reference/recommend.md` 按内容类型推荐），用用户自己的同一张图各出一版对比；用户选中的可以设成新默认 |
| 「你推荐」 | 才参考 `reference/recommend.md` 和 `reference/taste.md`（作者口味） |

设置存在 `~/.image-render/settings.json`，升级 skill 不会被覆盖；家目录写不进时（Codex 沙盒）自动存到当前项目的 `.image-render/`，以后在这个项目里用会自动读到；也可以用环境变量 `IMAGE_RENDER_HOME` 指定。

## 流程

| 步 | 做什么 | 谁 | 详细 |
|---|---|---|---|
| 1 画面单 | 每张图：画幅 / 用途、讲什么、内容类型、必含文字（「」包住）。写完给用户确认（用户说「直接做」可跳过） | Claude → 用户 | `stages/01-scenes.md` |
| 2 定风格 | 默认风格；没有就看图选；探索时选 3, 4 种 | 用户 | `stages/02-pick-style.md` |
| 3 风格适配 | **核心**：按风格卡的叙事语法为每张图重新设计场景、比喻、文字载体 | Claude | `stages/03-adapt.md` |
| 4 出图 | 检查 → 拼提示词 → Codex 原样出图 → 核对提示词逐字。**第一次用或刚换默认风格：先只出第 1 张给用户看，满意再出剩下的** | 脚本 + Codex | `stages/04-render.md` |
| 5 挑图与迭代 | Claude 先逐张看图上的字；对比页给用户标 ♡；不满意一次只改一处；选中的图写回样张 | Claude → 用户 | `stages/05-review.md` |

## 新增风格

用户想要库里没有的风格（给一句描述或一张参考图）：

The rest: https://github.com/yunshu0909/yunshu_skillshub/blob/HEAD/visualization/image-render/SKILL.md