Metadata-Version: 2.4
Name: wzq-ppt-build
Version: 1.4.0
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**。

## 特性

- **四步工作流**：设计表 + 用户确认门禁（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 技能（自动）

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

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

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

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