@topmindspace/tms-skills 0.3.0 → 0.3.5

package/top-ppt-html/scripts/validate_report.py

@@ -28,6 +28,7 @@ research / architecture 仍须显式传 --layout-qa（不强制）。
 import sys
 import re
 import json
+import base64
 import hashlib
 from typing import Optional
 from html.parser import HTMLParser
@@ -914,7 +915,11 @@ def _check_v9_hard_gates(txt, chk, model):
                 ctype = 'donut'
             if ctype not in skew_types:
                 continue
-            vals = [float(v) for v in (ch.get('values') or []) if v is not None]
+            try:
+                vals = [float(v) for v in (ch.get('values') or []) if v is not None]
+            except (TypeError, ValueError):
+                skew_hits.append(f"第{si}章 {ctype} values 含非数值（图表数据非法，无法判定占比）")
+                continue
             vals = [v for v in vals if v >= 0]
             if len(vals) < 2:
                 continue
@@ -1194,6 +1199,28 @@ def _img_srcs(img):
     return srcs
 
 
+def _img_alt_ok(tag: str) -> bool:
+    """alt 存在且非空（alt="" 视为缺失）。"""
+    m = re.search(r'alt\s*=\s*("([^"]*)"|\'([^\']*)\')', tag)
+    if not m:
+        return False
+    val = m.group(2) if m.group(2) is not None else m.group(3)
+    return bool(val and val.strip())
+
+
+def _data_uri_bytes(tag: str):
+    """解码 data: URI 的实际字节数；非 base64 或解码失败时回落为载荷字符数。"""
+    m = (re.search(r'src\s*=\s*"data:[^"\',]*,([^"]*)"', tag)
+         or re.search(r"src\s*=\s*'data:[^\"\',]*,([^']*)'", tag))
+    if not m:
+        return None
+    payload = re.sub(r'\s', '', m.group(1))
+    try:
+        return len(base64.b64decode(payload))
+    except Exception:
+        return len(payload)
+
+
 def _check_media(txt, chk, model):
     """素材图片与配图占位：零外链铁律（<img> 只允许 data: 内联或相对路径）；
     alt 可访问性；配图占位必须有可见标签；模型 image 三选一（src/items/placeholder）
@@ -1203,13 +1230,15 @@ def _check_media(txt, chk, model):
         bad = [t for t in imgs if re.search(r'src\s*=\s*["\']\s*(?:https?:)?//', t)]
         chk("图片源无外链（data: 内联或相对路径，零外链铁律）", not bad,
             f"{len(bad)} 处外链图片" if bad else "")
-        noalt = [t for t in imgs if 'alt=' not in t]
+        noalt = [t for t in imgs if not _img_alt_ok(t)]
         chk("图片均带 alt（可访问性）", not noalt,
-            f"{len(noalt)} 处缺 alt" if noalt else "", level="WARN")
+            f"{len(noalt)} 处缺 alt（含空 alt)" if noalt else "", level="WARN")
         data_imgs = [t for t in imgs if re.search(r'src\s*=\s*["\']\s*data:', t)]
-        inline_bytes = sum(len(t) for t in data_imgs)
-        chk("单图 data: 内联体积在上限内", all(len(t) <= IMAGE_MAX_INLINE for t in data_imgs),
-            f"最大 {max((len(t) for t in data_imgs), default=0) // 1024}KB > 上限 {IMAGE_MAX_INLINE // 1024}KB",
+        data_sizes = [(_data_uri_bytes(t), t) for t in data_imgs]
+        max_bytes = max((b or 0 for b, _ in data_sizes), default=0)
+        inline_bytes = sum(b if b is not None else len(t) for b, t in data_sizes)
+        chk("单图 data: 内联体积在上限内", all((b or 0) <= IMAGE_MAX_INLINE for b, _ in data_sizes),
+            f"最大 {max_bytes // 1024}KB > 上限 {IMAGE_MAX_INLINE // 1024}KB（按解码后字节计）",
             level="WARN")
         chk("报告内联图片总量在上限内", inline_bytes <= IMAGE_MAX_TOTAL,
             f"{inline_bytes // 1024}KB > 上限 {IMAGE_MAX_TOTAL // 1024}KB（改用相对路径）",
@@ -1610,7 +1639,14 @@ def main():
     if not path.exists():
         print(f"文件不存在: {path}")
         return 2
-    txt = path.read_text(encoding='utf-8')
+    try:
+        txt = path.read_text(encoding='utf-8')
+    except UnicodeDecodeError as e:
+        print(f"文件不是合法 UTF-8: {path}（{e}）")
+        return 2
+    except OSError as e:
+        print(f"无法读取文件: {path}（{e}）")
+        return 2
 
     v = Struct()
     v.feed(txt)

package/topmind-cover/README.en.md

@@ -4,6 +4,16 @@
 
 A reusable skill for generating cover art for X long-form posts and WeChat articles. Goal: **striking, eye-catching, theme-focused**.
 
+- Version: **v0.1.0** (same tag as `@topmindspace/tms-skills@0.3.5`)
+
+## 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>
+
+8 styles (viral dry-goods / giant-type manifesto / brand launch / tutorial steps / fun IP / news flash / minimalist / editorial magazine): use cases, palette stories, abstract design principles, and Chinese+English prompt recipes in [`references/cover-styles.md`](./references/cover-styles.md); full-size per-style shots in [`assets/examples/`](./assets/examples/).
+
 ## Install
 
 ```bash
@@ -12,7 +22,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).
@@ -26,12 +36,6 @@ python3 scripts/crop-cover.py <main-image> --out-dir <package>/images/
 # produces 00-封面.png (1200×675) + 00-封面-公众号.png (900×383, center crop)
 ```
 
-## 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)).
-- **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
 
 | Platform | Size | Aspect |
@@ -41,7 +45,7 @@ python3 scripts/crop-cover.py <main-image> --out-dir <package>/images/
 
 ## Design rules
 
-One image, one theme; subject fills 40%+ of the frame; big title ≤ 10 chars, high contrast; avoid clutter, tiny dense text, and competing subjects.
+One image, one theme; subject fills 40%+ of the frame; big title ≤ 10 chars, high contrast; avoid clutter, tiny dense text, and competing subjects. **Safe-zone rule**: title text and key subject must stay inside the central vertical 60% safe zone.
 
 ## Development
 

package/topmind-cover/README.md

@@ -4,6 +4,16 @@
 
 为 X 长文和公众号文章生成封面图的可复用技能。目标：**震撼、醒目、主题突出**。
 
+- 版本：**v0.1.0**（与 `@topmindspace/tms-skills@0.3.5` 同 tag）
+
+## 风格样张
+
+<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>
+
+8 种风格（爆款干货 / 巨字宣言 / 品牌发布 / 教程步骤 / IP 趣味 / 资讯快报 / 极简留白 / 杂志编辑）：适用场景、配色故事、抽象设计原则、中英 prompt 配方见 [`references/cover-styles.md`](./references/cover-styles.md)；单风格大图在 [`assets/examples/`](./assets/examples/)。
+
 ## 安装
 
 ```bash
@@ -12,8 +22,8 @@ npx @topmindspace/tms-skills install topmind-cover
 
 ## 用法
 
-0. **选风格（三步，必做）**：按题材从 `references/cover-styles.md` 选 1 种风格（6 选 1）
-   → 看 `assets/examples/<风格>.png` 示例图，确认视觉语言符合预期
+0. **选风格（三步，必做）**：按题材从 `references/cover-styles.md` 选 1 种风格（8 选 1）
+   → 看 `assets/examples/<风格>.png` 示例图确认视觉语言
    → 按该风格的 prompt 配方组 prompt（把 `{TITLE}` 换成实际标题）。
 1. 输入文章标题 + 3 个主题关键词 + 平台（x / wechat / both，默认 both）。
 2. 用 agent 的图片生成能力出图（横构图 16:9，四周留白 8%）。
@@ -26,12 +36,6 @@ python3 scripts/crop-cover.py <主图> --out-dir <包>/images/
 # 产出 00-封面.png (1200×675) + 00-封面-公众号.png (900×383，中央裁剪)
 ```
 
-## 风格库与示例图
-
-- **风格库** `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)）。
-- **安全区铁律**：标题字与关键主体必须落在画面中央垂直 60% 安全区内（上下各预留 13%+ 不放标题字），否则公众号中央裁剪会切掉标题。
-
 ## 尺寸
 
 | 平台 | 尺寸 | 比例 |
@@ -41,7 +45,7 @@ python3 scripts/crop-cover.py <主图> --out-dir <包>/images/
 
 ## 设计铁律
 
-一图一主题；主体占画面 40%+；大标题 ≤10 字高对比；忌元素堆砌、小字密排、多主体打架。
+一图一主题；主体占画面 40%+；大标题 ≤10 字高对比；忌元素堆砌、小字密排、多主体打架。**安全区铁律**：标题字与关键主体必须落在画面中央垂直 60% 安全区内。
 
 ## 开发
 

package/topmind-cover/SKILL.md

@@ -1,19 +1,24 @@
 ---
 name: topmind-cover
 version: 0.1.0
-description: "文章封面配图生成：X 长文与公众号共用。震撼、醒目、主题突出；平台尺寸规范、风格模板、命名落盘、成图检查全流程覆盖。Use when 封面、封面图、头图、配图、cover。Do NOT use for 正文插图、PPT/报告封面。"
+description: "文章封面配图生成：X 长文与公众号共用。震撼、醒目、主题突出；平台尺寸规范、风格模板、命名落盘、成图检查全流程覆盖。Use when 文章封面、封面图、头图、题图、cover。Do NOT use for 正文插图、PPT/报告封面。"
 action_category: write
 triggers:
   - 封面
   - 封面图
   - 头图
+  - 题图
+  - 首图
   - 配图
   - 缩略图
+  - banner
   - cover
   - thumbnail
 triggers_cn:
   - 公众号封面
+  - 公众号题图
   - X 封面
+  - X 首图
   - 文章封面
 author: TopMindspace
 license: MIT
@@ -23,12 +28,31 @@ updated: 2026-09-29
 
 # topmind-cover · 封面配图生成
 
-为 X 长文和公众号文章生成封面图的可复用技能。目标：**震撼、醒目、主题突出**。
+为 X 长文和公众号文章生成封面图。目标：**震撼、醒目、主题突出**。
 
 ```
 标题/主题 → 风格模板 → 生成 → 检查 → 裁剪双尺寸 → 落盘命名
 ```
 
+## 风格索引
+
+风格总览图见 `assets/examples/overview.png`（8 宫格，离线可看）。
+
+| 风格 | 首选题材 |
+|------|----------|
+| 爆款干货 `gan-huo` | 干货清单、评测、盘点、实测筛选 |
+| 巨字宣言 `big-type` | 观点评论、深度长文、发布宣言 |
+| 品牌发布 `brand-launch` | 产品发布、版本更新、官方白皮书 |
+| 教程步骤 `tutorial-steps` | 教程、上手指南、分步实操 |
+| IP 趣味 `ip-fun` | 实战案例、数据战报、复盘、连载 |
+| 资讯快报 `news-flash` | 资讯快讯、热点解读、揭秘类选题 |
+| 极简留白 `minimal` | 随笔、书评、轻观点 |
+| 杂志编辑 `magazine` | 深度访谈、人物特写、商业分析 |
+
+适用场景细则、配色故事、prompt 配方见 `references/cover-styles.md`；单风格大图 `assets/examples/<style>.png`。
+
+> 示例图为原创演示：只学设计原则，不临摹第三方版式（详见 `references/cover-styles.md` 顶部"原创铁律"）。
+
 ## 尺寸表
 
 | 平台 | 尺寸 | 比例 | 备注 |
@@ -40,29 +64,18 @@ updated: 2026-09-29
 
 ## 工作流
 
-0. **选风格（三步，必做）**：
-   ① 按题材从 `references/cover-styles.md` 选 1 种风格（6 选 1）；
-   ② 看 `assets/examples/<style>.png` 示例图，确认视觉语言符合预期；
-   ③ 按该风格的 prompt 配方组 prompt（把 `{TITLE}` 换成实际标题）。
-   示例清单见 `assets/examples/README.md`。
-1. **输入**：文章标题、3 个主题关键词、平台（`x` / `wechat` / `both`，默认 both）、
-   风格（默认按题材自动选，见 `references/cover-styles.md`）。
-   平台只影响生成 prompt 的侧重；裁剪落盘永远产出双尺寸。
-2. **组 prompt**：按 `references/cover-styles.md` 对应风格的配方组装
-   （标题 ≤10 字逐字写明，防 AI 自造错别字）。
+0. **选风格（三步，必做）**：① 按题材从 `references/cover-styles.md` 选 1 种（8 选 1）→ ② 看 `assets/examples/<style>.png` 确认视觉语言 → ③ 按该风格配方组 prompt（`{TITLE}` 换实际标题）。
+1. **输入**：文章标题、3 个主题关键词、平台（`x` / `wechat` / `both`，默认 both，平台只影响 prompt 侧重；裁剪落盘永远产出双尺寸）。
+2. **组 prompt**：按风格配方组装（标题 ≤10 字逐字写明，防 AI 自造错别字）。
 3. **生成**：`media.generate_image`，`name` 用 `<slug>-cover`。
-4. **检查**（必做，肉眼看一遍）：
-   - 标题字逐字正确，无错别字、无多字少字
-   - 主体完整不被裁切，画面不杂乱
-   - 一眼能说出主题；说不出就重生成
-   - 900×383 版复查：标题字、关键主体不被中央裁剪裁掉（见风格库"安全区铁律"）
+4. **检查**（必做，肉眼看一遍）：标题字逐字正确无错别字；主体完整不杂乱；一眼能说出主题；900×383 版标题字与关键主体不被中央裁剪裁掉（风格库"安全区铁律"）。
 5. **裁剪落盘**：
    ```bash
    python3 scripts/crop-cover.py <主图> --out-dir <包>/images/
    ```
    产出 `00-封面.png`（1200×675，X/公众号共用主文件）与 `00-封面-公众号.png`（900×383）。
    公众号包规约：正文引用 `images/00-封面.png`，`图片上传清单.md` 登记两版。
-6. **系列感**：同一系列文章固定色系 + 版式语言，prompt 复用同一风格模板。
+6. **系列感**：同一系列固定色系 + 版式语言，prompt 复用同一风格模板。
 
 ## 设计铁律
 
@@ -73,9 +86,8 @@ updated: 2026-09-29
 
 ## 外部依赖 / 规约来源
 
-- "公众号包规约"（正文引用 `images/00-封面.png`、`图片上传清单.md` 登记两版）
-  来自用户侧 workbuddy 环境，仓库内无此文件；缺失时仍按固定命名落盘，
-  不阻塞核心流程。
+"公众号包规约"（正文引用 `images/00-封面.png`、`图片上传清单.md` 登记两版）来自用户侧
+workbuddy 环境，仓库内无此文件；缺失时仍按固定命名落盘，不阻塞核心流程。
 
 ## When NOT to use
 

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

@@ -1,29 +1,26 @@
 # 封面风格示例图
 
-6 种风格 × 2 种尺寸 = 12 张示例（共约 6.4MB，随 npm 包发布，npx 安装即得）：
+8 种风格 × 2 种尺寸 = 16 张示例（随 npm 包发布，npx 安装即得），
+另附 `overview.png`（8 宫格总览，2260×806）。
 
 - `<style>.png`（1200×675，X 长文封面 / 公众号共用主尺寸）
-- `<style>-wechat.png`（900×383，公众号封面大图，`scripts/crop-cover.py` 中央裁剪版）
+- `<style>-wechat.png`（900×383，公众号封面大图，中央裁剪版）
+- `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` | 赛博故障艺术 | 网络文化、赛博朋克、前沿实验，年轻化/亚文化话题 |
+8 种风格（爆款干货 `gan-huo` / 巨字宣言 `big-type` / 品牌发布 `brand-launch` / 教程步骤
+`tutorial-steps` / IP 趣味 `ip-fun` / 资讯快报 `news-flash` / 极简留白 `minimal` /
+杂志编辑 `magazine`）：适用场景索引与配方见 `../references/cover-styles.md`。
 
-详细配方（配色 hex / 字体 / 中英 prompt / 避坑）见 `../references/cover-styles.md`。
+## 原创与虚构声明（重要）
 
-## 安全区说明（重要）
-
-所有示例的标题字都落在**中央垂直 60% 安全区**内——这正是 `900×383` 中央裁剪版标题不被裁掉的原因。
-自己组 prompt 时务必遵守：标题/关键主体不得超出上下各 13% 的禁区，否则公众号版会被切掉。
-反例：标题压在顶部 15% 处时，`-wechat.png` 里只剩半截字（第一版 tech-future/guochao 示例即如此，已修正）。
+本目录 16 张示例图均为**原创设计**（只演示抽象设计原则，不临摹任何第三方封面的
+版式与配色；复用本库设计时亦不得与第三方封面构成实质相似——只学原则，不学版式）。
+图中标题文案、数字、品牌名、署名均为**虚构演示内容**（如"深蓝 OS 2.0"、
+"@阿狐画画"）——直接复用前请换成自己的真实标题；凡封面上的数字必须在正文中有
+出处，严禁编造数据。
 
 ## 复用声明
 
-**示例图可直接拿去用/改，作封面底图或风格参考。**
-拿去用时建议按 `scripts/crop-cover.py` 的流程重新裁剪双尺寸并按包规约命名落盘；
-改图时保留原风格的配色与版式语言，只换主体与标题字，以维持系列感。
+**示例图可直接拿去用/改，作封面底图或风格参考。**拿去用时按 `scripts/crop-cover.py`
+的流程重新裁剪双尺寸并按包规约命名落盘；改图时保留原风格的配色与版式语言，
+只换主体与标题字，以维持系列感。