背景 / What

移植 hermes image_with_refs 的 COMPOSITION DIRECTION 构图指令到 corlinman 的参考图生图工具（corlinman_agent.image.dispatch），让多角色 AI 配图读作"随手拍的生活切片"而不是摆拍合影。

改动 / Changes

• _COMPOSITION_INTRO（新常量，英文，喂给图像模型的指令，非用户可见）覆盖全部要点：
  • candid slice-of-life snapshot, NOT a posed group photo
  • 每个角色不同动作 / 不同朝向（不都看镜头）
  • off-axis / off-center 取景
  • mid-action 姿态（非静止站立）
  • environmental clutter 增加生活感
  • "sneaky / casual" 动作要读得出隐蔽感
  • 角色写实句 + 画风句写成 persona 通用 —— 画风一律来自上游 persona/prompt 与参考图，绝不硬编码任何特定画风
• _compose_refs_prompt(prompt, chars_used)（新函数）拼装：intro + 按序参考图图例（Reference image 1 = <label1>, ...）+ Scene: 段 + 原 prompt（原样置尾）。用它替换传给 generate_with_refs 的裸 prompt。
• CORLINMAN_IMAGE_REFS_INTRO=off 环境开关可禁用（裸 prompt 直穿）；成功返回包新增 composition_intro: bool。
• 图例只列 chars_used（真正解析到参考图的 label），编号连续；缺失 label 不入图例。

测试

test_image_with_refs.py 新增 3 项 + 加固 happy-path：

• intro 包裹 prompt（intro 开头 / 原 prompt 置尾 / 按序列出 labels）
• 图例与 chars_used 一致（缺失 label 被丢弃，编号连续）
• CORLINMAN_IMAGE_REFS_INTRO=off → 裸 prompt 直穿、composition_intro=false

验证（全绿）

• ruff check python/packages/corlinman-agent ✅
• mypy python/packages/（strict，609 files）✅
• lint-imports（2 contracts kept，corlinman-agent 不 import corlinman-server）✅
• pytest test_image_with_refs.py + test_image_generate.py（35 passed）✅
• 回归：qzone publish/comment + vision（62 passed）✅

约束遵守

• dispatcher 永不抛异常（沿用现有错误折叠风格，纯字符串拼接无新失败面）。
• 无跨包 import；返回包变更为纯增量字段。