Techstyle Ppt

techstyle-ppt

按「content.json + 主题」生成 6 页简约科技风自我介绍 PPT。文案与代码分离：改文案只动 content.json，不动脚本。

主题选择：--theme tech-bright（默认，本次交付采用）全深色科技风·投影容错版；tech（更深更冷，环境很暗时更高级）；sandwich / dark / light 为无面板备选。

目录

• README.md — 安装与快速开始（人看的，先给他）
• scripts/build_deck.py — 生成器（护栏 + 自适应排版）
• scripts/verify_deck.py — 自检（页数 / 模块 / 字体 / 溢出 / 容器 / 动效）
• scripts/add_animations.ps1 — 加动效（切页淡化 + 元素淡入；幂等，可反复跑）
• scripts/export_pdf.ps1 — 可选：用本机 PowerPoint 导 PDF（打印画质，规避压图）
• scripts/export_png.ps1 — 可选：逐页导出 PNG（给 AI 自查布局用）
• references/design-spec.md — 配色 / 字号 / 栅格 / 母题 / 禁用项
• references/content-schema.md — content.json 字段定义与示例
• references/troubleshooting.md — 隐患与处置手册
• examples/content.example.json — 示例内容

使用（四步）

1. 准备内容：复制 examples/content.example.json 为你的 content.json（示例可直接跑通），按 references/content-schema.md 填写。
2. 生成：

   python scripts/build_deck.py --content <content.json> --out <out.pptx>
   

   可选 --theme tech-bright|tech|sandwich|dark|light（默认 tech-bright）；--verbose 打印每页间距系数 k 与填充率。
3. 自检（必须全 PASS，WARN 要人工看一眼）：

   python scripts/verify_deck.py --file <out.pptx> --content <content.json>
   

   期望值（页数 / 模块 / 姓名）从 content.json 自动推导；也可 --name/--pages/--modules 覆盖。
4. 加动效（交付版建议加；需本机 PowerPoint + PowerShell 7）：

   pwsh -NoProfile -File scripts/add_animations.ps1 -Pptx <out.pptx>          # 默认 Pace=auto
   pwsh -NoProfile -File scripts/add_animations.ps1 -Pptx <out.pptx> -Pace click
   

   加完再跑一次自检，加上 --expect-anim 确认动效在：

   python scripts/verify_deck.py --file <out.pptx> --content <content.json> --expect-anim
   

   ⚠️ 每次重跑 build_deck.py 都会清空动效（python-pptx 不支持动画）→ 必须重跑本脚本，否则交出去的就没动效。

硬约束（生成器强制执行）

• 页数：若 meta.page_count 已声明则必须完全相符；模块（meta.modules 或默认五模块）必须齐全，缺一拒绝生成
• 封面必须是第 1 页（role: cover）
• 16:9（13.333 × 7.5 英寸）；页面不引入外部图片（图形全用矢量形状）
• 目标文件被 PowerPoint 打开（存在 ~$ 锁文件）→ 拒绝生成
• 生成器只写 --out 指定的文件，绝不移动 / 删除任何其他文件

红线

• 生成前关掉 PowerPoint，或确保目标文件没在 PowerPoint 里打开（~$ 锁文件会让生成器拒绝执行）
• 重新生成 pptx 会清空动效 → 每次 build_deck.py 之后必须重跑 add_animations.ps1（跑前也要关掉 PowerPoint）
• 改形状名（ panel-* / content-* / kv-* / col* / title / index / motif-* / pagenum）会弄坏加动效脚本：脚本靠这些名字识别动画单元，改名前先读 references/design-spec.md 的《动效规范》
• 本 skill 不写备注（notes）；讲稿另存 md
• 不加动效（python-pptx 不支持；且面试 PPT 由对方播放）
• 导出 PDF 用 export_pdf.ps1（打印画质），不要用 PowerPoint 默认「另存为 PDF」（会把图片压糊）
• 文案中的人名、经历必须真实：内容来自使用者的既有文档，不得编造