Metadata-Version: 2.4
Name: word-wzq
Version: 2.1.0
Summary: Word(.docx) 多模态教学知识库自动化构建：节级文本/公式/图片提取 → 图片AI解读 → 教材文案 → 图文绑定（混合法：标题层级逻辑分块 + 可选渲染定页）
Author-email: 吴振谦 <wuzhenqian@nbu.edu.cn>
License: MIT
Keywords: word,docx,education,knowledge-base,multimodal,latex
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: Pillow>=9.0
Requires-Dist: openai>=1.0
Requires-Dist: olefile>=0.46
Requires-Dist: omml2latex>=0.1.1
Requires-Dist: pywin32>=306; platform_system == "Windows"
Provides-Extra: ocr
Requires-Dist: pix2tex>=0.1.2; extra == "ocr"
Provides-Extra: render
Requires-Dist: pdfplumber>=0.10; extra == "render"

# word-wzq · Word(.docx) 多模态教学知识库自动化构建

把 Word 讲义/教材文稿自动转化为**可检索、可复用、可再加工**的多模态教学知识库：
节级文本 + 公式 LaTeX + 图片集 + 图片 AI 理解 + 教材文案 + 图文绑定 JSON。
与 [pptx-wzq](https://pypi.org/project/pptx-wzq/) 同构——指令、流程、产物协议完全一致。

## 核心方案：混合法

Word 是连续流文档、无物理页，故采用「**标题层级逻辑分块 + 可选渲染定页**」：

1. **逻辑分块（默认）**：以 Heading1~9 / 标题1~9 样式切分「节」→ 节即伪「页」，
   段落/表格/图片/公式归属最近一节；教材语义比物理页更贴切；
2. **渲染定页（`--render-pages` 增强）**：LibreOffice/Word 导出 PDF 后映射物理页码，
   用于与「PPTX 转 PDF」对齐或人工核对。

## 安装

```bash
pip install word-wzq
pip install "word-wzq[render]"   # 混合法增强：物理页码映射
```

## 快速开始

```bash
# 一条命令完整流水线（自动装依赖 / 引导 Key / 预估 Token / 确认执行）
word-paser 模拟电子技术讲义.docx -o 讲义输出

# 结果目录：images/ + <名>_captions.md + <名>_textbook.md + <名>_binding.json

# 分步执行
word-text 讲义.docx -o out
word-formula 讲义.docx -o out
word-img 讲义.docx -o out
word-caption out/images -o cap.md --texts out/texts.md --formulas out/formulas.md
word-author --texts out/texts.md --formulas out/formulas.md --captions cap.md -o textbook.md
word-bind out -o binding.json --textbook textbook.md --images-dir out/images
```

## 指令一览

| 命令 | 功能 | 模型 | Token |
|---|---|---|---|
| `word-text` | 节级文本/表格提取（标题层级逻辑分块） | — | 0 |
| `word-formula` | 三路径公式→LaTeX（OMML/EQ3/OCR） | — | 0 |
| `word-img` | 节级图片提取+过滤+EMF/WMF 渲染 | — | 0 |
| `word-caption` | 图片 AI 解读（文档上下文模式） | qwen3.7-plus | 有 |
| `word-author` | 教材文案（学科推断+分批） | deepseek-v4-flash | 有 |
| `word-bind` | 节级图文绑定 JSON | — | 0 |
| `word-paser` | 整体编排（混合法） | — | — |

## 作者

吴振谦 · wuzhenqian@nbu.edu.cn · QQ：38328063
