wzq-ppt-build · PyPI 技能包

wzq-ppt-build —— 块级语义增强的 PPT-Master 提示词引擎。 以《最终版.pptx》（2026 产教融合赛道现场汇报）的 cxfusion 蓝橙设计语言为主导， 输入 textbook 后自动完成：① 生成 PPT 页面设计表 → 用户确认门禁 → ② 解析 → ③ 块级提示词 → ④ 驱动 PPT-Master 生成原生可编辑 PPTX。

特性

• 四步工作流：设计表 + 用户确认门禁（Q1 设计表可否 + Q2 资源图）→ 解析 → 块级提示词 → PPT-Master 生成
• 块级六要素契约：每页拆 1-3 个 visual block，每块带「拓扑 + 表达内容 + 表达目标 + 形态方案 + 设计元素 + 成品态描述」
• 88 拓扑真源：动态导入 ppt-blueprint-builder 拓扑正典（182 词条）
• 39 形态方案库：morph_dict.json 数据化，同一拓扑跨页强制换形态
• 导航三规则：顶栏标题 28-36pt / 顶栏 tab 每章节名称动态联动 / 左栏章卡全栏等高
• 用户约束优先：用户手工页面设计表（xlsx）为权威约束
• 资源图嵌入：SVG <image> → finalize 自动 base64 内嵌
• 双保险策略：wzq-ppt 原版技能保持不动，本包独立发布

依赖

• ppt-master（WorkBuddy 技能，~/.workbuddy/skills/ppt-master，必须）
• ppt-blueprint-builder（88 拓扑真源，缺失时降级内置 24 拓扑）
• Python: python-pptx / openpyxl / PyYAML / Pillow

快速开始

安装即部署为 WorkBuddy 技能（自动）

pip install wzq-ppt-build

安装后自动生效（无需手动复制）：

• 任意 import wzq_ppt_build 时自动把技能文件同步到 ~/.workbuddy/skills/wzq-ppt-build/（幂等：已是最新则零操作；包升级自动覆盖同步）
• 或手动执行一次：wzq-ppt-build-install（--force 强制覆盖）

生成 PPT（wzq-ppt-build 三步脚本链路）

# 1. 解析 textbook 页面结构
python3 extract_pages.py "<textbook.md>" -o extract.json --textbook "<textbook.md>"

# 2. 生成块级蓝图（每页块数/拓扑/表达内容）
python3 build_block_blueprint.py extract.json -o "<工作目录>" --textbook "<textbook.md>"

# 3. 生成 PPT 页面设计表（6 列 xlsx）→ 请用户确认（Q1 设计表可否 + Q2 资源图）
python3 build_design_table.py "<block_blueprint.json>" \
    -o "PPT页面设计表_《课件名》.xlsx" --title "<课件名>" [--template "<模板.xlsx>"]

# 4. 组装 wzq_prompt.md（L0 全局 + L1 页面类型 + L2 块级契约 + L3 硬底线）
#    驱动 PPT-Master 生成（routing → design_spec → SVG → finalize → svg_to_pptx）

包内容

wzq_ppt_build/
├── __init__.py                  import 钩子：自动部署技能（幂等）
├── _auto_install.py             部署逻辑 + wzq-ppt-build-install 命令
├── SKILL.md                     技能入口 · 四步工作流 · 硬规则
├── references/                 设计契约 / 页面类型 / 块级规范 / 提示词规范 / 设计表规范 / 形态库
├── scripts/                     extract_pages / build_block_blueprint / build_design_table
└── docs/                        技能全解析文档（PDF）

文档

• docs/wzq-ppt-build-全解析.pdf：技术路径 / 文档结构 / 应用步骤与方法（图文并茂）

License

MIT © 吴振谦（wuzhenqian6611）