@yujp_vc/ppt-assistant 0.0.0-stage → 1.5.2

package/slide_patch.py

@@ -0,0 +1,153 @@
+#!/usr/bin/env python3
+"""Inspect shape ids and patch selected slide geometry/text frames only."""
+from __future__ import annotations
+
+import argparse
+import copy
+import json
+import math
+import tempfile
+from pathlib import Path
+from zipfile import ZipFile
+
+from pptx import Presentation
+from pptx.enum.text import MSO_ANCHOR, MSO_AUTO_SIZE, PP_ALIGN
+from pptx.util import Inches, Pt
+
+from speaker_notes import dump, slide_parts
+
+ANCHORS = {"top": MSO_ANCHOR.TOP, "middle": MSO_ANCHOR.MIDDLE, "bottom": MSO_ANCHOR.BOTTOM}
+ALIGNMENTS = {"left": PP_ALIGN.LEFT, "center": PP_ALIGN.CENTER, "right": PP_ALIGN.RIGHT}
+FRAME_KEYS = {"word_wrap", "vertical_anchor", "margin_inches", "line_spacing",
+              "space_before_pt", "space_after_pt", "alignment"}
+
+
+def inspect(pptx: Path) -> dict:
+    """List top-level shape ids and inch-based boxes in presentation order."""
+    prs = Presentation(pptx)
+    return {"size_inches": [prs.slide_width / 914400, prs.slide_height / 914400],
+            "pages": [{"page": page, "shapes": [
+                {"shape_id": shape.shape_id, "name": shape.name,
+                 "type": str(shape.shape_type), "text": shape.text if shape.has_text_frame else None,
+                 "box_inches": [value / 914400 for value in
+                                (shape.left, shape.top, shape.width, shape.height)]}
+                for shape in slide.shapes]} for page, slide in enumerate(prs.slides, 1)]}
+
+
+def number(value, label: str, *, positive: bool = False) -> float:
+    if (type(value) not in (int, float) or not math.isfinite(value)
+            or value < 0 or (positive and value == 0)):
+        raise ValueError(f"{label} must be a finite {'positive' if positive else 'nonnegative'} number")
+    return value
+
+
+def apply_frame(shape, spec: dict) -> None:
+    """Repair spacing without replacing paragraphs, runs, fonts or text."""
+    if not isinstance(spec, dict) or not spec or spec.keys() - FRAME_KEYS:
+        raise ValueError("text_frame must contain supported, explicit settings")
+    if not shape.has_text_frame:
+        raise ValueError("selected shape has no text frame")
+    frame = shape.text_frame
+    frame.auto_size = MSO_AUTO_SIZE.NONE
+    if "word_wrap" in spec:
+        if type(spec["word_wrap"]) is not bool:
+            raise ValueError("word_wrap must be boolean")
+        frame.word_wrap = spec["word_wrap"]
+    if "vertical_anchor" in spec:
+        if spec["vertical_anchor"] not in ANCHORS:
+            raise ValueError("vertical_anchor must be top, middle or bottom")
+        frame.vertical_anchor = ANCHORS[spec["vertical_anchor"]]
+    if "margin_inches" in spec:
+        margins = spec["margin_inches"]
+        if not isinstance(margins, list) or len(margins) != 4:
+            raise ValueError("margin_inches must be [left, top, right, bottom]")
+        values = [Inches(number(value, "margin")) for value in margins]
+        if values[0] + values[2] >= shape.width or values[1] + values[3] >= shape.height:
+            raise ValueError("margins must leave positive text space")
+        for key, value in zip(("margin_left", "margin_top", "margin_right", "margin_bottom"), values):
+            setattr(frame, key, value)
+    for paragraph in frame.paragraphs:
+        if "line_spacing" in spec:
+            paragraph.line_spacing = float(number(spec["line_spacing"], "line_spacing", positive=True))
+        for key in ("space_before_pt", "space_after_pt"):
+            if key in spec:
+                setattr(paragraph, key.removesuffix("_pt"), Pt(number(spec[key], key)))
+        if "alignment" in spec:
+            if spec["alignment"] not in ALIGNMENTS:
+                raise ValueError("alignment must be left, center or right")
+            paragraph.alignment = ALIGNMENTS[spec["alignment"]]
+
+
+def patch(pptx: Path, specification: Path, output: Path) -> dict:
+    """Atomically replace selected slide XML; retain all other ZIP payloads."""
+    if pptx.resolve() == output.resolve() or specification.resolve() == output.resolve():
+        raise ValueError("output must be separate from the inputs")
+    operations = json.loads(specification.read_text(encoding="utf-8"))
+    if not isinstance(operations, list) or not operations:
+        raise ValueError("specification must be a nonempty list")
+    with ZipFile(pptx) as archive:
+        infos = archive.infolist()
+        if len(infos) != len({item.filename for item in infos}) or archive.testzip():
+            raise ValueError("invalid or duplicate PPT ZIP entries")
+        before = {item.filename: archive.read(item) for item in infos}
+    parts = slide_parts(before)
+    prs = Presentation(pptx)
+    selected, seen = set(), set()
+    for operation in operations:
+        if (not isinstance(operation, dict) or operation.keys() - {"page", "shape_id", "box_inches", "text_frame"}
+                or not ({"box_inches", "text_frame"} & operation.keys())):
+            raise ValueError("operation requires page, shape_id and box_inches or text_frame")
+        page, shape_id = operation.get("page"), operation.get("shape_id")
+        if type(page) is not int or not 1 <= page <= len(prs.slides) or type(shape_id) is not int:
+            raise ValueError("invalid page or shape_id")
+        if (page, shape_id) in seen:
+            raise ValueError("duplicate page/shape_id operation")
+        seen.add((page, shape_id))
+        matches = [shape for shape in prs.slides[page - 1].shapes if shape.shape_id == shape_id]
+        if len(matches) != 1:
+            raise ValueError(f"P{page}: shape_id {shape_id} is not a unique top-level shape")
+        shape = matches[0]
+        if "box_inches" in operation:
+            box = operation["box_inches"]
+            if not isinstance(box, list) or len(box) != 4:
+                raise ValueError("box_inches must be [left, top, width, height]")
+            values = [Inches(number(value, "box", positive=index >= 2)) for index, value in enumerate(box)]
+            if values[0] + values[2] > prs.slide_width or values[1] + values[3] > prs.slide_height:
+                raise ValueError("box is outside slide bounds")
+            for key, value in zip(("left", "top", "width", "height"), values):
+                setattr(shape, key, value)
+        if "text_frame" in operation:
+            apply_frame(shape, operation["text_frame"])
+        selected.add(page)
+    updated = {parts[page - 1]: dump(prs.slides[page - 1]._element) for page in selected}
+    output.parent.mkdir(parents=True, exist_ok=True)
+    with tempfile.TemporaryDirectory(dir=output.parent, prefix=".slide-patch-") as directory:
+        temporary = Path(directory) / "presentation.pptx"
+        with ZipFile(temporary, "w") as archive:
+            for info in infos:
+                archive.writestr(copy.copy(info), updated.get(info.filename, before[info.filename]))
+        with ZipFile(temporary) as archive:
+            if archive.testzip() or any(archive.read(name) != data for name, data in before.items() if name not in updated):
+                raise ValueError("patch changed an unselected package part")
+        Presentation(temporary)
+        temporary.replace(output)
+    return {"patched_pages": sorted(selected), "patched_shapes": len(seen), "other_parts_preserved": True}
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    commands = parser.add_subparsers(dest="command", required=True)
+    reader = commands.add_parser("inspect")
+    reader.add_argument("pptx", type=Path)
+    writer = commands.add_parser("apply")
+    writer.add_argument("pptx", type=Path)
+    writer.add_argument("specification", type=Path)
+    writer.add_argument("output", type=Path)
+    args = parser.parse_args()
+    result = inspect(args.pptx) if args.command == "inspect" else patch(args.pptx, args.specification, args.output)
+    print(json.dumps(result, ensure_ascii=False, indent=2))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/speaker_notes.py

@@ -0,0 +1,245 @@
+#!/usr/bin/env python3
+"""Export speaker-script Markdown or embed it without rewriting slide content."""
+from __future__ import annotations
+
+import argparse
+import copy
+import hashlib
+import json
+import posixpath
+import re
+import tempfile
+from pathlib import Path
+from zipfile import ZipFile
+
+from lxml import etree as ET
+from pptx import Presentation
+
+P = "http://schemas.openxmlformats.org/presentationml/2006/main"
+A = "http://schemas.openxmlformats.org/drawingml/2006/main"
+R = "http://schemas.openxmlformats.org/officeDocument/2006/relationships"
+PR = "http://schemas.openxmlformats.org/package/2006/relationships"
+CT = "http://schemas.openxmlformats.org/package/2006/content-types"
+NS = {"p": P, "a": A}
+
+
+def xml(data: bytes):
+    """Parse local OOXML without resolving entities or fetching resources."""
+    return ET.fromstring(data, ET.XMLParser(resolve_entities=False, no_network=True))
+
+
+def dump(element) -> bytes:
+    return ET.tostring(element, encoding="UTF-8", xml_declaration=True, standalone=True)
+
+
+def child(parent, namespace, tag, **attrs):
+    return ET.SubElement(parent, f"{{{namespace}}}{tag}", **attrs)
+
+
+def relationship(root, kind):
+    return next((item for item in root if item.get("Type") == R + "/" + kind), None)
+
+
+def add_relationship(root, kind, target):
+    ids = {item.get("Id") for item in root}
+    number = 1
+    while f"rId{number}" in ids:
+        number += 1
+    return child(root, PR, "Relationship", Id=f"rId{number}", Type=R + "/" + kind, Target=target)
+
+
+def slide_parts(entries: dict[str, bytes]) -> list[str]:
+    """Resolve presentation order through relationships, including reordered slides."""
+    targets = {item.get("Id"): item.get("Target") for item in xml(entries["ppt/_rels/presentation.xml.rels"])}
+    return [resolve_part("ppt/presentation.xml", targets[item.get(f"{{{R}}}id")])
+            for item in xml(entries["ppt/presentation.xml"]).find(f"{{{P}}}sldIdLst")]
+
+
+def resolve_part(source: str, target: str) -> str:
+    """Resolve relative or package-absolute OOXML relationship targets."""
+    return posixpath.normpath(target.lstrip("/") if target.startswith("/")
+                             else posixpath.join(posixpath.dirname(source), target))
+
+
+def parse_script(path: Path, count: int) -> tuple[dict[int, str], int]:
+    """Require one nonempty P-numbered section per slide; reject unfinished drafts."""
+    raw = re.sub(r"<!--.*?-->", "", path.read_text(encoding="utf-8"), flags=re.S)
+    sections, budget = {}, 0
+    pattern = r"^## P(\d+)\s*[｜|:：]\s*([^\n]+)\n(.*?)(?=^## |\Z)"
+    for match in re.finditer(pattern, raw, re.M | re.S):
+        number = int(match[1])
+        title = match[2].strip()
+        body = re.sub(r"<!--.*?-->", "", match[3], flags=re.S).strip()
+        if number in sections or not body or "TODO speaker script" in body:
+            raise ValueError(f"P{number}: duplicate, empty or unfinished speaker script")
+        timing = re.search(r"[（(](\d+)\s*(?:秒|s|seconds)[）)]", title)
+        budget += int(timing[1]) if timing else 0
+        sections[number] = f"P{number}｜{title}\n\n{body}"
+    if set(sections) != set(range(1, count + 1)):
+        raise ValueError(f"script must cover P1 through P{count} exactly")
+    return sections, budget
+
+
+def notes_document(text: str):
+    root = ET.Element(f"{{{P}}}notes", nsmap={"p": P, "a": A, "r": R})
+    tree = child(child(root, P, "cSld"), P, "spTree")
+    nv = child(tree, P, "nvGrpSpPr")
+    child(nv, P, "cNvPr", id="1", name="")
+    child(nv, P, "cNvGrpSpPr")
+    child(nv, P, "nvPr")
+    child(tree, P, "grpSpPr")
+    sp = child(tree, P, "sp")
+    nv = child(sp, P, "nvSpPr")
+    child(nv, P, "cNvPr", id="2", name="Notes")
+    child(nv, P, "cNvSpPr")
+    child(child(nv, P, "nvPr"), P, "ph", type="body", idx="1")
+    child(sp, P, "spPr")
+    tx = child(sp, P, "txBody")
+    child(tx, A, "bodyPr")
+    child(tx, A, "lstStyle")
+    replace_text(tx, text)
+    child(child(root, P, "clrMapOvr"), A, "masterClrMapping")
+    return root
+
+
+def replace_text(tx, text: str):
+    for paragraph in list(tx):
+        if paragraph.tag == f"{{{A}}}p":
+            tx.remove(paragraph)
+    for line in text.split("\n"):
+        paragraph = child(tx, A, "p")
+        run = child(paragraph, A, "r")
+        child(run, A, "rPr", lang="zh-CN", sz="1100")
+        child(run, A, "t").text = line
+
+
+def semantic_part(data: bytes) -> bytes:
+    """Remove only notes declarations for preservation comparisons."""
+    root = xml(data)
+    for item in list(root):
+        if (item.tag == f"{{{P}}}notesMasterIdLst"
+                or item.get("Type") in (R + "/notesSlide", R + "/notesMaster")
+                or item.get("ContentType", "").endswith((".notesSlide+xml", ".notesMaster+xml"))):
+            root.remove(item)
+    return ET.tostring(root, method="c14n")
+
+
+def preservation_changes(before: dict[str, bytes], after: dict[str, bytes]) -> list[str]:
+    """Return changes outside notes parts and their required declarations."""
+    problems = []
+    for name in set(before) | set(after):
+        if name.startswith("ppt/notesSlides/") or name.startswith("ppt/notesMasters/"):
+            continue
+        old, new = before.get(name), after.get(name)
+        if old == new:
+            continue
+        declarations = name in ("[Content_Types].xml", "ppt/presentation.xml", "ppt/_rels/presentation.xml.rels")
+        slide_rels = name.startswith("ppt/slides/_rels/") and name.endswith(".rels")
+        if declarations or slide_rels:
+            empty = dump(ET.Element(f"{{{PR}}}Relationships"))
+            if new is not None and semantic_part(old or empty) == semantic_part(new):
+                continue
+        problems.append(name)
+    return sorted(problems)
+
+
+def embed(pptx: Path, script: Path, output: Path) -> dict:
+    """Atomically write complete notes after verifying all other content is preserved."""
+    with ZipFile(pptx) as source:
+        infos = source.infolist()
+        if len({item.filename for item in infos}) != len(infos) or source.testzip():
+            raise ValueError("invalid or duplicate ZIP entries")
+        before = {item.filename: source.read(item) for item in infos}
+    entries = before.copy()
+    parts = slide_parts(entries)
+    sections, budget = parse_script(script, len(parts))
+    content_types = xml(entries["[Content_Types].xml"])
+    for page, slide in enumerate(parts, 1):
+        relfile = posixpath.join(posixpath.dirname(slide), "_rels", posixpath.basename(slide) + ".rels")
+        rels = xml(entries[relfile]) if relfile in entries else ET.Element(f"{{{PR}}}Relationships", nsmap={None: PR})
+        rel = relationship(rels, "notesSlide")
+        if rel is None:
+            number = 1
+            while f"ppt/notesSlides/notesSlide{number}.xml" in entries:
+                number += 1
+            note_file = f"ppt/notesSlides/notesSlide{number}.xml"
+            add_relationship(rels, "notesSlide", f"../notesSlides/notesSlide{number}.xml")
+            entries[relfile] = dump(rels)
+            root = notes_document(sections[page])
+            note_rels = ET.Element(f"{{{PR}}}Relationships", nsmap={None: PR})
+            add_relationship(note_rels, "slide", posixpath.relpath(slide, "ppt/notesSlides"))
+            # A notes master is optional. Reuse it when the deck already has one.
+            masters = sorted(n for n in entries if re.fullmatch(r"ppt/notesMasters/notesMaster\d+\.xml", n))
+            if masters:
+                add_relationship(note_rels, "notesMaster", posixpath.relpath(masters[0], "ppt/notesSlides"))
+            entries[f"ppt/notesSlides/_rels/notesSlide{number}.xml.rels"] = dump(note_rels)
+            child(content_types, CT, "Override", PartName="/" + note_file,
+                  ContentType="application/vnd.openxmlformats-officedocument.presentationml.notesSlide+xml")
+        else:
+            note_file = resolve_part(slide, rel.get("Target"))
+            root = xml(entries[note_file])
+            bodies = root.xpath('.//p:sp[p:nvSpPr/p:nvPr/p:ph[@type="body"]]/p:txBody', namespaces=NS)
+            if len(bodies) != 1:
+                raise ValueError(f"P{page}: expected one notes body placeholder")
+            replace_text(bodies[0], sections[page])
+        entries[note_file] = dump(root)
+    entries["[Content_Types].xml"] = dump(content_types)
+    changes = preservation_changes(before, entries)
+    if changes:
+        raise ValueError(f"notes update changed presentation content: {changes}")
+    output.parent.mkdir(parents=True, exist_ok=True)
+    with tempfile.NamedTemporaryFile(dir=output.parent, suffix=".pptx", delete=False) as stream:
+        temporary = Path(stream.name)
+    try:
+        with ZipFile(temporary, "w") as archive:
+            for info in infos:
+                archive.writestr(copy.copy(info), entries[info.filename])
+            for name in entries.keys() - before.keys():
+                archive.writestr(name, entries[name])
+        result = Presentation(temporary)
+        for page, slide in enumerate(result.slides, 1):
+            if not slide.has_notes_slide or slide.notes_slide.notes_text_frame.text != sections[page]:
+                raise ValueError(f"P{page}: notes readback mismatch")
+        temporary.replace(output)
+    finally:
+        temporary.unlink(missing_ok=True)
+    return {"pages": len(parts), "notes_written": len(sections), "budget_seconds": budget,
+            "content_preserved": True, "sha256": hashlib.sha256(output.read_bytes()).hexdigest()}
+
+
+def export_script(pptx: Path, output: Path):
+    """Create a draft from slide text and existing notes, with no invented achievements."""
+    if pptx.resolve() == output.resolve():
+        raise ValueError("Markdown output must be separate from the source deck")
+    prs = Presentation(pptx)
+    lines = ["# Speaker script", "", "<!-- Set per-page timing, rehearse and verify evidence before embedding. -->", ""]
+    for page, slide in enumerate(prs.slides, 1):
+        title = slide.shapes.title.text if slide.shapes.title else f"Slide {page}"
+        title = " ".join(title.split())
+        body = slide.notes_slide.notes_text_frame.text if slide.has_notes_slide else ""
+        text = "\n".join(s.text for s in slide.shapes if s.has_text_frame).replace("--", "- -")
+        lines += [f"## P{page}｜{title}", "", f"<!-- Slide content:\n{text}\n-->", "", body.strip() or "[TODO speaker script]", ""]
+    output.parent.mkdir(parents=True, exist_ok=True)
+    output.write_text("\n".join(lines), encoding="utf-8")
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description=__doc__)
+    commands = parser.add_subparsers(dest="command", required=True)
+    export = commands.add_parser("export")
+    export.add_argument("pptx", type=Path)
+    export.add_argument("markdown", type=Path)
+    write = commands.add_parser("embed")
+    write.add_argument("pptx", type=Path)
+    write.add_argument("markdown", type=Path)
+    write.add_argument("output", type=Path)
+    args = parser.parse_args()
+    if args.command == "export":
+        export_script(args.pptx, args.markdown)
+    else:
+        print(json.dumps(embed(args.pptx, args.markdown, args.output), ensure_ascii=False))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())

package/style-recipes.md

@@ -0,0 +1,166 @@
+# 视觉配方（PPT 助手 · 视觉总监层）
+
+这不是模板库，是六套完整的视觉判断。先选一套当主配方，再用第二套做辅助（只借它的 1–2 个特征，不平均混合）。把 `meta.recipe` 记进 spec，保证整套不漂。
+
+## 用法
+
+1. 先写风格简报（见文末），明确受众、要促成的判断、内容类型、场景、情绪。
+2. 只选**一套**最接近任务的配方；没有完全匹配就用简报创造新配方，或有意识地「主 + 辅」。
+3. 把配方里的 tokens 抄进 `meta`；版式按 `rhythm` 排列，密度按 `density` 控制。
+4. 配方是起点，不是验收规则。证据、受众或场景提出更强要求时，让内容覆盖配方。
+
+---
+
+## 1. 咨询研报 · consulting
+
+- **三个形容词**：克制、证据密、结论先行
+- **设计张力**：高信息密度 vs 大量留白——用留白分区，不用留白填空
+- **密度**：高。每页 3–5 个证据模块，标题即结论
+- **配色逻辑**：冷灰纸底 + 单一深青强调；红只标风险；禁止第二个高饱和色
+- **字体逻辑**：无衬线；标题 28–32、正文 14–16、标签 11；数字用表格/原生图表，不用巨大数字占半页
+- **图片行为**：图表、表格、截图优先；照片只作证据，满幅时加 0.85 白蒙层
+- **空间节奏**：页眉结论带 → 证据网格 → 底部 takeaway；相邻页在表格/图表/卡片间切换
+
+```json
+"meta": {"theme": "paper", "recipe": "consulting", "accent": "176C88",
+         "colors": {"bg": "F4F6FA", "panel": "FFFFFF", "text": "15253F", "muted": "4D627A"},
+         "font": "Noto Sans CJK SC"}
+```
+
+版式池：`kpi_showcase` `table` `chart` `heat_bars` `comparison` `cards` `image_split` `image_annotated`
+骨架：结论页 → 证据 1（表）→ 证据 2（图）→ 拆解（卡）→ 建议（process）→ 收尾
+避免：装饰性大图封面、每页一个巨型数字、彩色卡片墙。
+
+---
+
+## 2. 正式工作汇报 · formal
+
+- **三个形容词**：庄重、清晰、可追溯
+- **设计张力**：正式感 vs 可读性——用大标题和短正文扛住，不靠装饰
+- **密度**：中高。每页一个判断 + 三条支撑 + 来源
+- **配色逻辑**：冷白底 + 深蓝主色；红只用于风险/待确认；页脚常驻
+- **字体逻辑**：无衬线；标题 26–30、正文 14–16；数字带单位与口径
+- **图片行为**：实拍、截图、流程图；满幅照片加暗色蒙版；不用 AI 插画替代现场
+- **空间节奏**：封面 → 目录 → 背景 → 进展 → 问题 → 计划 → 结束；章节页用 `section_number`
+
+```json
+"meta": {"theme": "paper", "recipe": "formal", "accent": "0B5FA5",
+         "colors": {"bg": "F7F9FC", "panel": "FFFFFF", "text": "15253F", "muted": "4D627A"},
+         "font": "Noto Sans CJK SC"}
+```
+
+版式池：`cover` `section_number` `cards` `table` `heat_bars` `image_overlay` `process` `closing`
+骨架：封面 → 目录 → 背景（图/时间线）→ 进展（表）→ 问题（对比）→ 计划（步骤）→ 收尾
+避免：一页塞两个结论、用装饰图代替数据、标题写成名词短语。
+
+---
+
+## 3. 社区党建 · civic
+
+- **三个形容词**：温暖、庄重、在地
+- **设计张力**：传统红金 vs 现代留白——红只做重音，不做满屏底
+- **密度**：中。活动实拍 + 短说明 + 一句群众原话
+- **配色逻辑**：暖纸底 + 深红主色 + 少量金；文字用暖黑，不用纯黑
+- **字体逻辑**：标题可用衬线（Noto Serif CJK SC），正文无衬线；标题 30–36、正文 15–17
+- **图片行为**：活动/场景/物件实拍，暖调；人物不特写、不摆拍；可用拱形/圆角裁切
+- **空间节奏**：封面 → 主题 → 活动图墙 → 成效数字 → 群众声音（金句）→ 下一步
+
+```json
+"meta": {"theme": "paper", "recipe": "civic", "accent": "9E2A2B",
+         "colors": {"bg": "FBF7F2", "panel": "FFFFFF", "text": "2B2118", "muted": "6B5B4D"},
+         "font": "Noto Sans CJK SC", "titleFont": "Noto Serif CJK SC"}
+```
+
+版式池：`image_hero` `quote_stage` `image_wall` `image_arch` `cards` `closing`
+骨架：红调封面 → 主题 → 活动实拍（图墙）→ 成效（数字）→ 群众声音（金句）→ 下一步
+避免：大红大金铺满、口号式空话、把群众照片当装饰。
+
+---
+
+## 4. 艺术市集 · artfair
+
+- **三个形容词**：高饱和、海报感、手作
+- **设计张力**：粗大字 vs 细信息——大字压版，小字密排，中间不留温吞灰区
+- **密度**：中低到中；一页一个视觉主张 + 一条实用信息
+- **配色逻辑**：奶油底 + 橙红主色 + 青绿辅助；色块可以撞，但只撞一次
+- **字体逻辑**：无衬线粗体；标题 40–56、正文 14–16；标签用大写+字距
+- **图片行为**：作品、摊位、人流、手作特写；透明抠图压版、拱窗、瀑布流；可以高饱和
+- **空间节奏**：海报封面 → 图墙 → 日程 → 地图/标注 → 主理人金句 → 收尾
+
+```json
+"meta": {"theme": "paper", "recipe": "artfair", "accent": "E4572E",
+         "colors": {"bg": "F6E7D8", "panel": "FFF8F0", "text": "1A1A1A", "muted": "6B5B4B"},
+         "font": "Noto Sans CJK SC"}
+```
+
+版式池：`cutout_statement` `image_wall` `image_triptych` `section_number` `quote_stage` `image_statement`
+骨架：海报封面 → 图墙 → 日程（步骤）→ 现场标注 → 金句 → 收尾
+避免：低饱和莫兰迪、居中对齐的安全牌、把作品缩进小卡片。
+
+---
+
+## 5. 编辑画册 · editorial
+
+- **三个形容词**：安静、留白、文学
+- **设计张力**：极大留白 vs 一张大图——图占 55–65%，文字退到边上
+- **密度**：低。一页一段话或一张图，标题克制
+- **配色逻辑**：象牙纸底 + 陶土色强调；几乎不用第三个颜色
+- **字体逻辑**：标题衬线（Noto Serif CJK SC），正文无衬线；标题 32–44、正文 16–18
+- **图片行为**：单张大图、拱形/圆角、双色调；不拼贴、不堆图
+- **空间节奏**：封面 → 长文 → 单图 → 引文 → 索引 → 收尾；页与页之间留呼吸
+
+```json
+"meta": {"theme": "paper", "recipe": "editorial", "accent": "B4552D",
+         "colors": {"bg": "F7F3EC", "panel": "FFFDF8", "text": "1C1B19", "muted": "6F675C"},
+         "font": "Noto Sans CJK SC", "titleFont": "Noto Serif CJK SC"}
+```
+
+版式池：`image_hero` `image_arch` `image_triptych` `quote_stage` `image_statement` `image_split` `closing`
+骨架：大图封面 → 长文 → 单图 → 引文 → 索引 → 收尾
+避免：满屏卡片、彩色标签、把每页都填满。
+
+---
+
+## 6. 历史教学 · history
+
+- **三个形容词**：时间感、叙事、克制
+- **设计张力**：年表密度 vs 图像叙事——用一条时间轴/一组标注把散点串起来
+- **密度**：中高。事件、年份、因果要能一眼读出
+- **配色逻辑**：羊皮纸底 + 赭石/暗红；照片做旧（mono/duotone），不用现代高饱和
+- **字体逻辑**：标题衬线，正文无衬线；年份用等宽或加粗数字
+- **图片行为**：档案照、地图、器物；标注圆点+引线；避免现代 stock 照片
+- **空间节奏**：时代背景 → 关键事件（标注）→ 人物/器物 → 影响 → 讨论
+
+```json
+"meta": {"theme": "paper", "recipe": "history", "accent": "8C3B2E",
+         "colors": {"bg": "EDE4D3", "panel": "F8F1E3", "text": "2A2118", "muted": "6B5A44"},
+         "font": "Noto Sans CJK SC", "titleFont": "Noto Serif CJK SC"}
+```
+
+版式池：`split_diagonal` `image_annotated` `cards` `image_arch` `quote_stage` `closing`
+骨架：时代背景 → 关键事件（标注）→ 人物/器物 → 影响 → 讨论
+避免：把年表写成流水账、用彩色图标替代史料、照片不做旧也不标注来源。
+
+---
+
+## 风格简报模板（没有匹配配方时）
+
+写七行，不超过 120 字：
+
+1. **受众 + 要促成的判断/行动**
+2. **三个形容词**
+3. **一个设计张力**（例如「密度 vs 留白」「传统 vs 现代」）
+4. **密度**（低/中/高，每页几个模块）
+5. **配色逻辑**（底色 + 主色 + 辅助色 + 禁用色）
+6. **字体逻辑**（标题/正文/数字，字号范围）
+7. **图片行为 + 空间节奏**（大图/图表/实拍；页与页怎么换气）
+
+## 验收清单（视觉总监）
+
+- 每页只有一个主要结论，标题是结论句。
+- 垂直结构完整：页眉 → 标题 → 间距 → 主体 → 结论/来源 → 页脚安全区。
+- 密度靠分组/对齐/证据结构，不靠缩小字号。
+- 字体、外边距、颜色角色、线条、页脚规则一致；版式轮廓有变化。
+- 先看缩略图总览，再抽封面、最密页、特殊媒体页、结束页全尺寸检查。
+- 低成本结构检查（完整性、占位符、讲稿、溢出）常做；跨渲染只在有风险时做。
+- 意外变化能加强沟通就保留；混合风格要声明主/辅，不平均折中。