minimal-agent 0.8.2 → 0.10.0

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

@@ -0,0 +1,251 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+check_ui_artifact_pptx_test.py —— 锁定「--for-pptx-export 不再为 web-app 件报 warning」。
+
+根因：导出 PPTX 的 deck 是**静态导出目标**——导出脚本自己控制每页 hidden、强制 1920×1080。
+但 check_ui_artifact 原本会对它报「缺 Tweaks / 缺 localStorage 持久化 / 缺 viewport 缩放」等
+warning，诱导弱模型去补 EDITMODE/localStorage/scale 而非修构图。本测试钉死：
+  - for_pptx_export=True：纯静态 deck **不**报这些 web-app warning，但**仍**报三层标注类提示（导出相关）。
+  - for_pptx_export=False（web 路径）：这些 warning **照常**报（不回归 web 行为）。
+
+运行：python skills/ui-design/scripts/check_ui_artifact_pptx_test.py
+"""
+
+import os
+import sys
+import tempfile
+import unittest
+from pathlib import Path
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from check_ui_artifact import run_checks  # noqa: E402
+
+# 渐变压图反模式：.edit-bg 把不透明渐变写在逗号 url() **之前** → 渐变画在图上面、盖死 AI 背景图。
+GRADIENT_OVER_IMAGE_DECK = """<!doctype html>
+<html lang="zh-CN">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>渐变压图</title>
+<style>
+.slide{display:grid}[hidden]{display:none!important}
+.edit-bg{position:absolute;inset:0;background:linear-gradient(135deg,#0a1020 0%,#0a1020 100%),url('assets/hero.png');background-size:cover}
+</style></head>
+<body>
+  <section class="slide" data-screen-label="01 封面"><div class="edit-bg"></div><h1 data-pptx-kind="text">标题</h1></section>
+</body></html>
+"""
+
+GRADIENT_WARNING_NEEDLE = "盖死背景图"
+
+# 纯静态 deck：grid 排版、中文 label、三层标注齐全；**无** Tweaks/localStorage/scale JS（导出不需要）。
+STATIC_DECK = """<!doctype html>
+<html lang="zh-CN">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>技术栈</title>
+<style>.slide{display:grid;padding:86px 104px}[hidden]{display:none!important}</style></head>
+<body>
+  <section class="slide cards" data-screen-label="01 标题页">
+    <h1 data-pptx-kind="text">AI 生成 PPT 技术栈</h1>
+    <div data-pptx-layer="foreground"><span data-pptx-kind="text">卡片</span></div>
+    <div data-pptx-export="ignore"></div>
+  </section>
+</body></html>
+"""
+
+WEB_APP_NOISE = (
+    "Tweaks",                       # check_tweaks
+    "persist current slide",        # localStorage 持久化
+    "viewport scaling",             # transform: scale
+    "transform-origin",             # transform-origin
+)
+
+MALFORMED_VISIBLE_CSS = """<!doctype html>
+<html lang="zh-CN">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>坏样例</title>
+<style>.slide{display:grid}[hidden]{display:none!important}</style></head>
+<body>
+  <section class="slide" data-screen-label="01 标题页"><h1>标题</h1></section>
+/* ============================================================
+   这段 CSS 错误地裸露在 body 里
+   ============================================================ */
+.slide.p2 {
+  display: grid;
+}
+  <section class="slide p2" data-screen-label="02 第二页"><h1>第二页</h1></section>
+</body></html>
+"""
+
+DUPLICATE_BODY = """<!doctype html>
+<html lang="zh-CN">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>坏样例</title>
+<style>.slide{display:grid}[hidden]{display:none!important}</style></head>
+<body><section class="slide" data-screen-label="01 标题页"><h1>标题</h1></section></body>
+<body><section class="slide" data-screen-label="02 第二页"><h1>第二页</h1></section></body>
+</html>
+"""
+
+
+# ── AI 味确定性 WARNING（F2）：禁栈字体 + 左边框强调卡 ──
+OVERUSED_FONT_NEEDLE = "Overused font family"
+LEFT_BORDER_NEEDLE = "Left-border accent card"
+
+# 主字体 = Inter → 触发（模板味）。
+OVERUSED_FONT_HTML = """<!doctype html>
+<html lang="zh-CN">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>字体</title>
+<style>:root{font-family:"Inter","PingFang SC",sans-serif}h1{color:#111}</style></head>
+<body><main data-screen-label="01 网页"><h1>标题</h1></main></body></html>
+"""
+
+# CJK 栈：PingFang 首位、Arial/Helvetica 仅末位兜底 → **不**触发（合法实践，防误报）。
+CJK_FALLBACK_HTML = """<!doctype html>
+<html lang="zh-CN">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>字体</title>
+<style>:root{font-family:"PingFang SC","Microsoft YaHei","Noto Sans CJK SC","Helvetica Neue",Helvetica,Arial,sans-serif}</style></head>
+<body><main data-screen-label="01 网页"><h1>标题</h1></main></body></html>
+"""
+
+# 左边框 <4px solid> + 圆角，同一规则块 → 触发（经典 AI 味强调卡）。
+LEFT_BORDER_CARD_HTML = """<!doctype html>
+<html lang="zh-CN">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>卡</title>
+<style>.note{border-left:4px solid #2f80ed;border-radius:8px;padding:16px}</style></head>
+<body><main data-screen-label="01 网页"><div class="note">提示</div></main></body></html>
+"""
+
+# 普通左边框、**无** border-radius → **不**触发（非圆角强调卡，避免误伤分隔线等正当用法）。
+PLAIN_LEFT_BORDER_HTML = """<!doctype html>
+<html lang="zh-CN">
+<head><meta charset="utf-8"><meta name="viewport" content="width=device-width, initial-scale=1"><title>线</title>
+<style>.quote{border-left:4px solid #ccc;padding-left:12px}</style></head>
+<body><main data-screen-label="01 网页"><blockquote class="quote">引用</blockquote></main></body></html>
+"""
+
+
+class CheckUiArtifactPptxTest(unittest.TestCase):
+    def setUp(self):
+        fd, self.path = tempfile.mkstemp(suffix=".html")
+        os.close(fd)
+        Path(self.path).write_text(STATIC_DECK, encoding="utf-8")
+
+    def tearDown(self):
+        try:
+            os.remove(self.path)
+        except OSError:
+            pass
+
+    def _messages(self, for_pptx_export):
+        return [f.message for f in run_checks(Path(self.path), for_pptx_export=for_pptx_export)]
+
+    def test_pptx_export_suppresses_webapp_warnings(self):
+        msgs = self._messages(for_pptx_export=True)
+        for noise in WEB_APP_NOISE:
+            self.assertFalse(
+                any(noise in m for m in msgs),
+                f"--for-pptx-export 不该报 web-app warning「{noise}」，但报了：{[m for m in msgs if noise in m]}",
+            )
+
+    def test_web_path_still_warns_about_deck_runtime(self):
+        # web 路径（不导出 PPTX）仍应提示 deck 运行态能力；Tweaks 现在改为按需强制，不再默认报警。
+        msgs = self._messages(for_pptx_export=False)
+        self.assertTrue(any("persist current slide" in m for m in msgs), msgs)
+        self.assertTrue(any("viewport scaling" in m for m in msgs), msgs)
+        self.assertTrue(any("transform-origin" in m for m in msgs), msgs)
+
+    def test_pptx_export_keeps_layer_hints(self):
+        # 导出相关的三层标注提示仍要在（这次缺 data-pptx-export 控件之外都标了，故主要确认不误杀 export hints 流程）。
+        msgs = self._messages(for_pptx_export=True)
+        # 不应把「基础结构 OK」也吞掉——至少能跑完、返回 list。
+        self.assertIsInstance(msgs, list)
+
+    def test_malformed_visible_css_is_error(self):
+        Path(self.path).write_text(MALFORMED_VISIBLE_CSS, encoding="utf-8")
+        msgs = self._messages(for_pptx_export=True)
+        self.assertTrue(any("CSS comment block appears outside <style>" in m for m in msgs), msgs)
+        self.assertTrue(any("CSS selector appears outside <style>" in m for m in msgs), msgs)
+
+    def test_duplicate_body_is_error(self):
+        Path(self.path).write_text(DUPLICATE_BODY, encoding="utf-8")
+        msgs = self._messages(for_pptx_export=True)
+        self.assertTrue(any("Multiple <body>" in m for m in msgs), msgs)
+
+    def test_gradient_over_image_warns_in_pptx_export(self):
+        # --for-pptx-export 下：渐变写在 url 图之前 → 报 WARNING（含命中片段），但**不**升级为 error、不阻断导出。
+        Path(self.path).write_text(GRADIENT_OVER_IMAGE_DECK, encoding="utf-8")
+        findings = run_checks(Path(self.path), for_pptx_export=True)
+        msgs = [f.message for f in findings]
+        hits = [f for f in findings if GRADIENT_WARNING_NEEDLE in f.message]
+        self.assertTrue(hits, f"应报渐变压图 WARNING，实得：{msgs}")
+        # 命中片段要带进消息，便于定位。
+        self.assertTrue(any("url(" in f.message for f in hits), msgs)
+        # 严格 WARNING 级——不得是 error（不改变 exit code / 不阻断导出）。
+        for f in hits:
+            self.assertEqual(f.severity, "warning", f"渐变压图应为 warning，实得 {f.severity}")
+        # 这份 deck 结构合法，除该 warning 外不应有任何 error → main() 退出码维持 0（不阻断）。
+        self.assertFalse(
+            [f for f in findings if f.severity == "error"],
+            f"渐变压图检查不该引入 error：{[f.message for f in findings if f.severity == 'error']}",
+        )
+
+    def test_gradient_over_image_not_reported_on_web_path(self):
+        # 仅 --for-pptx-export 模式扫描；web 路径（for_pptx_export=False）不报该 WARNING。
+        Path(self.path).write_text(GRADIENT_OVER_IMAGE_DECK, encoding="utf-8")
+        msgs = self._messages(for_pptx_export=False)
+        self.assertFalse(
+            any(GRADIENT_WARNING_NEEDLE in m for m in msgs),
+            f"web 路径不该报渐变压图 WARNING，实得：{[m for m in msgs if GRADIENT_WARNING_NEEDLE in m]}",
+        )
+
+
+    # ── F2：禁栈字体 + 左边框强调卡（确定性 WARNING，正/反例）──
+    def _write_and_check(self, html, for_pptx_export=False):
+        Path(self.path).write_text(html, encoding="utf-8")
+        return run_checks(Path(self.path), for_pptx_export=for_pptx_export)
+
+    def test_overused_primary_font_warns(self):
+        findings = self._write_and_check(OVERUSED_FONT_HTML)
+        hits = [f for f in findings if OVERUSED_FONT_NEEDLE in f.message]
+        self.assertTrue(hits, [f.message for f in findings])
+        for f in hits:
+            self.assertEqual(f.severity, "warning", f"应为 warning，实得 {f.severity}")
+
+    def test_cjk_fallback_font_not_flagged(self):
+        # 末位 Arial/Helvetica 兜底是合法 CJK 实践 → 不得误报（即便禁栈含 arial，只判首位）。
+        findings = self._write_and_check(CJK_FALLBACK_HTML)
+        self.assertFalse(
+            any(OVERUSED_FONT_NEEDLE in f.message for f in findings),
+            [f.message for f in findings if OVERUSED_FONT_NEEDLE in f.message],
+        )
+
+    def test_arial_as_primary_font_warns(self):
+        # `font-family: Arial, sans-serif` 当主字体 = claude_design.md:255 点名禁 → WARNING（首位命中）。
+        html = OVERUSED_FONT_HTML.replace('"Inter","PingFang SC",sans-serif', "Arial, sans-serif")
+        findings = self._write_and_check(html)
+        hits = [f for f in findings if OVERUSED_FONT_NEEDLE in f.message]
+        self.assertTrue(hits, [f.message for f in findings])
+        for f in hits:
+            self.assertEqual(f.severity, "warning", f"应为 warning，实得 {f.severity}")
+
+    def test_left_border_accent_card_warns(self):
+        findings = self._write_and_check(LEFT_BORDER_CARD_HTML)
+        hits = [f for f in findings if LEFT_BORDER_NEEDLE in f.message]
+        self.assertTrue(hits, [f.message for f in findings])
+        for f in hits:
+            self.assertEqual(f.severity, "warning", f"应为 warning，实得 {f.severity}")
+
+    def test_plain_left_border_not_flagged(self):
+        # 无圆角的普通左边框（引用条/分隔）不是强调卡 → 不得误报。
+        findings = self._write_and_check(PLAIN_LEFT_BORDER_HTML)
+        self.assertFalse(
+            any(LEFT_BORDER_NEEDLE in f.message for f in findings),
+            [f.message for f in findings if LEFT_BORDER_NEEDLE in f.message],
+        )
+
+    def test_new_style_checks_are_exit_code_neutral(self):
+        # 两条新检查全为 WARNING，绝不引入 error（共享脚本对 webppt 的 pass/fail 契约不变）。
+        for html in (OVERUSED_FONT_HTML, LEFT_BORDER_CARD_HTML):
+            findings = self._write_and_check(html)
+            errors = [f for f in findings if f.severity == "error"]
+            self.assertFalse(errors, f"新检查不该引入 error：{[f.message for f in errors]}")
+
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)

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

@@ -0,0 +1,158 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""
+deck_pages_check.py —— 分批生成 deck 的「页数完成度」确定性闸门（仅标准库）。
+
+为什么需要
+==========
+webppt 工作流把大 deck（几十页）**分批生成**（每轮 agent 写 ≤5 页），避免单步一次写完
+几十页撞 maxTurns 烂尾（真实事故：「50 页做了 5 页就停」）。但工作流表达式引擎**读不了
+磁盘 JSON**，无法直接比较「design 规划了几页 vs deck 已生成几页」。本脚本把这个确定性比较
+放进脚本：读 design.json 的页数 + 数 deck.html 的 <section class="slide">，输出 COMPLETE /
+MISSING，供分批 loop 的 branch 收口（includes(out,'COMPLETE') → break）+ 导出前兜底 verify。
+
+输出（供工作流 includes() 判断 + 退出码兜底）
+    COMPLETE: N/N 页已生成              （exit 0）
+    MISSING: 6,7,8（已生成 5/12 页）     （exit 1）
+    ERROR ...（design.json 缺失/损坏）   （exit 2）
+
+页号来源：deck.html 的 data-screen-label="NN ..." 前缀（乱序生成也能精确 diff 出缺页）；
+无 label 时回退按 <section class="slide"> 数量当「已生成前 N 页」。
+
+用法
+    python deck_pages_check.py <deck.html> --design <design.json>
+    python deck_pages_check.py <workdir>        # 目录：自动找 deck.html + design.json
+"""
+
+import argparse
+import json
+import os
+import re
+import sys
+
+
+def count_sections(html: str) -> int:
+    """数 <section ... class="...slide..."> 的数量（deck 每页一个 slide section）。"""
+    return len(re.findall(r"""<section\b[^>]*\bclass\s*=\s*(['"])[^'"]*\bslide\b[^'"]*\1""", html, re.I))
+
+
+def labeled_page_nums(html: str) -> set:
+    """从 data-screen-label="NN ..." 前缀解析已生成页号（乱序生成也能精确 diff）。"""
+    return {int(m.group(1)) for m in re.finditer(r'data-screen-label\s*=\s*["\'](\d+)', html, re.I)}
+
+
+def labeled_page_nums_ordered(html: str) -> list:
+    """按 **DOM 顺序**返回 data-screen-label 的数字前缀（保留顺序，用于查页序错乱）。"""
+    return [int(m.group(1)) for m in re.finditer(r'data-screen-label\s*=\s*["\'](\d+)', html, re.I)]
+
+
+def check_order(html: str):
+    """返回 (ok, message)。DOM 中各 <section> 的 data-screen-label 数字前缀应**单调递增**——
+    否则导出的 PPTX 播放顺序会与页面编号不符（真机事故：DOM 序 …09,12,13,10,11,15,14…，
+    export 按 DOM 位置命名/排序 → 播放顺序错乱）。仅 --check-order 时启用（ppt 专属；webppt 不传）。"""
+    nums = labeled_page_nums_ordered(html)
+    if len(nums) < 2:
+        return (True, f"ORDER_OK: {len(nums)} 个带编号 section，无需查序")
+    mism = [(i, nums[i - 1], nums[i]) for i in range(1, len(nums)) if nums[i] < nums[i - 1]]
+    seq = ",".join(str(n) for n in nums)
+    if not mism:
+        return (True, f"ORDER_OK: {len(nums)} 页 DOM 顺序与编号一致 [{seq}]")
+    detail = "；".join(f"第 {i + 1} 个 section 编号 {cur} < 前一个 {prev}" for i, prev, cur in mism)
+    return (
+        False,
+        f"ORDER_MISMATCH: DOM 顺序 [{seq}] 非升序 —— {detail}"
+        f"（导出按 DOM 位置排序，播放顺序会错；请把各 <section> 按编号从小到大重排）",
+    )
+
+
+def expected_page_nums(design):
+    """design.json 的页号列表：优先每页 page 字段，否则按数组序号 1..N。无效返回 None。"""
+    pages = design.get("pages") if isinstance(design, dict) else design
+    if not isinstance(pages, list) or not pages:
+        return None
+    nums = []
+    for i, p in enumerate(pages, 1):
+        if isinstance(p, dict) and isinstance(p.get("page"), int):
+            nums.append(p["page"])
+        else:
+            nums.append(i)
+    return nums
+
+
+def check(deck_path: str, design_path: str):
+    """返回 (status, message, exit_code)。status ∈ COMPLETE / MISSING / ERROR。"""
+    if not os.path.isfile(design_path):
+        return ("ERROR", f"ERROR: design.json 不存在：{design_path}（设计文档步未产出？）", 2)
+    try:
+        with open(design_path, "r", encoding="utf-8") as f:
+            design = json.load(f)
+    except (OSError, json.JSONDecodeError) as e:
+        return ("ERROR", f"ERROR: design.json 解析失败：{e}", 2)
+    expected = expected_page_nums(design)
+    if expected is None:
+        return ("ERROR", "ERROR: design.json 无有效 pages 数组", 2)
+    total = len(expected)
+
+    html = ""
+    if os.path.isfile(deck_path):
+        try:
+            with open(deck_path, "r", encoding="utf-8") as f:
+                html = f.read()
+        except OSError as e:
+            return ("ERROR", f"ERROR: deck.html 读取失败：{e}", 2)
+
+    labeled = labeled_page_nums(html)
+    sec_count = count_sections(html)
+    # 有 data-screen-label → 用页号集合（乱序精确）；否则按 section 数当已生成前 N 页。
+    done = labeled if labeled else set(range(1, sec_count + 1))
+    expected_set = set(expected)
+    done_count = len(done & expected_set)
+    missing = sorted(expected_set - done)
+
+    if not missing:
+        extra = sec_count - total
+        extra_note = f"；另有 {extra} 个多余 section（design 仅 {total} 页，请核对）" if extra > 0 else ""
+        return ("COMPLETE", f"COMPLETE: {min(done_count, total)}/{total} 页已生成{extra_note}", 0)
+    return (
+        "MISSING",
+        f"MISSING: {','.join(str(n) for n in missing)}（已生成 {done_count}/{total} 页，继续生成缺的页）",
+        1,
+    )
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(
+        description="分批 deck 页数完成度闸门（读 design.json 页数 + 数 deck.html section）"
+    )
+    parser.add_argument("target", help="deck.html 路径，或含 deck.html/design.json 的 workdir 目录")
+    parser.add_argument("--design", default=None, help="design.json 路径（缺省按 target 推断）")
+    parser.add_argument("--deck", default=None, help="deck.html 路径（target 为目录时可显式指定）")
+    parser.add_argument("--check-order", action="store_true",
+                        help="额外校验 data-screen-label 编号在 DOM 中单调递增（ppt 专属；错乱→ORDER_MISMATCH 非零退出）")
+    args = parser.parse_args()
+
+    if os.path.isdir(args.target):
+        deck_path = args.deck or os.path.join(args.target, "deck.html")
+        design_path = args.design or os.path.join(args.target, "design.json")
+    else:
+        deck_path = args.deck or args.target
+        design_path = args.design or os.path.join(os.path.dirname(deck_path) or ".", "design.json")
+
+    _status, message, code = check(deck_path, design_path)
+    print(message)
+
+    if args.check_order and os.path.isfile(deck_path):
+        try:
+            with open(deck_path, "r", encoding="utf-8") as f:
+                order_ok, order_msg = check_order(f.read())
+        except OSError as e:
+            order_ok, order_msg = True, f"ORDER_SKIP: deck.html 读取失败：{e}"
+        print(order_msg)
+        if not order_ok and code == 0:
+            code = 3  # 页数完整但顺序错乱 → 单独用退出码 3 标记（区分 MISSING=1 / ERROR=2）
+
+    return code
+
+
+if __name__ == "__main__":
+    sys.exit(main())

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

@@ -0,0 +1,134 @@
+#!/usr/bin/env python3
+# -*- coding: utf-8 -*-
+"""deck_pages_check.py 回归锚（stdlib unittest）。
+
+运行：python skills/ui-design/scripts/deck_pages_check_test.py
+"""
+
+import json
+import os
+import shutil
+import sys
+import tempfile
+import unittest
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+from deck_pages_check import check, check_order  # noqa: E402
+
+
+def deck_html(labels):
+    secs = "".join(
+        f'<section class="slide cover" data-screen-label="{l}">x</section>' for l in labels
+    )
+    return f"<html><body>{secs}</body></html>"
+
+
+def design(n, with_page_field=True):
+    if with_page_field:
+        return {"pages": [{"page": i, "archetype": "list"} for i in range(1, n + 1)]}
+    return {"pages": [{"archetype": "list"} for _ in range(n)]}
+
+
+class DeckPagesCheckTest(unittest.TestCase):
+    def setUp(self):
+        self.dir = tempfile.mkdtemp()
+
+    def tearDown(self):
+        shutil.rmtree(self.dir, ignore_errors=True)
+
+    def _write(self, deck, design_obj):
+        dp = os.path.join(self.dir, "deck.html")
+        gp = os.path.join(self.dir, "design.json")
+        with open(dp, "w", encoding="utf-8") as f:
+            f.write(deck)
+        with open(gp, "w", encoding="utf-8") as f:
+            json.dump(design_obj, f)
+        return dp, gp
+
+    def test_complete(self):
+        dp, gp = self._write(deck_html(["01", "02", "03"]), design(3))
+        status, msg, code = check(dp, gp)
+        self.assertEqual(status, "COMPLETE")
+        self.assertEqual(code, 0)
+        self.assertIn("COMPLETE", msg)
+
+    def test_missing_tail(self):
+        dp, gp = self._write(deck_html(["01", "02"]), design(5))
+        status, msg, code = check(dp, gp)
+        self.assertEqual(status, "MISSING")
+        self.assertEqual(code, 1)
+        self.assertIn("3,4,5", msg)
+
+    def test_out_of_order_diff(self):
+        # 乱序生成（先做 1,5,12）→ 精确 diff 出缺页 2,3,4（5 已生成，12 超范围忽略）。
+        dp, gp = self._write(deck_html(["01", "05", "12"]), design(5))
+        status, msg, code = check(dp, gp)
+        self.assertEqual(status, "MISSING")
+        self.assertIn("2,3,4", msg)
+
+    def test_no_labels_fallback_to_count(self):
+        # 无 data-screen-label → 按 section 数当已生成前 N 页。
+        deck = '<section class="slide">a</section><section class="slide">b</section>'
+        dp, gp = self._write(deck, design(3))
+        status, msg, code = check(dp, gp)
+        self.assertEqual(status, "MISSING")
+        self.assertIn("3", msg)
+
+    def test_single_quoted_class_counts_slides(self):
+        # HTML 合法单引号 class 也必须识别，避免误判 deck 没有页。
+        deck = "<section class='slide cover' data-screen-label='01 标题'>a</section>"
+        dp, gp = self._write(deck, design(1))
+        status, msg, code = check(dp, gp)
+        self.assertEqual(status, "COMPLETE")
+        self.assertEqual(code, 0)
+
+    def test_pages_without_page_field(self):
+        # pages 无 page 字段 → 按数组序号 1..N。
+        dp, gp = self._write(deck_html(["01", "02"]), design(3, with_page_field=False))
+        status, msg, code = check(dp, gp)
+        self.assertEqual(status, "MISSING")
+        self.assertIn("3", msg)
+
+    def test_design_missing_is_error(self):
+        dp = os.path.join(self.dir, "deck.html")
+        with open(dp, "w", encoding="utf-8") as f:
+            f.write(deck_html(["01"]))
+        status, msg, code = check(dp, os.path.join(self.dir, "nope.json"))
+        self.assertEqual(status, "ERROR")
+        self.assertEqual(code, 2)
+
+    def test_deck_missing_means_all_missing(self):
+        gp = os.path.join(self.dir, "design.json")
+        with open(gp, "w", encoding="utf-8") as f:
+            json.dump(design(2), f)
+        status, msg, code = check(os.path.join(self.dir, "nope.html"), gp)
+        self.assertEqual(status, "MISSING")
+        self.assertIn("1,2", msg)
+
+    def test_extra_sections_still_complete(self):
+        # deck 多于 design（生成超量）→ 仍 COMPLETE，但提示多余。
+        dp, gp = self._write(deck_html(["01", "02", "03", "04"]), design(3))
+        status, msg, code = check(dp, gp)
+        self.assertEqual(status, "COMPLETE")
+        self.assertIn("多余", msg)
+
+    # ── 页序一致性（--check-order）──
+    def test_order_ok_when_ascending(self):
+        ok, msg = check_order(deck_html(["01 标题", "02 次页", "03 三页"]))
+        self.assertTrue(ok, msg)
+        self.assertIn("ORDER_OK", msg)
+
+    def test_order_mismatch_detected(self):
+        # 真机事故序：…09,12,13,10,11,15,14… → 应报 ORDER_MISMATCH。
+        ok, msg = check_order(deck_html(["09", "12", "13", "10", "11", "15", "14"]))
+        self.assertFalse(ok, msg)
+        self.assertIn("ORDER_MISMATCH", msg)
+        self.assertIn("10 < 前一个 13", msg)
+
+    def test_order_single_page_ok(self):
+        ok, msg = check_order(deck_html(["01 只有一页"]))
+        self.assertTrue(ok, msg)
+
+
+if __name__ == "__main__":
+    unittest.main(verbosity=2)