@topmindspace/tms-skills 0.3.0 → 0.3.1

package/CHANGELOG.md

@@ -1,3 +1,30 @@
+## [0.3.1] - 2026-09-29
+
+> 根包 0.3.0 → **0.3.1**（patch）；4 个技能 `version` 保持不动（top-ppt-html 0.1.19，其余 0.1.0）。
+> 整仓同 tag 发版，技能 `version` 独立演进（见 docs/PUBLISHING.md）。
+
+### topmind-cover：风格库按爆款封面重沉淀 + 样张重制
+
+- `references/cover-styles.md` 按 7 张爆款参考封面 + Manus 实战封面重沉淀为 **8 种风格**：
+  爆款干货（`gan-huo`）/ 巨字宣言（`big-type`）/ 品牌发布（`brand-launch`）/
+  教程步骤（`tutorial-steps`）/ IP 趣味（`ip-fun`）/ 资讯快报（`news-flash`）/
+  极简留白（`minimal`，保留）/ 杂志编辑（`magazine`，保留），
+  每种含适用场景、构图公式、配色 hex、标题写法规范（4~8 字、数字/关键词彩色突出）、
+  中英 prompt 配方、避坑；删除旧 6 风格。
+- `assets/examples/` 样张全部重制：**16 张**（8 风格 × 1200×675 主图 + 900×383 公众号中央裁剪版）
+  + `overview.png`（8 宫格总览图），逐张目检（标题逐字准确、无乱码、中央 60% 安全区），
+  7 次返工均为"底部元素超出安全区"；旧 12 张移除。
+- 提炼规律：标题字巨大化（占画面高 22%~45%）、左文右图通用分区、三层文字结构
+  （大标题 + 胶囊/笔刷副标题 + 底部标签条）、数字前置造冲击、背景极简浅色。
+- 根 README（中/英）、cover README（中/英）、cover SKILL.md 嵌入总览图（GitHub 绝对 URL）
+  + 8 风格一行式索引；用法"6 选 1"→"8 选 1"。
+
+### bug 修复
+
+- topmind-wechat-post `scripts/md2wechat.py`：本地图片文件缺失时未登记进"图片上传清单"
+  （用户按清单补图会漏传）；现登记 `⚠ 本地文件缺失` 行并计入"图片 N 张"计数。
+  HTML 仍保留断链占位（设计选择），清单已标注。
+
 ## [0.3.0] - 2026-09-29
 
 > 根包 0.2.0 → **0.3.0**（minor，新功能）；4 个技能 `version` 保持不动（top-ppt-html 0.1.19，其余 0.1.0）。

package/README.en.md

@@ -37,12 +37,29 @@ npx @topmindspace/tms-skills install topmind-x-article
 
 ### topmind-cover · Cover art generation
 
-Shared cover art for X long-form and WeChat: striking, eye-catching, theme-focused. Built-in **6-style cover style library** (bold poster / futuristic tech / editorial magazine / minimalist / guochao illustration / cyber glitch art — each with use cases, hex palettes, font suggestions, Chinese+English prompt recipes) + **12 dual-size example images** (`assets/examples/`, shipped with the package): **pick a style → check the example → compose the prompt from the recipe**, then one-click crop to both platform sizes with `crop-cover.py` (X 1200×675, WeChat 900×383).
+Shared cover art for X long-form and WeChat: striking, eye-catching, theme-focused. Built-in **8-style cover style library** (viral dry-goods / giant-type manifesto / brand launch / tutorial steps / fun IP / news flash / minimalist / editorial magazine — each with use cases, hex palettes, font suggestions, Chinese+English prompt recipes) + **17 dual-size example images** (`assets/examples/`, shipped with the package): **pick a style → check the example → compose the prompt from the recipe**, then one-click crop to both platform sizes with `crop-cover.py` (X 1200×675, WeChat 900×383).
 
 ```bash
 npx @topmindspace/tms-skills install topmind-cover
 ```
 
+**Style gallery** (8-style overview; full-size per-style shots in `topmind-cover/assets/examples/<style>.png`, recipes in [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md)):
+
+<p align="center">
+  <img src="https://github.com/topmindspace/tms-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 8 cover-style overview" width="960" />
+</p>
+
+| Style | Best for |
+|-------|----------|
+| Viral dry-goods `gan-huo` | Tested picks, reviews, roundups; default for first-person "I tried it all for you" posts |
+| Giant-type manifesto `big-type` | Opinion pieces, deep essays, launch manifestos; default for one-sentence-stance pieces |
+| Brand launch `brand-launch` | Product launches, version updates, official best practices / whitepapers; first choice when a brand is the subject |
+| Tutorial steps `tutorial-steps` | Tutorials, onboarding guides, step-by-step walkthroughs, beginner-proof recipes |
+| Fun IP `ip-fun` | Case studies, data recaps, retrospectives, series (part 1 / part 2) |
+| News flash `news-flash` | News, flashes, hot-topic explainers, interview teasers, "myth-busting" angles |
+| Minimal `minimal` | Essays, book reviews, light takes, lifestyle musings; WeChat "light reading" pieces |
+| Editorial magazine `magazine` | In-depth interviews, profiles, business analysis, year-in-review; when "craft / trust" matters |
+
 > Let ideas fly — make good thinking visible.
 
 <p align="center">
@@ -101,22 +118,15 @@ See [top-ppt-html/README.md](./top-ppt-html/README.md#html-header-toolbar) and [
 | [`top-ppt-html`](./top-ppt-html/) | **0.1.19** | Formal business decks: paginated HTML + editable 16:9 PPTX; dual delivery · MD3-inspired density; 3 modes × 9 styles; strict 0/0 |
 | [`topmind-wechat-post`](./topmind-wechat-post/) | **0.1.0** | WeChat article lifecycle: package, review, 3 quality gates, inline typography & publish checklist |
 | [`topmind-x-article`](./topmind-x-article/) | **0.1.0** | X long-form one-click publish: Markdown → paste-ready plain text + cover + checklist |
-| [`topmind-cover`](./topmind-cover/) | **0.1.0** | Cover art for X / WeChat: striking, theme-focused; 6-style cover style library + 12 dual-size example images, size specs + crop tooling |
+| [`topmind-cover`](./topmind-cover/) | **0.1.0** | Cover art for X / WeChat: striking, theme-focused; 8-style cover style library + 17 dual-size example images, size specs + crop tooling |
 
-Installer [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) is **0.3.0** (whole-repo same-tag releases).
+Installer [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) is **0.3.1** (whole-repo same-tag releases).
 
 ### topmind-cover · Cover style library
 
-| Style | In one line | Typical topics |
-|-------|-------------|----------------|
-| Bold poster `big-poster` | One-sentence stance, maximum impact | Opinion pieces, hot takes |
-| Futuristic tech `tech-future` | Neon blue / electric violet on deep navy | AI / LLMs / agents |
-| Editorial magazine `magazine` | Restrained, premium, trustworthy | In-depth interviews, profiles |
-| Minimalist `minimal` | Vast negative space, room to breathe | Essays, book reviews, light takes |
-| Guochao illustration `guochao` | Vermilion / dark teal / gold, cultural punch | Trad culture, festivals, heritage |
-| Cyber glitch art `cyber-glitch` | RGB channel-split, digital-decay aesthetic | Net culture, cyberpunk |
+Style index and the 8-grid overview are in the topmind-cover skill intro above.
 
-**Three steps to a cover**: ① pick 1 of 6 styles by topic → ② check the matching example in [`topmind-cover/assets/examples/`](./topmind-cover/assets/examples/) → ③ compose the prompt from that style's recipe in [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md). 12 example images (6 styles × 1200×675 master + 900×383 WeChat center-crop, ~6.4MB) ship with the npm package; **safe-zone rule**: title text and key subject must stay inside the central vertical 60% safe zone.
+**Three steps to a cover**: ① pick 1 of 8 styles by topic → ② check the matching example in [`topmind-cover/assets/examples/`](./topmind-cover/assets/examples/) → ③ compose the prompt from that style's recipe in [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md). 17 example images (8 styles × 1200×675 master + 900×383 WeChat center-crop + `overview.png` 8-grid overview, ~7.5MB) ship with the npm package; **safe-zone rule**: title text and key subject must stay inside the central vertical 60% safe zone.
 
 ## Install
 
@@ -126,7 +136,7 @@ Installer [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspa
 npx @topmindspace/tms-skills list
 npx @topmindspace/tms-skills install top-ppt-html
 npx @topmindspace/tms-skills install top-ppt-html --to ./.claude/skills
-npx @topmindspace/tms-skills@0.3.0 install top-ppt-html   # pin
+npx @topmindspace/tms-skills@0.3.1 install top-ppt-html   # pin
 ```
 
 ```bash

package/README.md

@@ -35,12 +35,29 @@ npx @topmindspace/tms-skills install topmind-x-article
 
 ### topmind-cover · 封面配图生成
 
-X 长文与公众号共用的封面图：震撼、醒目、主题突出。内置 **6 种封面风格库**（震撼大字报 / 科技未来感 / 杂志编辑风 / 极简留白 / 国潮插画 / 赛博故障艺术，含适用场景、配色 hex、字体建议、中英 prompt 配方）+ **12 张双尺寸示例图**（`assets/examples/`，随包发布）：**选风格 → 看示例 → 按配方组 prompt** 三步出图，`crop-cover.py` 一键裁出双平台尺寸（X 1200×675、公众号 900×383）。
+X 长文与公众号共用的封面图：震撼、醒目、主题突出。内置 **8 种封面风格库**（爆款干货 / 巨字宣言 / 品牌发布 / 教程步骤 / IP 趣味 / 资讯快报 / 极简留白 / 杂志编辑，含适用场景、配色 hex、字体建议、中英 prompt 配方）+ **17 张双尺寸示例图**（`assets/examples/`，随包发布）：**选风格 → 看示例 → 按配方组 prompt** 三步出图，`crop-cover.py` 一键裁出双平台尺寸（X 1200×675、公众号 900×383）。
 
 ```bash
 npx @topmindspace/tms-skills install topmind-cover
 ```
 
+**封面风格样张**（8 宫格总览；单风格大图见 `topmind-cover/assets/examples/<风格>.png`，配方见 [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md)）：
+
+<p align="center">
+  <img src="https://github.com/topmindspace/tms-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 8 封面风格总览" width="960" />
+</p>
+
+| 风格 | 适用场景 |
+|------|----------|
+| 爆款干货 `gan-huo` | 干货清单、评测、盘点、实测筛选；"我替你试完了/筛完了"类第一人称实测文默认选它 |
+| 巨字宣言 `big-type` | 观点评论、深度长文、产品/版本发布宣言；"一句话立场"类文章默认选它 |
+| 品牌发布 `brand-launch` | 产品发布、版本更新、官方最佳实践/白皮书；有明确品牌主体的内容首选 |
+| 教程步骤 `tutorial-steps` | 教程、上手指南、分步实操、保姆级攻略 |
+| IP 趣味 `ip-fun` | 实战案例、数据战报、复盘、系列连载（上/下篇） |
+| 资讯快报 `news-flash` | 资讯、快讯、热点解读、人物专访预告、"祛魅/揭秘"类选题 |
+| 极简留白 `minimal` | 随笔、书评、轻观点、生活感悟；公众号"轻阅读"类文章 |
+| 杂志编辑 `magazine` | 深度访谈、人物特写、商业分析、年度盘点；需要"质感/信任感"时用它 |
+
 > 让 idea 飞，好想法被看见。
 
 <p align="center">
@@ -99,22 +116,15 @@ npx @topmindspace/tms-skills install topmind-cover
 | [`top-ppt-html`](./top-ppt-html/) | **0.1.19** | 正式商务演示：HTML 可翻页 + 16:9 可编辑 PPTX；双交付 · MD3 密度克制；三模式 × 九风格；strict 0/0 |
 | [`topmind-wechat-post`](./topmind-wechat-post/) | **0.1.0** | 公众号文章全生命周期：交付包、审校改写、质量三关、微信内联排版与发布清单 |
 | [`topmind-x-article`](./topmind-x-article/) | **0.1.0** | X 长文一键发布：Markdown 原稿转可直接粘贴的纯文本 + 封面图 + 发布清单 |
-| [`topmind-cover`](./topmind-cover/) | **0.1.0** | 文章封面配图（X / 公众号共用）：震撼醒目主题突出；6 风格封面风格库 + 12 张双尺寸示例图，尺寸规范 + 裁剪落盘 |
+| [`topmind-cover`](./topmind-cover/) | **0.1.0** | 文章封面配图（X / 公众号共用）：震撼醒目主题突出；8 风格封面风格库 + 17 张双尺寸示例图，尺寸规范 + 裁剪落盘 |
 
-安装器 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 为 **0.3.0**（整仓同 tag 发版）。
+安装器 [`@topmindspace/tms-skills`](https://www.npmjs.com/package/@topmindspace/tms-skills) 为 **0.3.1**（整仓同 tag 发版）。
 
 ### topmind-cover · 封面风格库
 
-| 风格 | 一句话 | 典型题材 |
-|------|--------|----------|
-| 震撼大字报 `big-poster` | 一句话立场，冲击力拉满 | 观点评论、热点快评 |
-| 科技未来感 `tech-future` | 霓虹蓝/电光紫，深空藏青底 | AI / 大模型 / 智能体 |
-| 杂志编辑风 `magazine` | 克制高级，质感与信任感 | 深度访谈、人物特写 |
-| 极简留白 `minimal` | 大面积留白，给版面呼吸感 | 随笔、书评、轻观点 |
-| 国潮插画 `guochao` | 朱红/黛青/鎏金，文化感 | 传统文化、节气、非遗 |
-| 赛博故障艺术 `cyber-glitch` | RGB 错位，数字 decay 美学 | 网络文化、赛博朋克 |
+风格索引与 8 宫格总览样张见上文 topmind-cover 技能介绍处。
 
-**三步出图**：① 按题材从 6 风格选 1 → ② 看 [`topmind-cover/assets/examples/`](./topmind-cover/assets/examples/) 对应示例图 → ③ 按 [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md) 该风格的 prompt 配方组 prompt。12 张示例图（6 风格 × 1200×675 主图 + 900×383 公众号中央裁剪版，约 6.4MB）随 npm 包发布；**安全区铁律**：标题字与关键主体必须落在画面中央垂直 60% 安全区内。
+**三步出图**：① 按题材从 8 风格选 1 → ② 看 [`topmind-cover/assets/examples/`](./topmind-cover/assets/examples/) 对应示例图 → ③ 按 [`references/cover-styles.md`](./topmind-cover/references/cover-styles.md) 该风格的 prompt 配方组 prompt。17 张示例图（8 风格 × 1200×675 主图 + 900×383 公众号中央裁剪版 + `overview.png` 8 宫格总览，约 7.5MB）随 npm 包发布；**安全区铁律**：标题字与关键主体必须落在画面中央垂直 60% 安全区内。
 
 ## 安装
 
@@ -124,7 +134,7 @@ npx @topmindspace/tms-skills install topmind-cover
 npx @topmindspace/tms-skills list
 npx @topmindspace/tms-skills install top-ppt-html
 npx @topmindspace/tms-skills install top-ppt-html --to ./.claude/skills
-npx @topmindspace/tms-skills@0.3.0 install top-ppt-html   # 钉版本
+npx @topmindspace/tms-skills@0.3.1 install top-ppt-html   # 钉版本
 ```
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@topmindspace/tms-skills",
-  "version": "0.3.0",
+  "version": "0.3.1",
   "description": "TopMindspace 智能体技能 monorepo — 通过 npm / GitHub npx 安装技能（top-ppt-html：HTML+PPT 双交付，正式商务演示文稿）。",
   "license": "MIT",
   "author": "TopMindspace",

package/top-ppt-html/README.en.md

@@ -18,7 +18,7 @@ Plenty of PPT skills exist. This one is for **formal business presenting**: clea
 </p>
 
 - Skill id: `top-ppt-html`; brand: **TopPPT HTML**
-- Version: **v0.1.19** (same tag as `@topmindspace/tms-skills@0.3.0`)
+- Version: **v0.1.19** (same tag as `@topmindspace/tms-skills@0.3.1`)
 - **Agent entry**: `SKILL.md` → `references/playbook.md` (L1) → L2 on demand
 - **Human maintainers**: this README (install / commands / layout); do not treat it as the generation spec
 
@@ -73,7 +73,7 @@ Also: arrow-key paging; **Esc** closes modals. After style/theme change, re-run
 
 ```bash
 npx @topmindspace/tms-skills install top-ppt-html
-npx @topmindspace/tms-skills@0.3.0 install top-ppt-html
+npx @topmindspace/tms-skills@0.3.1 install top-ppt-html
 npx github:topmindspace/tms-skills install top-ppt-html
 ```
 

package/top-ppt-html/README.md

@@ -18,7 +18,7 @@
 </p>
 
 - 技能标识：`top-ppt-html`；品牌名：**TopPPT HTML**
-- 版本：**v0.1.19**（与 `@topmindspace/tms-skills@0.3.0` 同 tag）
+- 版本：**v0.1.19**（与 `@topmindspace/tms-skills@0.3.1` 同 tag）
 - **智能体入口**：`SKILL.md` → `references/playbook.md`（L1）→ L2 按需
 - **人类维护者**：本 README（安装 / 命令 / 目录）；勿把本文件当生成规范
 

package/topmind-cover/README.en.md

@@ -4,6 +4,23 @@
 
 A reusable skill for generating cover art for X long-form posts and WeChat articles. Goal: **striking, eye-catching, theme-focused**.
 
+## Style gallery
+
+<p align="center">
+  <img src="https://github.com/topmindspace/tms-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 8 cover-style overview" width="960" />
+</p>
+
+| Style | Best for |
+|-------|----------|
+| Viral dry-goods `gan-huo` | Tested picks, reviews, roundups; default for first-person "I tried it all for you" posts |
+| Giant-type manifesto `big-type` | Opinion pieces, deep essays, launch manifestos; default for one-sentence-stance pieces |
+| Brand launch `brand-launch` | Product launches, version updates, official best practices / whitepapers; first choice when a brand is the subject |
+| Tutorial steps `tutorial-steps` | Tutorials, onboarding guides, step-by-step walkthroughs, beginner-proof recipes |
+| Fun IP `ip-fun` | Case studies, data recaps, retrospectives, series (part 1 / part 2) |
+| News flash `news-flash` | News, flashes, hot-topic explainers, interview teasers, "myth-busting" angles |
+| Minimal `minimal` | Essays, book reviews, light takes, lifestyle musings; WeChat "light reading" pieces |
+| Editorial magazine `magazine` | In-depth interviews, profiles, business analysis, year-in-review; when "craft / trust" matters |
+
 ## Install
 
 ```bash
@@ -12,7 +29,7 @@ npx @topmindspace/tms-skills install topmind-cover
 
 ## Usage
 
-0. **Pick a style (3 steps, required)**: choose 1 of 6 styles from `references/cover-styles.md` by topic
+0. **Pick a style (3 steps, required)**: choose 1 of 8 styles from `references/cover-styles.md` by topic
    → check `assets/examples/<style>.png` to confirm the visual language
    → compose the prompt from that style's recipe (replace `{TITLE}` with the real title).
 1. Input: article title + 3 theme keywords + platform (x / wechat / both, default both).
@@ -28,8 +45,8 @@ python3 scripts/crop-cover.py <main-image> --out-dir <package>/images/
 
 ## Style library & examples
 
-- **Style library** `references/cover-styles.md`: 6 styles (bold poster / futuristic tech / editorial magazine / minimalist / guochao illustration / cyber glitch art), each with use cases, hex palettes, font suggestions, Chinese+English prompt recipes, and pitfalls.
-- **Example images** [assets/examples/](./assets/examples/): 12 (6 styles × 1200×675 master + 900×383 WeChat center-crop, ~6.4MB), shipped with the package, free to reuse or adapt (manifest + safe-zone notes + reuse terms in [assets/examples/README.md](./assets/examples/README.md)).
+- **Style library** `references/cover-styles.md`: 8 styles (viral dry-goods / giant-type manifesto / brand launch / tutorial steps / fun IP / news flash / minimalist / editorial magazine), each with use cases, hex palettes, font suggestions, Chinese+English prompt recipes, and pitfalls.
+- **Example images** [assets/examples/](./assets/examples/): 17 (8 styles × 1200×675 master + 900×383 WeChat center-crop + `overview.png` 8-grid overview, ~7.5MB), shipped with the package, free to reuse or adapt (manifest + safe-zone notes + reuse terms in [assets/examples/README.md](./assets/examples/README.md)).
 - **Safe-zone rule**: title text and key subject must stay inside the central vertical 60% safe zone (keep the top/bottom 13%+ free of title text), or the WeChat center crop will cut the title.
 
 ## Sizes

package/topmind-cover/README.md

@@ -4,6 +4,23 @@
 
 为 X 长文和公众号文章生成封面图的可复用技能。目标：**震撼、醒目、主题突出**。
 
+## 风格样张
+
+<p align="center">
+  <img src="https://github.com/topmindspace/tms-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 8 封面风格总览" width="960" />
+</p>
+
+| 风格 | 适用场景 |
+|------|----------|
+| 爆款干货 `gan-huo` | 干货清单、评测、盘点、实测筛选；"我替你试完了/筛完了"类第一人称实测文默认选它 |
+| 巨字宣言 `big-type` | 观点评论、深度长文、产品/版本发布宣言；"一句话立场"类文章默认选它 |
+| 品牌发布 `brand-launch` | 产品发布、版本更新、官方最佳实践/白皮书；有明确品牌主体的内容首选 |
+| 教程步骤 `tutorial-steps` | 教程、上手指南、分步实操、保姆级攻略 |
+| IP 趣味 `ip-fun` | 实战案例、数据战报、复盘、系列连载（上/下篇） |
+| 资讯快报 `news-flash` | 资讯、快讯、热点解读、人物专访预告、"祛魅/揭秘"类选题 |
+| 极简留白 `minimal` | 随笔、书评、轻观点、生活感悟；公众号"轻阅读"类文章 |
+| 杂志编辑 `magazine` | 深度访谈、人物特写、商业分析、年度盘点；需要"质感/信任感"时用它 |
+
 ## 安装
 
 ```bash
@@ -12,7 +29,7 @@ npx @topmindspace/tms-skills install topmind-cover
 
 ## 用法
 
-0. **选风格（三步，必做）**：按题材从 `references/cover-styles.md` 选 1 种风格（6 选 1）
+0. **选风格（三步，必做）**：按题材从 `references/cover-styles.md` 选 1 种风格（8 选 1）
    → 看 `assets/examples/<风格>.png` 示例图，确认视觉语言符合预期
    → 按该风格的 prompt 配方组 prompt（把 `{TITLE}` 换成实际标题）。
 1. 输入文章标题 + 3 个主题关键词 + 平台（x / wechat / both，默认 both）。
@@ -28,8 +45,8 @@ python3 scripts/crop-cover.py <主图> --out-dir <包>/images/
 
 ## 风格库与示例图
 
-- **风格库** `references/cover-styles.md`：6 种风格（震撼大字报 / 科技未来感 / 杂志编辑风 / 极简留白 / 国潮插画 / 赛博故障艺术），每种含适用场景、配色 hex、字体建议、中英 prompt 配方、避坑。
-- **示例图** [assets/examples/](./assets/examples/)：12 张（6 风格 × 1200×675 主图 + 900×383 公众号中央裁剪版，约 6.4MB），随包发布，可直接拿去用/改（清单 + 安全区说明 + 复用声明见 [assets/examples/README.md](./assets/examples/README.md)）。
+- **风格库** `references/cover-styles.md`：8 种风格（爆款干货 / 巨字宣言 / 品牌发布 / 教程步骤 / IP 趣味 / 资讯快报 / 极简留白 / 杂志编辑），每种含适用场景、配色 hex、字体建议、中英 prompt 配方、避坑。
+- **示例图** [assets/examples/](./assets/examples/)：17 张（8 风格 × 1200×675 主图 + 900×383 公众号中央裁剪版 + `overview.png` 8 宫格总览，约 7.5MB），随包发布，可直接拿去用/改（清单 + 安全区说明 + 复用声明见 [assets/examples/README.md](./assets/examples/README.md)）。
 - **安全区铁律**：标题字与关键主体必须落在画面中央垂直 60% 安全区内（上下各预留 13%+ 不放标题字），否则公众号中央裁剪会切掉标题。
 
 ## 尺寸

package/topmind-cover/SKILL.md

@@ -29,6 +29,25 @@ updated: 2026-09-29
 标题/主题 → 风格模板 → 生成 → 检查 → 裁剪双尺寸 → 落盘命名
 ```
 
+## 风格样张
+
+<p align="center">
+  <img src="https://github.com/topmindspace/tms-skills/raw/main/topmind-cover/assets/examples/overview.png" alt="topmind-cover · 8 封面风格总览" width="960" />
+</p>
+
+| 风格 | 适用场景 |
+|------|----------|
+| 爆款干货 `gan-huo` | 干货清单、评测、盘点、实测筛选；"我替你试完了/筛完了"类第一人称实测文默认选它 |
+| 巨字宣言 `big-type` | 观点评论、深度长文、产品/版本发布宣言；"一句话立场"类文章默认选它 |
+| 品牌发布 `brand-launch` | 产品发布、版本更新、官方最佳实践/白皮书；有明确品牌主体的内容首选 |
+| 教程步骤 `tutorial-steps` | 教程、上手指南、分步实操、保姆级攻略 |
+| IP 趣味 `ip-fun` | 实战案例、数据战报、复盘、系列连载（上/下篇） |
+| 资讯快报 `news-flash` | 资讯、快讯、热点解读、人物专访预告、"祛魅/揭秘"类选题 |
+| 极简留白 `minimal` | 随笔、书评、轻观点、生活感悟；公众号"轻阅读"类文章 |
+| 杂志编辑 `magazine` | 深度访谈、人物特写、商业分析、年度盘点；需要"质感/信任感"时用它 |
+
+单风格大图：`assets/examples/<style>.png`；配方：`references/cover-styles.md`。
+
 ## 尺寸表
 
 | 平台 | 尺寸 | 比例 | 备注 |
@@ -41,7 +60,7 @@ updated: 2026-09-29
 ## 工作流
 
 0. **选风格（三步，必做）**：
-   ① 按题材从 `references/cover-styles.md` 选 1 种风格（6 选 1）；
+   ① 按题材从 `references/cover-styles.md` 选 1 种风格（8 选 1）；
    ② 看 `assets/examples/<style>.png` 示例图，确认视觉语言符合预期；
    ③ 按该风格的 prompt 配方组 prompt（把 `{TITLE}` 换成实际标题）。
    示例清单见 `assets/examples/README.md`。

package/topmind-cover/assets/examples/README.md

@@ -1,29 +1,37 @@
 # 封面风格示例图
 
-6 种风格 × 2 种尺寸 = 12 张示例（共约 6.4MB，随 npm 包发布，npx 安装即得）：
+8 种风格 × 2 种尺寸 = 16 张示例（共约 7.5MB，随 npm 包发布，npx 安装即得），
+另附 `overview.png`（8 宫格总览，2360×854）。
 
 - `<style>.png`（1200×675，X 长文封面 / 公众号共用主尺寸）
 - `<style>-wechat.png`（900×383，公众号封面大图，`scripts/crop-cover.py` 中央裁剪版）
+- `overview.png`（8 宫格总览：2 行 × 4 列缩略图 + 风格名标注，选风格时先看它）
 
 | 文件 | 风格 | 适用场景（一句话） |
 |------|------|--------------------|
-| `big-poster.png` / `big-poster-wechat.png` | 震撼大字报 | 观点评论、行业观察、热点快评，"一句话立场"类文章默认选它 |
-| `tech-future.png` / `tech-future-wechat.png` | 科技未来感 | AI/大模型/智能体/前沿技术题材，X 长文科技类默认风格 |
-| `magazine.png` / `magazine-wechat.png` | 杂志编辑风 | 深度访谈、人物特写、商业分析，需要质感与信任感时用它 |
-| `minimal.png` / `minimal-wechat.png` | 极简留白 | 随笔、书评、轻观点，给版面"呼吸感"的穿插封面 |
-| `guochao.png` / `guochao-wechat.png` | 国潮插画 | 传统文化、历史、节气、非遗、国货品牌，节日特辑首选 |
-| `cyber-glitch.png` / `cyber-glitch-wechat.png` | 赛博故障艺术 | 网络文化、赛博朋克、前沿实验，年轻化/亚文化话题 |
+| `gan-huo.png` / `gan-huo-wechat.png` | 爆款干货 | 干货清单、评测、盘点、实测筛选；"我替你试完了/筛完了"类第一人称实测文默认选它 |
+| `big-type.png` / `big-type-wechat.png` | 巨字宣言 | 观点评论、深度长文、产品/版本发布宣言；"一句话立场"类文章默认选它 |
+| `brand-launch.png` / `brand-launch-wechat.png` | 品牌发布 | 产品发布、版本更新、官方最佳实践/白皮书；有明确品牌主体的内容首选 |
+| `tutorial-steps.png` / `tutorial-steps-wechat.png` | 教程步骤 | 教程、上手指南、分步实操、保姆级攻略 |
+| `ip-fun.png` / `ip-fun-wechat.png` | IP 趣味 | 实战案例、数据战报、复盘、系列连载（上/下篇） |
+| `news-flash.png` / `news-flash-wechat.png` | 资讯快报 | 资讯、快讯、热点解读、人物专访预告、"祛魅/揭秘"类选题 |
+| `minimal.png` / `minimal-wechat.png` | 极简留白 | 随笔、书评、轻观点、生活感悟；公众号"轻阅读"类文章 |
+| `magazine.png` / `magazine-wechat.png` | 杂志编辑 | 深度访谈、人物特写、商业分析、年度盘点；需要"质感/信任感"时用它 |
 
 详细配方（配色 hex / 字体 / 中英 prompt / 避坑）见 `../references/cover-styles.md`。
 
 ## 安全区说明（重要）
 
-所有示例的标题字都落在**中央垂直 60% 安全区**内——这正是 `900×383` 中央裁剪版标题不被裁掉的原因。
+所有示例的标题字与关键元素都落在**中央垂直 60% 安全区**（画面垂直 20%~80%）内——
+这正是 `900×383` 中央裁剪版（保留画面垂直 21.6%~78.4%）标题不被裁掉的原因。
 自己组 prompt 时务必遵守：标题/关键主体不得超出上下各 13% 的禁区，否则公众号版会被切掉。
-反例：标题压在顶部 15% 处时，`-wechat.png` 里只剩半截字（第一版 tech-future/guochao 示例即如此，已修正）。
+反例：胶囊标签条/副标题横条压在底部 85% 以下时，`-wechat.png` 里会只剩半截或完全消失
+（本轮重制时 gan-huo / big-type / brand-launch / tutorial-steps 均因此返工过）。
 
 ## 复用声明
 
 **示例图可直接拿去用/改，作封面底图或风格参考。**
 拿去用时建议按 `scripts/crop-cover.py` 的流程重新裁剪双尺寸并按包规约命名落盘；
 改图时保留原风格的配色与版式语言，只换主体与标题字，以维持系列感。
+注意：示例标题均为虚构演示文案（如"星火最佳实践""100天"），直接复用前请换成自己的真实标题；
+凡封面上的数字必须在正文中有出处，严禁编造数据。

package/topmind-cover/references/cover-styles.md

@@ -1,10 +1,11 @@
-# 封面风格库（6 种）
+# 封面风格库（8 种）
 
 选风格先看题材，再看系列延续性。同一系列固定一个模板，只换主体与标题字。
 选风格三步走：**先选风格 → 看 `assets/examples/` 对应示例图 → 按本库配方组 prompt**。
 
-每种风格的 prompt 配方都是中英双语模板：`{TITLE}` 为标题文字占位符（≤10 字，
-示例图上用 2~6 字短标题），尺寸固定 1200×675、横构图 16:9。
+每种风格的 prompt 配方都是中英双语模板：`{TITLE}` 为标题文字占位符（短标题 4~8 字）、
+`{KEYWORDS}` 为需要彩色突出的数字/关键词占位符，其余占位符见各风格说明。
+尺寸固定 1200×675、横构图 16:9。标题字逐字写进 prompt；生成后第一件事就是检查标题字。
 
 ## 安全区铁律（所有风格通用）
 
@@ -16,166 +17,305 @@
 
 ---
 
-## 1. big-poster · 震撼大字报
+## 1. gan-huo · 爆款干货
 
-- **适用场景**：观点评论、行业观察、热点快评；X 长文首图、公众号头图都适用，
-  是"一句话立场"类文章的默认选择。
-- **配色方案**：主色深红 `#C8102E`（或墨黑 `#111111` 做深色版），
-  辅色明黄 `#FFC400`（点缀线条/印章），文字色纯白 `#FFFFFF`。
-- **字体建议**：中文标题用 Noto Sans SC Black / 思源黑体 Heavy，
-  标题字号占画面高度 28%~35%，字距紧凑，可做轻微倾斜或描边增强冲击力。
+- **适用场景**：干货清单、评测、盘点、实测筛选类文章；"我替你试完了/筛完了"这类
+  第一人称实测文的默认选择。参考样张：Muse 爆款干货、Manus 2.0 封面。
+- **构图公式**：左右分区。左侧 60% 为文案堆叠区（自上而下：短引子行 → 巨型标题 →
+  底部胶囊标签条）；右侧 40% 为萌物/IP 形象（抱着主题物品，如帖子、产品），
+  形象顶部不超过标题区、不遮挡任何文字。标题字占画面高度 25%~32%。
+- **配色方案**：暖白底 `#FFF9F0`（或米白 `#FAF6EF`）；主标题炭黑 `#1A1A1A`；
+  数字/品牌词用亮蓝 `#2B7FFF`；篇数类数字可用橙红 `#FF4D2E`；
+  关键词下垫黄色笔刷底 `#FFD23F`；底部标签条为蓝色胶囊 `#2B7FFF` 配白字。
+- **标题写法规范**：
+  - 短标题 4~8 字，如"爆款干货""实测报告"；上方加 1~2 行引子小字
+    （"刷了3天时间线/我从上百个帖子里"），引子字号约为标题的 55%。
+  - 数字必须放大并上色："26篇"中的 26 用橙红，"3天"中的 3 用蓝色；
+    品牌词（如 Muse、Manus）用蓝色。
+  - 底部标签条：蓝色圆角胶囊，内放 3 个标签，格式 `⚡四字词 | 📋四字词 | 📊四字词`
+    （如"实测筛选 | 长文精选 | 全流程实操"），字号约为标题的 30%。
 - **prompt 配方**：
   ```
-  中文：震撼中文大字报风格封面，纯深红底色配黑色斜切色块，纸张颗粒质感，
-  画面中央巨型白色粗黑标题"{TITLE}"，占画面一半，极简构图，高对比，
-  横构图16:9，尺寸1200×675，除标题外无其他文字。
+  中文：爆款干货风中文封面，暖白色干净背景，左侧文案区：上方小字引子行，
+  中央巨型炭黑色粗黑标题"{TITLE}"，其中数字与关键词"{KEYWORDS}"用亮蓝色与橙红色突出，
+  关键词下方垫黄色笔刷底色；底部一条蓝色圆角胶囊标签条；右侧一只毛茸茸的可爱
+  IP 萌物抱着与主题相关的物品，萌物占画面右侧三分之一、不遮挡文字，
+  画面中央垂直安全区内，星星小点缀，亲切活泼，横构图16:9，尺寸1200×675。
 
-  EN: Bold Chinese big-character poster style cover, solid crimson red
-  background with black diagonal bands, subtle paper grain. Giant bold white
-  Chinese title "{TITLE}" dominates the center, half the frame. Minimal
-  composition, high contrast, landscape 16:9, 1200x675, no other text.
+  EN: Chinese viral-listicle style cover, clean warm-white background. Left
+  text zone: small intro lines on top, giant bold charcoal-black Chinese
+  title "{TITLE}" at center, with numbers and keywords "{KEYWORDS}" highlighted
+  in bright blue and orange-red, a yellow brush stroke behind keywords; a blue
+  rounded capsule tag bar at the bottom. On the right third, a fluffy cute IP
+  mascot holding a theme-related item, never overlapping the text. All key
+  elements within the central vertical safe zone, tiny star accents, friendly
+  and lively, landscape 16:9, 1200x675.
   ```
+  占位符：`{CHARACTER}` 可替换萌物描述（如"蓝色毛绒小怪物""戴墨镜的猫导演"），
+  必须与文章主题相关。
 - **避坑**：
-  - 标题超过 10 个字必翻车——大字报风格下长标题会被模型挤成小字或错字；
-    长标题先压缩再生成。
-  - 忌加副标题/英文小字/日期：模型极易在小字上造错别字，且破坏冲击力。
-  - 深色版（墨黑底）配白字时，检查文字与背景对比度，边缘加细描边防"糊"。
-
-## 2. tech-future · 科技未来感
-
-- **适用场景**：AI/大模型/智能体/前沿技术题材；X 长文科技类默认风格，
-  Manus / Cue / Agent 这类题材首选。
-- **配色方案**：主色深空藏青 `#0A1628`（近黑），辅色霓虹蓝 `#38BDF8`、
-  电光紫 `#A78BFA`（渐变光效），文字色纯白 `#FFFFFF`。
-- **字体建议**：中文标题用 Noto Sans SC Bold，字号占画面高度 18%~24%，
-  落在画面上部、中央垂直安全区内；英文/数字点缀可用 Rajdhani 或 DIN 风格细体（仅作装饰字，
-  必须人工核对拼写）。
+  - 萌物是配角：占画面不超过 40%，一旦挡住标题字整张作废。
+  - 彩色字不要超过 2 种颜色，三色以上立刻变杂。
+  - 胶囊标签条必须整体落在中央安全区内，上下留白防裁切。
+  - 元素总数 ≤5（引子+标题+标签条+萌物+小点缀），多一件都是负担。
+
+## 2. big-type · 巨字宣言
+
+- **适用场景**：观点评论、深度长文、产品/版本发布宣言；"一句话立场"类文章的默认选择。
+  参考样张：Skill 指南封面。
+- **构图公式**：标题即画面。巨型标题字占画面高度 35%~45%，横跨画面三分之二以上，
+  分两行：上行品牌词/关键词（白色或黑色），下行宣言（品牌色/红色，可做 3D 立体字）；
+  背景为场景化配图（巨型书、建筑、空间纵深），人物极小仅作比例参照；
+  底部一条白色横条放问题式副标题，横条压在画面底部安全区内。
+- **配色方案**：深底版：近黑 `#101014` 底 + 纯白 `#FFFFFF` 字 + 强调红 `#E63B2E`
+  （或品牌色）；浅底版：白底 + 黑字 + 红字。同一系列固定一种底色。
+- **标题写法规范**：
+  - 短标题 4~8 字，分两行断句，如"Skill指南：/从入门到精通"；下行宣言用彩色。
+  - 底部白横条用问句引出内容："如何从0开始构建一个属于自己的Skill?"，
+    字号约为标题的 35%，左对齐。
+  - 右侧可加竖排小字装饰（如一句 slogan），字号小、不抢戏。
 - **prompt 配方**：
   ```
-  中文：科技未来感封面，深空藏青近黑背景，霓虹蓝色电路线条与细颗粒星空，
-  中央主体为发光的抽象AI核心光球，边缘光干净，画面上部、中央垂直安全区内
-  白色粗黑中文标题"{TITLE}"，电影感光影，极简不堆砌，横构图16:9，尺寸1200×675，
-  除标题外无其他文字。
+  中文：震撼巨字宣言风中文封面，深色场景化背景（{SCENE}，如巨型书本/建筑纵深，
+  一位小小人物作比例参照），画面中央巨型中文标题"{TITLE}"占画面近一半，
+  上行白色下行红色粗黑体，可做轻微3D立体质感，极具冲击力；底部一条白色横条，
+  内写黑色问句副标题；标题与横条均在中央垂直安全区内，高对比，
+  横构图16:9，尺寸1200×675。
 
-  EN: Futuristic tech cover, deep navy-black space background with glowing
-  neon-blue circuit lines and fine starfield particles. A sleek abstract
-  glowing AI core orb as central subject with clean rim light. Bold white
-  Chinese title "{TITLE}" in the upper third. Cinematic lighting, minimal,
-  landscape 16:9, 1200x675, no other text.
+  EN: Bold giant-type manifesto Chinese cover, dark scenic background
+  ({SCENE}, e.g. gigantic books / architectural depth, a tiny human figure for
+  scale). Enormous bold Chinese title "{TITLE}" dominates the center, nearly
+  half the frame, white on the first line and red on the second, subtle 3D
+  extruded type feel, maximum impact; a white horizontal bar at the bottom
+  with a black question-style subtitle. Title and bar inside the central
+  vertical safe zone, high contrast, landscape 16:9, 1200x675.
   ```
+  占位符：`{SCENE}` 为场景化配图描述，必须与主题强相关（如 Skill 主题用"巨型操作手册"）。
 - **避坑**：
-  - 霓虹元素别超过 2 种颜色，三色以上画面立刻变"杀马特"。
-  - 主体（光球/芯片/机器人）必须完整不被裁切，且占画面 40% 以上，
-    否则标题和背景会"各说各话"。
-  - 星空颗粒开太大容易显脏：要求"细颗粒"而非"密集星空"。
+  - 标题超过 10 个字必翻车——先压缩成 4~8 字再生成。
+  - 3D 立体字与背景对比度不够会"糊"：深底配白字、浅底配黑字，边缘加细描边。
+  - 背景人物只是比例参照，放大抢戏就喧宾夺主。
+  - 字不能顶到画面边缘：四周至少留 5% 空气，否则公众号裁剪会切字。
 
-## 3. magazine · 杂志编辑风
+## 3. brand-launch · 品牌发布
 
-- **适用场景**：深度访谈、人物特写、商业分析、年度盘点；公众号长文首选，
-  需要"质感/信任感"时用它。
-- **配色方案**：主色暖灰 `#E8E4DC`（浅底）或墨黑 `#141414`（深底版），
-  辅色砖红 `#B03A2E`（细线/点缀），文字色炭黑 `#2B2B2B`（浅底）/
-  米白 `#F5F1E8`（深底）。
-- **字体建议**：中文标题用 Noto Serif SC Bold（宋体感）或思源黑体 Bold，
-  字号占画面高度 14%~20%，落在左侧下方、中央垂直安全区内；标题上方配一条细色线，
-  杂志感立刻出来。
+- **适用场景**：产品发布、版本更新、官方最佳实践/白皮书；有明确品牌主体的内容首选。
+  参考样张：typesafe AI Jev 封面、Manus 2.0 封面（品牌区部分）。
+- **构图公式**：左文右图。左上品牌 logo 区（AI 不画 logo，prompt 里留空位、后期贴真实 logo）；
+  左侧大标题（品牌词用品牌色渐变 + 其余黑字），标题下手写感副标题 + 品牌色下划线；
+  右侧 50% 为产品/界面展示（深色控制台、App 界面、产品渲染图）；
+  底部 3~4 个卖点图标条：图标 + 中文 + 英文小字。标题字占画面高度 20%~28%。
+- **配色方案**：以品牌主色为准（示例：品红 `#E8408C` 渐变至 `#B02860`）；
+  浅底 `#FDF6F9`（或品牌浅色 tint）；文字炭黑 `#1A1A1A`；
+  图标底色用品牌色 10% 浅底。
+- **标题写法规范**：
+  - 品牌词前置并上色："Jev"用品牌色渐变，"最佳实践"用黑字；短标题 4~8 字。
+  - 副标题口语化、手写感，如"手把手教你改进现有工作流"，下方加品牌色笔刷下划线。
+  - 卖点条格式：`图标 / 中文四字 / 英文小字`（如"更高效率 / Make it faster"），
+    3~4 个，中文在上英文在下，英文仅装饰。
 - **prompt 配方**：
   ```
-  中文：杂志编辑风封面，暖灰色影棚背景，右侧三分之一处黑白质感人物肖像，
-  左侧大面积留白，左侧下方（中央垂直安全区内）炭黑色典雅粗体中文标题"{TITLE}"，标题上方一条砖红
-  色细线，克制高级，杂志封面美学，横构图16:9，尺寸1200×675，除标题外无其他文字。
+  中文：品牌发布风中文封面，品牌浅色背景（{BRAND_TINT}），左上预留空白 logo 区，
+  左侧大标题"{TITLE}"，其中品牌词"{KEYWORDS}"用品牌主色（{BRAND_COLOR}）渐变突出、
+  其余字炭黑色粗黑体；标题下方手写感副标题配品牌色下划线；
+  右侧一半为产品展示（{PRODUCT}，深色界面、发光细节）；底部 3~4 个卖点图标条
+  （图标+中文+英文小字）；干净高级，横构图16:9，尺寸1200×675。
 
-  EN: Editorial magazine style cover, warm light-gray studio background,
-  dramatic black-and-white portrait in the right third, generous negative
-  space on the left. Dark charcoal elegant bold Chinese title "{TITLE}" at
-  lower left, with a thin brick-red rule line above it. Refined, minimal,
-  magazine cover aesthetic, landscape 16:9, 1200x675, no other text.
+  EN: Brand-launch style Chinese cover, light brand-tinted background
+  ({BRAND_TINT}), empty logo area reserved at top-left. Large title "{TITLE}"
+  on the left, brand term "{KEYWORDS}" in gradient brand color
+  ({BRAND_COLOR}), remaining characters in bold charcoal black; handwritten-feel
+  subtitle below with a brand-color underline. Right half shows the product
+  ({PRODUCT}, dark UI with glowing details). Bottom row of 3-4 selling-point
+  icon chips (icon + Chinese + small English). Clean and premium, landscape
+  16:9, 1200x675.
+  ```
+  占位符：`{BRAND_COLOR}`/`{BRAND_TINT}` 为品牌色 hex，`{PRODUCT}` 为产品展示描述；
+  真实 logo 必须后期贴图，绝不用 AI 生成 logo。
+- **避坑**：
+  - 产品界面里的 UI 文字让 AI 生成必出乱码：要求"界面文字模糊/占位块"，
+    或只展示界面氛围不展示可读文字。
+  - 卖点条超过 4 个立刻变说明书；英文小字必须人工核对拼写。
+  - 品牌色渐变只用在品牌词上，全标题上色等于没重点。
+
+## 4. tutorial-steps · 教程步骤
+
+- **适用场景**：教程、上手指南、分步实操、保姆级攻略。参考样张：Reddit 上手教程封面。
+- **构图公式**：左文右卡。左侧：顶部彩色笔刷横条（写起点，如"从0到1"）→
+  大黑标题（4~8 字）→ 底部彩色笔刷横条（内容总结，如"搞懂规则×发帖实操"）；
+  右侧：2~3 张步骤卡片纵向拼贴（撕纸/便签质感），每张含彩色圆章序号（01/02）+
+  小图标 + 短句，卡片间用箭头连接；右上小字点睛（如"先懂规则，再动手"）。
+  标题字占画面高度 22%~30%。
+- **配色方案**：纸白底 `#F7F4EC`；笔刷/序号章用强调红 `#E8401F`
+  （或品牌色）；标题字炭黑 `#1A1A1A`；卡片描边浅灰。
+- **标题写法规范**：
+  - 顶部笔刷条：白字写起点/承诺，"从0到1""7天上手"，4 字以内最有力。
+  - 大标题 4~8 字，如"Reddit上手/保姆级教程"，分两行断句。
+  - 底部笔刷条：白字总结全文骨架，"搞懂规则×发帖实操"，用 × 连接两个关键词。
+  - 步骤卡片内文字极简：序号 + 8 字以内短句（如"看懂平台与社区规则"）。
+- **prompt 配方**：
+  ```
+  中文：教程步骤风中文封面，纸白色温暖背景，左侧：顶部红色笔刷横条白字写"{HOOK}"，
+  中央大号炭黑色粗黑标题"{TITLE}"，底部红色笔刷横条白字写"{SUMMARY}"；
+  右侧两张撕纸质感便签卡片纵向排列，卡片上有红色圆形序号章（01/02）、
+  简笔画小图标与极简短句，卡片间黑色箭头连接；右上角小字点睛；
+  红黑白三色，对比鲜明，横构图16:9，尺寸1200×675。
+
+  EN: Tutorial-steps style Chinese cover, warm paper-white background. Left
+  side: red brush-stroke banner with white text "{HOOK}" on top, large bold
+  charcoal-black Chinese title "{TITLE}" at center, red brush banner with white
+  text "{SUMMARY}" at the bottom. Right side: two torn-paper memo cards
+  stacked vertically, each with a red circular number badge (01/02), a small
+  line icon and minimal short text, connected by a black arrow; small accent
+  text at top-right. Red-black-white palette, crisp contrast, landscape 16:9,
+  1200x675.
+  ```
+  占位符：`{HOOK}` 顶部钩子（≤4 字）、`{SUMMARY}` 底部总结（≤10 字）、
+  卡片短句直接写进 prompt 且每张 ≤8 字（模型小字易错，越短越安全）。
+- **避坑**：
+  - 步骤卡片最多 3 张，第 4 张起画面必乱。
+  - 卡片内一个字都不能多：小字是 AI 错别字重灾区，生成后逐字核对。
+  - 箭头方向必须明确向下/向右，别让模型自由发挥画成回路。
+  - 笔刷横条别压住标题字，上下留 breathing room。
+
+## 5. ip-fun · IP 趣味
+
+- **适用场景**：实战案例、数据战报、复盘、系列连载（上/下篇）。参考样张：AI 视频制作实战封面。
+- **构图公式**：左文右图。左侧：巨型彩色数字行（数字占画面高度 20%+，如"600万播放"，
+  数字彩色、单位黑字）→ 大黑标题（4~8 字）→ 灰色副标题 + 署名（左下小字）；
+  右侧 50% 为趣味 IP 形象：拟人动物/角色 + 主题道具（如猫导演 + 放映机 + 胶片），
+  形象生动、与主题强绑定。
+- **配色方案**：纯白底 `#FFFFFF`；数字用亮蓝 `#2B7FFF`（或品牌色）；
+  标题炭黑 `#1A1A1A`；副标题/署名用中灰 `#9AA0A6`。
+- **标题写法规范**：
+  - 数字前置造冲击："600万播放"中数字放大 1.5 倍并上色，单位用黑字；
+    数字必须真实，严禁编造数据。
+  - 大标题 4~8 字黑粗体，如"AI视频制作实战"。
+  - 副标题灰字说明结构："从想法到成片 · 下篇"；署名 "@Xanderwow" 放左下角小字。
+- **prompt 配方**：
+  ```
+  中文：IP 趣味风中文封面，纯白干净背景，左侧：巨型亮蓝色数字"{NUMBER}"
+  配炭黑色单位字，下方大号炭黑色粗黑标题"{TITLE}"，再下方灰色小字副标题与署名；
+  右侧一半为趣味 IP 形象（{CHARACTER}，如戴墨镜的猫导演操作复古放映机、
+  胶片环绕），形象生动、细节丰富但不遮挡文字；所有文字在中央垂直安全区内，
+  横构图16:9，尺寸1200×675。
+
+  EN: Fun-IP style Chinese cover, clean pure-white background. Left side: huge
+  bright-blue number "{NUMBER}" with charcoal-black unit characters, large
+  bold charcoal-black Chinese title "{TITLE}" below, small gray subtitle and
+  byline underneath. Right half features a playful IP character ({CHARACTER},
+  e.g. a sunglasses-wearing cat director operating a vintage film projector
+  with film reels swirling around), vivid and detailed but never covering the
+  text. All text within the central vertical safe zone, landscape 16:9,
+  1200x675.
   ```
+  占位符：`{NUMBER}` 为真实数据（"600万"）、`{CHARACTER}` 为 IP 形象描述，
+  必须与主题道具绑定（如视频主题 → 导演猫 + 放映机）。
 - **避坑**：
-  - 人物肖像必须用"泛指"描述（商务人士/学者剪影），不得出现可识别的真实人物长相；
-    隐私红线。
-  - 留白区别手痒加装饰字——杂志风的力量全在克制，加元素必俗。
-  - 深底版和浅底版不要混用：同一系列固定一种底色。
+  - 数字造假是红线：封面上的每个数字必须在正文中有出处。
+  - IP 形象再可爱也不能抢字：右侧边界止于画面 55% 处。
+  - 白底最怕"脏"：要求"纯白干净背景"，防模型加渐变/纹理。
+  - 连载标注（上篇/下篇）放副标题里，别进大标题。
 
-## 4. minimal · 极简留白
+## 6. news-flash · 资讯快报
+
+- **适用场景**：资讯、快讯、热点解读、人物专访预告、"祛魅/揭秘"类选题。
+  参考样张：算法工程师祛魅封面。
+- **构图公式**：左文右图。左侧：两行大字标题（上行黑字 4 字、下行品牌色 4~5 字 +
+  感叹号）→ 下方彩色胶囊副标题（问句/悬念）；右侧 35%~50% 为人物或主题元素点缀
+  （二次元人物、产品小物、场景物件），点缀丰富但不进文字区。
+  标题字占画面高度 22%~30%。
+- **配色方案**：白底 `#FFFFFF`；标题黑 `#1A1A1A` + 品牌蓝 `#2B7FFF`
+  （或品牌色）；胶囊副标题用品牌色底 + 白字。
+- **标题写法规范**：
+  - 标题两行、上黑下彩，如"带你祛魅/算法工程师！"，每行 4~6 字；
+    感叹号是点睛，一个就够。
+  - 胶囊副标题用问句制造悬念："薪资？日常？统统告诉你"，问号 + 陈述收尾；
+    问句必须在正文中有答案，不做无答案的标题党。
+  - 右侧点缀可加小标签云（如书脊上的"Machine Learning/PyTorch"），丰富主题氛围。
+- **prompt 配方**：
+  ```
+  中文：资讯快报风中文封面，纯白背景，左侧两行大字标题，上行炭黑色"{TITLE_TOP}"、
+  下行品牌蓝色"{TITLE_BOTTOM}"加感叹号，粗黑体；标题下方蓝色圆角胶囊副标题，
+  白字问句"{SUBTITLE}"；右侧人物/主题元素点缀（{CHARACTER}，如专注的二次元
+  少年、笔记本电脑、代码屏幕、书堆小物），生动但不遮挡文字；
+  所有文字在中央垂直安全区内，横构图16:9，尺寸1200×675。
+
+  EN: News-flash style Chinese cover, white background. Left side: two-line
+  bold headline, charcoal-black "{TITLE_TOP}" on top and brand-blue
+  "{TITLE_BOTTOM}" with exclamation mark below; a blue rounded capsule
+  subtitle with a white question-style "{SUBTITLE}" underneath. Right side
+  decorative figure / theme elements ({CHARACTER}, e.g. a focused anime-style
+  youth, laptop, code screen, book stack props), lively but never covering the
+  text. All text within the central vertical safe zone, landscape 16:9,
+  1200x675.
+  ```
+  占位符：`{TITLE_TOP}` 上行（黑字）、`{TITLE_BOTTOM}` 下行（彩色）、
+  `{SUBTITLE}` 胶囊问句、`{CHARACTER}` 右侧点缀描述。
+- **避坑**：
+  - 感叹号/问号各一个，多了变地摊文学。
+  - 右侧点缀元素别超过 4 件，多了就抢标题的风头。
+  - 胶囊问句的字数 ≤12 字，太长胶囊装不下会被模型挤小。
+  - 热点人物用"泛指"描述，不画可识别真人。
+
+## 7. minimal · 极简留白
 
 - **适用场景**：随笔、书评、轻观点、生活感悟；公众号"轻阅读"类文章，
   或系列中需要"呼吸感"的穿插封面。
+- **构图公式**：大面积留白（≥60%）。一处微小点缀落在右侧中央安全区内
+  （如水墨笔触、孤鸟剪影）；标题小字号放左下角安全区内，不与点缀打架。
+  标题字占画面高度 8%~12%。
 - **配色方案**：主色米白 `#F7F4EC`（或冷白 `#F2F4F6`），
   辅色淡墨 `#9AA0A6`（小面积点缀），文字色深灰 `#3A3A3A`。
-- **字体建议**：中文标题用 Noto Sans SC Medium（不要用 Black，太重），
-  字号占画面高度 8%~12%，落在左下角、中央垂直安全区内，留白 ≥60%。
+- **标题写法规范**：短标题 4~8 字即可，字体用 Noto Sans SC Medium（不用 Black，
+  太重则极简感全失）；不加副标题、不加标签条，克制到底。
 - **prompt 配方**：
   ```
   中文：极致极简主义封面，暖米白背景，大面积留白，一处微小的水墨笔触
   （如孤鸟剪影）点缀在画面右侧中央（中央垂直安全区内），左下角（中央垂直安全区内）
-  小字号深灰色中文标题"{TITLE}"，呼吸感强，禅意，横构图16:9，尺寸1200×675，除标题外无其他文字。
+  小字号深灰色中文标题"{TITLE}"，呼吸感强，禅意，无其他元素，
+  横构图16:9，尺寸1200×675，除标题外无其他文字。
 
   EN: Extreme minimalism cover, warm off-white background with vast empty
   space, one tiny ink-brush stroke (like a lone bird silhouette) near the
   center-right. Small dark-gray Chinese title "{TITLE}" in delicate bold type
-  at the lower-left corner. Calm, airy, zen aesthetic, landscape 16:9,
-  1200x675, no other text.
+  at the lower-left corner. Calm, airy, zen aesthetic, no other elements,
+  landscape 16:9, 1200x675, no other text.
   ```
 - **避坑**：
-  - 极简风对"杂物"零容忍：模型爱加云/山/多余笔触，prompt 里明确"一处""微小""无其他元素"。
-  - 标题字别贪大：字一大立刻变"大字报"，极简感全失。
-  - 公众号 900×383 中央裁剪会吃掉左右留白——主体和标题尽量往中央安全区放。
-
-## 5. guochao · 国潮插画
-
-- **适用场景**：传统文化、历史、节气、非遗、国货品牌题材；公众号文化类、
-  节日特辑首选。
-- **配色方案**：主色朱红 `#D43D2A`，辅色黛青 `#2F4F4F`、鎏金 `#C9A86A`
-  （标题/纹样），文字色金 `#C9A86A` 或米白 `#F5EFE0`。
-- **字体建议**：中文标题用书法感粗体（站酷快乐体/演示佛系体风格描述，
-  或 Noto Serif SC Black），字号占画面高度 20%~28%，可竖排，
-  落在上方（中央垂直安全区内）或中央。
-- **prompt 配方**：
-  ```
-  中文：国潮插画风封面，朱红与黛青大色块碰撞，祥云海浪传统纹样作暗纹背景，
-  中央主体为风格化国风人物或神兽插画，上方（中央垂直安全区内）鎏金书法感
-  中文标题"{TITLE}"，浓烈鲜明，文化感，横构图16:9，尺寸1200×675，除标题外无其他文字。
+  - 对"杂物"零容忍：prompt 明确"一处""微小""无其他元素"，防模型加云加山。
+  - 标题字别贪大：字一大立刻变大字报。
+  - 主体和标题尽量往中央安全区放，防公众号裁剪吃掉左右留白。
 
-  EN: Guochao Chinese-trendy illustration cover, bold vermilion red and dark
-  teal color blocks, traditional cloud-and-wave patterns as subtle background
-  texture. Stylized Chinese-style figure or mythical beast illustration as
-  central subject. Golden calligraphy-style Chinese title "{TITLE}" at the
-  top. Vibrant, cultural, landscape 16:9, 1200x675, no other text.
-  ```
-- **避坑**：
-  - 忌用真实历史人物/文物高精度复刻做主体——一是版权风险，二是模型画不准；
-    用"风格化插画"表述。
-  - 朱红+黛青+鎏金已是三色上限，别再加第四色。
-  - 竖排标题时检查字序：模型偶发把竖排字写成横排或倒序，生成后逐字核对。
-
-## 6. cyber-glitch · 赛博故障艺术
-
-- **适用场景**：网络文化、赛博朋克题材、前沿实验、数字艺术评论；
-  X 长文年轻化/亚文化话题，公众号慎用（读者年龄层偏大时跳过）。
-- **配色方案**：主色深黑 `#0D0D12`，辅色品红 `#FF2E88`、电青 `#00E5FF`
-  （RGB 分离故障色），文字色白 `#FFFFFF`（带品红/青色错位重影）。
-- **字体建议**：中文标题用 Noto Sans SC Black，字号占画面高度 18%~25%，
-  居中，允许轻微 RGB 错位/扫描线质感，但笔画必须完整可辨认。
+## 8. magazine · 杂志编辑风
+
+- **适用场景**：深度访谈、人物特写、商业分析、年度盘点；需要"质感/信任感"时用它，
+  公众号长文首选。
+- **构图公式**：三分法。右侧三分之一为黑白质感人物肖像（泛指描述）；
+  左侧大面积留白；标题放左侧下方安全区内，标题上方一条品牌色/砖红细线。
+  标题字占画面高度 14%~20%。
+- **配色方案**：主色暖灰 `#E8E4DC`（浅底）或墨黑 `#141414`（深底版），
+  辅色砖红 `#B03A2E`（细线/点缀），文字色炭黑 `#2B2B2B`（浅底）/
+  米白 `#F5F1E8`（深底）。
+- **标题写法规范**：短标题 4~8 字，字体用 Noto Serif SC Bold（宋体感）或思源黑体 Bold；
+  标题上方一条细色线是杂志感的灵魂，别省略；深底/浅底同一系列只用一种。
 - **prompt 配方**：
   ```
-  中文：赛博故障艺术风封面，深黑背景，RGB通道分离错位、扫描线与数字噪点，
-  霓虹品红与电青色块碎裂，中央主体为像素化消散的全息人脸/城市剪影，
-  中央白色粗黑中文标题"{TITLE}"带轻微故障错位，笔画完整可辨认，
-  前卫，数字 decay 美学，横构图16:9，尺寸1200×675，除标题外无其他文字。
+  中文：杂志编辑风封面，暖灰色影棚背景，右侧三分之一处黑白质感人物肖像，
+  左侧大面积留白，左侧下方（中央垂直安全区内）炭黑色典雅粗体中文标题"{TITLE}"，
+  标题上方一条砖红色细线，克制高级，杂志封面美学，
+  横构图16:9，尺寸1200×675，除标题外无其他文字。
 
-  EN: Cyberpunk glitch art cover, dark black background with RGB channel-split
-  distortion, scanlines and digital noise, neon magenta and cyan shards. A
-  fragmented holographic face / city silhouette dissolving into pixels at
-  center. Bold white Chinese title "{TITLE}" with slight glitch offset at the
-  center, strokes complete and legible. Edgy, digital decay aesthetic,
-  landscape 16:9, 1200x675, no other text.
+  EN: Editorial magazine style cover, warm light-gray studio background,
+  dramatic black-and-white portrait in the right third, generous negative
+  space on the left. Dark charcoal elegant bold Chinese title "{TITLE}" at
+  lower left, with a thin brick-red rule line above it. Refined, minimal,
+  magazine cover aesthetic, landscape 16:9, 1200x675, no other text.
   ```
 - **避坑**：
-  - 故障特效开度要收：标题笔画一旦被" glitch" 吃掉变成乱码，整张图作废；
-    明确要求"笔画完整可辨认"。
-  - 噪点/扫描线过密会在公众号小图上糊成一团——要求"适度噪点"。
-  - 该风格视觉刺激强，连续多篇使用会疲劳：系列中最多穿插 1~2 次。
+  - 人物肖像必须用"泛指"描述（商务人士/学者剪影），不得出现可识别的真实人物长相。
+  - 留白处别手痒加装饰字——杂志风的力量全在克制。
+  - 深底版和浅底版不要混用。
 
 ---
 
@@ -191,3 +331,16 @@
 标题字逐字写进 prompt；生成后第一件事就是检查标题字。
 示例图在 `assets/examples/`（`<style>.png` 1200×675 主图 + `<style>-wechat.png`
 900×383 公众号裁剪版），选风格前先看图。
+
+## 风格速查
+
+| 风格 | 一句话 | 标题字号占比 | 首选题材 |
+|---|---|---|---|
+| gan-huo | 萌物 + 巨型标题 + 彩色数字 + 胶囊标签条 | 25%~32% | 干货清单/评测/盘点 |
+| big-type | 标题即画面，字占近半，分两行撞色 | 35%~45% | 观点/深度/发布宣言 |
+| brand-launch | 品牌色大标题 + 产品展示 + 卖点图标条 | 20%~28% | 产品发布/版本更新 |
+| tutorial-steps | 笔刷横条标题 + 步骤卡片拼贴 + 序号章 | 22%~30% | 教程/上手指南 |
+| ip-fun | 巨型彩色数字 + 趣味 IP + 署名 | 数字 20%+ | 实战案例/数据战报 |
+| news-flash | 两行大字 + 胶囊问句 + 人物点缀 | 22%~30% | 资讯/解读/快讯 |
+| minimal | 大面积留白，一处点缀，小字标题 | 8%~12% | 随笔/书评/轻阅读 |
+| magazine | 三分法 + 人物肖像 + 细线标题 | 14%~20% | 访谈/商业分析/盘点 |

package/topmind-wechat-post/scripts/md2wechat.py

@@ -880,6 +880,10 @@ def resolve_image(src, md_path, out_dir, assets, asset_root):
         if os.path.exists(candidate):
             abs_path = candidate
     if not os.path.exists(abs_path):
+        # 本地文件缺失：登记缺失记录再返回原 src（HTML 保留占位 <img>，
+        # embed 会跳过并提示"未内嵌"，上传清单与计数也不会漏掉这一项）
+        assets.append({"src": src, "local": None, "remote": False,
+                       "missing": True})
         return src
     img_dir = os.path.join(out_dir, "images")
     os.makedirs(img_dir, exist_ok=True)
@@ -1435,9 +1439,12 @@ def write_manifest(out_dir, slug, title, assets, diagrams, theme, footnotes,
                 size = "%.0f KB" % kb if kb < 1024 else "%.1f MB" % (kb / 1024)
             if a.get("remote"):
                 lines.append("| %d | %s（远程） | %s | `%s` |" % (idx, a["src"], size, a["src"]))
+            elif a.get("missing"):
+                lines.append("| %d | ⚠ 本地文件缺失：`%s` | — | `%s` |"
+                             % (idx, a["src"], a["src"]))
             else:
                 lines.append("| %d | `%s` | %s | `%s` |"
-                             % (idx, a.get("basename", ""), size, a["src"]))
+                             % (idx, a.get("basename") or "", size, a["src"]))
         lines.append("")
         lines.append("图片目录：`images/`（公众号单图建议 < 2 MB，宽度 1080 px 左右）")
         lines.append("")