dsh-ppt-studio 1.1.1 → 1.1.4

package/lib/pptd/export-pptx.js

@@ -1,7 +1,8 @@
 /**
  * PPTD → PPTX 导出器（主引擎）：生成最小可打开的 OOXML。
  * - 元素：text / shape(rect,ellipse,triangle) / line(箭头) / image / table
- *   / chart（矢量拼绘：bar=矩形、line=连接线+圆点、pie=饼形）
+ *   / chart（第三轮起**默认原生可编辑图表**：ppt/charts/chartN.xml + 内嵌数据工作簿，
+ *     PowerPoint 里可"编辑数据"/换类型；`chart.render: 'vector'` 保留矢量拼绘降级：bar=矩形、line=连线+圆点、pie=饼形）
  * - 文本自动 fit：与 verify 同一度量与阈值（overflow > 1px 才缩），按比例缩字号；
  *   下限语义（2026-09-06 用户拍板）：theme.minFontSize 显式 = 用户给出的字号下限（严格遵守，且不超过原字号）；
  *   未设置 = 无强制下限（仅 60% 原字号防荒谬保底），绝不升字；到下限仍溢出记 floorHit。
@@ -12,9 +13,11 @@
  */
 import { writeFile, readFile } from 'node:fs/promises'
 import { join, isAbsolute } from 'node:path'
+import { createHash } from 'node:crypto'
 import { zipWrite } from '../zips.js'
 import { normalizePage } from './layout.js'
-import { chartData, chartColors, chartIssue } from './svgCharts.js'
+import { chartData, chartColors, chartIssue, resolveChart } from './svgCharts.js'
+import { auditNativeCharts, chartFrameXml, chartPartNames, embeddedWorkbook, nativeChartRels, nativeChartXml } from './nativeChart.js'
 
 const EMU = 12700
 const xm = (s) => String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;').replace(/"/g, '&quot;')
@@ -36,17 +39,50 @@ export async function exportPptx(ctx, { out = 'out.pptx', engine = 'pptd' } = {}
   const lineProof = { exp: 0, out: 0, wrong: [] }
   UID = 1000
 
+  // 媒体部件命名（2026-09-26 修复"同名静默错图"）——**整册共享**（不能按页各算一套，否则同一 srcPath
+  // 在不同页会拿到不同部件名，parity 会假红）。要防的事故：旧实现 addMedia 按**完整路径**去重（rId 不同），
+  // 但包内部件名与 rels Target 都取 `basename` ⇒ `media/a/logo.png` 与 `media/b/logo.png` 共用一个
+  // `ppt/media/logo.png`，后写覆盖先写 —— **成品里一张图被静默换成另一张**，而 parity（只数 `<p:pic>`）与
+  // warnings 全绿（2026-09-26 实测复现）。
+  // 规则：ASCII 安全且未被占用 ⇒ **原名不动**（既有产物零变化）；非 ASCII/空格或重名 ⇒ `stem-<hash8>.<ext>`
+  // （hash 取相对路径，跨机器/跨运行确定；`ppt/media/` 是包内部件名，用户看不到）。
+  const usedParts = new Map() // srcPath → 部件名
+  const takenParts = new Set()
+  const renamedMedia = new Map() // srcPath → 改名后的部件名（供报告"不静默"）
+  const mediaPartName = (srcPath) => {
+    if (usedParts.has(srcPath)) return usedParts.get(srcPath)
+    const key = String(srcPath)
+    const base = key.split(/[\\/]/).pop() || 'image'
+    const dot = base.lastIndexOf('.')
+    const ext = dot > 0 ? base.slice(dot) : ''
+    const stem = dot > 0 ? base.slice(0, dot) : base
+    let part = base
+    if (!/^[A-Za-z0-9._-]+$/.test(base) || takenParts.has(base)) {
+      const slug = stem.replace(/[^A-Za-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'image'
+      const h = createHash('sha1').update(key).digest('hex').slice(0, 8)
+      part = `${slug}-${h}${ext}`
+      let n = 1
+      while (takenParts.has(part)) part = `${slug}-${h}-${n++}${ext}`
+      renamedMedia.set(key, part)
+    }
+    takenParts.add(part)
+    usedParts.set(srcPath, part)
+    return part
+  }
+
   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 counts = { table: 0, image: 0, chart: 0, chartNative: 0, chartVector: 0 }
+    // 原生图表：收集本页要产出的图表部件（rId / 部件名在"媒体发现完之后"才分配，见下方 relBase）
+    const chartRefs = []
     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 })
+      media.push({ srcPath, rId, part: mediaPartName(srcPath) })
       return rId
     }
 
@@ -70,7 +106,17 @@ export async function exportPptx(ctx, { out = 'out.pptx', engine = 'pptd' } = {}
           counts.chart++
           const issue = chartIssue(el.chart)
           if (issue) report.chartInfos.push(`第 ${page.index + 1} 页（${page.name}）${el.id}: ${issue}`)
-          shapes.push(...chartSp(el))
+          // 第三轮：默认原生可编辑图表；`render: 'vector'` 才走旧的矢量拼绘（形状计数自证照旧）
+          if (resolveChart(el.chart).opts.render === 'vector') {
+            counts.chartVector++
+            shapes.push(...chartSp(el))
+          } else {
+            counts.chartNative++
+            const k = chartRefs.length
+            chartRefs.push({ el, pageNo: page.index + 1, pageName: page.name })
+            // rId 先占位：媒体是在本循环里陆续发现的，图表关系必须排在媒体（与讲稿）之后
+            shapes.push(chartFrameXml(el, nid(), `__CHART_RID_${k}__`))
+          }
           break
         }
       }
@@ -83,13 +129,28 @@ export async function exportPptx(ctx, { out = 'out.pptx', engine = 'pptd' } = {}
       bg.xml = bg.xml.replace('BGPLACEHOLDER', bg.rId)
     }
 
+    // ── 关系编号（媒体之后）：讲稿 → 图表 ──────────────────────────────────
+    // 不产图表的工程：编号与旧实现**逐字节一致**（rId1=slideLayout，rId2..=media，notesRel=media+2）。
+    const notes = typeof page.page.notes === 'string' && page.page.notes.trim() ? page.page.notes.trim() : null
+    const relBase = media.length + 2
+    const notesRId = notes ? `rId${relBase}` : null
+    chartRefs.forEach((c, k) => {
+      c.rId = `rId${relBase + (notes ? 1 : 0) + k}`
+    })
+    for (let k = 0; k < chartRefs.length; k++) {
+      const idx = shapes.findIndex((s) => typeof s === 'string' && s.includes(`__CHART_RID_${k}__`))
+      if (idx >= 0) shapes[idx] = shapes[idx].replace(`__CHART_RID_${k}__`, chartRefs[k].rId)
+    }
+
     slides.push({
       page,
       shapes,
       media,
       counts,
+      chartRefs,
       // 讲稿：只有非空字符串才产备注页（空/未写 = 与旧行为完全一致，不生成部件）
-      notes: typeof page.page.notes === 'string' && page.page.notes.trim() ? page.page.notes.trim() : null,
+      notes,
+      notesRId,
       notesNo: 0,
       spTree: `<p:spTree>${spTreeHeader()}${shapes.join('')}</p:spTree>`,
       bg,
@@ -99,8 +160,21 @@ export async function exportPptx(ctx, { out = 'out.pptx', engine = 'pptd' } = {}
   let notesCount = 0
   for (const s of slides) if (s.notes) s.notesNo = ++notesCount
 
+  // ── 原生图表编号（跨页递增，chart1..chartN）与部件生成 ──────────────────────
+  // 每张原生图表 = 一个 chartN.xml + 一个内嵌工作簿（Microsoft_Excel_SheetN.xlsx），与 python-pptx 产物同构。
+  const nativeCharts = []
+  for (const s of slides) {
+    for (const c of s.chartRefs ?? []) {
+      const chartNo = nativeCharts.length + 1
+      const names = chartPartNames(chartNo)
+      c.chartNo = chartNo
+      c.names = names
+      nativeCharts.push({ id: c.el.id, chart: c.el.chart, pageNo: c.pageNo, pageName: c.pageName, chartNo, names })
+    }
+  }
+
   const files = {}
-  files['[Content_Types].xml'] = contentTypes(slides)
+  files['[Content_Types].xml'] = contentTypes(slides, nativeCharts)
   files['_rels/.rels'] = rootRels()
   files['docProps/core.xml'] = coreProps(ctx)
   files['docProps/app.xml'] = appProps(ctx)
@@ -115,13 +189,19 @@ export async function exportPptx(ctx, { out = 'out.pptx', engine = 'pptd' } = {}
     files['ppt/notesMasters/notesMaster1.xml'] = notesMasterXml()
     files['ppt/notesMasters/_rels/notesMaster1.xml.rels'] = notesMasterRels()
   }
+  // 图表部件三件套（chartN.xml / chartN.xml.rels / 内嵌 xlsx）
+  for (const ch of nativeCharts) {
+    files[ch.names.chart] = nativeChartXml({ chart: ch.chart, chartNo: ch.chartNo })
+    files[ch.names.rels] = nativeChartRels(ch.chartNo)
+    files[ch.names.embed] = embeddedWorkbook(ch.chart)
+  }
 
   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"/>` : ''
+    // 备注页关系：rId 取媒体之后的下一个空闲号（媒体用 rId2..rId(1+media)）——见页面循环里的统一分配
+    const notesRel = s.notesRId ? `<Relationship Id="${s.notesRId}" 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 + 回指本页幻灯）。
@@ -136,13 +216,14 @@ export async function exportPptx(ctx, { out = 'out.pptx', engine = 'pptd' } = {}
       '<?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()}"/>`),
+      ...s.media.map((m) => `<Relationship Id="${m.rId}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/image" Target="../media/${m.part}"/>`),
       notesRel,
+      ...(s.chartRefs ?? []).map((c) => `<Relationship Id="${c.rId}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/chart" Target="../charts/chart${c.chartNo}.xml"/>`),
       '</Relationships>',
     ].join('')
     files[`ppt/slides/_rels/slide${n}.xml.rels`] = srels
     for (const m of s.media) {
-      const bn = m.srcPath.split(/[\\/]/).pop()
+      const bn = m.part
       try {
         files[`ppt/media/${bn}`] = await readFile(join(ctx.dir, m.srcPath))
       } catch {
@@ -171,13 +252,90 @@ export async function exportPptx(ctx, { out = 'out.pptx', engine = 'pptd' } = {}
   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`))
+  // 媒体 parity（2026-09-26 新增）：**不同 srcPath 数 == 包内媒体部件数**。
+  // 为什么必须单独加一条：图数量 parity（imagesExp/imagesOut）只数 `<p:pic>`，两张不同的图塌成同一个部件时
+  // 它依然是 2/2、ok=true（实测）。而"两张不同的图被写成同一个部件"= 成品里静默用错图，正是本插件最不能出的错。
+  const mediaExpSet = new Set()
+  for (const s of slides) for (const m of s.media) mediaExpSet.add(m.srcPath)
+  const mediaOut = Object.keys(files).filter((k) => /^ppt\/media\//.test(k)).length
+  // 内容级回读（2026-09-26 第二轮 启发 A）：**产物里到底有没有我们打算写的那句话、那格数据**。
+  // 为什么必须补：此前 parity 只有**计数**（表/图/线/媒体）+ audit 的页数/尺寸/字号 ⇒
+  // "预览层对、成品层丢字/串行/表格漏格"这一类抓不到。官方 office 技能同款纪律：
+  // "Reopen the file to check the requested edits." 本检查**从产物反推内容**，不是读中间层。
+  const textMissing = []
+  const chartFramesMissing = []
+  let textExp = 0
+  let chartShapesExp = 0
+  let chartShapesOut = 0
+  for (let i = 0; i < slides.length; i++) {
+    const slot = (ctx.pages ?? [])[i]
+    if (slot === undefined) continue
+    // `ctx.pages[i]` = `{ file, ref, page, name, index }`，元素在 `slot.page.elements`（DSL 原文：`elementId`）
+    const elements = slot.page?.elements ?? []
+    const pageNo = (slot.index ?? i) + 1
+    const raw = files[`ppt/slides/slide${i + 1}.xml`]
+    const txt = typeof raw === 'string' ? raw : String(raw ?? '')
+    for (const el of elements) {
+      const id = String(el.elementId ?? el.id ?? '?')
+      const want = []
+      if (el.elementType === 'text') {
+        for (const line of String(el.content?.text ?? '').split('\n')) if (line.trim() !== '') want.push(line)
+      } else if (el.elementType === 'table') {
+        for (const v of [...(el.cols ?? []), ...((el.rows ?? []).flat())]) {
+          if (v !== null && v !== undefined && String(v) !== '') want.push(String(v))
+        }
+      }
+      for (const w of want) {
+        textExp++
+        if (!txt.includes(xm(w))) textMissing.push(`第 ${pageNo} 页/${id}: ${w.slice(0, 24)}`)
+      }
+      if (el.elementType === 'chart') {
+        if (resolveChart(el.chart).opts.render === 'vector') {
+          // 矢量拼绘（形状不是图表对象）⇒ 内容级判据只能是"该画的图形个数对不对"。
+          chartShapesExp += chartShapeCountOf(el)
+          const re = new RegExp(`name="${escapeRe(xm(id))}-`, 'g')
+          chartShapesOut += (txt.match(re) ?? []).length
+        } else {
+          // 原生图表：判据在包级（部件数 + externalData 关系 + 内嵌工作簿数据 == deck 数据），见下面的 auditNativeCharts。
+          // 幻灯片级还要自证"这个图表帧真的在产物里"（防止 graphicFrame 被静默丢弃/参数写错）。
+          const frameOk = txt.includes(`name="${xm(id)}"`) && txt.includes('drawingml/2006/chart')
+          if (!frameOk) chartFramesMissing.push(`第 ${pageNo} 页/${id}: slide XML 里没有图表帧（graphicFrame + graphicData uri=.../chart）`)
+        }
+      }
+    }
+  }
+  // 原生图表部件自证（第三轮）：声明的 chart 元素数 == ppt/charts/*.xml 数；
+  // 每个图表帧的 rId 真的指向 chartN.xml；chartN 的 externalData 关系真的指向存在的内嵌工作簿；
+  // 内嵌工作簿 `xl/worksheets/sheet1.xml` 取值 == deck 数据（逐格比对）。
+  const chartAudit = auditNativeCharts(files, nativeCharts.map((c) => ({ id: `${c.id}（第 ${c.pageNo} 页）`, chart: c.chart, chartPart: c.names.chart })))
+  const chartRelMissing = []
+  // 图表帧 → slide rels → chartN.xml 的链路自证（逐条从产物反查）
+  for (let i = 0; i < slides.length; i++) {
+    for (const c of slides[i].chartRefs ?? []) {
+      const srels = String(files[`ppt/slides/_rels/slide${i + 1}.xml.rels`] ?? '')
+      if (!srels.includes(`Id="${c.rId}"`) || !srels.includes(`../charts/chart${c.chartNo}.xml`)) {
+        chartRelMissing.push(`第 ${i + 1} 页/${c.el.id}: slide rels 缺 ${c.rId} → chart${c.chartNo}.xml`)
+      }
+      if (!String(files[`ppt/slides/slide${i + 1}.xml`]).includes(`r:id="${c.rId}"`)) {
+        chartRelMissing.push(`第 ${i + 1} 页/${c.el.id}: 图表帧没有引用 ${c.rId}`)
+      }
+    }
+  }
   report.parity = {
     tablesExp, tablesOut, imagesExp, imagesOut, illegalFrames: illegal,
     linesExp: lineProof.exp, linesOut: lineProof.out, linesWrong: lineProof.wrong.length,
     notesExp, notesOut,
+    mediaExp: mediaExpSet.size, mediaOut,
+    textExp, textMissing, chartShapesExp, chartShapesOut,
+    chartFramesMissing,
+    chartsExp: chartAudit.chartsExp, chartsOut: chartAudit.chartsOut,
+    chartEmbedsOut: chartAudit.embedsOut, chartSheetsChecked: chartAudit.sheetsChecked,
+    chartDataMismatch: chartAudit.dataMismatch, chartRelsMissing: [...chartAudit.relsMissing, ...chartRelMissing],
     ok: tablesExp === tablesOut && imagesExp === imagesOut && illegal === 0 &&
       lineProof.exp === lineProof.out && lineProof.wrong.length === 0 &&
-      notesExp === notesOut && notesRelOk,
+      notesExp === notesOut && notesRelOk && mediaExpSet.size === mediaOut &&
+      textMissing.length === 0 && chartShapesExp === chartShapesOut &&
+      chartFramesMissing.length === 0 && chartAudit.ok && chartRelMissing.length === 0,
   }
 
   // out：绝对路径原样使用；相对路径相对 deck 目录（反馈 E1 ★）
@@ -186,6 +344,12 @@ export async function exportPptx(ctx, { out = 'out.pptx', engine = 'pptd' } = {}
   report.file = outPath
   report.slides = slides.length
   report.engine = engine
+  // 原生图表清单（可观测，便于 smoke/验证脚本核对"第几个 chartN 是哪一页的哪个元素"）
+  if (nativeCharts.length) {
+    report.nativeCharts = nativeCharts.map((c) => ({ id: c.id, page: c.pageNo, chartNo: c.chartNo, part: c.names.chart, embed: c.names.embed }))
+  }
+  // 改名必须**可见**（不静默）：非 ASCII/空格或重名时部件名变了，报告里说明改成了什么。
+  if (renamedMedia.size) report.mediaRenamed = [...renamedMedia].map(([src, part]) => `${src} → ppt/media/${part}`)
   return report
 }
 
@@ -421,6 +585,24 @@ function tableFrame(el) {
 }
 
 // ── chart（矢量拼绘）───────────────────────────────────────────────────────
+/** 正则元字符转义（元素 id 可能含 `(`、`.` 等；用于"这个图表的形状有没有真的写进产物"）。 */
+function escapeRe(s) {
+  return String(s).replace(/[.*+?^${}()|[\]\\]/g, '\\$&')
+}
+
+/**
+ * 一个 chart 元素**应当**在产物里画出多少个形状（与下面的 `chartSp` 一一对应；改 chartSp 必须同步改这里）。
+ * bar：每个数值一根矩形；line：每系列 (点数−1) 条连接线 + 每个点一个圆点；pie：每个正数一个扇区。
+ */
+function chartShapeCountOf(el) {
+  const data = chartData(el.chart)
+  const kind = el.chart?.type
+  if (kind === 'bar') return data.series.reduce((n, s) => n + s.values.length, 0)
+  if (kind === 'line') return data.series.reduce((n, s) => n + Math.max(0, s.values.length - 1) + s.values.length, 0)
+  if (kind === 'pie') return (data.series[0]?.values ?? []).filter((v) => v > 0).length
+  return 0
+}
+
 function chartSp(el) {
   const x = el.bounds.x
   const y = el.bounds.y
@@ -490,7 +672,13 @@ function chartSp(el) {
 }
 
 // ── package parts ─────────────────────────────────────────────────────────
-function contentTypes(slides) {
+/**
+ * `[Content_Types].xml`。
+ * `nativeCharts`（第三轮）：每个 `ppt/charts/chartN.xml` 一条 Override（`drawingml.chart+xml`），
+ * 并补 `<Default Extension="xlsx">`（内嵌数据工作簿是 `ppt/embeddings/*.xlsx`）。
+ * 无原生图表的工程**逐字节不变**（老工程/回归样例零变化）。
+ */
+function contentTypes(slides, nativeCharts = []) {
   const notes = slides.filter((s) => s.notes)
   const overrides = [
     '<Override PartName="/ppt/presentation.xml" ContentType="application/vnd.openxmlformats-officedocument.presentationml.presentation.main+xml"/>',
@@ -502,6 +690,7 @@ function contentTypes(slides) {
     ...(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"/>'),
+    ...nativeCharts.map((c) => '<Override PartName="/' + c.names.chart + '" ContentType="application/vnd.openxmlformats-officedocument.drawingml.chart+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"/>'
@@ -509,6 +698,7 @@ function contentTypes(slides) {
     + '<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"/>'
+    + (nativeCharts.length ? '<Default Extension="xlsx" ContentType="application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"/>' : '')
     + overrides.join('') + '</Types>'
 }
 

package/lib/pptd/import-pptx.js

@@ -9,6 +9,7 @@ import { existsSync } from 'node:fs'
 import { join, basename } from 'node:path'
 import { zipRead, decodeXml } from '../zips.js'
 import { parseXml, children, first, allText } from '../xmljs.js'
+import { auditLoss, lossAuditLine, LOSS_AUDIT_FILE } from './loss-audit.js'
 
 const EMU = 12700
 const px = (emu) => Math.round(emu / EMU)
@@ -152,11 +153,22 @@ export async function importPptx(pptxPath, outDir) {
     elements: pages.flatMap((p) => p.elements.map((el) => ({ page: p.index + 1, id: el.elementId, ...(el._styleRaw ?? {}) }))),
   }
   await writeFile(join(outDir, 'import-styles.json'), JSON.stringify(stylesJson, null, 2))
+  // 启发 B（审计半）：重建有损审计——源稿里 DSL/导出无法保真的特性（动画/阴影/超链接/切换/
+  // SmartArt/不可嵌入媒体/主题渐变）。单独成文 loss-audit.json（理由见下方 return 注释），
+  // 工具输出用 lossAuditLine 给一行结论，支撑"只改某几页 ⇒ 优先 ppt_splice"的选择。
+  const lossAudit = auditLoss(files, { source: basename(pptxPath) })
+  await writeFile(join(outDir, LOSS_AUDIT_FILE), JSON.stringify(lossAudit, null, 2))
   const bgCount = pages.filter((p) => p.background).length
   const styleCount = Object.keys(stats.colors).length
   return {
     outDir, pages: pages.length, media: [...mediaNames], size: { width, height },
     reference: refPreviews?.length ? { previews: refPreviews, source: 'source.pptx' } : null,
+    // 启发 B：损失审计报告 + 一行结论（tools.js 的 ppt_import 只加这一行输出）。
+    // JSON 独立成 loss-audit.json（而非塞进 import-styles.json）：① 语义相反——styles 记"我们保住了什么"，
+    // audit 记"我们保不住什么"，混在一起会让"改版求一致直接复用 styles"的既有使用者读到无关字段；
+    // ② 生命周期不同：audit 是决策输入（改哪几页 / 要不要 splice），styles 是素材账本；
+    // ③ 独立文件名便于模型/用户直接定位与断言（smoke 无需解析既有 schema，向后兼容、零破坏）。
+    lossAudit, lossLine: lossAuditLine(lossAudit),
     warnings: ['chart 降级为文本占位；未映射 prst 形状近似为矩形（import-styles.json 有记录）',
       ...(missingMedia.length ? [`⚠ 原稿 ${missingMedia.length} 个媒体引用未提取（${missingMedia.join('、')}——rels 指向包外/特殊格式）：已在 media/ 生成 1×1 白色占位图，导出可用；建议人工替换或删除对应页面元素`] : []),
       ...(existsSync(join(outDir, 'source.pptx')) ? ['已保留原始 pptx ⊳ source.pptx（零失真真相层；参考双轨 v0.9.1）'] : []),