jvs-pptxtojson 0.0.3 → 0.0.5

package/.babelrc.cjs

@@ -0,0 +1,15 @@
+module.exports = {
+  presets: [
+    [
+      '@babel/preset-env',
+      {
+        modules: false,
+      }
+    ]
+  ],
+  plugins: [
+    [
+      '@babel/plugin-transform-runtime',
+    ]
+  ]
+}

package/.eslintignore

@@ -0,0 +1,3 @@
+/node_modules
+/dist
+/public

package/.eslintrc.cjs

@@ -0,0 +1,78 @@
+module.exports = {
+  env: {
+    node: true,
+    browser: true,
+    es6: true,
+  },
+  extends: [
+    'eslint:recommended',
+  ],
+  parserOptions: {
+    ecmaVersion: 2020,
+    sourceType: 'module',
+  },
+  rules: {
+    'curly': ['error', 'multi-line'],
+    'eqeqeq': ['error', 'always'],
+    'semi': ['error', 'never'],
+    'indent': ['error', 2, { 
+      'SwitchCase': 1,
+    }],
+    'quotes': ['error', 'single', {
+      'avoidEscape': true,
+      'allowTemplateLiterals': true,
+    }],
+    'key-spacing': ['error', {
+      'beforeColon': false,
+      'afterColon': true,
+      'mode': 'strict',
+    }],
+    'no-empty': 'error',
+    'no-else-return': 'error',
+    'no-multi-spaces': 'error',
+    'require-await': 'error',
+    'brace-style': ['error', 'stroustrup'],
+    'spaced-comment': ['error', 'always'],
+    'arrow-spacing': 'error',
+    'no-duplicate-imports': 'error',
+    'comma-spacing': ['error', {
+      'before': false,
+      'after': true,
+    }],
+    'default-case': 'error',
+    'consistent-this': ['error', '_this'],
+    'max-depth': ['error', 6],
+    'max-lines': ['error', 2000],
+    'no-multi-str': 'error',
+    'space-infix-ops': 'error',
+    'space-before-blocks': ['error', 'always'],
+    'space-before-function-paren': ['error', {
+      'named': 'never',
+      'anonymous': 'never',
+      'asyncArrow': 'always',
+    }],
+    'keyword-spacing': ['error'],
+    'prefer-const': 'error',
+    'no-useless-return': 'error',
+    'array-bracket-spacing': 'error',
+    'no-useless-escape': 'off',
+    'no-case-declarations': 'off',
+    'no-eval': 'error',
+    'no-var': 'error',
+    'no-with': 'error',
+    'no-alert': 'warn',
+    'no-console': 'warn',
+    'no-debugger': 'warn',
+  },
+  overrides: [
+    {
+      files: [
+        '**/__tests__/*.{j,t}s?(x)',
+        '**/tests/unit/**/*.spec.{j,t}s?(x)'
+      ],
+      env: {
+        jest: true,
+      },
+    },
+  ],
+}

package/PPTX_OOXML_/350/247/243/346/236/220/345/256/214/346/225/264/350/257/264/346/230/216.md

@@ -0,0 +1,538 @@
+# PPTX OOXML 解析完整说明
+
+> 基于 ISO/IEC 29500-1 (ECMA-376) Part 1 — PresentationML + DrawingML  
+> 适用场景：PPTX 解析器开发、PPTX → JSON/XML 转换、在线 PPT 渲染引擎
+
+---
+
+## 一、命名空间（解析时务必保留）
+
+| 前缀 | URI | 用途 |
+|---|---|---|
+| `p:` | `http://schemas.openxmlformats.org/presentationml/2006/main` | PresentationML（幻灯片、形状树、母版等） |
+| `a:` | `http://schemas.openxmlformats.org/drawingml/2006/main` | DrawingML（填充、线条、颜色、文本、表格） |
+| `r:` | `http://schemas.openxmlformats.org/officeDocument/2006/relationships` | 关系 ID 引用（embed/link） |
+| `c:` | `http://schemas.openxmlformats.org/drawingml/2006/chart` | 图表数据 |
+| `dgm:` | `http://schemas.openxmlformats.org/drawingml/2006/diagram` | SmartArt / 关系图 |
+| `v:` | `urn:schemas-microsoft-com:vml` | 旧版 VML（极少数兼容场景） |
+
+---
+
+## 二、PPTX 包结构（解析入口）
+
+```
+[pptx]
+├── [Content_Types].xml          ← MIME 类型注册表
+├── _rels/.rels                  ← 包级关系
+├── ppt/
+│   ├── presentation.xml          ← p:presentation（根节点）
+│   ├── _rels/presentation.xml.rels
+│   ├── slides/
+│   │   ├── slide{N}.xml         ← p:sld（每页幻灯片）
+│   │   └── _rels/slide{N}.xml.rels
+│   ├── slideMasters/
+│   │   └── slideMaster{N}.xml   ← 母版定义
+│   ├── slideLayouts/
+│   │   └── slideLayout{N}.xml   ← 版式定义
+│   ├── theme/
+│   │   └── theme{N}.xml         ← a:theme（配色/字体/效果矩阵）
+│   ├── notesSlides/
+│   │   └── notesSlide{N}.xml    ← 演讲者备注
+│   ├── tables/                  ← 表格样式（若有）
+│   └── media/
+│       └── image{N}.{ext}       ← 图片/音频/视频资源
+```
+
+### 关键文件说明
+
+| 文件 | 解析优先级 | 作用 |
+|---|---|---|
+| `[Content_Types].xml` | ⭐⭐⭐ | 所有部件的 MIME 类型注册，解析入口 |
+| `_rels/.rels` | ⭐⭐⭐ | 包级关系，定位 presentation.xml |
+| `presentation.xml` | ⭐⭐⭐ | 幻灯片顺序、页面尺寸、默认样式 |
+| `slide{N}.xml` | ⭐⭐⭐ | 每页具体内容（形状/文本/图片/表格） |
+| `slideMaster{N}.xml` | ⭐⭐ | 母版占位符、默认样式继承 |
+| `slideLayout{N}.xml` | ⭐⭐ | 版式细节，继承母版 |
+| `theme{N}.xml` | ⭐⭐⭐ | 配色方案（clrScheme）、字体方案（fontScheme）、效果方案（fmtScheme） |
+| `notesSlide{N}.xml` | ⭐ | 演讲者备注文本 |
+
+---
+
+## 三、幻灯片 XML 结构（p:sld → p:spTree）
+
+### 3.1 幻灯片整体结构
+
+```xml
+<p:sld>
+  <p:cSld>                    <!-- Common Slide Data -->
+    <p:spTree>                <!-- 形状树（最重要） -->
+      <p:nvGrpSpPr/>           <!-- 组形状非可视属性 -->
+      <p:grpSpPr/>             <!-- 组形状变换 -->
+      <p:sp>      ... </p:sp>  <!-- 形状/文本框/占位符 -->
+      <p:pic>    ... </p:pic>  <!-- 图片 -->
+      <p:graphicFrame> ...     <!-- 表格/图表/OLE 对象 -->
+      <p:cxnSp>  ... </p:cxnSp><!-- 连接符（箭头线） -->
+      <p:grpSp>  ... </p:grpSp><!-- 组合形状（递归） -->
+    </p:spTree>
+  </p:cSld>
+  <p:clrMapOvr/>               <!-- 可选：覆盖主题配色 -->
+  <p:timing/>                 <!-- 动画（通常跳过） -->
+</p:sld>
+```
+
+### 3.2 `<p:sp>`（形状）三大子元素
+
+| 子元素 | 标签路径 | 解析重点 |
+|---|---|---|
+| 非可视属性 | `<p:nvSpPr>` → `<p:cNvPr id name/>` `<p:nvPr ph=""/>` | id / 名称 / 是否为标题/正文占位符 |
+| **可视属性** | `<p:spPr>` | ⭐ 几何 / 位置 / 填充 / 线条 / 效果 / 变换 |
+| 文本体 | `<p:txBody>` | ⭐ 段落 / 运行 / 字体 / 文字颜色 |
+
+### 3.3 `<p:pic>`（图片）
+
+```xml
+<p:pic>
+  <p:nvPicPr>
+    <p:cNvPr id="4" name="Picture 3"/>
+    <p:nvPr/>
+  </p:nvPicPr>
+  <p:blipFill>
+    <a:blip r:embed="rId2"/>   <!-- 查 _rels/slideN.xml.rels 得 media/xxx.png -->
+    <a:srcRect l="10000" t="10000" r="10000" b="10000"/>  <!-- 裁剪（万分之一） -->
+    <a:stretch/>               <!-- 拉伸模式 -->
+  </p:blipFill>
+  <p:spPr>                     <!-- 位置/尺寸 -->
+    <a:xfrm>
+      <a:off x="3657600" y="2743200"/>
+      <a:ext cx="5486400" cy="3657600"/>
+    </a:xfrm>
+  </p:spPr>
+</p:pic>
+```
+
+### 3.4 `<p:graphicFrame>`（表格/图表）
+
+```xml
+<p:graphicFrame>
+  <p:nvGraphicFramePr>...</p:nvGraphicFramePr>
+  <p:xfrm>...</p:xfrm>
+  <a:graphic>
+    <a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/table">
+      <a:tbl> ... </a:tbl>     <!-- 表格内容 -->
+    </a:graphicData>
+  </a:graphic>
+</p:graphicFrame>
+```
+
+---
+
+## 四、`<p:spPr>` —— 填充 / 线条 / 几何 / 变换（DrawingML a:）
+
+### 4.1 变换与几何
+
+| 标签 | 属性/子元素 | 说明 |
+|---|---|---|
+| `<a:xfrm rot="..." flipH/V="1">` | `<a:off x="..." y="..."/>` | 旋转（1° = 60000 EMU）、翻转、位置 |
+| | `<a:ext cx="..." cy="..."/>` | 尺寸（EMU） |
+| `<a:prstGeom prst="rect">` | `<a:avLst/>` | 预设几何：rect（矩形）、ellipse（椭圆）、roundRect（圆角矩形）、triangle（三角形）、arrow（箭头）等 |
+| `<a:custGeom>` | `<a:pathLst><a:path>` | 自定义贝塞尔路径 |
+
+### 4.2 填充类型（互斥，取第一个有效）
+
+| 标签 | 子颜色节点 | 说明 |
+|---|---|---|
+| `<a:noFill/>` | — | 无填充 / 透明 |
+| `<a:solidFill>` | `<a:srgbClr val="RRGGBB"/>` 或 `<a:schemeClr val="accent1"/>` | ⭐ 纯色填充 |
+| `<a:gradFill>` | `<a:gsLst><a:gs pos="50000"><a:srgbClr/></a:gs></a:gsLst>` `<a:lin ang="5400000"/>` | 线性/径向渐变（pos 单位万分之一，ang 单位 1°=60000） |
+| `<a:blipFill>` | `<a:blip r:embed="rIdX"/>` | 图片填充（查 rels 得图片路径） |
+| `<a:pattFill>` | `<a:fgClr>` + `<a:bgClr>` | 图案填充 |
+| `<a:grpFill/>` | — | 继承组合填充 |
+
+### 4.3 线条（轮廓）`<a:ln w="EMU">`
+
+| 子元素 | 说明 |
+|---|---|
+| `<a:noFill/>`（在 ln 内）| 无边框 |
+| `<a:solidFill>` / `<a:gradFill>` | 线颜色（同填充规则） |
+| `<a:prstDash val="solid\|dot\|dash\|lgDash\|dashDot"/>` | 虚线样式 |
+| `<a:round/>` `<a:miter/>` `<a:bevel/>` | 转角样式 |
+| `<a:cap val="flat\|round\|square"/>` | 线端样式 |
+| `<a:cmpd val="sng\|dbl\|thickThin"/>` | 复合线（单线/双线/粗细变化） |
+| `<a:headEnd type="arrow" w="med" len="med"/>` | 线头箭头 |
+| `<a:tailEnd type="arrow" w="med" len="med"/>` | 线尾箭头 |
+
+> ⚠️ 若 `<a:ln>` 不存在但 `<p:style><a:lnRef idx="N"/>` 存在 → 查 `theme1.xml → a:lnStyleLst[idx-1]` 取默认线型/颜色
+
+### 4.4 效果
+
+| 标签 | 子元素 | 说明 |
+|---|---|---|
+| `<a:effectLst>` | 容器 | 效果列表 |
+| `<a:outerShdw>` | `<a:srgbClr>` + `blurRad` + `dist` + `dir` | 外阴影 |
+| `<a:innerShdw>` | 同上 | 内阴影 |
+| `<a:glow>` | `<a:srgbClr>` + `rad` | 发光效果 |
+| `<a:reflection>` | `blurRad` + `stDist` + `endPos` + `fadeDir` | 反射效果 |
+
+---
+
+## 五、颜色模型（DrawingML a: 颜色系统 —— 解析关键）
+
+PPT 颜色可能是直接 RGB 或**主题配色引用 + 变换**：
+
+### 5.1 颜色节点类型
+
+| 标签 | 含义 | 查主题位置 |
+|---|---|---|
+| `<a:srgbClr val="FF5733"/>` | 直接 RGB（不含 `#`）| — |
+| `<a:schemeClr val="accent1\|accent2\|...\|tx1\|bg1\|dk1\|lt1"/>` | 引用主题配色 | `a:theme/a:themeElements/a:clrScheme/` |
+| `<a:sysClr val="window\|windowText" lastClr="RRGGBB"/>` | 系统颜色（极少用）| — |
+| `<a:hslClr hue="..." sat="..." lum="..."/>` | HSL 颜色 | — |
+| `<a:prstClr val="black\|white\|red"/>` | 预设颜色名 | — |
+
+### 5.2 颜色变换（子节点）
+
+| 标签 | 含义 | 示例 |
+|---|---|---|
+| `<a:lumMod val="50000"/>` | 亮度调制（×50%）| 作用于 schemeClr |
+| `<a:lumOff val="20000"/>` | 亮度偏移（+20%）| — |
+| `<a:shade val="50000"/>` | 暗化（×50%）| — |
+| `<a:tint val="80000"/>` | 减淡（×80%）| — |
+| `<a:alpha val="50000"/>` | 透明度（50000 = 50% 不透明）| — |
+| `<a:satMod val="130000"/>` | 饱和度调制（×130%）| — |
+| `<a:hueMod val="60000"/>` | 色相调制 | — |
+
+### 5.3 主题配色方案（theme1.xml 中）
+
+```xml
+<a:clrScheme name="Office">
+  <a:dk1><a:sysClr val="window" lastClr="FFFFFF"/></a:dk1>    <!-- 深色1 / 背景1 -->
+  <a:lt1><a:sysClr val="windowText" lastClr="000000"/></a:lt1><!-- 浅色1 / 文字1 -->
+  <a:dk2><a:srgbClr val="1F4E79"/></a:dk2>                   <!-- 深色2 -->
+  <a:lt2><a:srgbClr val="D6E4F0"/></a:lt2>                   <!-- 浅色2 -->
+  <a:accent1><a:srgbClr val="4472C4"/></a:accent1>            <!-- 强调色1~6 -->
+  <a:accent2><a:srgbClr val="ED7D31"/></a:accent2>
+  <a:accent3><a:srgbClr val="A5A5A5"/></a:accent3>
+  <a:accent4><a:srgbClr val="FFC000"/></a:accent4>
+  <a:accent5><a:srgbClr val="5B9BD5"/></a:accent5>
+  <a:accent6><a:srgbClr val="70AD47"/></a:accent6>
+  <a:hlink><a:srgbClr val="0563C1"/></a:hlink>                <!-- 超链接 -->
+  <a:folHlink><a:srgbClr val="954F72"/></a:folHlink>           <!-- 已访问链接 -->
+</a:clrScheme>
+```
+
+### 5.4 颜色解析算法（伪代码）
+
+```
+function resolveColor(node):
+  if node has a:srgbClr:
+    color = srgbClr.val
+  else if node has a:schemeClr:
+    schemeName = schemeClr.val
+    color = theme.clrScheme[schemeName].srgbClr.val
+  else:
+    return FALLBACK_COLOR
+
+  // 应用变换链
+  for child in node.children:
+    if child is a:lumMod: color = applyLuminanceMod(color, child.val)
+    if child is a:lumOff: color = applyLuminanceOffset(color, child.val)
+    if child is a:shade:  color = applyShade(color, child.val)
+    if child is a:tint:   color = applyTint(color, child.val)
+    if child is a:alpha:  alpha = child.val
+
+  return { rgb: color, alpha: alpha }
+```
+
+### 5.5 单位速记
+
+| 单位 | 换算 |
+|---|---|
+| 1 英寸 | 914,400 EMU |
+| 1 厘米 | 360,000 EMU |
+| 1 磅 (pt) | 12,700 EMU |
+| 1°（角度）| 60,000（用于 rot / ang 属性） |
+| 百分比 | 50,000 = 50%（万分之一为单位） |
+
+---
+
+## 六、文本（`<p:txBody>` —— DrawingML a:）
+
+### 6.1 文本整体结构
+
+```xml
+<p:txBody>
+  <a:bodyPr anchor="t|c|b" wrap="square" vert="horz"/>
+  <a:lstStyle/>                          <!-- 列表级别样式引用 -->
+  <a:p>                                  <!-- 段落 -->
+    <a:pPr lvl="0" algn="l|c|r|j">
+      <a:buFont typeface="..."/>
+      <a:buChar char="•"/>
+      <a:spcBef val="..."/>             <!-- 段前距 (EMU) -->
+      <a:spcAft val="..."/>             <!-- 段后距 (EMU) -->
+      <a:lnSpc val="..."/>              <!-- 行距 (EMU) -->
+    </a:pPr>
+    <a:r>                                <!-- 文本运行 (Run) -->
+      <a:rPr lang="zh-CN" sz="1800" b="1" i="1" u="sng">
+        <a:solidFill>
+          <a:srgbClr val="333333"/>
+        </a:solidFill>
+      </a:rPr>
+      <a:t>实际文字内容</a:t>
+    </a:r>
+    <a:br/>                              <!-- 软换行 -->
+  </a:p>
+</p:txBody>
+```
+
+### 6.2 运行属性（`<a:rPr>`）
+
+| 属性 | 说明 | 值示例 |
+|---|---|---|
+| `lang` | 语言 | `zh-CN` / `en-US` |
+| `sz` | 字号（百分之一磅）| 1800 = 18pt |
+| `b="1"` | 粗体 | 0/1 |
+| `i="1"` | 斜体 | 0/1 |
+| `u="sng\|dbl\|none"` | 下划线 | sng=单线 |
+| `strike="sng\|dbl\|noStrike"` | 删除线 | — |
+| `caps="all\|small"` | 大小写 | all=全大写 |
+| `spc="200"` | 字符间距（EMU）| 正数=加宽，负数=紧缩 |
+
+### 6.3 文字颜色
+
+文字颜色同第五节规则，位于 `<a:rPr>` 内：
+
+```xml
+<a:rPr sz="1800" b="1">
+  <a:solidFill>
+    <a:srgbClr val="FF0000"/>           <!-- 直接 RGB -->
+  </a:solidFill>
+</a:rPr>
+
+<a:rPr sz="1400">
+  <a:solidFill>
+    <a:schemeClr val="accent1">         <!-- 主题配色引用 -->
+      <a:lumMod val="50000"/>
+    </a:schemeClr>
+  </a:solidFill>
+</a:rPr>
+```
+
+> 若无 `<a:rPr>` 中颜色 → 继承段落 `<a:pPr>` → 占位符 → 主题默认文字色
+
+### 6.4 段落属性（`<a:pPr>`）
+
+| 属性/子元素 | 说明 |
+|---|---|
+| `algn="l\|c\|r\|j"` | 对齐：左/中/右/两端对齐 |
+| `lvl="0"` | 列表层级（0~8）|
+| `marL` / `marR` | 左右缩进 (EMU) |
+| `indent` | 首行缩进 (EMU) |
+| `spcBef` / `spcAft` | 段前/段后距 (EMU) |
+| `lnSpc` | 行距 (EMU) |
+| `<a:buChar char="•"/>` | 项目符号字符 |
+| `<a:buFont typeface="..."/>` | 项目符号字体 |
+| `<a:buNone/>` | 无项目符号 |
+
+---
+
+## 七、表格（`<a:tbl>` in `<p:graphicFrame>`）
+
+### 7.1 表格结构
+
+```xml
+<a:tbl>
+  <a:tblPr firstRow="1" bandRow="1" bandCol="0">
+    <a:tableStyleId>{GUID}</a:tableStyleId>
+  </a:tblPr>
+  <a:tblGrid>
+    <a:gridCol w="3048000"/>   <!-- 列宽 (EMU) -->
+    <a:gridCol w="3048000"/>
+  </a:tblGrid>
+  <a:tr h="568000">           <!-- 行高 (EMU) -->
+    <a:tc>                     <!-- 单元格 -->
+      <a:txBody>... </a:txBody> <!-- 同第六节文本 -->
+      <a:tcPr rowSpan="2" colSpan="1">
+        <a:fill>               <!-- 单元格填充 -->
+          <a:solidFill>
+            <a:srgbClr val="D6E4F0"/>
+          </a:solidFill>
+        </a:fill>
+      </a:tcPr>
+    </a:tc>
+  </a:tr>
+</a:tbl>
+```
+
+### 7.2 表格属性说明
+
+| 元素/属性 | 说明 |
+|---|---|
+| `<a:tblPr firstRow="1">` | 是否应用首行样式（斑马纹） |
+| `<a:tblPr bandRow="1">` | 是否应用隔行样式 |
+| `<a:tblPr bandCol="1">` | 是否应用隔列样式 |
+| `<a:tableStyleId>` | 表格样式 GUID，查 `ppt/tableStyles.xml` |
+| `<a:tcPr rowSpan / colSpan>` | 单元格合并 |
+| `<a:tcPr horzOverflow="clip\|overflow"` | 水平溢出处理 |
+| `<a:tcPr anchor="t\|c\|b"` | 垂直对齐 |
+
+---
+
+## 八、主题继承解析顺序（最重要！）
+
+当 `<p:spPr>` 中某属性（fill / ln / 字体）**缺失时**，按此优先级解析：
+
+```
+spPr 显式值（最高优先级）
+  ↓（无）
+p:style → fillRef/lnRef/fontRef idx → theme1.xml fillStyleLst/lnStyleLst/fontScheme
+  ↓（无）
+slideLayout → 对应 placeholder 样式
+  ↓（无）
+slideMaster → 对应 placeholder 样式
+  ↓（无）
+presentation.xml → p:defaultTextStyle / p:defaultMasterStyle
+```
+
+### 8.1 继承链详细展开
+
+#### 第一层：spPr 显式值
+```xml
+<p:sp>
+  <p:spPr>
+    <a:solidFill><a:srgbClr val="FF0000"/></a:solidFill>  <!-- 显式红色填充 -->
+  </p:spPr>
+</p:sp>
+```
+→ 直接使用，不查继承链。
+
+#### 第二层：p:style → theme 引用
+```xml
+<p:sp>
+  <p:style>
+    <a:fillRef idx="2"/>   <!-- 查 theme1.xml → a:fillStyleLst[1] -->
+    <a:lnRef idx="1"/>     <!-- 查 theme1.xml → a:lnStyleLst[0] -->
+    <a:fontRef idx="1"/>   <!-- 查 theme1.xml → a:fontScheme/a:majorFont -->
+  </p:style>
+</p:sp>
+```
+
+theme1.xml 中：
+```xml
+<a:fmtScheme name="Office">
+  <a:fillStyleLst>
+    <a:solidFill><a:schemeClr val="bg1"/></a:solidFill>    <!-- idx=1 -->
+    <a:solidFill><a:schemeClr val="accent1"/></a:solidFill> <!-- idx=2 -->
+  </a:fillStyleLst>
+  <a:lnStyleLst>
+    <a:ln w="12700">...</a:ln>  <!-- idx=1 -->
+  </a:lnStyleLst>
+</a:fmtScheme>
+```
+
+#### 第三层：slideLayout 占位符样式
+```xml
+<!-- slideLayout1.xml -->
+<p:sp ph="ctrTitle">
+  <p:spPr>
+    <a:solidFill><a:schemeClr val="tx1"/></a:solidFill>
+  </p:spPr>
+</p:sp>
+```
+
+#### 第四层：slideMaster 占位符样式
+```xml
+<!-- slideMaster1.xml -->
+<p:sp ph="ctrTitle">
+  <p:spPr>
+    <a:solidFill><a:schemeClr val="dk1"/></a:solidFill>
+  </p:spPr>
+</p:sp>
+```
+
+#### 第五层：presentation.xml 默认值
+```xml
+<!-- presentation.xml -->
+<p:defaultTextStyle>
+  <a:defPPr>
+    <a:defRPr sz="1800" b="0">
+      <a:solidFill><a:schemeClr val="tx1"/></a:solidFill>
+    </a:defRPr>
+  </a:defPPr>
+</p:defaultTextStyle>
+```
+
+### 8.2 继承解析算法（伪代码）
+
+```
+function resolveProperty(shape, propertyName):
+  // Layer 1: 显式 spPr
+  if shape.spPr has propertyName:
+    return shape.spPr[propertyName]
+
+  // Layer 2: style → theme
+  if shape.style has reference for propertyName:
+    idx = shape.style[propertyName + "Ref"].idx
+    return theme.fmtScheme[propertyName + "StyleLst"][idx - 1]
+
+  // Layer 3: slideLayout placeholder
+  layoutShape = findMatchingPlaceholder(shape, slideLayout)
+  if layoutShape and layoutShape.spPr has propertyName:
+    return layoutShape.spPr[propertyName]
+
+  // Layer 4: slideMaster placeholder
+  masterShape = findMatchingPlaceholder(shape, slideMaster)
+  if masterShape and masterShape.spPr has propertyName:
+    return masterShape.spPr[propertyName]
+
+  // Layer 5: presentation default
+  return presentation.defaultStyle[propertyName]
+```
+
+### 8.3 占位符匹配规则
+
+占位符通过 `ph` 属性匹配：
+
+| ph 值 | 含义 |
+|---|---|
+| `ctrTitle` | 中心标题 |
+| `subTitle` | 副标题 |
+| `body` | 正文 |
+| `sldNum` | 幻灯片编号 |
+| `ftr` | 页脚 |
+| `hdr` | 页眉 |
+| `dt` | 日期 |
+| `obj` | 对象 |
+| `chart` | 图表 |
+| `tbl` | 表格 |
+
+---
+
+## 附录：权威参考文档
+
+| 资源 | 链接 |
+|---|---|
+| ISO/IEC 29500-1:2016 (ECMA-376 Part 1) | §19 PresentationML / §20 DrawingML |
+| Open XML SDK 文档 | https://learn.microsoft.com/en-us/dotnet/api/documentformat.openxml.presentation |
+| OOXML 社区参考 | http://officeopenxml.com/prPresentation.php |
+| W3ID OOXML 在线附录 | https://w3id.org/ooxml/onlineInfomativeAnnexes/ |
+| DrawingML 颜色说明 | http://officeopenxml.com/drwSp-styles.php |
+| LibreOffice OOXML 实现参考 | https://wiki.documentfoundation.org/Development/ODF/OOXML |
+
+---
+
+## 解析器建议实现顺序
+
+1. **解压 ZIP** → 读 `[Content_Types].xml` + `_rels/.rels`
+2. **解析 `presentation.xml`** → 建立幻灯片 ID ↔ rId ↔ 文件路径映射表
+3. **解析 `theme/theme1.xml`** → 缓存 `clrScheme` / `fontScheme` / `fmtScheme`（fill/ln 样式列表）
+4. **逐页解析 `slideN.xml`** → `spTree` 递归遍历 `sp` / `pic` / `graphicFrame` / `grpSp`
+5. **对每个元素解析可视属性**：
+   - 先取 `spPr` 显式值
+   - 缺失则查 `style → theme` 继承链（第四节 + 第八节）
+6. **颜色解析**：先 `srgbClr`，再 `schemeClr + theme.clrScheme + transform` 子节点（第五节）
+7. **文本解析**：遍历 `txBody → p → r → rPr/t`（第六节）
+8. **表格解析**：`graphicFrame → tbl → tr → tc`（第七节）
+
+---
+
+> 📌 **提示**：以上覆盖 PPTX 解析 95% 以上场景。动画（`<p:timing>`）、音频/视频、OLE 嵌入、数字签名等属于低频特性，可按需扩展。