pptx-wzq · PPT 多模态教学知识库自动化构建
作者：吴振谦 · wuzhenqian@nbu.edu.cn · QQ：38328063 本项目帮助高校教师把教学 PPT 自动转化为图文并茂的多模态教学知识库。
把一份教学 PPT 自动转化为可检索、可复用、可再加工的多模态教学知识库： 图片集 + 图片 AI 理解 + 公式 LaTeX + 教材文案 + 图文绑定 JSON，并可一键导出 教材 HTML 与教学 Deck。
PPT(.pptx)
→ 图片提取/过滤 pptx-img
→ 公式提取 pptx-formula
→ 文本提取 pptx-text
→ 图片AI解读 pptx-caption
→ 教材文案 pptx-author
→ 图文绑定 pptx-bind
→ 一条命令编排 pptx-paser
→ 教材 HTML/Deck pptx-html / pptx-deck
安装
pip install pptx-wzq # 核心
pip install "pptx-wzq[ocr]" # 含本地公式 OCR（pix2tex，可选）
Windows 下会自动安装 pywin32（用于 PowerPoint 渲染矢量图）。
首次运行 pptx-paser 会自动补齐缺失组件、检查 API Key
（DeepSeek / 阿里云百炼）并引导注册。
权重来源与许可：图片过滤内置的 YOLO 模型权重
yolov5su.pt来自 ultralytics（YOLO 官方）， 采用 AGPL-3.0 许可证随包分发；商用或闭源使用请自行评估其开源条款。
快速开始
# 一条命令跑完整流水线（自动装依赖 / 引导 Key / 预估 Token / 确认执行）
pptx-paser 第九章功率放大电路.pptx -o output
# 结果目录：
# output/images/ + output/<名>_captions.md + <名>_textbook.md + <名>_binding.json
# 导出教材 HTML（MathJax 公式渲染）
pptx-html output -o output/第九章.html
# 分步执行 / 断点续跑
pptx-img 课件.pptx -o out
pptx-caption out/images -o cap.md --texts out/texts.md --formulas out/formulas.md
pptx-paser 课件.pptx -o out --skip img,formula,text
指令一览
| 命令 | 功能 | 模型 | Token |
|---|---|---|---|
pptx-img |
图片提取 + 三路过滤 + WMF 识别/渲染 + 公式图片补提 | — | 0 |
pptx-formula |
公式三路径提取（OMML / EQ3-MTEF / OCR）→ LaTeX | — | 0 |
pptx-text |
逐页文本/表格提取，排除页眉页脚 | — | 0 |
pptx-caption |
图片 AI 解读（文档上下文模式，教材角度） | qwen3.7-plus | 有 |
pptx-author |
教材文案（学科推断 + 整文生成 + 自适应分批） | deepseek-v4-flash | 有 |
pptx-bind |
图文绑定 JSON（每页文案 ↔ 该页图片） | — | 0 |
pptx-paser |
整体编排：环境自检 / Key 引导 / Token 预估 / 汇报 | — | — |
pptx-html |
单文件教材 HTML（MathJax 公式 + PPT 原生标题） | — | 0 |
pptx-deck |
教育蓝图风格教学 Deck（示例脚本） | — | 0 |
API Key
| 用途 | 平台 | 模型 |
|---|---|---|
| 图片 AI 解读 / 公式图片识别 | 阿里云百炼（bailian.console.aliyun.com） | qwen3.7-plus |
| 教材文案 / 学科判断 | DeepSeek（platform.deepseek.com） | deepseek-v4-flash |
缺失时 pptx-paser 会打印注册引导并交互写入环境变量（DEEPSEEK_API_KEY /
DASHSCOPE_API_KEY）。
产物
结果目录/
├─ images/ 教学图片集（PNG，曲线矢量图已由 PowerPoint 渲染）
├─ <名>_captions.md 图片理解（图片类型/内容理解/教学用途）
├─ <名>_textbook.md 教材文案（每页一节，≥300 字教材口吻）
├─ <名>_binding.json 图文绑定（按页 {page, text, images[{file, caption}]}）
└─ 过程文件/ 中间产物（by_page / manifest / texts / formulas / …）
应用
- 课程知识内容体系自动构建（章 → 节 → 知识点 → 公式 + 配图）
- 基于学情测验的个性化学习内容生成
- 教材二次开发与多形态出版（HTML / Deck / Word / PDF）
- 智能问答与 RAG 检索（binding.json 作索引，答案图文并茂）
- 试题与测验生成（按 Bloom 认知层次，真实配图出题）
License
MIT
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distributions
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file pptx_wzq-1.0.6-py3-none-any.whl.
File metadata
- Download URL: pptx_wzq-1.0.6-py3-none-any.whl
- Upload date:
- Size: 17.2 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
40b5d27a4bd864bc40cdf3fd5b718b46b1ebc1f3a45b6937ef5d2e3a3e2d4481
|
|
| MD5 |
ab58bab0c923f652ac2a8a9d894d5d8f
|
|
| BLAKE2b-256 |
f8fc047e0e05109b227f61b57f2cf8b2e5d235837f199be3e7528f8368252454
|
