wzq-ppt-build · PyPI 技能包

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

v1.5.0：pip install 后自动两步部署（内置完整 PPT-Master 技能），开箱即用，零手动配置。

特性

• 四步工作流：设计表 + 用户确认门禁（Q1 设计表可否 + Q2 资源图）→ 解析 → 块级提示词 → PPT-Master 生成
• 两步自动部署：内置 vendor/ppt-master.zip（完整 PPT-Master 技能 12922 文件），pip 安装后 import wzq_ppt_build 自动部署 ppt-master + wzq-ppt-build 两个技能到 ~/.workbuddy/skills/
• 独立运行：88 拓扑真源内嵌（topology_vocab.json，196 词表）+ 45 形态库， 不依赖任何外部技能（除自动部署的 ppt-master）
• 块级六要素契约：每页拆 1-3 个 visual block，每块带「拓扑 + 表达内容 + 表达目标 + 形态方案 + 设计元素 + 成品态描述」
• 同拓扑跨页换形态：形态按出现次数轮换（_MORPH_SEQ），杜绝同质化
• 导航三规则：顶栏标题 28-36pt / 顶栏 tab 每章节名称动态联动 / 左栏章卡全栏等高
• 用户约束优先：用户手工页面设计表（xlsx）为权威约束；常用拓扑写法自动命中（14 条同义别名）
• 技能文件保护门禁：使用过程中 SKILL.md / scripts / references 只读（SHA-256 哈希校验），仅 assets/ 可写
• 资源图嵌入：SVG <image> → finalize 自动 base64 内嵌
• 双保险策略：wzq-ppt 原版技能保持不动，本包独立发布

快速开始

安装即用（自动两步部署）

pip install wzq-ppt-build

安装后自动生效（无需任何手动配置）：

import wzq_ppt_build   # ← 触发两步自动部署（约 30-60 秒首次）

• 第一步：内置 vendor/ppt-master.zip 解压部署 → ~/.workbuddy/skills/ppt-master（PPT 生成引擎）
• 第二步：本技能文件部署 → ~/.workbuddy/skills/wzq-ppt-build
• 幂等：已安装则跳过；升级版本自动覆盖同步
• 也可手动执行：wzq-ppt-build-install [--force]

生成 PPT（四步脚本链路）

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

# 2. 生成块级蓝图（每页块数/拓扑/表达内容，88 拓扑内嵌）
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 命令
├── vendor/ppt-master.zip        内置完整 PPT-Master 技能（54.8MB / 12922 文件）
├── SKILL.md                     技能入口 · 四步工作流 · 硬规则 · 文件保护门禁
├── references/                 设计契约 / 页面类型 / 块级规范 / 提示词规范 / 设计表规范 / 形态库 / 88 拓扑
├── scripts/                     extract_pages / build_block_blueprint / build_design_table / guard_skill_files
└── docs/                        技能全解析文档（PDF）

文档

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

环境要求

• Python ≥ 3.10
• 自动部署目标：~/.workbuddy/skills/（WorkBuddy 技能目录）

License

MIT © 吴振谦（wuzhenqian6611）