| name | xiaolvs-image-gen |
| description | 小绿书图文生成。当用户需要将文章/观点生成手绘风格信息图和配套公众号文案时，使用此 skill。关键词触发：生成信息图、手绘图、图文生成、小绿书、NotebookLM 图片、Gemini 生成图片、生成图表。 |
小绿书图文生成
概述
将文章分析结果转化为多张手绘风格竖版信息图 + 配套公众号文案 + 话题标签。
默认使用 Gemini Nano Banana Pro（3:4 竖版）生成图片，通过 Gemini 3 Pro 模型 + 图片生成工具激活，利用 Gemini Pro 订阅配额，无额外 API token 消耗。认证通过 Chrome CDP 模式直接复用用户浏览器的 Google 登录态，无需手动配置。
脚本自动完成以下设置（对应网页端手动操作）：
- 选择「Pro」模型（等价于网页端切换到 Pro 模式）
- 启用「生成图片 🍌」工具（等价于网页端点击 Nano Banana 图片生成工具）
- 设置 Pro 质量模式（高质量图片输出）
- 启用「临时对话」模式（等价于网页端点击「临时对话」，生成的会话不会保存到 Gemini 聊天历史）
仅当用户明确要求使用 NotebookLM 生成信息图时，才走 NotebookLM 信息图 API 通道。
前置条件
本 skill 假设已完成素材收集（article.md + article_meta.json 已存在于项目子目录）。如果尚未完成，请先使用 fetch-archive skill 抓取和归档文章。
最终产出物
- 1 张总览信息图（涵盖全部核心要点）
- 2-7 张数据/观点拆解图（每张聚焦单个核心论点或数据，总张数含总览图不超过 8 张）
- 1 篇 300 字以内的公众号文案（
copywriting.txt）
- 5-8 个话题标签
工作流程
Step 1：检查环境与认证
1.1 Python 环境
脚本需要 Python 3.9+（使用 from __future__ import annotations 兼容）。macOS 系统自带的 /usr/bin/python3 通常是 3.9.6，可直接使用。如果系统有 homebrew 安装的更高版本（如 /opt/homebrew/bin/python3.12），也可使用。
确认 Python 和 playwright 可用：
python3 --version
python3 -c "from playwright.sync_api import sync_playwright; print('playwright OK')"
pip3 install playwright
⚠️ 避免重复安装：如果 python3 -c "import playwright" 已成功，不要再次运行 pip install。当 python3 是系统 Python 3.9 但 playwright 装在 homebrew Python 3.12 下时，用 /opt/homebrew/bin/python3.12 执行脚本即可。
1.2 Chrome CDP 认证
脚本会自动启动一个独立的 CDP Chrome 实例（使用专用 profile 目录 ~/.gemini_browser/chrome_cdp_profile），无需关闭用户正在使用的 Chrome，两者可同时运行互不冲突。
⚠️ 关键机制：macOS Chrome 禁止在默认 user-data-dir 上开启 CDP 远程调试端口（会报错 DevTools remote debugging requires a non-default data directory）。脚本已改为使用独立 profile 目录，彻底避免此问题。
首次使用需要在 CDP Chrome 中登录 Google 账号：
python3 scripts/gemini_generate_images_browser.py login
首次登录后，Google 登录态保存在 ~/.gemini_browser/chrome_cdp_profile/ 中，后续运行 generate 命令自动复用，无需再次登录。
验证 CDP 可连接（可选，脚本会自动处理）：
curl -s http://localhost:9222/json/version
认证原理: 脚本自动启动一个独立的 Chrome 实例（专用 profile + CDP 端口 9222），通过 Playwright connect_over_cdp 连接并操控 gemini.google.com。独立 profile 意味着不影响用户日常使用的 Chrome，也不需要手动关闭/重启 Chrome。
Step 2：事实信息筛查（Fact-Check）
在编写提示词之前，必须对素材中的所有事实性内容进行准确性验证，防止将错误信息写入信息图。
2.1 提取并分类事实性声明
从结构化分析中，逐条提取所有事实性声明，并按以下类别分类：
| 类别 | 示例 | 验证要求 |
|---|
| 产品发布时间 | "2024.06 Sonnet 3.5 发布" | 必须验证 — web_search 查证确切日期 |
| 财务/营收数据 | "年营收 $150 亿" | 必须验证 — 确认数据来源和时效性 |
| 用户量/使用数据 | "GitHub 20% 公共提交来自 X" | 必须验证 — 确认数据出处和统计口径 |
| 第三方引用/名言 | "某人说了 XXX" | 必须验证 — 确认引用来源真实存在 |
| 技术概念/产品名称 | "Claude Code 支持 XXX" | 常识性核实即可 |
| 嘉宾个人观点/经历 | "我每天提交 10-30 个 PR" | 无需外部验证 — 标注为嘉宾原话即可 |
2.2 交叉验证事实
对每条必须验证的声明，执行以下步骤：
- 搜索验证：使用
web_search 搜索关键词（产品名 + 发布日期 / 公司名 + 营收数据 / 引用原文）
- 来源比对：将搜索结果与原文声明比对，确认：
- 日期是否准确（精确到月份）
- 数据量级是否正确（注意 ARR vs 年营收 vs 估值的区别）
- 引用是否存在可追溯的原始出处
- 标记结果：
【事实筛查结果】
✅ [已验证] Sonnet 3.5 发布时间 → 2024.06.21（来源：Anthropic 官方博客）
⚠️ [已修正] "年营收 $150 亿" → 实际 2025 年底 ARR ~$9B（来源：Sacra 估算）
❌ [不可验证] "Spotify 最好的开发者从 12 月起没写过代码" → 搜索未找到原始出处，删除或替换
ℹ️ [嘉宾原话] "我每天提交 10-30 个 PR" → 保留，标注来源
2.3 数据纪律（⚠️ 最高优先级）
核心原则：事实筛查是「验证」而非「替换」。图片 prompt 中只允许使用原文出现的数据，绝不混入外部数据源。
对于验证结果的处理：
- ✅ 已验证（原文数据与外网一致）：直接使用原文数据
- ⚠️ 原文数据与外网有出入：仍然使用原文数据，但向用户报告差异，由用户决定是否修正。不要自行用外网数据替换
- ❌ 原文数据明显错误（如日期/人名写错）：向用户报告，由用户决定。如果是笔误（如「2024」写成「2025」）可建议修正
- 引用无出处 / 不可验证：保留原文表述，标注「原文声明」即可
绝对禁止的行为：
- ❌ 将 web_search 搜到的具体数据（如「$440亿」「$20亿 ARR」）直接写入图片 prompt
- ❌ 为图片补充原文没有的数据点（如原文没提 Cursor，就不能在图中加 Cursor 数据）
- ❌ 用外网「最新」数据替换原文中的预测/估算值
允许的做法：
- ✅ 使用原文中的原话、原始数据、原始表述
- ✅ 展示用户补充的推导公式作为数据说明
- ✅ 在 footer/来源标注中写「来源：原文/作者名」
2.4 向用户报告筛查结果
将事实筛查结果呈现给用户，特别是原文与外网有差异的部分。明确告知：「以下数据与外网公开信息有出入，但图片中将按原文使用，你确认吗？」
等用户确认后再进入提示词编写阶段。
Step 2.5：选择图片风格（⏸️ 用户确认）
事实筛查完成后、编写提示词之前，必须让用户选择图片风格。
当前支持两种命名风格（详见 references/style_guide.md）：
| 风格名称 | 英文 ID | 视觉特征 | 适用场景 |
|---|
| 暖纸手账 | warm-sketch | 浅奶油白纸张 + 棕色手绘线条 + 暖色点缀 | 知识分享、方法论、产品分析（亲切温馨） |
| 黑金粉笔 | blackboard-gold | 深黑背景 + 金色/铜色粉笔线条 + 米白手写文字 | 技术架构、战略分析、行业趋势（权威高端） |
交互方式：使用 ask_followup_question 向用户展示两种风格选项，默认选择黑金粉笔（blackboard-gold）：
🎨 请选择配图风格：
A. 暖纸手账（warm-sketch）— 浅色暖纸 + 棕色手绘，亲切温馨
B. 黑金粉笔（blackboard-gold）— 深黑底 + 金色粉笔，权威优雅 [默认]
用户选择后，记录所选风格 ID，后续 Step 3 编写提示词时使用对应的 STYLE_PREFIX。
Step 3：编写提示词并生成信息图
3.1 应用所选风格
根据 Step 2.5 用户选择的风格（默认 blackboard-gold），在 gemini_charts_config.json 中通过 "style" 字段记录，并在每张图的提示词开头使用对应的 STYLE_PREFIX。
⚠️ 风格一致性（关键）：所有图片（包括第一张总览图 infographic.png）必须使用完全相同的 STYLE_PREFIX 文本。不能因为总览图内容简单就省略手写体强调。常见错误是第一张图的字体描述不够强烈，导致 Gemini 用印刷体渲染，与后续图片风格割裂。每张图的 Typography 部分都必须包含以下强调：
ALL text MUST look hand-written / hand-letteredABSOLUTELY FORBIDDEN: no clean printed fonts, no sans-serif, no serif, no monospacewobbly, uneven baselines with natural stroke variation
3.2 构建 Gemini 提示词（使用 Step 2.5 选定的风格）
Gemini 提示词格式与 NotebookLM instructions 不同。每张图的提示词结构：
Generate a TALL PORTRAIT infographic image. The image MUST be in 3:4 aspect ratio (width:height = 3:4, i.e. taller than wide, like a phone screen in portrait mode). Do NOT generate a square or landscape image.
All text must use standard Simplified Chinese characters (标准简体中文字符), ensuring every character is clear, legible, and free of garbled text.
<所选风格的 STYLE_PREFIX（参考 references/style_guide.md 中对应风格的英文版描述）>
<具体内容布局和视觉元素描述（英文为主，中文内容用中文）>
关键规则：
- Gemini 提示词以强调宽高比的指令开头，必须反复强调
3:4 portrait, taller than wide
- 风格描述用英文（Gemini 对英文提示词理解更好）
- 具体中文标题和文本内容保留中文
- 必须使用 Pro 模型：默认的 Fast 模型中文渲染质量极差（严重乱码），必须切换到 Pro（Gemini 3.1 Pro）模型才能正确渲染中文
3.3 为每张图编写提示词
每张图的提示词 = 所选风格的 STYLE_PREFIX + 专属内容描述。
专属内容仍需包含：
- 中文标题 — 用「」引用
- 各 Section 的布局描述 — 用英文描述结构，中文内容保留中文
- 视觉元素要求 — 容器形状、图标、连接方式
从 references/style_guide.md 的「视觉元素库」中选择搭配。
内容风格要求：信息图中的文字内容（标题、要点、金句等）必须贴合作者「实战派技术布道者」的风格（参考用户级 skill wechat-article-writer）：
- 标题用「不是X，而是Y」「X意味着Y」等句式增强洞察感
- 要点表述务实接地气，避免空泛的技术堆砌
- 数据引用标注来源，体现专业性
- 保留英文术语原词（参考
references/terminology.json）
术语翻译规则：编写提示词和文案时，必须参考 references/terminology.json 英文术语保留词库：
keep_english 列表中的词（如 Agent、token、API、GPU、LLM、prompt 等）保持英文原词不翻译translate_as 映射中的词翻译为指定的中文（如 workflow → 工作流、scaling law → 规模定律）
3.3 生成配置文件
将所有图表定义写入 JSON 配置文件（存放在项目子目录下）：
[
{
"prompt": "<Gemini 提示词全文>",
"filename": "infographic.png",
"model": "pro"
},
{
"prompt": "<Gemini 提示词全文>",
"filename": "chart_1.png",
"model": "pro"
}
]
model 字段: 默认为 "pro"（Gemini 3.1 Pro），必须使用 Pro 模型以确保中文渲染正确。可选 "flash"（快速模式）但中文质量无保障。
3.4 运行生成脚本
方式1：浏览器 CDP 模式（默认，中文渲染质量最佳）
python scripts/gemini_generate_images_browser.py generate \
--config <项目子目录>/gemini_charts_config.json \
--output-dir <项目子目录>
python scripts/gemini_generate_images_browser.py --no-headless generate \
--config <项目子目录>/gemini_charts_config.json \
--output-dir <项目子目录>
浏览器 CDP 模式每张图的完整流程：
- 连接 Chrome CDP 端口 9222 → 打开 gemini.google.com
- 展开侧边栏 → 点击 Temporary chat（临时对话，不污染聊天历史）→ 验证页面显示 "Temporary chat" 文本后才继续（最多重试 3 次，若验证失败回退到普通新对话）
- 点击 Tools 菜单 → 启用 Create image（激活 Nano Banana Pro 图片生成能力）
- 点击模型选择器 → 切换到 Pro 模型（Gemini 3.1 Pro，中文渲染正确）
- 通过
execCommand('insertText') 输入提示词（换行符替换为空格防止 Enter 触发发送）
- 点击发送按钮提交
- 等待图片生成完成
- 滚动到图片位置 → hover 图片 → 点击下载按钮保存原图
⚠️ 严禁截图保存信息图，必须通过下载按钮获取原图。 截图会导致分辨率降低、画质损失、且可能包含浏览器 UI 元素。如果找不到下载入口（hover 后未出现下载按钮），则重新生成该图片，不要退而求其次使用截图。
方式2：gemini-webapi 库模式（备选，等库更新后酌情启用）
python scripts/gemini_generate_images.py generate \
--config <项目子目录>/gemini_charts_config.json \
--output-dir <项目子目录>
默认策略: 优先使用方式1（浏览器 CDP 模式），中文渲染质量最佳。
脚本路径: scripts/gemini_generate_images_browser.py（默认）和 scripts/gemini_generate_images.py（备选）位于本 skill 目录下。
Step 4：撰写公众号文案并保存为 copywriting.txt
参照 references/copywriting_guide.md 撰写 300 字以内的公众号文案。
⚠️ 风格要求：文案必须贴合作者的「实战派技术布道者」人设风格，具体参考用户级 skill wechat-article-writer 的风格定义。核心风格要点：
- 场景驱动：从真实痛点/场景出发，而非技术本身
- 三层语言系统：专业层（行业术语建立权威）+ 解释层（类比降低门槛）+ 口语层（自嘲/网络用语拉近距离）
- 务实乐观：对新技术保持热情但不盲目吹捧，会指出局限性
- 典型句式：「不是X，而是Y」（纠正认知）、「X意味着Y」（揭示本质）、「X才是Y」（强调重点）
- 数据说话：关键论点用数据支撑，引用权威来源
- 利益披露：涉及投资关系/商业利益时必须标注
文案结构：
- 吸引力标题（不超过 20 个字，含标点和 emoji）
- 核心观点段（场景切入，从读者痛点或好奇心出发）
- 要点列表（3-5 个，▸ 标记）
- 关键数据/金句
- 立场声明（如适用，⚠️ 标注利益相关）
- 原文出处
- 话题标签（5-8 个）
必须将文案保存为 <项目子目录>/copywriting.txt。此文件是后续发布步骤的文案数据源，发布脚本会从中自动提取标题和正文内容。
文件格式：
<emoji> <标题>
<空行>
<正文内容（核心观点段 + 要点列表 + 金句 + 声明 + 出处）>
<空行>
#标签1 #标签2 #标签3 ...
Step 5：展示结果与迭代
⚠️ 严禁通过 read_file 展示图片文件。 多张 PNG 图片内容过大（每张 ~10000 行 base64），同时 read_file 5 张图片会导致上下文溢出、生成卡住。
- 列出生成的文件清单（文件名 + 文件大小），不读取图片内容：
📷 生成的图片：
1. infographic.png (1709KB) — 总览信息图
2. chart_1.png (1800KB) — <主题>
3. chart_2.png (1679KB) — <主题>
...
图片已保存在 <项目子目录>/ 下，请在 IDE 或 Finder 中预览。
- 展示
copywriting.txt 文案全文（纯文本，可安全 read_file）
- 收集用户反馈，可能的迭代方向：
- 风格调整 → 修改提示词风格描述（参考
references/style_guide.md）
- 视觉丰富度不足 → 在提示词中增加具体视觉元素描述
- 内容聚焦调整 → 修改单张图的提示词
- 文案优化 → 直接修改文案
- 修改配置文件后重新运行生成脚本
关键经验
风格一致性控制
- 提示词中的风格描述是控制风格的唯一且核心手段，必须详细到色号级别
- 仅写「手绘风格」远远不够，必须精确指定背景色号、线条色号、禁止颜色
- 视觉丰富度需要在提示词中列出具体的视觉元素，否则生成结果偏单调
常见问题
| 问题 | 原因 | 修复方法 |
|---|
| 图表冷色调（蓝/绿/紫） | 提示词未明确禁止 | 在风格描述中列出所有禁止的冷色调 |
| 背景色太深 | 背景描述不够精确 | 加色号参考（#F5F0E8）+ 明确禁止深色 |
| 视觉元素单一 | 提示词过于简略 | 详细描述每个区块的图标、图表类型、容器形状 |
| Gemini 返回文本而非图片 | 提示词未触发图片生成 | 确保以 Generate an infographic image 开头；浏览器 CDP 模式下脚本会自动启用 Create image 工具 |
| Gemini 认证失败（CDP 模式） | Chrome 未登录 Google 或 CDP profile 未初始化 | 运行 python3 scripts/gemini_generate_images_browser.py login 在 CDP Chrome 中登录 Google |
| CDP 端口不可用（macOS） | 使用了默认 user-data-dir 启动 Chrome，macOS Chrome 拒绝在默认目录上开 CDP | 脚本已修复：自动使用独立 profile 目录 ~/.gemini_browser/chrome_cdp_profile。如仍失败，删除该目录重试 |
Python str | None 语法报错 | Python 版本低于 3.10 | 脚本已改用 from __future__ import annotations 兼容 3.9+。如仍报错，用 /opt/homebrew/bin/python3.12 |
| playwright 模块未找到 | 当前 Python 环境未安装 playwright | pip3 install playwright（或 pip3 install --break-system-packages playwright） |
| 图片内容重复 | 提示词聚焦范围重叠 | 为每张图指定明确的聚焦主题 |
| 中文乱码/字符缺失 | 使用了 Fast 模型（默认） | 必须切换到 Pro 模型（Gemini 3.1 Pro） |
| 图片下载失败 | 截图方式不可靠 | 严禁截图保存。必须通过 hover → 下载按钮方式保存原图 |
| 多张图之间内容重复 | 提示词聚焦范围重叠 | 为每张图指定明确、互不重叠的聚焦主题 |
| 标题超过 20 字 | copywriting.txt 标题过长 | 在生成阶段就确保标题不超过 20 字 |
| 信息图中事实信息错误 | 素材提取阶段未验证事实性声明 | 执行 Step 2 事实信息筛查 |
| "token" 被翻译为"代币" | 未参考术语保留词库 | 必须参考 references/terminology.json |
| 单张图重新生成时全量重跑 | 修改单张图的 prompt 后错误地用完整 config 重新生成 | 为单张图创建临时配置文件，生成完成后删除 |
| Gemini 临时对话打开失败/超时 | 侧边栏展开或 Temporary chat 按钮定位不稳定 | 已优化：脚本现采用多策略定位（aria-label / mattooltip / JS DOM 遍历 / 暴力搜索）+ 创建后验证（检查页面是否显示 "Temporary chat" 文本）+ 最多 3 次重试。每次失败会保存调试截图到 /tmp/gemini_temp_chat_attempt_N.png。如仍失败，回退到普通新对话并在日志中警告 |
| Gemini Pro 模型切换失败 | 模型选择器 DOM 结构变化，或 Pro 按钮未找到 | 确认 Gemini 订阅有效（Pro 模型需付费订阅），检查脚本中模型选择器是否匹配最新页面结构 |
| Gemini 图片生成超时/长时间无响应 | Pro 模型排队繁忙（尤其高峰时段），或网络代理不稳定 | 增加等待超时（默认 180s → 建议 300s）；确保代理稳定；避开高峰时段（北京时间凌晨质量最佳）；如超时可尝试重新提交同一 prompt |
| Gemini 返回 "I can't generate that image" | 提示词触发了 Gemini 安全过滤，或 Pro 模型繁忙降级 | 检查提示词是否含敏感内容；去除可能触发过滤的用词；等待几分钟后重试 |
| 图片生成过程中浏览器被冻结/崩溃 | 同时打开多个 Gemini 会话，或 Chrome 内存不足 | 关闭其他不必要的 Chrome Tab；确保 CDP 连接只打开一个 gemini.google.com 页面 |
| 下载按钮 hover 后不出现 | Gemini 页面 DOM 更新，hover 区域变化 | 脚本会尝试多种 hover + 点击策略，如全部失败则重新生成该图片（不用截图替代） |
| 批量生成中途某张失败 | 网络波动或 Gemini 临时限流 | 脚本支持 --config 传入部分图表重新生成；为失败的单张图创建临时配置，不需要全量重跑 |
| 整体生成耗时过长（>30分钟） | Pro 模型每张图生成 + 下载需 3-8 分钟 | 属正常范围。4-5 张图预计 15-30 分钟。不要中途手动中断，让脚本完成自动重试 |
Gemini 图片生成性能优化建议
- 时间预期：Pro 模型每张图生成耗时 3-8 分钟（含等待排队），4-5 张图总计 15-30 分钟属正常范围
- 最佳时段：北京时间凌晨-上午（美西夜间）生成速度最快，下午高峰时段可能排队更久
- 网络要求：确保代理连接稳定，Gemini 图片生成过程中网络中断会导致需要重新生成
- 不要并发：一次只运行一个生成任务，不要同时启动多个
gemini_generate_images_browser.py 实例
- 中断恢复：如果批量生成中途中断，查看输出目录已生成的图片，只重新生成缺失的图片（创建临时配置文件）
备选方案：NotebookLM 信息图 API
当用户明确要求使用 NotebookLM 生成信息图时，使用 scripts/generate_images.py 脚本：
python scripts/generate_images.py generate \
--notebook-id <NOTEBOOK_ID> \
--output-dir <项目子目录路径> \
--config <项目子目录>/charts_config.json
NotebookLM 配额警告: 有账号级别配额（约 10-15 张/天），触发后需等待数小时恢复。
资源文件
| 文件 | 用途 |
|---|
scripts/gemini_generate_images_browser.py | 默认图片生成脚本（浏览器 CDP 模式） |
scripts/gemini_generate_images.py | 备选图片生成脚本（gemini-webapi 库模式） |
scripts/generate_images.py | 备选信息图生成脚本（NotebookLM API） |
references/style_guide.md | 手绘风格规范、STYLE_PREFIX 完整文本、视觉元素库 |
references/notebooklm_api.md | NotebookLM Python API 参考、配额限制说明 |
references/terminology.json | 英文术语保留词库 |
references/copywriting_guide.md | 公众号文案结构、语言风格、话题标签选取规范 |
