Metadata-Version: 2.4
Name: wzq-ppt-build
Version: 1.5.1
Summary: wzq-ppt-build：块级语义增强的 PPT-Master 提示词引擎（cxfusion 蓝橙设计语言 · 四步工作流 · 88 拓扑真源）· pip 安装后自动部署为 WorkBuddy 技能
Author-email: 吴振谦 <wuzhenqian6611@users.noreply.github.com>
License: MIT
Project-URL: Homepage, https://github.com/wuzhenqian6611/wzq-ppt-build
Project-URL: Source, https://github.com/wuzhenqian6611/wzq-ppt-build
Keywords: ppt,pptx,presentation,skill,ppt-master,workbuddy,prompt
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Education
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Multimedia :: Graphics :: Presentation
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: python-pptx>=0.6.21
Requires-Dist: openpyxl>=3.0
Requires-Dist: PyYAML>=6.0
Requires-Dist: Pillow>=9.0
Dynamic: license-file

# 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 原版技能保持不动，本包独立发布

## 快速开始

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

```bash
pip install wzq-ppt-build
```

安装后**自动生效**（无需任何手动配置）：
```python
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（四步脚本链路）

```bash
# 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）
