dsh-ppt-studio 1.1.0

package/lib/pptd/export-pptx.js

@@ -0,0 +1,686 @@
+/**
+ * PPTD → PPTX 导出器（主引擎）：生成最小可打开的 OOXML。
+ * - 元素：text / shape(rect,ellipse,triangle) / line(箭头) / image / table
+ *   / chart（矢量拼绘：bar=矩形、line=连接线+圆点、pie=饼形）
+ * - 文本自动 fit：与 verify 同一度量与阈值（overflow > 1px 才缩），按比例缩字号；
+ *   下限语义（2026-09-06 用户拍板）：theme.minFontSize 显式 = 用户给出的字号下限（严格遵守，且不超过原字号）；
+ *   未设置 = 无强制下限（仅 60% 原字号防荒谬保底），绝不升字；到下限仍溢出记 floorHit。
+ *   验证通过 ⇒ 导出不缩字（反馈 E2：双度量差已对齐）。
+ * - 1px = 1pt；EMU = pt × 12700。
+ * - 讲稿（2026-09-14 新增）：页面 `notes:` 文本 → 标准 pptx 备注页（notesSlide + notesMaster）。
+ *   无 `notes:` 的工程**不产出任何备注部件**（产物与旧实现一致 ⇒ 老工程零变化）；parity 里 notesExp/notesOut 自证。
+ */
+import { writeFile, readFile } from 'node:fs/promises'
+import { join, isAbsolute } from 'node:path'
+import { zipWrite } from '../zips.js'
+import { normalizePage } from './layout.js'
+import { chartData, chartColors, chartIssue } from './svgCharts.js'
+
+const EMU = 12700
+const xm = (s) => String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;')
+const emu = (v) => Math.round(v * EMU)
+const hex = (c) => (c ?? '#000000').replace('#', '').toUpperCase().slice(0, 6).padEnd(6, '0')
+
+let UID = 1
+const nid = () => UID++
+
+// A2 修复（反馈二）：缺失媒体兜底——1×1 白色 PNG（页面引用但 media/ 无文件时不再 ENOENT 硬失败）
+const TINY_PNG = Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==', 'base64')
+
+export async function exportPptx(ctx, { out = 'out.pptx', engine = 'pptd' } = {}) {
+  const report = { autoFit: [], warnings: [], chartInfos: [] }
+  const slides = []
+  // 连线自证（2026-09-14 真实反馈：预览对、PowerPoint 里线条镜像/×掉一条）：
+  // straightConnector1 在 OOXML 里**只按包围盒的左上→右下**绘制，方向必须靠 flipH/flipV 表达；
+  // 漏写 → 反向斜率/镜像（cross1×cross2 会重合成一条线）。这里逐条从写出的 XML 反推端点自证。
+  const lineProof = { exp: 0, out: 0, wrong: [] }
+  UID = 1000
+
+  for (const page of ctx.pages) {
+    const els = normalizePage(page, ctx)
+    const shapes = []
+    const media = []
+    const mediaSeen = new Map()
+    const counts = { table: 0, image: 0, chart: 0 }
+    const addMedia = (srcPath) => {
+      if (mediaSeen.has(srcPath)) return mediaSeen.get(srcPath)
+      const rId = `rId${media.length + 2}`
+      mediaSeen.set(srcPath, rId)
+      media.push({ srcPath, rId })
+      return rId
+    }
+
+    for (const el of els) {
+      switch (el.type) {
+        case 'text': shapes.push(textSp(el, report, ctx.minFontSize)); break
+        case 'shape': shapes.push(shapeSp(el)); break
+        case 'line': {
+          lineProof.exp++
+          shapes.push(connectorSp(el, lineProof))
+          break
+        }
+        case 'image': {
+          counts.image++
+          const rId = addMedia(el.src)
+          shapes.push(picSp(el, rId))
+          break
+        }
+        case 'table': counts.table++; shapes.push(tableFrame(el)); break
+        case 'chart': {
+          counts.chart++
+          const issue = chartIssue(el.chart)
+          if (issue) report.chartInfos.push(`第 ${page.index + 1} 页（${page.name}）${el.id}: ${issue}`)
+          shapes.push(...chartSp(el))
+          break
+        }
+      }
+    }
+
+    // 页面背景（原生 p:bg：solid 或 image，背景图进入本页 media 列表）
+    const bg = resolveBg(page.page.background, ctx)
+    if (bg?.kind === 'image') {
+      bg.rId = addMedia(bg.src)
+      bg.xml = bg.xml.replace('BGPLACEHOLDER', bg.rId)
+    }
+
+    slides.push({
+      page,
+      shapes,
+      media,
+      counts,
+      // 讲稿：只有非空字符串才产备注页（空/未写 = 与旧行为完全一致，不生成部件）
+      notes: typeof page.page.notes === 'string' && page.page.notes.trim() ? page.page.notes.trim() : null,
+      notesNo: 0,
+      spTree: `<p:spTree>${spTreeHeader()}${shapes.join('')}</p:spTree>`,
+      bg,
+    })
+  }
+  // 备注页编号：只为有讲稿的页分配（notesSlide1..N；无讲稿的页没有关系，也没有部件）
+  let notesCount = 0
+  for (const s of slides) if (s.notes) s.notesNo = ++notesCount
+
+  const files = {}
+  files['[Content_Types].xml'] = contentTypes(slides)
+  files['_rels/.rels'] = rootRels()
+  files['docProps/core.xml'] = coreProps(ctx)
+  files['docProps/app.xml'] = appProps(ctx)
+  files['ppt/presentation.xml'] = presentationXml(ctx, slides)
+  files['ppt/_rels/presentation.xml.rels'] = presentationRels(slides)
+  files['ppt/slideMasters/slideMaster1.xml'] = slideMasterXml()
+  files['ppt/slideMasters/_rels/slideMaster1.xml.rels'] = slideMasterRels()
+  files['ppt/slideLayouts/slideLayout1.xml'] = slideLayoutXml()
+  files['ppt/slideLayouts/_rels/slideLayout1.xml.rels'] = slideLayoutRels()
+  files['ppt/theme/theme1.xml'] = themeXml()
+  if (notesCount > 0) {
+    files['ppt/notesMasters/notesMaster1.xml'] = notesMasterXml()
+    files['ppt/notesMasters/_rels/notesMaster1.xml.rels'] = notesMasterRels()
+  }
+
+  for (let i = 0; i < slides.length; i++) {
+    const s = slides[i]
+    const n = i + 1
+    files[`ppt/slides/slide${n}.xml`] = slideXml(s)
+    // 备注页关系：rId 取媒体之后的下一个空闲号（媒体用 rId2..rId(1+media)）
+    const notesRel = s.notes ? `<Relationship Id="rId${s.media.length + 2}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesSlide" Target="../notesSlides/notesSlide${s.notesNo}.xml"/>` : ''
+    if (s.notes) {
+      files[`ppt/notesSlides/notesSlide${s.notesNo}.xml`] = notesSlideXml(s.notes)
+      // 关键：notesSlide **必须自带 rels**（→ notesMaster + 回指本页幻灯）。
+      // 2026-09-14 实测：缺这个 rels 时 python-pptx 能读，**PowerPoint 直接报"文件或目录损坏"**——
+      // 参照 python-pptx 默认模板（PowerPoint 原生产物）的结构：rId1=notesMaster、rId2=slide。
+      files[`ppt/notesSlides/_rels/notesSlide${s.notesNo}.xml.rels`] = '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">'
+        + '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesMaster" Target="../notesMasters/notesMaster1.xml"/>'
+        + `<Relationship Id="rId2" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide" Target="../slides/slide${n}.xml"/>`
+        + '</Relationships>'
+    }
+    const srels = [
+      '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>',
+      '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">',
+      '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout" Target="../slideLayouts/slideLayout1.xml"/>',
+      ...s.media.map((m) => `<Relationship Id="${m.rId}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/image" Target="../media/${m.srcPath.split(/[\\/]/).pop()}"/>`),
+      notesRel,
+      '</Relationships>',
+    ].join('')
+    files[`ppt/slides/_rels/slide${n}.xml.rels`] = srels
+    for (const m of s.media) {
+      const bn = m.srcPath.split(/[\\/]/).pop()
+      try {
+        files[`ppt/media/${bn}`] = await readFile(join(ctx.dir, m.srcPath))
+      } catch {
+        report.mediaPlaceholders = report.mediaPlaceholders ?? []
+        report.mediaPlaceholders.push(bn)
+        files[`ppt/media/${bn}`] = TINY_PNG
+      }
+    }
+  }
+
+  // P1 防线（测试反馈 ★）：导出产物 parity 回读——
+  // layout 元素计数 == OOXML 计数 + 结构不变量（graphicFrame 无嵌套 a:xfrm = PowerPoint 弃帧根源）
+  let tablesExp = 0, tablesOut = 0, imagesExp = 0, imagesOut = 0, illegal = 0
+  for (let i = 0; i < slides.length; i++) {
+    const s = slides[i]
+    tablesExp += s.counts.table
+    imagesExp += s.counts.image
+    const xml = files[`ppt/slides/slide${i + 1}.xml`]
+    const txt = typeof xml === 'string' ? xml : String(xml)
+    tablesOut += (txt.match(/graphicData uri="http:\/\/schemas\.openxmlformats\.org\/drawingml\/2006\/table"/g) ?? []).length
+    imagesOut += (txt.match(/<p:pic>/g) ?? []).length
+    if (txt.includes('<p:xfrm><a:xfrm>')) illegal++
+  }
+  // 备注 parity：页里有 notes 的页数 == 包里的 notesSlide 部件数；且每张 notesSlide 都被对应幻灯 rels 引用
+  const notesExp = slides.filter((s) => s.notes).length
+  const notesParts = Object.keys(files).filter((k) => /^ppt\/notesSlides\/notesSlide\d+\.xml$/.test(k))
+  const notesOut = notesParts.length
+  const notesRelOk = slides.filter((s) => s.notes).every((s) => String(files[`ppt/slides/_rels/slide${slides.indexOf(s) + 1}.xml.rels`]).includes(`notesSlide${s.notesNo}.xml`))
+  report.parity = {
+    tablesExp, tablesOut, imagesExp, imagesOut, illegalFrames: illegal,
+    linesExp: lineProof.exp, linesOut: lineProof.out, linesWrong: lineProof.wrong.length,
+    notesExp, notesOut,
+    ok: tablesExp === tablesOut && imagesExp === imagesOut && illegal === 0 &&
+      lineProof.exp === lineProof.out && lineProof.wrong.length === 0 &&
+      notesExp === notesOut && notesRelOk,
+  }
+
+  // out：绝对路径原样使用；相对路径相对 deck 目录（反馈 E1 ★）
+  const outPath = isAbsolute(out) ? out : join(ctx.dir, out)
+  await writeFile(outPath, zipWrite(files))
+  report.file = outPath
+  report.slides = slides.length
+  report.engine = engine
+  return report
+}
+
+function spTreeHeader() {
+  return '<p:nvGrpSpPr><p:cNvPr id="1" name=""/><p:cNvGrpSpPr/><p:nvPr/></p:nvGrpSpPr><p:grpSpPr><a:xfrm><a:off x="0" y="0"/><a:ext cx="0" cy="0"/><a:chOff x="0" y="0"/><a:chExt cx="0" cy="0"/></a:xfrm></p:grpSpPr>'
+}
+
+function xfrm(x, y, w, h, rot = 0, flips = '') {
+  const r = rot ? ` rot="${Math.round(rot * 60000)}"` : ''
+  return '<a:xfrm' + flips + r + '><a:off x="' + emu(x) + '" y="' + emu(y) + '"/><a:ext cx="' + emu(w) + '" cy="' + emu(h) + '"/></a:xfrm>'
+}
+
+/**
+ * 描边属性。`arrow` 的 `<a:tailEnd>` **必须写在 `<a:ln>` 内部**（2026-09-14 修复）——
+ * 旧实现把它拼在 `</a:ln>` 之后，PowerPoint 直接忽略 ⇒ 箭头全部消失（预览有、成品没有）。
+ * OOXML 子元素顺序：fill → prstDash → join → headEnd → tailEnd。
+ */
+function lineSpPr(line, arrow = false) {
+  const w = Math.round((line?.width ?? 1) * EMU)
+  const tail = arrow ? '<a:tailEnd type="triangle" w="med" len="med"/>' : ''
+  return '<a:ln w="' + w + '"><a:solidFill><a:srgbClr val="' + hex(line?.color ?? '#000000') + '"/></a:solidFill>' + tail + '</a:ln>'
+}
+
+// ── text ─────────────────────────────────────────────────────────────────
+const FIT_TOL = 1 // 与 verify 的 TOL 一致：verify 通过 ⇒ 导出不缩字（反馈 E2 ★★）
+
+function textSp(el, report, minFontSize) {
+  const s = el.style
+  const m = el.metrics
+  const id = nid()
+  const origSize = s.fontSize
+  let fontSize = origSize
+  const boxH = el.bounds.h
+  // 缩字下限语义（2026-09-06 修订，用户拍板）：下限 = 用户指令——
+  // ① 用户给出最小字号（theme.minFontSize 显式）→ 严格遵守（且不超过原字号，绝不升字）；
+  // ② 未给出 → 不设强制（仅防荒谬：60% 原字号保底、最低 6pt）；绝不高于原字号。
+  const floor = typeof minFontSize === 'number' && minFontSize > 0
+    ? Math.min(origSize, minFontSize)
+    : Math.max(6, Math.round(origSize * 0.6))
+  if (s.wrap !== false && m.overflowY > FIT_TOL) {
+    const fit = Math.max(1, Math.floor(fontSize * Math.min(0.95, (boxH / Math.max(1, m.textH)) * 0.95)))
+    if (fit < fontSize) {
+      const floorHit = fit < floor
+      fontSize = floorHit ? floor : fit
+      report.autoFit.push({ id: el.id, from: origSize, to: fontSize, floorHit })
+    }
+  }
+  const rPr =
+    '<a:rPr lang="zh-CN" sz="' + Math.round(fontSize * 100) + '"' + (s.bold ? ' b="1"' : '') + (s.italic ? ' i="1"' : '') +
+    '><a:solidFill><a:srgbClr val="' + hex(s.color ?? '#000000') + '"/></a:solidFill>' +
+    (s.fontFamily ? '<a:latin typeface="' + xm(s.fontFamily) + '"/><a:ea typeface="' + xm(s.fontFamily) + '"/>' : '') +
+    '</a:rPr>'
+  const body = String(el.content?.text ?? '').split(/\n/).map((line) => {
+    return '<a:p><a:pPr algn="' + alignOf(s.align) + '" lvl="0"/><a:r>' + rPr + '<a:t>' + xm(line) + '</a:t></a:r></a:p>'
+  }).join('')
+  const bodyPr = s.wrap === false
+    ? '<a:bodyPr wrap="none" lIns="0" rIns="0" tIns="0" bIns="0"/>'
+    : '<a:bodyPr wrap="square" lIns="0" rIns="0" tIns="0" bIns="0"/>'
+  const sp = '<p:sp><p:nvSpPr><p:cNvPr id="' + id + '" name="' + xm(el.id) + '"/><p:cNvSpPr txBox="1"/><p:nvPr/></p:nvSpPr>'
+  return sp + '<p:spPr>' + xfrm(el.bounds.x, el.bounds.y, el.bounds.w, el.bounds.h) + '<a:prstGeom prst="rect"><a:avLst/></a:prstGeom></p:spPr>'
+    + '<p:txBody>' + bodyPr + '<a:lstStyle/>' + body + '</p:txBody></p:sp>'
+}
+
+function alignOf(a) { return a === 'right' ? 'r' : a === 'center' ? 'ctr' : 'l' }
+
+// ── shapes ────────────────────────────────────────────────────────────────
+function shapeSp(el) {
+  const id = nid()
+  // v0.9.1：kind 直通 OOXML prst（白名单 = schema SHAPE_KINDS）；v0.11 候选 C：custGeom → custGeom 元素（几何零损失）
+  if (el.kind === 'custGeom') {
+    const fill = fillSpPr(el.fill)
+    const ln = el.line ? lineSpPr(el.line) : '<a:ln><a:noFill/></a:ln>'
+    return '<p:sp><p:nvSpPr><p:cNvPr id="' + id + '" name="' + xm(el.id) + '"/><p:cNvSpPr/><p:nvPr/></p:nvSpPr>'
+      + '<p:spPr>' + xfrm(el.bounds.x, el.bounds.y, el.bounds.w, el.bounds.h, el.rotation ?? 0)
+      + custGeomXml(el.path) + fill + ln + '</p:spPr>'
+      + '<p:txBody><a:bodyPr rtlCol="0" anchor="ctr"/><a:lstStyle/><a:p/></p:txBody></p:sp>'
+  }
+  const prst = el.kind && /^[A-Za-z]+$/.test(el.kind) ? el.kind : 'rect'
+  const avLst = el.kind === 'roundRect' ? '<a:avLst><a:gd name="adj" fmla="val 8000"/></a:avLst>'
+    : el.kind === 'chevron' ? '<a:avLst><a:gd name="adj" fmla="val 25000"/></a:avLst>'
+      : el.kind === 'parallelogram' ? '<a:avLst><a:gd name="adj" fmla="val 25000"/></a:avLst>'
+        : '<a:avLst/>'
+  const fill = fillSpPr(el.fill)
+  const ln = el.line ? lineSpPr(el.line) : '<a:ln><a:noFill/></a:ln>'
+  return '<p:sp><p:nvSpPr><p:cNvPr id="' + id + '" name="' + xm(el.id) + '"/><p:cNvSpPr/><p:nvPr/></p:nvSpPr>'
+    + '<p:spPr>' + xfrm(el.bounds.x, el.bounds.y, el.bounds.w, el.bounds.h, el.rotation ?? 0)
+    + '<a:prstGeom prst="' + prst + '">' + avLst + '</a:prstGeom>' + fill + ln + '</p:spPr>'
+    + '<p:txBody><a:bodyPr rtlCol="0" anchor="ctr"/><a:lstStyle/><a:p/></p:txBody></p:sp>'
+}
+
+/** v0.11 候选 C：PPTD path → custGeom XML（命令直通，几何零损失）。 */
+function custGeomXml(path) {
+  const p = path ?? {}
+  const w = p.w ?? 100000
+  const h = p.h ?? 100000
+  const cmds = (p.commands ?? []).map((c) => {
+    if (c.cmd === 'close') return '<a:close/>'
+    if (c.cmd === 'arcTo') return '<a:arcTo wR="' + c.wR + '" hR="' + c.hR + '" stAng="' + c.stAng + '" swAng="' + c.swAng + '"/>'
+    const pts = (c.pts ?? []).map((pt) => '<a:pt x="' + pt[0] + '" y="' + pt[1] + '"/>').join('')
+    return '<a:' + c.cmd + '>' + pts + '</a:' + c.cmd + '>'
+  }).join('')
+  return '<a:custGeom><a:avLst/><a:gdLst/><a:ahLst/><a:cxnLst/><a:rect l="l" t="t" r="r" b="b"/>'
+    + '<a:pathLst><a:path w="' + w + '" h="' + h + '">' + cmds + '</a:path></a:pathLst></a:custGeom>'
+}
+
+/** fill：'#hex' | {color, alpha?} | {type: gradient, stops: [{pos, color, alpha?}], angle} → OOXML fill。 */
+function fillSpPr(fill) {
+  if (!fill) return '<a:noFill/>'
+  if (typeof fill === 'string') return '<a:solidFill>' + srgbClrXml(fill) + '</a:solidFill>'
+  if (fill.color) return '<a:solidFill>' + srgbClrXml(fill.color, fill.alpha) + '</a:solidFill>'
+  if (fill.type === 'gradient') {
+    const gs = (fill.stops ?? []).map((s) => {
+      const pos = Math.max(0, Math.min(100, Number(s.pos) || 0))
+      return '<a:gs pos="' + Math.round(pos * 1000) + '">' + srgbClrXml(s.color, s.alpha) + '</a:gs>'
+    }).join('')
+    if (!gs) return '<a:noFill/>'
+    const ang = fill.angle !== undefined ? Math.round(Math.max(0, ((Number(fill.angle) % 360) + 360) % 360) * 60000) : 5400000
+    return '<a:gradFill rotWithShape="1"><a:gsLst>' + gs + '</a:gsLst><a:lin ang="' + ang + '" scaled="1"/></a:gradFill>'
+  }
+  return '<a:noFill/>'
+}
+
+/** srgbClr（可选 alpha 0-100）→ OOXML（v0.11 透明度闭环）。 */
+function srgbClrXml(color, alpha) {
+  return '<a:srgbClr val="' + hex(color) + '">' + (alpha !== undefined ? '<a:alpha val="' + Math.round(Number(alpha) * 1000) + '"/>' : '') + '</a:srgbClr>'
+}
+
+// ── line / connector ──────────────────────────────────────────────────────
+/**
+ * 连线导出（2026-09-14 修复方向丢失）：
+ * `straightConnector1` 只画包围盒的**左上→右下**，线的真实走向必须由 `flipH`/`flipV` 表达：
+ *   p2 在 p1 左侧 → flipH；p2 在 p1 上方 → flipV。
+ * 漏写会镜像斜率；两条交叉线（如 × 的两笔）还会重叠成一条 —— 预览对、PowerPoint 里不对的根源。
+ * `tailEnd`（箭头）始终落在画出的"终点"＝ p2，所以定点翻转后箭头方向自动正确。
+ */
+function connectorSp(el, proof) {
+  const id = nid()
+  const p1 = el.points[0]
+  const p2 = el.points[1]
+  const x1 = p1[0]
+  const y1 = p1[1]
+  const x2 = p2[0]
+  const y2 = p2[1]
+  const minX = Math.min(x1, x2)
+  const minY = Math.min(y1, y2)
+  // 包围盒必须**精确**等于线段跨度（2026-09-14 第二修：不再 max(1,…) 兜底）——
+  // straightConnector1 是"包围盒对角"，水平线给 cy=1 会被画成 1pt/12pt 的**假斜线**
+  // （预览平、PowerPoint 斜的根源）。cy=0 / cx=0 是合法表达（Office 自己也这么写）。
+  let wdt = Math.abs(x2 - x1)
+  let hgt = Math.abs(y2 - y1)
+  if (wdt === 0 && hgt === 0) { wdt = 1; hgt = 1 } // 零长线（退化点）：给 1×1 以免被消费端丢弃
+  const flips = (x2 < x1 ? ' flipH="1"' : '') + (y2 < y1 ? ' flipV="1"' : '')
+  const xml = '<p:cxnSp><p:nvCxnSpPr><p:cNvPr id="' + id + '" name="' + xm(el.id) + '"/><p:cNvCxnSpPr/><p:nvPr/></p:nvCxnSpPr>'
+    + '<p:spPr>' + xfrm(minX, minY, wdt, hgt, 0, flips) + '<a:prstGeom prst="straightConnector1"><a:avLst/></a:prstGeom>'
+    + lineSpPr(el.line, el.arrow === true) + '</p:spPr></p:cxnSp>'
+  if (proof !== undefined && proof !== null) {
+    proof.out++
+    // 从写出的 XML 反推线段两端（OOXML 语义：本地 (0,0)→(w,h) 经 flip 映射回页面），必须与源 points 一致。
+    const back = connectorEndsFromXml(xml)
+    const same = back !== null &&
+      Math.abs(back[0][0] - x1) < 0.01 && Math.abs(back[1][0] - x2) < 0.01 &&
+      Math.abs(back[0][1] - y1) < 0.01 && Math.abs(back[1][1] - y2) < 0.01
+    if (!same) proof.wrong.push(`${el.id}: 源 [[${x1},${y1}],[${x2},${y2}]] → OOXML 还原 ${back === null ? '解析失败' : JSON.stringify(back.map((p) => p.map((v) => Math.round(v * 100) / 100)))}`)
+    // 箭头必须在 <a:ln> 内部（写在外面 PowerPoint 直接忽略）
+    if (el.arrow === true && !/<a:ln\b[^>]*>(?:(?!<\/a:ln>)[\s\S])*<a:tailEnd/.test(xml)) {
+      proof.wrong.push(`${el.id}: arrow=true 但 <a:tailEnd> 不在 <a:ln> 内（PowerPoint 会忽略箭头）`)
+    }
+  }
+  return xml
+}
+
+/** 从 connector XML 反推页面坐标端点（导出自证用；也供测试复用）。 */
+export function connectorEndsFromXml(xml) {
+  const off = xml.match(/<a:off x="(-?\d+)" y="(-?\d+)"\/>/)
+  const ext = xml.match(/<a:ext cx="(\d+)" cy="(\d+)"\/>/)
+  if (!off || !ext) return null
+  const x = Number(off[1]) / EMU
+  const y = Number(off[2]) / EMU
+  const w = Number(ext[1]) / EMU
+  const h = Number(ext[2]) / EMU
+  const flipH = /flipH="1"/.test(xml)
+  const flipV = /flipV="1"/.test(xml)
+  const start = [x + (flipH ? w : 0), y + (flipV ? h : 0)]
+  const end = [x + (flipH ? 0 : w), y + (flipV ? 0 : h)]
+  return [start, end]
+}
+
+// ── image ─────────────────────────────────────────────────────────────────
+function picSp(el, rId) {
+  const id = nid()
+  return '<p:pic><p:nvPicPr><p:cNvPr id="' + id + '" name="' + xm(el.id) + '"/><p:cNvPicPr><a:picLocks noChangeAspect="1"/></p:cNvPicPr><p:nvPr/></p:nvPicPr>'
+    + '<p:blipFill><a:blip r:embed="' + rId + '"/><a:stretch><a:fillRect/></a:stretch></p:blipFill>'
+    + '<p:spPr>' + xfrm(el.bounds.x, el.bounds.y, el.bounds.w, el.bounds.h) + '<a:prstGeom prst="rect"><a:avLst/></a:prstGeom></p:spPr></p:pic>'
+}
+
+// ── table ─────────────────────────────────────────────────────────────────
+/** PowerPoint 默认表格样式（python-pptx/PowerPoint 落盘同一 GUID）；无样式时部分版本丢弃表格（P1 事故）。 */
+const TABLE_STYLE_ID = '{5C22544A-7EE6-4342-B048-85BDC9FD1C3A}'
+
+function tableFrame(el) {
+  const id = nid()
+  const rows = [el.header ? [...el.cols] : null, ...el.rows.map((r) => [...r])].filter(Boolean)
+  const ncols = Math.max(1, ...rows.map((r) => r.length))
+  const colW = Math.floor(emu(el.bounds.w) / ncols)
+  const header = el.header
+  const grid = '<a:tblGrid>' + Array.from({ length: ncols }, () => '<a:gridCol w="' + colW + '"/>').join('') + '</a:tblGrid>'
+  const trs = rows.map((r, ri) => {
+    const tds = Array.from({ length: ncols }, (_, ci) => {
+      const cell = r[ci]
+      const isH = header && ri === 0
+      const fill = isH ? '<a:solidFill><a:srgbClr val="DDEBF7"/></a:solidFill>' : '<a:noFill/>'
+      // 字号来自 normalizePage 的 fontPt（= max(11, theme.minFontSize)），不再硬编码 1100：
+      // 硬编码会让 audit 档"最小字号 ≥ minFontSize"的断言对含表工程恒假，且用户在 DSL 里无法修正。
+      const cellSz = Math.round((Number(el.fontPt) || 11) * 100)
+      const rPr = '<a:rPr lang="zh-CN" sz="' + cellSz + '"' + (isH ? ' b="1"' : '') + '><a:solidFill><a:srgbClr val="1F2937"/></a:solidFill></a:rPr>'
+      const tb = '<a:txBody><a:bodyPr/><a:lstStyle/><a:p><a:r>' + rPr + '<a:t>' + xm(cell ?? '') + '</a:t></a:r></a:p></a:txBody>'
+      // P1 修复（测试反馈 ★）：tcPr 子元素顺序须为 lnL..lnB → fill → marL（ECMA-376 CT_TableCellProperties）；
+      // anchor 是 tcPr 的属性而非 marL 的属性。
+      return '<a:tc>' + tb + '<a:tcPr anchor="ctr">'
+        + '<a:lnL><a:noFill/></a:lnL><a:lnR><a:noFill/></a:lnR><a:lnT><a:noFill/></a:lnT><a:lnB><a:noFill/></a:lnB>'
+        + fill + '<a:marL l="45720" r="45720" t="22860" b="22860"/></a:tcPr></a:tc>'
+    }).join('')
+    return '<a:tr h="' + Math.floor(emu(el.bounds.h) / rows.length) + '">' + tds + '</a:tr>'
+  }).join('')
+  // P1 修复：graphicFrame 的 <p:xfrm> 直接含 <a:off>/<a:ext>（不能复用 spPr 的 xfrm()，
+  // 其嵌套 <a:xfrm> 属非法结构——PowerPoint 打开时静默丢弃整帧，HTML 预览不受影响，极具迷惑性）。
+  return '<p:graphicFrame><p:nvGraphicFramePr><p:cNvPr id="' + id + '" name="' + xm(el.id) + '"/><p:cNvGraphicFramePr/><p:nvPr/></p:nvGraphicFramePr>'
+    + '<p:xfrm><a:off x="' + emu(el.bounds.x) + '" y="' + emu(el.bounds.y) + '"/><a:ext cx="' + emu(el.bounds.w) + '" cy="' + emu(el.bounds.h) + '"/></p:xfrm>'
+    + '<a:graphic><a:graphicData uri="http://schemas.openxmlformats.org/drawingml/2006/table">'
+    + '<a:tbl><a:tblPr firstRow="' + (header ? 1 : 0) + '" bandRow="0"><a:tableStyleId>' + TABLE_STYLE_ID + '</a:tableStyleId></a:tblPr>'
+    + grid + trs + '</a:tbl>'
+    + '</a:graphicData></a:graphic></p:graphicFrame>'
+}
+
+// ── chart（矢量拼绘）───────────────────────────────────────────────────────
+function chartSp(el) {
+  const x = el.bounds.x
+  const y = el.bounds.y
+  const w = el.bounds.w
+  const h = el.bounds.h
+  const data = chartData(el.chart)
+  const colors = chartColors(el.chart)
+  const out = []
+  const padT = 0.06 * h
+  const padR = 0.04 * w
+  const padB = el.chart.type === 'pie' ? 0.1 * h : 0.24 * h
+  const padL = 0.12 * w
+  const iw = w - padL - padR
+  const ih = h - padT - padB
+  const vals = data.series.flatMap((s) => s.values)
+  const maxV = Math.max(1e-9, ...vals)
+  const n = Math.max(1, data.categories.length)
+  const slot = iw / n
+
+  if (el.chart.type === 'bar') {
+    data.series.forEach((s, si) => {
+      s.values.forEach((v, i) => {
+        const bw = Math.max(2, (slot * 0.6) / data.series.length)
+        const bx = x + padL + slot * i + slot / 2 - bw / 2 + (si - (data.series.length - 1) / 2) * bw
+        const bh = Math.max(2, Math.abs(v / maxV) * ih)
+        const by = y + padT + ih - bh
+        out.push(shapeSp({ id: el.id + '-b' + i + '-' + si, kind: 'rect', bounds: { x: bx, y: by, w: bw, h: bh }, fill: colors[si % colors.length] }))
+      })
+    })
+  } else if (el.chart.type === 'line') {
+    data.series.forEach((s, si) => {
+      for (let i = 1; i < s.values.length; i++) {
+        const x1 = x + padL + slot * (i - 1) + slot / 2
+        const y1 = y + padT + ih - (s.values[i - 1] / maxV) * ih
+        const x2 = x + padL + slot * i + slot / 2
+        const y2 = y + padT + ih - (s.values[i] / maxV) * ih
+        out.push(connectorSp({ id: el.id + '-L' + i, points: [[x1, y1], [x2, y2]], line: { color: colors[si % colors.length], width: 2 } }))
+      }
+      s.values.forEach((v, i) => {
+        out.push(shapeSp({ id: el.id + '-d' + i + '-' + si, kind: 'ellipse', bounds: { x: x + padL + slot * i + slot / 2 - 3, y: y + padT + ih - (v / maxV) * ih - 3, w: 6, h: 6 }, fill: colors[si % colors.length] }))
+      })
+    })
+  } else if (el.chart.type === 'pie') {
+    const v = data.series[0].values
+    const total = v.reduce((a, b) => a + Math.max(0, b), 0) || 1
+    const r = Math.min(iw, ih) / 2
+    const cx = x + padL + iw / 2
+    const cy = y + padT + ih / 2
+    let ang = -90 * 60000
+    v.forEach((val, i) => {
+      if (val <= 0) return
+      const frac = val / total
+      const span = Math.round(frac * 360 * 60000)
+      const gd1 = Math.abs(ang % (360 * 60000))
+      const gd2 = Math.abs((ang + span) % (360 * 60000))
+      const gid = nid()
+      const oval = '<a:off x="' + Math.round(cx - r) + '" y="' + Math.round(cy - r) + '"/><a:ext cx="' + Math.round(r * 2) + '" cy="' + Math.round(r * 2) + '"/>'
+      out.push('<p:sp><p:nvSpPr><p:cNvPr id="' + gid + '" name="' + xm(el.id) + '-p' + i + '"/><p:cNvSpPr/><p:nvPr/></p:nvSpPr>'
+        + '<p:spPr><a:xfrm>' + oval + '</a:xfrm>'
+        + '<a:prstGeom prst="pie"><a:avLst><a:gd name="adj1" fmla="val ' + gd1 + '"/><a:gd name="adj2" fmla="val ' + gd2 + '"/></a:avLst></a:prstGeom>'
+        + '<a:solidFill><a:srgbClr val="' + hex(colors[i % colors.length]) + '"/></a:solidFill><a:ln><a:noFill/></a:ln>'
+        + '</p:spPr><p:txBody><a:bodyPr/><a:lstStyle/><a:p/></p:txBody></p:sp>')
+      ang += span
+    })
+  }
+  return out
+}
+
+// ── package parts ─────────────────────────────────────────────────────────
+function contentTypes(slides) {
+  const notes = slides.filter((s) => s.notes)
+  const overrides = [
+    '<Override PartName="/ppt/presentation.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.presentation.main+xml"/>',
+    '<Override PartName="/ppt/slideMasters/slideMaster1.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.slideMaster+xml"/>',
+    '<Override PartName="/ppt/slideLayouts/slideLayout1.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.slideLayout+xml"/>',
+    '<Override PartName="/ppt/theme/theme1.xml" ContentType="application/vnd.openxmlformats-officedocument.theme+xml"/>',
+    '<Override PartName="/docProps/core.xml" ContentType="application/vnd.openxmlformats-package.core-properties+xml"/>',
+    '<Override PartName="/docProps/app.xml" ContentType="application/vnd.openxmlformats-officedocument.extended-properties+xml"/>',
+    ...(notes.length ? ['<Override PartName="/ppt/notesMasters/notesMaster1.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.notesMaster+xml"/>'] : []),
+    ...slides.map((_, i) => '<Override PartName="/ppt/slides/slide' + (i + 1) + '.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.slide+xml"/>'),
+    ...notes.map((s) => '<Override PartName="/ppt/notesSlides/notesSlide' + s.notesNo + '.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.notesSlide+xml"/>'),
+  ]
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Types xmlns="http://schemas.openxmlformats.org/package/2006/content-types">'
+    + '<Default Extension="rels" ContentType="application/vnd.openxmlformats-package.relationships+xml"/>'
+    + '<Default Extension="xml" ContentType="application/xml"/>'
+    + '<Default Extension="png" ContentType="image/png"/><Default Extension="jpeg" ContentType="image/jpeg"/>'
+    + '<Default Extension="jpg" ContentType="image/jpeg"/><Default Extension="gif" ContentType="image/gif"/>'
+    + '<Default Extension="webp" ContentType="image/webp"/>'
+    + overrides.join('') + '</Types>'
+}
+
+function rootRels() {
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">'
+    + '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/officeDocument" Target="ppt/presentation.xml"/>'
+    + '<Relationship Id="rId2" Type="http://schemas.openxmlformats.org/package/2006/relationships/metadata/core-properties" Target="docProps/core.xml"/>'
+    + '<Relationship Id="rId3" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/extended-properties" Target="docProps/app.xml"/>'
+    + '</Relationships>'
+}
+
+function coreProps(ctx) {
+  const d = new Date().toISOString()
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><cp:coreProperties xmlns:cp="http://schemas.openxmlformats.org/package/2006/metadata/core-properties" xmlns:dc="http://purl.org/dc/elements/1.1/">'
+    + '<dc:title>' + xm(ctx.deck.title ?? 'deck') + '</dc:title><dc:creator>dsh-ppt-studio</dc:creator><cp:lastModifiedBy>dsh-ppt-studio</cp:lastModifiedBy>'
+    + '<dcterms:created xmlns:dcterms="http://purl.org/dc/terms/" xsi:type="dcterms:W3CDTF" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">' + d + '</dcterms:created>'
+    + '<dcterms:modified xmlns:dcterms="http://purl.org/dc/terms/" xsi:type="dcterms:W3CDTF" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">' + d + '</dcterms:modified>'
+    + '</cp:coreProperties>'
+}
+
+function appProps(ctx) {
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Properties xmlns="http://schemas.openxmlformats.org/officeDocument/2006/extended-properties" xmlns:vt="http://schemas.openxmlformats.org/officeDocument/2006/docPropsVTypes">'
+    + '<Application>dsh-ppt-studio</Application><Slides>' + ctx.pages.length + '</Slides></Properties>'
+}
+
+function presentationXml(ctx, slides) {
+  const sldIdLst = slides.map((_, i) => '<p:sldId id="' + (256 + i) + '" r:id="rId' + (i + 2) + '"/>').join('')
+  // 注意：**不写 <p:notesMasterIdLst>**。备注母版只通过 presentation.xml.rels 里的 notesMaster 关系挂载
+  //（与 PowerPoint 原生模板 / python-pptx 产物同构）。2026-09-14 实测：多写这个元素，PowerPoint 直接报
+  // "文件或目录损坏"（0x80070570）——python-pptx 却照读不误。减量二分定位：撤掉它即恢复正常。
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><p:presentation xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">'
+    + '<p:sldMasterIdLst><p:sldMasterId id="2147483648" r:id="rId1"/></p:sldMasterIdLst>'
+    + '<p:sldIdLst>' + sldIdLst + '</p:sldIdLst>'
+    + '<p:sldSz cx="' + emu(ctx.size.width) + '" cy="' + emu(ctx.size.height) + '"/><p:notesSz cx="6858000" cy="9144000"/>'
+    + '<p:defaultTextStyle><a:lvl1pPr algn="l"><a:defRPr sz="1800"/></a:lvl1pPr><a:lvl2pPr><a:defRPr sz="1400"/></a:lvl2pPr><a:lvl3pPr><a:defRPr sz="1200"/></a:lvl3pPr><a:lvl4pPr><a:defRPr sz="1200"/></a:lvl4pPr><a:lvl5pPr><a:defRPr sz="1200"/></a:lvl5pPr></p:defaultTextStyle>'
+    + '</p:presentation>'
+}
+
+function presentationRels(slides) {
+  const r = slides.map((_, i) => '<Relationship Id="rId' + (i + 2) + '" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slide" Target="slides/slide' + (i + 1) + '.xml"/>').join('')
+  const notesMaster = slides.some((s) => s.notes) ? `<Relationship Id="rId${slides.length + 2}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/notesMaster" Target="notesMasters/notesMaster1.xml"/>` : ''
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">'
+    + '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideMaster" Target="slideMasters/slideMaster1.xml"/>'
+    + r + notesMaster + '</Relationships>'
+}
+
+function slideMasterXml() {
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><p:sldMaster xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">'
+    + '<p:cSld><p:spTree>' + spTreeHeader() + '</p:spTree></p:cSld>'
+    + '<p:clrMap bg1="lt1" tx1="dk1" bg2="lt2" tx2="dk2" accent1="accent1" accent2="accent2" accent3="accent3" accent4="accent4" accent5="accent5" accent6="accent6" hlink="hlink" folHlink="folHlink"/>'
+    + '<p:sldLayoutIdLst><p:sldLayoutId id="2147483649" r:id="rId1"/></p:sldLayoutIdLst>'
+    + '<p:txStyles><p:titleStyle><a:lvl1pPr algn="l"/></p:titleStyle><p:bodyStyle><a:lvl1pPr algn="l"/></p:bodyStyle><p:otherStyle><a:lvl1pPr algn="l"/></p:otherStyle></p:txStyles>'
+    + '</p:sldMaster>'
+}
+
+function slideMasterRels() {
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">'
+    + '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout" Target="../slideLayouts/slideLayout1.xml"/>'
+    + '<Relationship Id="rId2" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme" Target="../theme/theme1.xml"/>'
+    + '</Relationships>'
+}
+
+function slideLayoutXml() {
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><p:sldLayout xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main" type="blank" preserve="1">'
+    + '<p:cSld name="blank"><p:spTree>' + spTreeHeader() + '</p:spTree></p:cSld>'
+    + '<p:clrMapOvr><a:masterClrMapping/></p:clrMapOvr></p:sldLayout>'
+}
+
+function slideLayoutRels() {
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">'
+    + '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideMaster" Target="../slideMasters/slideMaster1.xml"/>'
+    + '</Relationships>'
+}
+
+function slideXml(s) {
+  const bg = s.bg ? ['<p:bg>', s.bg.xml, '</p:bg>'].join('') : ''
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><p:sld xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main">'
+    + '<p:cSld>' + bg + s.spTree + '</p:cSld><p:clrMapOvr><a:masterClrMapping/></p:clrMapOvr></p:sld>'
+}
+
+// ── 备注页（讲稿）：2026-09-14 新增 ────────────────────────────────────────────
+// 结构对齐 PowerPoint/python-pptx 的实际产物：presentation → notesMasterIdLst + rels → notesMaster（含 theme rel），
+// slide → rels（notesSlide）→ notesSlide（body 占位符 + 段落文本）。缺 notesMaster 时 PowerPoint 会在打开时自行补，
+// 但产物就不是"标准包"了——所以宁可多两个小部件，保持与真实 pptx 同构。
+const P_NS = 'xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" xmlns:r="http://schemas.openxmlformats.org/officeDocument/2006/relationships" xmlns:p="http://schemas.openxmlformats.org/presentationml/2006/main"'
+
+/** 讲稿文本 → notesSlide。
+ *  结构照 python-pptx 默认模板（PowerPoint 原生产物）复核过：
+ *  ① notesSlide 的占位符 **必须能在 notesMaster 里找到对应项**（body 用 idx="3"、幻灯图 sldImg idx="2"）；
+ *  ② notesSlide 必须自带 rels（→ notesMaster + 回指本页幻灯），见调用处。
+ *  2026-09-14 实测教训：占位符 idx 对不上 / 缺 rels 时 python-pptx 能读，**PowerPoint 报"文件或目录损坏"**。 */
+function notesSlideXml(notes) {
+  const paras = String(notes).split(/\r?\n/)
+    .map((line) => '<a:p><a:r><a:rPr lang="zh-CN" dirty="0"/><a:t>' + xm(line) + '</a:t></a:r></a:p>')
+    .join('')
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><p:notes ' + P_NS + '>'
+    + '<p:cSld><p:spTree>' + spTreeHeader()
+    + '<p:sp><p:nvSpPr><p:cNvPr id="2" name="Slide Image Placeholder 1"/><p:cNvSpPr><a:spLocks noGrp="1"/></p:cNvSpPr><p:nvPr><p:ph type="sldImg" idx="2"/></p:nvPr></p:nvSpPr><p:spPr/></p:sp>'
+    + '<p:sp><p:nvSpPr><p:cNvPr id="3" name="Notes Placeholder 2"/><p:cNvSpPr><a:spLocks noGrp="1"/></p:cNvSpPr><p:nvPr><p:ph type="body" sz="quarter" idx="3"/></p:nvPr></p:nvSpPr>'
+    + '<p:spPr/><p:txBody><a:bodyPr/><a:lstStyle/>' + paras + '</p:txBody></p:sp>'
+    + '</p:spTree></p:cSld><p:clrMapOvr><a:masterClrMapping/></p:clrMapOvr></p:notes>'
+}
+
+/** 备注母版的占位符表（几何取自 PowerPoint 原生 notesMaster：notesSz = 6858000×9144000 EMU）。 */
+const NOTES_PH = [
+  { id: 2, name: 'Header Placeholder 1', ph: '<p:ph type="hdr" sz="quarter"/>', off: [0, 0], ext: [2971800, 457200], algn: 'l' },
+  { id: 3, name: 'Date Placeholder 2', ph: '<p:ph type="dt" idx="1"/>', off: [3884613, 0], ext: [2971800, 457200], algn: 'r' },
+  { id: 4, name: 'Slide Image Placeholder 3', ph: '<p:ph type="sldImg" idx="2"/>', off: [1143000, 685800], ext: [4572000, 3429000] },
+  { id: 5, name: 'Notes Placeholder 4', ph: '<p:ph type="body" sz="quarter" idx="3"/>', off: [685800, 4343400], ext: [5486400, 4114800] },
+  { id: 6, name: 'Footer Placeholder 5', ph: '<p:ph type="ftr" sz="quarter" idx="4"/>', off: [0, 8685213], ext: [2971800, 457200], algn: 'l' },
+  { id: 7, name: 'Slide Number Placeholder 6', ph: '<p:ph type="sldNum" sz="quarter" idx="5"/>', off: [3884613, 8685213], ext: [2971800, 457200], algn: 'r' },
+]
+
+/** 最小但**完整**的 notesMaster（CT_NotesMaster 顺序：cSld → clrMap → notesStyle）。
+ *  占位符不能省：notesSlide 里的 ph 必须在此有对应项，否则 PowerPoint 判包损坏。 */
+function notesMasterXml() {
+  const sp = (p) => '<p:sp><p:nvSpPr><p:cNvPr id="' + p.id + '" name="' + p.name + '"/><p:cNvSpPr><a:spLocks noGrp="1"/></p:cNvSpPr><p:nvPr>' + p.ph + '</p:nvPr></p:nvSpPr>'
+    + '<p:spPr><a:xfrm><a:off x="' + p.off[0] + '" y="' + p.off[1] + '"/><a:ext cx="' + p.ext[0] + '" cy="' + p.ext[1] + '"/></a:xfrm><a:prstGeom prst="rect"><a:avLst/></a:prstGeom></p:spPr>'
+    + '<p:txBody><a:bodyPr vert="horz" lIns="91440" tIns="45720" rIns="91440" bIns="45720" rtlCol="0"/><a:lstStyle>'
+    + (p.algn ? '<a:lvl1pPr algn="' + p.algn + '"><a:defRPr sz="1200"/></a:lvl1pPr>' : '')
+    + '</a:lstStyle><a:p><a:endParaRPr lang="zh-CN"/></a:p></p:txBody></p:sp>'
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><p:notesMaster ' + P_NS + '>'
+    + '<p:cSld><p:spTree>' + spTreeHeader() + NOTES_PH.map(sp).join('') + '</p:spTree></p:cSld>'
+    + '<p:clrMap bg1="lt1" tx1="dk1" bg2="lt2" tx2="dk2" accent1="accent1" accent2="accent2" accent3="accent3" accent4="accent4" accent5="accent5" accent6="accent6" hlink="hlink" folHlink="folHlink"/>'
+    + '<p:notesStyle><a:lvl1pPr algn="l"><a:defRPr sz="1200"/></a:lvl1pPr></p:notesStyle>'
+    + '</p:notesMaster>'
+}
+
+function notesMasterRels() {
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">'
+    + '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/theme" Target="../theme/theme1.xml"/>'
+    + '</Relationships>'
+}
+
+/** 页面背景 → 导出结构：{ kind:'solid', xml } | { kind:'image', src, rId, xml } | null */
+function resolveBg(bg, ctx) {
+  if (!bg) return null
+  if (typeof bg === 'string') {
+    return { kind: 'solid', xml: '<p:bgPr><a:solidFill><a:srgbClr val="' + hex(ctx.resolveColor(bg)) + '"/></a:solidFill><a:effectLst/></p:bgPr>' }
+  }
+  if (bg.type === 'solid') {
+    return { kind: 'solid', xml: '<p:bgPr><a:solidFill><a:srgbClr val="' + hex(ctx.resolveColor(bg.color ?? '#FFFFFF')) + '"/></a:solidFill><a:effectLst/></p:bgPr>' }
+  }
+  if (bg.type === 'image') {
+    return {
+      kind: 'image',
+      src: bg.src,
+      rId: null, // 由调用方 addMedia 后回填
+      xml: '<p:bgPr><a:blipFill><a:blip r:embed="BGPLACEHOLDER"/><a:stretch><a:fillRect/></a:stretch></a:blipFill><a:effectLst/></p:bgPr>',
+    }
+  }
+  return null
+}
+
+function themeXml() {
+  const clr = [
+    ['dk1', '000000'], ['lt1', 'FFFFFF'], ['dk2', '1F2937'], ['lt2', 'F3F4F6'],
+    ['accent1', '2563EB'], ['accent2', 'F59E0B'], ['accent3', '10B981'], ['accent4', 'EF4444'],
+    ['accent5', '8B5CF6'], ['accent6', '06B6D4'], ['hlink', '2563EB'], ['folHlink', '7C3AED'],
+  ].map(([n, v]) => '<a:' + n + '><a:srgbClr val="' + v + '"/></a:' + n + '>').join('')
+  const fill = '<a:fillStyleLst><a:solidFill><a:schemeClr val="phClr"/></a:solidFill><a:solidFill><a:schemeClr val="phClr"/></a:solidFill><a:solidFill><a:schemeClr val="phClr"/></a:solidFill></a:fillStyleLst>'
+  const ln = '<a:lnStyleLst>'
+    + '<a:ln w="6350" cap="flat" cmpd="sng" algn="ctr"><a:solidFill><a:schemeClr val="phClr"/></a:solidFill></a:ln>'
+    + '<a:ln w="12700" cap="flat" cmpd="sng" algn="ctr"><a:solidFill><a:schemeClr val="phClr"/></a:solidFill></a:ln>'
+    + '<a:ln w="19050" cap="flat" cmpd="sng" algn="ctr"><a:solidFill><a:schemeClr val="phClr"/></a:solidFill></a:ln>'
+    + '</a:lnStyleLst>'
+  const eff = '<a:effectStyleLst><a:effectStyle><a:effectLst/></a:effectStyle><a:effectStyle><a:effectLst/></a:effectStyle><a:effectStyle><a:effectLst/></a:effectStyle></a:effectStyleLst>'
+  const bg = '<a:bgFillStyleLst><a:solidFill><a:schemeClr val="phClr"/></a:solidFill><a:solidFill><a:schemeClr val="phClr"/></a:solidFill><a:solidFill><a:schemeClr val="phClr"/></a:solidFill></a:bgFillStyleLst>'
+  return '<?xml version="1.0" encoding="UTF-8" standalone="yes"?><a:theme xmlns:a="http://schemas.openxmlformats.org/drawingml/2006/main" name="Studio">'
+    + '<a:themeElements><a:clrScheme name="Studio">' + clr + '</a:clrScheme>'
+    + '<a:fontScheme name="Studio"><a:majorFont><a:latin typeface="Calibri"/><a:ea typeface="Microsoft YaHei"/><a:cs typeface=""/></a:majorFont>'
+    + '<a:minorFont><a:latin typeface="Calibri"/><a:ea typeface="Microsoft YaHei"/><a:cs typeface=""/></a:minorFont></a:fontScheme>'
+    + '<a:fmtScheme name="Studio">' + fill + ln + eff + bg + '</a:fmtScheme>'
+    + '</a:themeElements></a:theme>'
+}