用 annual-report 把周报/年报从堆文字变成一页说清的可视化报告

一、输入材料

每到周报、月报、年终总结季，最难受的不是「没内容」，是「内容有了但不会摆」。

我见过太多汇报：一整页文字，标题和正文分不清，关键数字埋在第三段，领导扫一眼就划走。问题不在写得好不好，在于呈现密度不对——文字适合讲过程，数字和对比适合一眼看见，混在一起两个都废。

我把「要交什么」整理成一份结构化数据（一份 JSON，或直接在模板里填几行），按四类信息分组：

• 核心指标（这周期最关键的那几个数：增长、完成率、环比）
• 关键动作（做了什么、卡在哪、下周怎么动）
• 对比维度（本期 vs 上期、目标 vs 实际）
• 一句结论（这周期到底怎么样，给看报告的人一个落点）

再配一份落盘约定：生成的报告是本地 HTML 文件，截图成 PNG 用，源数据留在本地可改可重跑。所有产物只写本地磁盘指定目录，不写系统盘。

这就是全部输入：一份结构化数据 + 一个目录约定。没有别的。

二、annual-report 配置

1）四套视觉模板（这是整件事的发动机）

annual-report 内置 4 套独立视觉预设（dashboard / magazine / poster / deck），分别对应暗紫仪表盘、米白杂志、近黑巨幅海报、深蓝横幅四种风格。每份报告选一套，决定它「长什么样、重点怎么突出」。

2）本地文件驱动（分场景出图，不是一锅烩）

报告生成后落成本地 HTML，再用 CDP 全页截图成 PNG。不同场景用不同预设：周报用 dashboard 暗紫、给客户的战报用 magazine 米白、技术复盘用 poster 近黑、汇报用 deck 深蓝。同一份数据换套模板就是另一张图，不重做。

3）视觉差异校验（这一步是踩坑后才加的）

最早四套预设底层共用一个模板、只做微调，截图只截首屏，结果肉眼看着是「同一张图换字」。后来改成 4 套独立视觉方案，并用「计算样式」客观校验确认差异真实生效（背景色、hero 版式、指标卡布局、主色四维都不同），才彻底解决「看起来一样」。

4）生成本地命令骨架（节选，公开）

生成一份汇报可视化报告：
1. 准备数据 sample-<场景>.json（核心指标 / 关键动作 / 对比 / 结论）
2. 选 preset：dashboard | magazine | poster | deck
3. 跑 generate.py → 产出 out-<场景>.html（可交互）
4. CDP 全页截图 → <场景>.png（用于汇报/帖文）
5. 源数据留本地，下次改数重跑即可

Skill 在这条链路里负责「把结构化数据套进模板并渲染」，不改你的内容——你写什么它摆什么，摆得好看。

三、操作步骤

第 1 步：整理数据，不写长文。

把要汇报的内容压成「指标 + 动作 + 对比 + 结论」四块，填进一份 JSON。这一步逼你想清楚「这周期最重要的是什么」，比直接开写省一半时间。

第 2 步：选模板。

周报/内部看板选 dashboard；对外战报选 magazine；技术复盘选 poster；正式汇报选 deck。选错也能重选，源数据不动。

第 3 步：生成 HTML。

跑生成脚本，产出可交互 HTML 报告。报告里数字、对比、结论分区块，重点自明。

第 4 步：全页截图。

用 CDP clip 全页捕获（不是只截视口），保证整页版式都截到，不缺下半截。

第 5 步：视觉差异校验。

换下一份时检查四维差异（背景 / 版式 / 卡布局 / 主色）确实变了，避免「换字不换皮」。

中途踩的坑：最早四套预设底层共用一个模板、只做微调，截图只截首屏，导致四张图肉眼看着是同一张。改成独立视觉方案 + 计算样式校验后才解决。教训：「看起来不一样」必须用客观样式确认，不能靠感觉。

四、产出物

以「研发团队技术复盘」为例，一份数据产出：

同份数据换模板还能出 dashboard / magazine / deck 三张，视觉四维均不同。这套做法已支撑连续多周小红书「汇报可视化」内容更新，相邻两篇在颜色/布局/示例信息三维度不重样。

可验收的三条：

1. 报告里核心指标是否一眼可见（不是埋在第三段）
2. 本期 vs 上期对比是否并排（不是分开两段）
3. 四套模板视觉四维是否客观不同（不是换字不换皮）

五、用到了哪些产品能力（评审加分项）

• Skill：annual-report 负责「结构化数据 → 可视化报告」的渲染，不改内容只改呈现
• 本地文件：报告是本地 HTML，源数据可改可重跑，不依赖云端
• 模板化：4 套独立视觉预设，一套数据多场景出图

六、这套做法能复制的关键

不是「用 AI 帮你写汇报」——这句谁都会说。真正起作用的是三件事：

1. 先结构化再呈现。文字讲过程、数字要被看见，混在一起两个都废；先压成四块再套模板。
2. 模板化但要真不同。一套数据多场景出图省时间，但「换字不换皮」等于没换，必须用客观样式校验差异。
3. 源数据留本地。改数重跑比重写快十倍，汇报材料是可版本管理的资产不是一次性消耗品。

可视化报告成品效果（同一数据不同模板）