baoyu-infographic实战：把结构化资料变成可信的信息图

baoyu-infographic 的重点不是把文章“画得更热闹”，而是把事实按关系重新组织成可阅读的空间结构。它先生成内容分析和结构化材料，再选择布局与风格，最终调用图像后端输出信息图。

本文基于固定提交源码核对；案例是操作示例，非付费服务或账号实测，没有实际生成图片或调用服务。

一、场景与边界

适合产品对比、时间线、分类表、知识总览、步骤指南、指标摘要和高密度信息大图。相比文章配图，它更强调一张图内部的完整结构；相比多页社交卡片，它不负责滑动阅读节奏。

技能有两个独立维度：布局处理信息关系，风格处理视觉表现。源码的主目录列出 21 种布局和 22 种风格。布局如 binary-comparison、comparison-matrix、linear-progression、bento-grid、dense-modules；风格如 craft-handmade、technical-schematic、corporate-memphis、hand-drawn-edu。末尾参考清单仍有“21 styles”的旧表述，应以当前主风格表为准，不把文档数量不一致扩展成新的能力承诺。

最重要的边界是保真：结构化内容不应新增信息，统计和引用应照原文保留，且必须先清除密钥、令牌等秘密。若输入是一篇需要大幅删减的长文，先单独得到用户确认的精简稿，再送进本技能，不能一边出图一边静默改写事实。

二、前置依赖与按需安装

需要支持 Skills 的 Agent、明确且可读取的资料，以及可用图像后端。对文档分析而言不必准备所有供应商；对出图而言，至少要有一种已经授权的原生或非原生图像能力。

经 README 核实的安装入口：

1	npx skills add jimliu/baoyu-skills --skill baoyu-infographic --agent codex

Claude Code 用户可将 codex 替换为 claude-code。

按需选择 baoyu-infographic；缺少后端再补图片生成。该入口未固定本文提交，安装最新版后仍需重新核对差异。固定源码的项目级 Codex 安装可复制完整目录到 .agents/skills/baoyu-infographic/，必须保留布局、风格和配置参考文件。

本教程不执行安装、配置密钥或付费调用。上传输入前要确认资料可以交给所选供应商处理；脱敏不仅是最终发布阶段的工作。

三、输入输出

输入建议由清晰标题、受众、事实条目和关系构成。例如对比两种备份策略，先给出恢复目标、保存频率、存储成本口径和适用场景，不能只给零散数字让 Agent 自己推断单位。

默认输出目录是 infographic/{topic-slug}/，文件包括源内容、analysis.md、structured-content.md、prompts/infographic.md 与 infographic.png。前两份中间材料很重要：如果最后的图出现错误，可以判断是内容结构阶段就错了，还是图像渲染阶段才写错。

比例支持横向 16:9、纵向 9:16、方形 1:1，也可指定自定义 W:H。比例不等于保证像素尺寸，具体还要看后端支持。输出是位图，不是每个模块可独立编辑的设计源文件。

四、可复制的 Agent 请求

请使用 baoyu-infographic，将我提供的两种备份方案对照表制作成中文信息图。
先核对输入中的单位、统计时间和术语，遇到缺失信息向我询问，不补造数据。
保留每条事实的原文表述；移除任何令牌、密钥和敏感账号信息。
先生成分析与 structured-content.md，推荐三种布局和风格组合。
优先考虑二元对比或比较矩阵，横向 16:9，受众是技术团队。
让我确认组合、比例、语言和图像后端后，再保存最终提示词并出图。
完成时给出数据核对清单和文件路径，不发布、不自动改写原文。

若要先做资料整理，明确说“本轮停在结构化材料，不调用图像后端”。这只是限制本轮执行范围，不是假造新的 CLI 参数。

五、案例：两种备份策略的比较图

准备一份已经由资料负责人确认的表格，其中每一行是相同口径：备份频率、恢复流程、维护成本、适用数据类型。本例不填入虚构的恢复秒数；没有实测指标就保持定性描述。

第一步分析内容，判断它是多因素对比而不是时间线。把受众定为技术团队，学习目标是“读者能区分两种方案的取舍”，而不是“看完觉得某方案更先进”。

第二步生成 structured-content.md。为每个模块保留原始事实，分别记录关键概念、原文内容、视觉元素与标签。数值、单位、引文不随意换算或简写；如果太长，在这个阶段请用户先批准修改原文，而不是让绘图模型自由压缩。

第三步推荐布局。两种方案、少量差异可选 binary-comparison；多因素多方案可选 comparison-matrix；概览模块可选 bento-grid。源码对“信息图”“高密度信息大图”有关键词优先推荐，因此泛泛说“信息图”可能先得到便当格建议。明确说明比较关系并在确认时选择矩阵，通常比只强调风格更有帮助。

第四步确认组合。保守选择易读的技术或企业风格，不用装饰纹理抢占文字空间。默认 bento-grid + craft-handmade 只是推荐，不意味着自动跳过确认。

第五步读取布局定义、风格定义和基础提示词模板，写入完整提示词再生成。如果已有同名源文件、分析、提示词或图片，应先按时间戳备份，再创建新版本。

第六步逐项对照。不要只检查标题好不好看，要把原表每行与图中对应项逐字比对。若图像把“每天”写成“每周”，这是交付阻断问题。修正提示词并另存候选图，不在位图上程序覆盖文字。

六、配置与参考图片

偏好查找顺序是项目 .baoyu-skills/baoyu-infographic/EXTEND.md、XDG 配置目录、用户 $HOME/.baoyu-skills/baoyu-infographic/EXTEND.md，首个命中生效。未找到时进入首次偏好询问。

常用字段有 preferred_layout、preferred_style、preferred_aspect、language 和 preferred_image_backend。例如经常做高密度中文卡片，可保存纵向比例与固定风格；但这些值只是后续推荐和确认的默认值，不会授权跳过确认。

参考图支持三种模式：direct 直接传给后端，style 抽取线条和表现特点，palette 抽取配色。直接参考需要后端支持；否则应把提取特征写进提示词并告知用户，并非声称完成了相同的图像参考过程。文件应复制到输出目录 refs/，在提示词里记录用途。

七、验收与排错

[ ] 每个数值、单位、引用和结论都能回溯输入。
[ ] 结构化材料没有新增事实或偷偷改变统计口径。
[ ] 图的布局反映真实关系，不把相关性画成因果。
[ ] 最终提示词在生成前保存，已有文件得到备份。
[ ] 中文可读，标题、模块标签和数据值没有错误。
[ ] Obsidian 与 Hexo 可访问图片附件，公开目录没有秘密。

信息密度过高：优先拆任务或让用户确认精简稿，不是无限缩小文字。图漂亮但数据错：先对照 structured-content.md，定位内容错误还是渲染错误。默认布局不合理：检查关键词快捷推荐，明确说明比较、循环或层级关系。没有图像后端：停止生成并选择后端，源码不允许用 HTML 或 SVG 冒充该技能的位图结果。博客阅读困难：在实际手机宽度预览，必要时拆成社交图片卡片，不要只在桌面大屏验收。