SEO 榜单卡片生成器
将一句需求自动转化为可直接发布的游戏榜单卡片（封面 + 分数榜 + 详情页）。
- slug（市场标识）：
seo-rank-card-maker - 图标：
assets/logo.png（512×512） - 自包含：图标库已内嵌
assets/icons/（146 个）——换机器/给别人用都不缺素材 - 跨平台：Windows / macOS / Linux 命令一致，脚本自动发现环境，无需配
NODE_PATH
快速开始（3 步）
1. 准备数据 → 写一个 data.json：{ "folder": "输出名", "games": [ { "n": "游戏名", "d": "文案", "s": 分数 } ] }
2. 运行渲染 → node scripts/render_card.js data.json
3. 拿图 → 自动输出到 桌面/<folder>/ 并自动打开文件夹
> 只需 games 一项即可出图，标题/标语等不填会自动用默认值。
> 首次使用若报缺依赖：先跑一次 node scripts/setup.js（会自动装好 puppeteer-core）。
只看一个文件就能做完全流程 → references/CHEATSHEET.md（一页纸速查）。
何时使用
- 用户要求制作「游戏 TOP10 榜单 / 手游推荐榜 / 盘点卡片 / 图文卡片」
- 用户说「做卡片 / 出图 / 榜单 / 盘点 / TOP10 / 推荐榜」
- 不限游戏品类：手游、端游、二次元、休闲、竞技均可
不适用：短视频脚本（另有视频技能）、只要纯文字榜单（无需出图时直接写文字即可）。
全流程（7 步，缺一不可）
1. 理解需求 → 提取参数（主题/必含游戏/数量/平台/文案长度）
2. 智能补齐 → 缺参数优先自推断，仅主题这类核心项问一次
3. 联网核实 → WebSearch 显式带当前年份，查每款游戏最新动态/停服状态
4. 生成内容 → 爆款标题 + 玩家口语化卡片文案 + 分数
5. 匹配图标 → EXACT_MAP 精确匹配，缺的联网下载并登记
6. 渲染成图 → 写 data.json → 跑 scripts/render_card.js
7. 自检交付 → 三重身份自检（内容/布局/规则）→ 桌面 + 自动打开
参数速查（人话版）
| 参数 | 说人话 | 默认 |
|---|---|---|
| 盘点主题 | 这份榜单评什么 | 需指定或问一次 |
| 必含游戏 | 哪几款一定要上榜 | 用户指定 |
| 卡片数量 | 榜单放几款 | 10（可 5/10/任意） |
| 文案长度 | 每款写多少字 | 12-25 字（两行内） |
| 分数模式 | 要不要打分 | 带，100 分制 |
| 输出平台 | 发哪儿 | 抖音 |
铁律（违反任一条 = 返工）
- 零虚构：版本号、活动、评分、数据必须来自 WebSearch 或用户提供，绝不编造
- 搜索带年份：WebSearch 必须显式加当前年份（如「2026 年」），否则默认返回去年旧数据
- 文案不堆关键词：文案只介绍游戏本身，不刻意呼应榜单主题
- 文案各有性格：每款句式用词侧重点各不相同，禁止同模板套 N 遍，真实玩家口语，拒绝营销话术
- 分数非等差：禁等差序列，头部差距小、中间断崖、尾部跌穿；脚本已内置单调清理
- 文案两行以内：手机阅读，短而有力
- 无浮夸比喻：禁用「比 XX 还上头」这类，有人味但不夸张
- 字号手机可读：描述 ≥22px、游戏名 ≥28px（脚本已固化）
- 游戏名不截断：长名（如「崩坏：星穹铁道」）确保完整显示
渲染
node scripts/setup.js # 首次：一次性环境准备（缺依赖自动装）
node scripts/env_check.js # 可选：环境 + 渲染链路自检
node scripts/render_card.js data.json # 渲染（自动重试 · 自动开文件夹）
可选参数：--out <目录> --scale 1-3 --no-open。
详细参数、data.json 格式、图标规则、排错见 references/render-guide.md。
自检清单（交付前必过）
【内容】
[ ] 每款游戏动态最新（搜索带年份）
[ ] 无虚构版本号/数据/评分
[ ] 文案各有性格，无同模板
[ ] 分数非等差
[ ] 无浮夸比喻
【布局】
[ ] 游戏名无截断/省略号
[ ] 描述文字不溢出
[ ] 图标全加载（无灰色「?」）
[ ] 字号手机可读
【交付】
[ ] 图片已生成到桌面文件夹
[ ] 文件夹已打开
文件地图（按需读）
| 想了解 | 读这个 |
|---|---|
| 全套规则一页纸 | references/CHEATSHEET.md ⭐ 最常用 |
| 渲染参数 / data.json / 图标 / 排错 | references/render-guide.md |
| 文案与爆款标题细则、正反案例 | references/copy-rules.md |
| 上传市场的元数据规范 | references/platform-spec.md |
| 数据模板 | references/data.example.json |
scripts/
render_card.js— 渲染主脚本（自动发现环境 · 自动重试 · 自动选端口 · 自动开文件夹）setup.js— 一次性环境准备（缺 puppeteer-core 自动安装）env_check.js— 环境与渲染链路自检
assets/
logo.png— 技能图标（512×512）icons/— 内嵌图标库（146 个，自包含）
