Article Illustrator 是一款为 Markdown 文章自动配图的技能，基于品牌素材和即梦 AI 图生图能力，自动生成并插入配图。
一、用途 该技能面向需要为 Markdown 文章批量、规范化配图的场景，尤其是要求配图与品牌视觉调性一致、且希望图文节奏自然的内容创作流程。
二、主要能力
- 读取品牌资产：加载品牌调性、视觉规范与素材索引。
- 分析文章结构：识别章节、叙事节奏、情感高潮点。
- 规划配图方案：确定配图数量、位置、每张图的场景描述。
- 匹配参考图：从实景素材中选择最相关的参考图。
- 上传参考图：通过 COS 图床获取公开 URL。
- 生成配图：调用即梦 /compositions 接口进行图生图。
- 审核选图：展示变体供用户选择，检查风格一致性。
- 插入文章：将选定图片插入 Markdown 对应位置。
三、使用前提
- 即梦 API 服务运行中（Docker: jimeng-free-api-all，端口 8000）
- 即梦 session ID 已配置（~/.nby-skills/nby-jimeng-api/.env）
- COS 图床可用（cos-uploader skill）
- 品牌资产文件存在（brand/brand-assets.md）
四、工作流程 步骤 1：读取品牌资产。查找品牌资产文件，提取视觉规范（主色调、摄影风格、传播调性）、调性词（用于生成提示词的关键词）和素材索引（实景照片路径）。如有素材分析文件（如 assets-analysis.yaml）一并读取。
步骤 2：分析文章结构。读取目标 Markdown 文章，分析章节数量和标题、叙事时间线、情感高潮点、已有图片。配图密度参考：3-5 个章节建议 3-4 张（每 1-2 个章节 1 张）；6-9 个章节建议 4-6 张（每 2-3 个章节 1 张）；10+ 个章节建议 5-7 张（每 2-3 个章节 1 张）。图片来源分配上，头图和尾图优先使用实景素材，中间场景图用即梦图生图，实景/AI 比例建议至少 40% 实景图。
步骤 3：生成提示词。采用图生图/修改指令式模板，关键原则包括：用修改指令而非场景描述（如“将这张照片改为夜晚”）；明确保留什么（如“保持所有家具、装修、摆设完全不变”）；强调真实感（如“保持真实摄影照片质感”）；不要过度描述。品牌调性融入方式示例：从容→构图留白不拥挤；懂你→人物姿态放松自然；在地→窗外可见小城风景；真实→真实摄影质感非 AI 绘画风格；舒展→光线柔和温暖。
步骤 4：匹配参考图。优先级为：与文章描述最匹配的房型；构图接近目标比例（16:9 优先选广角侧拍素材）；装修细节丰富。
步骤 5：上传参考图到 COS。准备临时目录后，使用 cos-uploader 脚本上传，获取 COS URL 后用于 API 调用。命令：node ~/.claude/skills/cos-uploader/scripts/upload.mjs /tmp/cos-upload/ article-ref/
步骤 6：调用即梦 API。必须使用 /compositions 接口。接口选择说明：/v1/images/generations 为纯文生图，images 参数不生效；/v1/images/compositions 为图生图，images 参数生效。验证参考图是否生效：检查返回 JSON 是否包含 input_images 和 composition_type 字段。推荐参数：model 为 jimeng-4.6（房间还原度最好），ratio 为 16:9，resolution 为 2k，sample_strength 为 0.75。Session ID 支持逗号分隔多账户，API 自动轮换。
步骤 7：审核与选图。每次调用返回 4 张变体，审核标准包括装修细节与参考图一致、色调与品牌视觉规范一致、人物自然、光影效果符合目标场景、无明显 AI 瑕疵。展示 4 张变体供用户选择并推荐最佳。
步骤 8：插入文章。插入位置原则：在情感高潮段落之后；不要插在章节标题下方；不要连续两个章节都有图。图文节奏示例：开头（实景，建立信任）→ 体验 1（AI，情感共鸣）→ 留白 → 体验 2（AI，高潮）→ 留白 → 多样性展示（实景）→ 结尾（实景，温暖收束）。
五、错误处理
- 返回无 input_images：用了 /generations 而非 /compositions，改用 /compositions。
- credit prededuct failed：积分不足，切换账户或等待刷新。
- sample_strength invalid：multipart 模式不支持该参数，改用 JSON 模式。
- 图片还原度低：sample_strength 太低，提高到 0.75-0.85。
- 装修细节丢失：参考图构图与目标比例差异大，选择构图更接近的参考图。
六、适用场景与限制 适用场景为需要按品牌视觉规范为 Markdown 文章自动配图、并控制图文节奏的内容创作者。限制包括：依赖即梦 API 服务、session ID、COS 图床和品牌资产文件；配图生成依赖即梦积分。具体收费、价格等信息暂未提供。