xiaohei-illustrations

name	xiaohei-illustrations
description	生成墨筝风格的小黑正文配图。用于用户要求为中文文章、帖子、博客、工作流文档、方法论、流程、结构、状态、隐喻或观点生成”怪诞””小黑””手绘””正文配图””文章插图””配图建议””shot list””去标题/改图”等任务；默认使用小黑 IP、纯白手绘、筝弦金为主强调色、简洁清爽但天马行空的视觉风格。

小黑怪诞正文配图

核心定位

为中文文章设计和生成 16:9 横版正文配图。目标不是做商业插画、PPT 信息图或可爱卡通，而是把文章里的关键判断、流程、结构、状态或隐喻，变成一张清爽、怪诞、有创意、可读但不说明书的手绘解释图。

默认视觉 IP 是“小黑”：黑色实心、白点眼、细腿、空表情，认真做一件荒诞但成立的事。小黑必须参与画面的核心动作，不能只是站在旁边当装饰。

先读这些参考

按任务需要读取，不要一次塞满上下文：

• references/style-dna.md：风格 DNA、颜色、文字、禁忌。
• references/xiaohei-ip.md：小黑 IP 的形象、性格、动作库和禁忌。
• references/composition-patterns.md：结构类型、原创隐喻方法和反复刻规则。
• references/prompt-template.md：单张生图提示词模板。
• references/qa-checklist.md：生成后检查和迭代规则。
• assets/examples/：只作低频视觉校准，不进入默认生成路径。不要照抄这些案例的构图、物件或标注。

工作流

1. 消化正文

先读用户给的正文、链接、Notion 页面、Markdown 文件或截图内容。提炼：

• 核心观点是什么
• 哪些段落承担认知转折
• 哪些内容适合用图解释
• 哪些地方只适合文字，不需要图

不要平均配图。优先选择“认知锚点”，例如：核心判断、两个断点、输入输出闭环、分流、前后对比、一鱼多吃、承接路径、常见坑、角色状态变化。

2. 先出配图策略

如果用户只是说“分析怎么配图 / 思考哪些地方需要配图”，先给 shot list。每张图写清楚：

• 放在哪个段落后
• 图的主题
• 核心意思
• 结构类型
• 小黑在图里做什么
• 建议元素
• 建议中文标注词

默认 4-8 张。文章很短时 1-3 张；长文也不要轻易超过 9 张。够用就好，避免把正文做成画册。

3. 单张生成

如果用户明确要求”生成 / 输出 / 做图 / 帮我生成”，不要停下来等确认；按 references/prompt-template.md 模板填充提示词，调用 TopView API 生图脚本逐张生成。不要把多张图拼在一张里。

生成方式：使用 content-pipeline 的 topview_image_gen.py 脚本调用 TopView AI API（GPT Image 2 模型，16:9，2K 分辨率）。

# 单张
python3 “${CONTENT_PIPELINE_DIR}/scripts/topview_image_gen.py” \
  --prompt “<填充后的完整提示词>” \
  --output “content/<slug>/xiaohei-illustrations/01-topic-name.png”

# 批量（先将 shot list 的 prompt 写入 JSON）
python3 “${CONTENT_PIPELINE_DIR}/scripts/topview_image_gen.py” \
  --batch shot-list.json \
  --output-dir “content/<slug>/xiaohei-illustrations/”

batch JSON 格式：

[
  {“filename”: “01-topic-name.png”, “prompt”: “Generate one standalone 16:9 ...”},
  {“filename”: “02-topic-name.png”, “prompt”: “...”}
]

每张图只讲一个核心结构。提示词必须包含：

• 16:9 横版中文正文配图
• 纯白背景
• 黑色手绘线稿
• 少量筝弦金（#A07848 白底加深版）/红色/蓝色中文手写批注
• 大量留白
• 小黑作为核心动作主体
• 禁止 PPT、商业插画、幼稚可爱、复杂架构、左上角类型标题

不要复刻过往案例。案例只提供风格密度和小黑参与方式，不能直接复用”传送带断点 / 小黑拉线 / 素材鱼 / 盖章工具箱 / 常见坑路径”等已有构图，除非用户明确要求复刻某张图。每次都要从当前文章重新发明一个奇怪但成立的隐喻。

4. 检查与迭代

生成后检查 references/qa-checklist.md。如果出现以下问题，优先重生成或局部编辑：

• 小黑只是装饰
• 画面太满
• 太像流程图/PPT
• 中文太多或错字严重
• 左上角出现“常见坑/流程图/系统架构图”等标题
• 画风太可爱、幼稚、死板
• 背景不是干净白底

5. 保存交付

配图直接生成到 content-pipeline 的产物目录：

content/<slug>/xiaohei-illustrations/

按顺序命名：

01-topic-name.png
02-topic-name.png

保留原始生成文件，不要覆盖已有资产，除非用户明确要求替换。

环境变量

生图依赖 TopView AI API，需要设置：

export TOPVIEW_API_KEY='your-api-key'
export TOPVIEW_UID='your-user-id'

脚本位置：content-pipeline/scripts/topview_image_gen.py（与 content-pipeline skill 共享）。

输出口径

生成前的策略输出要短而准。生成后的交付要包含：

• 生成了几张
• 每张图的用途
• 保存路径
• 哪些图最稳，哪些图是可选

不要长篇解释风格理论；让图自己说话。