@huicai/cli 2026.814.0 → 2026.1021.0

package/skills/pptx-author/scripts/pptx_build.py

@@ -0,0 +1,119 @@
+# 结构化 spec → PPTX：模型只给"每页讲什么"，版式/字号/坐标/配色全由引擎算。
+#
+# 这是 create_deck 工具的执行端，也可以单独用：
+#   python pptx_build.py 大纲.json 产物.pptx
+#
+# 为什么不让模型直接写 python-pptx：写坐标就一定会有算错的坐标，
+# 那正是"文字出框、两块压在一起、图被拉长"的全部来源。
+# 模型擅长决定"这页讲什么"，不擅长也不该负责"这行字在 3.72 英寸处会不会撞到图"。
+
+import json
+import os
+import sys
+
+sys.path.insert(0, os.path.dirname(os.path.abspath(__file__)))
+
+from pptx_deck import Deck                                   # noqa: E402
+
+LAYOUTS = {
+    'cover': ('title',), 'agenda': ('items',), 'section': ('title',), 'bullets': ('title', 'bullets'),
+    'two_col': ('title', 'left', 'right'), 'kpi': ('title', 'kpis'), 'image': ('title', 'image'),
+    'image_text': ('title', 'image', 'bullets'), 'table': ('title', 'rows'), 'quote': ('text',),
+    'compare': ('title', 'left', 'right'), 'timeline': ('title', 'items'), 'end': (),
+}
+ALIAS = {  # 模型爱用的同义写法，都接住，别为了一个词名让整份 deck 失败
+    '封面': 'cover', '目录': 'agenda', 'toc': 'agenda', 'contents': 'agenda', '章节': 'section',
+    'divider': 'section', '要点': 'bullets', 'bullet': 'bullets', 'list': 'bullets', 'points': 'bullets',
+    '两栏': 'two_col', 'twocol': 'two_col', 'two-column': 'two_col', 'columns': 'two_col',
+    '指标': 'kpi', 'metrics': 'kpi', 'stats': 'kpi', '图': 'image', 'picture': 'image', 'chart': 'image',
+    '图文': 'image_text', 'imagetext': 'image_text', '表': 'table', '表格': 'table',
+    '引言': 'quote', '金句': 'quote', '对照': 'compare', '对比': 'compare', 'comparison': 'compare',
+    '时间轴': 'timeline', 'roadmap': 'timeline', '结尾': 'end', 'thanks': 'end', 'closing': 'end',
+}
+
+
+def norm_layout(v):
+    k = str(v or '').strip().lower()
+    return k if k in LAYOUTS else ALIAS.get(k) or ALIAS.get(str(v or '').strip())
+
+
+def build(spec, out_path, check=True):
+    """按 spec 建一份 PPTX。返回 {path, slides, outline, warnings, check}。"""
+    if not isinstance(spec, dict):
+        raise ValueError('spec 必须是对象')
+    slides = spec.get('slides') or spec.get('pages') or []
+    if not isinstance(slides, list) or not slides:
+        raise ValueError('spec.slides 不能为空：至少给一页（每页含 layout 与内容字段）')
+    d = Deck(theme=spec.get('theme', 'navy'), size=spec.get('size', '16:9'),
+             footer=spec.get('footer', ''), page_numbers=spec.get('page_numbers', True))
+    for i, sl in enumerate(slides, 1):
+        if not isinstance(sl, dict):
+            raise ValueError(f'第 {i} 页不是对象')
+        lay = norm_layout(sl.get('layout') or sl.get('type'))
+        if not lay:
+            raise ValueError(f'第 {i} 页 layout={sl.get("layout") or sl.get("type")!r} 不认识；'
+                             f'可选：{" / ".join(sorted(LAYOUTS))}')
+        miss = [k for k in LAYOUTS[lay] if not sl.get(k)]
+        if miss:
+            raise ValueError(f'第 {i} 页（{lay}）缺字段：{"、".join(miss)}')
+        try:
+            _emit(d, lay, sl)
+        except Exception as e:
+            raise ValueError(f'第 {i} 页（{lay}）建版失败：{e}') from e
+    res = d.save(out_path, check=check, verbose=False)
+    return dict(path=os.path.abspath(out_path), slides=len(d.prs.slides),
+                outline=[dict(page=n, layout=k, title=t) for n, k, t in d.outline()],
+                warnings=d.warnings, check=res)
+
+
+def _emit(d, lay, s):
+    g = s.get
+    if lay == 'cover':
+        d.add_cover(g('title'), g('subtitle', ''), g('meta', ''), g('notes'))
+    elif lay == 'agenda':
+        d.add_agenda(list(g('items')), g('title', '目录'), g('notes'))
+    elif lay == 'section':
+        d.add_section(g('title'), g('no'), g('subtitle', ''), g('notes'))
+    elif lay == 'bullets':
+        d.add_bullets(g('title'), g('bullets'), g('notes'), g('lead', ''))
+    elif lay == 'two_col':
+        d.add_two_col(g('title'), g('left'), g('right'), g('left_title', ''), g('right_title', ''), g('notes'))
+    elif lay == 'kpi':
+        d.add_kpi(g('title'), [tuple(k) if isinstance(k, (list, tuple)) else (str(k), '') for k in g('kpis')],
+                  g('notes'), g('caption', ''))
+    elif lay == 'image':
+        d.add_image(g('title'), g('image'), g('caption', ''), g('notes'))
+    elif lay == 'image_text':
+        d.add_image_text(g('title'), g('image'), g('bullets'), g('side', 'left'), g('caption', ''), g('notes'))
+    elif lay == 'table':
+        d.add_table(g('title'), g('rows'), g('notes'), g('col_widths'), g('note', ''))
+    elif lay == 'quote':
+        d.add_quote(g('text'), g('author', ''), g('notes'))
+    elif lay == 'compare':
+        d.add_compare(g('title'), g('left_title', '现状'), g('left'), g('right_title', '目标'), g('right'), g('notes'))
+    elif lay == 'timeline':
+        d.add_timeline(g('title'), g('items'), g('notes'))
+    elif lay == 'end':
+        d.add_end(g('text', '谢谢'), g('subtitle', ''), g('notes'))
+
+
+def main(argv):
+    if len(argv) < 2:
+        print('用法：python pptx_build.py <spec.json> <产物.pptx>')
+        return 2
+    with open(argv[0], encoding='utf-8') as f:
+        spec = json.load(f)
+    try:
+        r = build(spec, argv[1])
+    except Exception as e:
+        print(json.dumps(dict(error=str(e)), ensure_ascii=False))
+        return 1
+    import pptx_check
+    r['report'] = pptx_check.report(r['check']) if r.get('check') else ''
+    r['check'] = {k: r['check'][k] for k in ('ok', 'counts', 'slides', 'ratio')} if r.get('check') else None
+    print(json.dumps(r, ensure_ascii=False))
+    return 0
+
+
+if __name__ == '__main__':
+    sys.exit(main(sys.argv[1:]))