infographics

基础记忆图像

生成以证据为依据的仓库视觉内容，并使用规范的输出路径。 文件名和标记名仍保留“infographic”，以确保兼容性；但 PR 生成以图像为先：场景、海报、绘画、照片、封面、画面、布置好的物件，或其他能传达 PR 意图的编辑式视觉瞬间。PR 图像是非门禁的 BM Bossbot 产物；变更日志和发布摘要图像则采用手动证据包工作流。

输出约定

• 基础输出目录：docs/assets/infographics/
• PR 图像：docs/assets/infographics/pr-<number>.webp
• 变更日志图像：docs/assets/infographics/changelog.webp
• 周度图像：
  • 始终采用 2 周回顾窗口：从前一 ISO 周到当前 ISO 周（start-week = current-week - 1，end-week = current-week）。
  • 同年窗口：docs/assets/infographics/<year>-w<start-week>-w<end-week>.webp
  • 跨年窗口： docs/assets/infographics/<start-year>-w<start-week>-<end-year>-w<end-week>.webp

PR 模式

PR 模式使用 BM Bossbot 摘要块作为素材。不要手动编写 PR 正文中没有的说法。

1. 获取 PR 正文：

gh pr view <number> --json body --jq '.body // ""' > /tmp/bm-pr-body.md

2. 生成规范资源：

uv run --script scripts/generate_pr_infographic.py \
  --pr-number <number> \
  --pr-body-file /tmp/bm-pr-body.md \
  --theme "<optional visual theme>" \
  --provenance-output /tmp/bm-infographic-provenance.md \
  --output docs/assets/infographics/pr-<number>.webp

如果 PR 正文包含受管理的图像主题块，脚本会自动读取：

<theme>

调用图像生成前，先在本地测试提示词路径：

uv run --script scripts/generate_pr_infographic.py \
  --pr-number <number> \
  --pr-body-file /tmp/bm-pr-body.md \
  --theme "<optional visual theme>" \
  --output docs/assets/infographics/pr-<number>.webp \
  --print-prompt

--dry-run 是 --print-prompt 的别名；两者都会打印最终提示词，并在不调用 OpenAI 的情况下退出。

未提供主题时，脚本会根据 PR 编号和 Bossbot 摘要，从下方的风格池中确定性地选择 BM 视觉方向。这样可避免重复的 PR 图像都变成相同的通用视觉。

生成图像时，还要使用 --provenance-output <path> 写入溯源信息。BM Bossbot 会通过以下标记，将该受管理的区块发布到 PR 正文：

...

溯源区块会记录生成的资源路径、图像模型、尺寸、质量、图像模式、主题来源和选定的视觉方向。它不会将完整的生成提示词写入 PR 正文。请仅将此区块视为用于调试和创意溯源的信息；它不是合并门禁。

PR 图像仅用于视觉辅助。权威的合并门禁是名为 BM Bossbot Approval 的 GitHub 提交状态。

变更日志模式

编写提示词前，先构建证据包：

• 差异事实来源：已合并 PR 的差异、合并提交，或本地重建的差异
• 变更文件概览：git diff --stat，加上关键文件内容
• 影响清单：将变更前后的结果与实际变更对应起来
• 排除清单：误导性标题、已回退的工作、仅重命名的变动、推测性的 TODO
• 选定的图像形式：海报、场景、画面、封面、绘画、照片、布置好的物件，或其他编辑式视觉瞬间
• 选定的 BM 风格类别：从下方的选择池中恰好选一个类别

起草提示词前，请阅读以下参考资料：

• references/prompt-blueprint.md
• references/style-balance.md

阅读当前 CHANGELOG.md 条目，并纳入最新的重要变更。

风格与类别选择

根据语义契合度，为每张图像恰好选择一个 BM 风格类别。视觉语言应易于辨认且得体，同时保持清晰易读、适用于商务场景。

创作以图像为先、能传达变更内容的视觉形式：海报、场景、画面、封面图、绘画、照片、布置好的物件，或其他编辑式视觉瞬间。地图、图表、档案卷宗、统计图和标签可以作为场景中的道具出现，但不要制作文字密集的信息图。

BM 类别池：

• 计算机科学大学教材：SICP 风格的示意图、算法课程、编译器流水线、自动机、数据库系统、类型理论、操作系统
• 古典文学题材：海上航行、哥特式庄园、狄更斯风格的城市地图、奥斯汀风格的社交关系图、图书馆边注、旅行日志
• 奇幻／D&D 风格：任务地图、地下城钥匙、行会账簿、魔法书、怪物图鉴、酒馆告示板；不使用受版权保护的设定
• 音乐：金属、硬摇滚、朋克、电子乐、灵魂乐、雷鬼乐队；不包括流行音乐、直接使用乐队徽标、专辑封面或音乐人肖像
• 科幻：受《星球大战》启发的仿作、近似《太空炮弹》的太空歌剧、舰队航线、任务控制台、违禁品清单；避免使用受版权保护的角色、徽标或命名的虚构宇宙
• 受野蛮人柯南启发的剑与魔法题材：废墟神殿、沙漠路线、战旗、古地图；不描绘具名角色
• 漫画书：单期封面、跨页大图、动作分镜地图、说明文字框、半色调能量效果、清晰的拟声词排版
• 法国新浪潮电影：海报风格、醒目排版、城市路线图、跳切式编排、高对比度的编辑摄影视觉线索
• 二战宣传海报：后方民众宣传海报用语、物流箭头、配给图表、动员地图、大胆简化的人物形象；不使用现实世界政党标志、仇恨图像、非人化口号或虚假历史说法
• 意大利电影海报：手绘戏剧效果、醒目演职员名单、富有表现力的色彩、路线图拼贴、20 世纪 60 或 70 年代的电影气息；不直接使用电影片名或演员肖像
• 莎士比亚：舞台地图、幕与场、人物表、王室宫廷、后台提示单
• 希腊神话：神殿示意图、星座路线、英雄之旅地图、神谕石板、迷宫、航船路线
• 黑色电影侦探线索板：案件档案、红线地图、打字机打印的证据标签、警局墙面图表
• NASA 任务控制仪表板：发射时间线、遥测地图、轨道路线、状态面板
• 太空探索与天文学：天体图集、天文台星图、星野地图、轨道力学示意图、行星勘测路线、望远镜注释、任务轨迹、深空时间线
• 绘画：抽象画、古典风景画、受 Remington 启发的西部动作画、受 Rembrandt 启发的明暗对照画、历史壁画、暴风雨中的海景、寓言式社论绘画
• 经典黑白摄影：纪实现场报告、新闻编辑室档案照片、编辑摄影专题、街头摄影、高对比度暗房照片、接触印相、城市基础设施照片
• 80 年代动作电影：实景爆炸、烟雾弥漫且逆光照明的仓库、霓虹闪烁的城市街道、直升机探照灯、任务档案、英雄剪影、生死攸关的倒计时、手绘群像海报；不使用演员肖像、真实电影片名、系列标志或标志性台词
• 炼金术手稿：转化示意图、带注释的符号、类似配方的流程图、装饰性页边
• 粗野主义城市规划：交通地图、混凝土标识、分区地块、基础设施示意图

选择规则：

• 只选择一个类别；不要混搭不同类别。
• 选择最合适的图像形式。优先采用真实场景、海报、绘画、照片、场景画面或封面，而不是文字密集的信息图。
• 让隐喻贴合内容，但不要过度推敲。类别是创意催化剂，而非语义限制。
• 采用精致的编辑式呈现风格：文字平滑抗锯齿、对比鲜明、边缘清晰、标签易读。
• 通过易于理解的分镜场景、编辑式构图、象征性环境、路线、实物或视觉隐喻，让类别主导构图。
• 结构要足够直观，以帮助理解，但不要过于繁复，以免掩盖工程含义。
• 让图像生成器在布局、结构、配色和视觉隐喻方面保有创作空间。明确说明要呈现的内容，灵活处理呈现方式。
• 不要使用受版权保护的角色、徽标或具名虚构世界。改用类型风格元素、仿作和原创构图。

内容优先的美学准则

含义必须清晰易懂，层次分明。其他一切都可以自由创作：图像形式、布局、视觉隐喻、装饰元素、配色，以及类别专属的视觉语言。

层级：

1. 含义：交付了什么、发生了哪些变化，以及为何重要，都必须清楚。
2. 如果图像中包含文字、标签、章节或证据要点，它们必须清晰可读。
3. 所选类别的视觉基因应主导构图，呈现为海报、场景、绘画、照片、场景画面、封面或象征性物品陈列。
4. 不要求稳。引人注目、让人想看的图像，胜过正确但乏味的图像。

硬性规则：

• 内容章节和标签（如有）必须清晰可读。装饰不能遮挡文字。
• 不要使用会与工程或业务含义相冲突、充斥设定背景的文案。
• 每条提示词都必须包含清晰的图像优先构图指引：分镜场景、海报构图、绘画、照片、象征性场景、主体物件、任务室、档案卷宗、实物、路线或视觉隐喻。
• 不要过度规定精确坐标或面板几何；给出构图骨架，让模型围绕它进行创作。

生成

1. 将最终提示词写入临时 Markdown 文件。
2. 使用共享图像辅助工具生成：

uv run --script scripts/generate_infographic.py \
  --prompt-file /tmp/bm-infographic-prompt.md \
  --output docs/assets/infographics/<name>.webp

3. 确认图像存在且清晰可读后，再报告成功。

质量标准

• 讲清楚具体的前后价值变化，不要空泛地声称有所改进。
• 确保工程师和非技术相关方都能理解。
• 有文字时，使用通俗易懂的章节标题和标签。
• 确保视觉层次清晰：标题、分镜焦点、象征性场景、证据道具或主体物件。
• 不要编造事实；仅使用提供的源材料。
• 优先呈现已交付的成果，而非中间过程或已撤销的工作。
• 采用高对比度、字号适中的标签和简洁布局，确保内容清晰易读。