minimal-agent 0.8.2 → 0.10.0

package/skills/ui-design/scripts/image_plan_lint.py

@@ -0,0 +1,571 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+image_plan_lint.py —— 配图分流确定性闸门：拦下「本该用 HTML/SVG 画的结构图」被当 AI 图生成。
+
+为什么需要这个脚本？
+====================
+`/workflow ppt` 里弱/懒模型有个固定偷懒模式：把**结构图**（流程图、架构图、分层图、树状图/决策树、
+并轨/对比图）**改名成"抽象概念背景 / 章节氛围图"**塞进 `route=ai-A/ai-B`，用 AI 生成。真机产物
+`build_bak/` 实证：img_2「architecture visualization with 5 layers」、img_3「parallel tracks」、
+img_5「decision tree」全是 AI 生的结构图。AI 渲染结构**必糊、必错、无文字、不可编辑**——而 HTML/SVG
+精确、可编辑、零成本。`layout-composition.md` 早已写"流程图/架构图→用 HTML"，但纯提示词规则被绕过了，
+所以需要一道**绕不过的确定性闸门**（与 layout_balance.py / check_ui_artifact.py 同哲学，作用在生图计划上）。
+
+它查什么？
+==========
+扫 `img_plan.json` 里 **text-to-image** 条的 `prompt`（英）+（可选）`design.json` / `outline.json` 里
+`route=ai-A/ai-B` 页的 `visual.note`（中），命中**精挑的双语「图表型名词」黑名单**（architecture /
+flowchart / decision tree / parallel tracks / 架构 / 流程图 / 决策树 / 双轨 …）即判违规 → 那张应改用
+HTML/SVG，不要 AI 生成。
+
+**只查「AI 凭空生成」，不碰真实客户图**：`image-to-image` 提示词 / `source-enhanced` 路由处理的是
+**客户真图的 img2img 增强**（提示词保原内容），其结构是客户真图带来的、不是 AI 造的——一律豁免结构/审美检查。
+否则会把「客户提供的对比图/架构图 direct_contain 原比例」误判成违规，逼着删 img_plan / 改 HTML，
+反而丢弃真实客户图（违红线「客户图 contain 用 as-is」）。要不要把某结构 HTML 化是设计取舍，不在本闸门硬拦。
+
+**刻意不封堵**装饰性 / 设计性词（nodes、lines、geometric、gradient、单独的 network、visual hierarchy、
+contrast/对比色、bare "layers/分层"）——它们在合法氛围图里也常见。已用 build_bak 反向校准：净命中
+img_2/3/5（真结构图），放行 img_1（封面渐变氛围）/ img_4（山峰隐喻）。
+
+诚实边界（不静默夸大）
+======================
+本闸门只抓**自报式**结构 prompt/note（直接写了图表名词的）。若模型改写措辞规避（"five stacked
+horizontal bands" 而非 "5 layers"），关键词匹配抓不到——那一层仍靠 layout-composition.md 的 guidance
+（AI 背景只能氛围/隐喻、不得承载可命名结构）。两层配合，不是单靠本脚本。
+
+和 layout_balance / opc_check 一样：只用标准库（json / argparse / os / sys），不替代视觉 QA。
+
+退出码：0 = 通过（或无 img_plan.json，无需检查）；1 = 发现违规；2 = 参数 / 解析错。
+
+用法
+====
+    python image_plan_lint.py ./build/img_plan.json [--outline ./build/design.json] [-v]
+    python image_plan_lint.py ./build            # 传目录则自动找 img_plan.json / design.json / outline.json
+"""
+
+import argparse
+import json
+import os
+import re
+import sys
+
+# 「图表型名词」黑名单 —— 命中即「这是结构图，应 HTML/SVG，不该 AI 生」。
+# 选词原则：只收**自报式图表名词**（diagram-type nouns），刻意排除装饰/设计词以免误伤氛围图。
+# 大小写不敏感（统一 .lower() 后子串匹配）；中英混在一张表，对 prompt 与 note 同样适用。
+STRUCTURAL_TERMS = [
+    # —— 英文（多为 img_plan.prompt）——
+    "architecture",        # architecture diagram / visualization（系统架构图）
+    "flowchart",
+    "flow chart",
+    "flow diagram",
+    "process diagram",
+    "decision tree",
+    "tree diagram",
+    "org chart",
+    "organizational chart",
+    "hierarchy diagram",   # 注意：不收裸 "hierarchy"（"visual hierarchy" 是合法构图术语）
+    "mind map",
+    "layered architecture",  # 不收裸 "layers"（"layers of light/mist" 是合法氛围）
+    "layered structure",
+    "parallel paths",
+    "parallel tracks",
+    "parallel evolution",
+    "parallel lanes",
+    "swimlane",
+    "topology",
+    "network diagram",     # 不收裸 "network"（"neural network nodes" 装饰底图合法）
+    "comparison chart",
+    "comparison matrix",   # 不收裸 "comparison/contrast"（"对比色/contrast" 是配色术语）
+    "gantt",
+    "timeline",
+    "data flow",
+    # —— 中文（多为 outline.visual.note）——
+    "架构",                 # 架构图 / 架构示意 / 五层架构（实物"建筑架构"罕见于科技配图，命中后可人工豁免）
+    "流程图",
+    "流程",
+    "步骤图",
+    "决策树",
+    "树状",
+    "树形",
+    "组织结构",
+    "层级",
+    "思维导图",
+    "时间线",
+    "时间轴",
+    "关系图",
+    "拓扑",
+    "对比图",
+    "对比矩阵",
+    "矩阵图",
+    "并轨",
+    "双轨",
+    "泳道",
+    "数据流",
+]
+
+HINT = "改用 HTML/SVG 表达结构，不要 AI 生成"
+
+# 这些词不一定是结构图，但会稳定诱发「廉价科技底图 / 盾牌跑偏 / 拼贴缩略图 / UI 卡片墙」。
+# 产品详情页式 PPT 的 AI 图应是摄影感场景、产品/设备特写、低干扰背景或完整客户图增强，
+# 而不是把页面结构、卡片或小图阵列直接交给生图模型。
+BAD_AESTHETIC_TERMS = [
+    "abstract blueprint",
+    "blueprint background",
+    "crosshair",
+    "target reticle",
+    "shield",
+    "aegis",
+    "18 thumbnails",
+    "thumbnail grid",
+    "many thumbnails",
+    "ui card",
+    "ui cards",
+    "floating cards",
+    "dashboard cards",
+    "matrix background",
+    "collage of icons",
+    "text label",
+    "准星",
+    "靶心",
+    "盾牌",
+    "缩略图",
+    "卡片墙",
+    "浮动卡片",
+    "矩阵背景",
+]
+
+BAD_AESTHETIC_HINT = "改成摄影感场景/完整产品特写/低干扰背景；不要让 AI 画卡片、盾牌、准星或缩略图阵列"
+
+I2I_ONLY_TERMS = [
+    "use the attached image",
+    "attached image",
+    "strict visual reference",
+    "preserve its main subject",
+    "preserve its main subject, content and real colors",
+    "input image",
+    "source_file",
+    "source image",
+]
+
+I2I_ONLY_HINT = "这是图生图提示词，不能用于 text-to-image 背景；改成独立互补背景/场景 prompt"
+
+# 这些词经常让文生图跑成随机消费电子、游戏手柄、药瓶/化妆瓶、普通显示器。
+# 如果没有同时出现从当前 design/outline 动态抽出的业务锚点，就说明 prompt 没有和 PPT 文案绑定。
+GENERIC_OBJECT_RISK_TERMS = [
+    "professional product photography",
+    "sleek device",
+    "futuristic screen",
+    "generic consumer device",
+    "generic monitor",
+    "random monitor",
+    "game controller",
+    "cosmetic bottle",
+    "medicine bottle",
+    "shampoo bottle",
+]
+
+GENERIC_OBJECT_HINT = "文生图 prompt 太泛或含随机消费品风险；必须绑定页面标题/结论/行业场景/VI，并排除手柄、瓶子、普通显示器等无关物体"
+
+BACKGROUND_TEXT_MARKER_TERMS = [
+    "chapter number",
+    "chapter numbers",
+    "numbered chapters",
+    "numbers 1 2 3 4",
+    "sequence numbers",
+    "text labels",
+    "labels on the image",
+    "captions in the image",
+    "章节序号",
+    "章节编号",
+    "序号",
+    "编号",
+    "数字标签",
+    "文字标签",
+    "图中文字",
+]
+
+BACKGROUND_TEXT_MARKER_HINT = "背景/场景/hero 图不得生成不可编辑文字、数字、标签或章节序号；这些必须用 HTML/SVG 前景可编辑元素实现"
+
+# 背景层 t2i 提示词不得携带页面文案/图表描述（2026-07-03 ai_p9 真机事故：rewrite 曾把
+# "Slide title: 投入有限，对冲无限. Core message: 核心总投入约 3 万元… Visual focus: 成本拆解 HTML 表 +
+# 投入/对冲对比柱状图" 原文拼进背景 t2i prompt——Seedream 类文字渲染型模型照着画出一整版烘字假幻灯片，
+# 与 HTML 真表格/真图表互相遮挡）。只对 target=background 的 text-to-image 生效；前景 cutout 模板
+# 合法使用 "Topic anchors:"，i2i（客户图增强）一律豁免。
+SLIDE_COPY_MARKER_TERMS = [
+    "slide title:",
+    "core message:",
+    "topic anchors:",
+    "柱状图",
+    "折线图",
+    "饼图",
+    "表格",
+    "数据表",
+    "bar chart",
+    "line chart",
+    "pie chart",
+    "data table",
+    "cost breakdown",
+]
+
+SLIDE_COPY_HINT = (
+    "背景生图提示词不得携带页标题/正文句/图表描述——文字渲染型生图模型会照着画出整版烘字假幻灯片；"
+    "背景只写场景/材质/光线/留白，标题正文由 HTML 文字层承载、表格图表由 HTML/SVG 层绘制"
+)
+
+NEGATION_RE = re.compile(
+    r"(?:\bno\b|\bwithout\b|\bdo\s+not\b|\bdon't\b|\bavoid\b|\bnever\b|\bnot\s+a\b|\bnot\s+an\b|"
+    r"禁止|不要|不得|不生成|不画|不出现|避免|不能|不可)",
+    re.I,
+)
+
+CHINESE_ANCHOR_RE = re.compile(r"[\u4e00-\u9fff][\u4e00-\u9fffA-Za-z0-9·+\-/]{1,11}")
+ENGLISH_ANCHOR_RE = re.compile(r"\b[A-Za-z][A-Za-z0-9+\-/]{3,}\b")
+ANCHOR_STOPWORDS = {
+    "主题", "用户", "要求", "生成", "做成", "页面", "背景", "图片", "文字", "内容", "设计",
+    "视觉", "风格", "中文", "文案", "标题", "素材", "客户", "产品", "场景", "重点", "需要",
+    "必须", "用于", "高清", "比例", "信息", "专业", "方案", "系统", "能力", "价值", "结构",
+    "presentation", "visual", "image", "slide", "title", "core", "message", "premium",
+    "product", "detail", "page", "background", "foreground", "style", "clean", "high",
+    "resolution", "text", "safe", "zone",
+}
+
+
+def _find_terms(text):
+    """返回 text 命中的黑名单词列表（去重、保序）；text 非字符串或空 → []。"""
+    return _find_non_negated_terms(text, STRUCTURAL_TERMS)
+
+
+def _find_bad_aesthetic_terms(text):
+    return _find_non_negated_terms(text, BAD_AESTHETIC_TERMS)
+
+
+def _find_i2i_only_terms(text):
+    if not isinstance(text, str) or not text:
+        return []
+    hay = text.lower()
+    hits = []
+    for term in I2I_ONLY_TERMS:
+        if term.lower() in hay and term not in hits:
+            hits.append(term)
+    return hits
+
+
+def _is_negated_match(text, start):
+    """Return True when a matched risky term is inside a nearby negative constraint.
+
+    Image prompts deliberately include constraints such as "no game controller" and
+    "do not create a thumbnail grid". Those should not be treated as positive
+    requests to generate the banned object/layout.
+    """
+    prefix = text[max(0, start - 48):start]
+    return bool(NEGATION_RE.search(prefix))
+
+
+def _find_non_negated_terms(text, terms):
+    if not isinstance(text, str) or not text:
+        return []
+    hay = text.lower()
+    hits = []
+    for term in terms:
+        needle = term.lower()
+        pos = hay.find(needle)
+        while pos >= 0:
+            if not _is_negated_match(text, pos):
+                if term not in hits:
+                    hits.append(term)
+                break
+            pos = hay.find(needle, pos + len(needle))
+    return hits
+
+
+def _text_of(value):
+    if value is None:
+        return ""
+    if isinstance(value, str):
+        return value
+    if isinstance(value, (int, float, bool)):
+        return str(value)
+    if isinstance(value, list):
+        return " ".join(_text_of(v) for v in value)
+    if isinstance(value, dict):
+        return " ".join(_text_of(v) for v in value.values())
+    return str(value)
+
+
+def _add_anchor(out, value):
+    value = value.strip(" ，,。.;；:：()（）[]【】<>《》\"'")
+    if len(value) < 2:
+        return
+    if value.lower() in ANCHOR_STOPWORDS:
+        return
+    if value not in out:
+        out.append(value)
+
+
+def _extract_dynamic_anchors(value, limit=80):
+    text = _text_of(value)
+    anchors = []
+    for match in CHINESE_ANCHOR_RE.findall(text):
+        _add_anchor(anchors, match)
+        if len(anchors) >= limit:
+            return anchors
+    for match in ENGLISH_ANCHOR_RE.findall(text):
+        _add_anchor(anchors, match)
+        if len(anchors) >= limit:
+            return anchors
+    return anchors
+
+
+def _find_generic_object_risks(text, anchors=None):
+    if not isinstance(text, str) or not text:
+        return []
+    anchors = anchors or []
+    hay = text.lower()
+    hits = _find_non_negated_terms(text, GENERIC_OBJECT_RISK_TERMS)
+    if not hits:
+        return []
+    explicit_bad = [
+        term for term in hits
+        if term in ("game controller", "cosmetic bottle", "medicine bottle", "shampoo bottle", "generic monitor", "random monitor")
+    ]
+    has_anchor = any(str(term).lower() in hay for term in anchors)
+    return hits if explicit_bad or not has_anchor else []
+
+
+def _find_background_text_marker_terms(text):
+    return _find_non_negated_terms(text, BACKGROUND_TEXT_MARKER_TERMS)
+
+
+def _find_slide_copy_terms(text):
+    return _find_non_negated_terms(text, SLIDE_COPY_MARKER_TERMS)
+
+
+def _is_background_target(item):
+    """镜像 image_prompt_rewrite 的背景判定：`_fg.` 文件名或 role/target_layer 声明前景 → 非背景。"""
+    file_name = str(item.get("file") or "").lower()
+    if "_fg." in file_name:
+        return False
+    role = str(item.get("role") or item.get("target_layer") or "").lower()
+    return role not in ("foreground", "fg", "cutout")
+
+
+def _snippet(text, terms, width=80):
+    """截取首个命中词附近的一小段原文，便于人读定位（不回显整段长 prompt）。"""
+    if not isinstance(text, str):
+        return ""
+    low = text.lower()
+    pos = min((low.find(t.lower()) for t in terms if t.lower() in low), default=-1)
+    if pos < 0:
+        return text[:width].strip()
+    start = max(0, pos - 16)
+    return text[start:start + width].strip()
+
+
+def _resolve(path, filename):
+    """path 是目录则拼 filename；是文件则原样返回。不存在交由调用方处理。"""
+    if path and os.path.isdir(path):
+        return os.path.join(path, filename)
+    return path
+
+
+def lint(img_plan_path, outline_path=None):
+    """
+    返回 (violations, scanned, plan_exists)：
+      violations = [{"where","id","terms","snippet"}, ...]
+      scanned    = 实际扫了几条（prompt 条数 + ai-* note 数）
+      plan_exists= img_plan.json 是否存在（不存在 = 无需检查，视为通过）
+    解析失败抛 ValueError（main 转 exit 2）。
+    """
+    violations = []
+    scanned = 0
+    outline = None
+    dynamic_anchors = []
+
+    if outline_path and os.path.isfile(outline_path):
+        try:
+            with open(outline_path, "r", encoding="utf-8") as f:
+                outline = json.load(f)
+            dynamic_anchors = _extract_dynamic_anchors(outline)
+        except (json.JSONDecodeError, OSError) as e:
+            raise ValueError(f"读取/解析 {outline_path} 失败：{e}")
+
+    # —— 1. img_plan.json 的每条 prompt（精确到 file）——
+    plan_exists = bool(img_plan_path) and os.path.isfile(img_plan_path)
+    if plan_exists:
+        try:
+            with open(img_plan_path, "r", encoding="utf-8") as f:
+                plan = json.load(f)
+        except (json.JSONDecodeError, OSError) as e:
+            raise ValueError(f"读取/解析 {img_plan_path} 失败：{e}")
+        if not isinstance(plan, list):
+            raise ValueError(f"{img_plan_path} 应是数组（每条 {{file,aspect,prompt}}），实际是 {type(plan).__name__}")
+        for i, item in enumerate(plan):
+            if not isinstance(item, dict):
+                continue
+            prompt = item.get("prompt", "")
+            mode = str(item.get("mode") or "text-to-image").lower()
+            scanned += 1
+            # 结构词/坏审美是「AI 凭空造图」检查，只对 text-to-image 生效；image-to-image 增强的是
+            # 真实客户图（提示词保原内容），其结构/审美是客户真图带来的、不是 AI 造的 → 豁免
+            # （与下方 i2i/generic/marker 的 mode 守卫同一逻辑）。无 mode 字段默认 text-to-image。
+            terms = _find_terms(prompt) if mode != "image-to-image" else []
+            if terms:
+                violations.append({
+                    "where": "img_plan.prompt",
+                    "id": str(item.get("file", f"#{i}")),
+                    "terms": terms,
+                    "snippet": _snippet(prompt, terms),
+                    "hint": HINT,
+                })
+            bad_terms = _find_bad_aesthetic_terms(prompt) if mode != "image-to-image" else []
+            if bad_terms:
+                violations.append({
+                    "where": "img_plan.prompt",
+                    "id": str(item.get("file", f"#{i}")),
+                    "terms": bad_terms,
+                    "snippet": _snippet(prompt, bad_terms),
+                    "hint": BAD_AESTHETIC_HINT,
+                })
+            i2i_terms = _find_i2i_only_terms(prompt) if mode != "image-to-image" else []
+            if i2i_terms:
+                violations.append({
+                    "where": "img_plan.prompt",
+                    "id": str(item.get("file", f"#{i}")),
+                    "terms": i2i_terms,
+                    "snippet": _snippet(prompt, i2i_terms),
+                    "hint": I2I_ONLY_HINT,
+                })
+            generic_terms = _find_generic_object_risks(prompt, dynamic_anchors) if mode != "image-to-image" else []
+            if generic_terms:
+                violations.append({
+                    "where": "img_plan.prompt",
+                    "id": str(item.get("file", f"#{i}")),
+                    "terms": generic_terms,
+                    "snippet": _snippet(prompt, generic_terms),
+                    "hint": GENERIC_OBJECT_HINT,
+                })
+            marker_terms = _find_background_text_marker_terms(prompt) if mode != "image-to-image" else []
+            if marker_terms:
+                violations.append({
+                    "where": "img_plan.prompt",
+                    "id": str(item.get("file", f"#{i}")),
+                    "terms": marker_terms,
+                    "snippet": _snippet(prompt, marker_terms),
+                    "hint": BACKGROUND_TEXT_MARKER_HINT,
+                })
+            slide_copy_terms = (
+                _find_slide_copy_terms(prompt)
+                if mode != "image-to-image" and _is_background_target(item)
+                else []
+            )
+            if slide_copy_terms:
+                violations.append({
+                    "where": "img_plan.prompt",
+                    "id": str(item.get("file", f"#{i}")),
+                    "terms": slide_copy_terms,
+                    "snippet": _snippet(prompt, slide_copy_terms),
+                    "hint": SLIDE_COPY_HINT,
+                })
+
+    # —— 2.（可选）outline.json 里 route=ai-A/ai-B/source-enhanced 页的 visual.note（精确到 page，提召回）——
+    if outline_path and os.path.isfile(outline_path):
+        pages = outline.get("pages", []) if isinstance(outline, dict) else []
+        for p in pages:
+            if not isinstance(p, dict):
+                continue
+            visual = p.get("visual", {}) if isinstance(p.get("visual"), dict) else {}
+            route = str(visual.get("route", "")).lower()
+            # 只扫「AI 凭空生成」的路由。source-enhanced（客户图 img2img 增强）是**真实客户内容**——
+            # 结构由客户真图承载（img2img 保原图），note 里出现「对比图/架构」是描述真图、不是 AI 造结构，
+            # 扫它会误伤合法客户图并逼「删 img_plan / 改 HTML」丢弃真图（违红线「客户图 contain 用 as-is」）。
+            if route not in ("ai-a", "ai-b"):
+                continue
+            note = visual.get("note", "")
+            scanned += 1
+            terms = _find_terms(note)
+            if terms:
+                violations.append({
+                    "where": "outline.visual.note",
+                    "id": f"page {p.get('page', '?')}（{p.get('title', '')}）",
+                    "terms": terms,
+                    "snippet": _snippet(note, terms),
+                    "hint": HINT,
+                })
+            bad_terms = _find_bad_aesthetic_terms(note)
+            if bad_terms:
+                violations.append({
+                    "where": "outline.visual.note",
+                    "id": f"page {p.get('page', '?')}（{p.get('title', '')}）",
+                    "terms": bad_terms,
+                    "snippet": _snippet(note, bad_terms),
+                    "hint": BAD_AESTHETIC_HINT,
+                })
+            marker_terms = _find_background_text_marker_terms(note)
+            if marker_terms:
+                violations.append({
+                    "where": "outline.visual.note",
+                    "id": f"page {p.get('page', '?')}（{p.get('title', '')}）",
+                    "terms": marker_terms,
+                    "snippet": _snippet(note, marker_terms),
+                    "hint": BACKGROUND_TEXT_MARKER_HINT,
+                })
+
+    return violations, scanned, plan_exists
+
+
+def main():
+    parser = argparse.ArgumentParser(
+        description="配图分流确定性闸门：拦下本该 HTML/SVG 的结构图被当 AI 图生成（仅标准库）"
+    )
+    parser.add_argument(
+        "img_plan",
+        help="img_plan.json 路径，或其所在目录（目录则自动找 img_plan.json / design.json / outline.json）",
+    )
+    parser.add_argument("--outline", default=None, help="design.json / outline.json 路径（交叉扫 ai-* 页 visual.note 提召回）")
+    parser.add_argument("-v", "--verbose", action="store_true", help="打印扫描条数等明细")
+    args = parser.parse_args()
+
+    img_plan_path = _resolve(args.img_plan, "img_plan.json")
+    outline_path = args.outline
+    if outline_path is None and args.img_plan and os.path.isdir(args.img_plan):
+        for name in ("design.json", "outline.json"):
+            cand = os.path.join(args.img_plan, name)
+            if os.path.isfile(cand):
+                outline_path = cand
+                break
+
+    try:
+        violations, scanned, plan_exists = lint(img_plan_path, outline_path)
+    except ValueError as e:
+        print(f"错误：{e}", file=sys.stderr)
+        return 2
+
+    if not plan_exists:
+        # 无 img_plan.json（illustrations=0 / 无 AI 页）= 没有 AI 图要查，直接通过。
+        print(f"配图分流检查 PASSED —— 未找到 {img_plan_path}（无 AI 图计划，无需检查）。")
+        return 0
+
+    if args.verbose:
+        print(f"已扫描 {scanned} 处（img_plan prompt + outline ai-* note）。")
+
+    if violations:
+        print(f"配图分流检查 FAILED —— 发现 {len(violations)} 处 AI 配图计划风险：")
+        for v in violations:
+            print(f"  - 【{v['where']}】{v['id']} · 命中 {v['terms']} · {v.get('hint') or HINT}")
+            if args.verbose and v["snippet"]:
+                print(f"      ↳ 原文片段：{v['snippet']}")
+        print(
+            "说明：流程/架构/分层/树/决策树/并轨/对比等**结构图**应用 HTML/SVG 精确绘制（可编辑、不糊、能带文字），"
+            "不要让 AI 生成——把这些页 route 改 html、在 deck.html 用 div+CSS Grid / SVG 画结构，并从 img_plan.json 删掉该条。"
+            "封面/章节的**纯氛围/隐喻底图**仍可 AI 生（prompt 去掉结构名词即可）。"
+            "（本闸门只抓自报式结构 prompt/note，措辞规避仍靠 layout-composition.md 的配图分流 guidance。）"
+        )
+        return 1
+
+    print(f"配图分流检查 PASSED —— {img_plan_path} 的 AI 图均为氛围/隐喻/实物，无结构图滥用。")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())