dsh-ppt-studio 1.1.0

package/scripts/dbg-media.mjs

@@ -0,0 +1,10 @@
+import { readFile } from 'node:fs/promises'
+import { join } from 'node:path'
+import { verifyDeck } from '../lib/verify.js'
+
+// 开发调试脚本（不在发布 files）；layout 路径经环境变量兜底，避免机器绑定
+const layout = process.env.DBG_LAYOUT ?? 'D:/SharkCode/dsh-ppt-studio/examples/overlap-smoke/preview/layout.json'
+const l = JSON.parse(await readFile(layout, 'utf8'))
+console.log(JSON.stringify(l.pages[0].elements.map((e) => ({ id: e.id, kind: e.kind, role: e.role, b: e.bounds })), null, 1))
+const v = verifyDeck(l)
+console.log(v.text)

package/scripts/dbg-tpl-inventory.mjs

@@ -0,0 +1,23 @@
+// 模板保真度盘点（临时诊断脚本）
+import { resolveDeck } from '../lib/pptd/schema.js'
+import { templateWorkspace, TEMPLATES_DIR } from '../lib/templates.js'
+import { readdir } from 'node:fs/promises'
+for (const id of (await readdir(TEMPLATES_DIR)).filter((n) => !n.startsWith('.'))) {
+  try {
+    const t = await templateWorkspace(id)
+    const ctx = await resolveDeck(t.dir)
+    const stats = { els: 0, lines: 0, texts: 0, shapes: 0, imgs: 0 }
+    for (const p of ctx.pages) {
+      for (const e of p.page.elements ?? []) {
+        stats.els++
+        if (e.elementType === 'line') stats.lines++
+        else if (e.elementType === 'text') stats.texts++
+        else if (e.elementType === 'shape') stats.shapes++
+        else if (e.elementType === 'image') stats.imgs++
+      }
+    }
+    console.log(`${id}: ${ctx.pages.length}页 ${stats.els}元素 (线${stats.lines}/文${stats.texts}/形${stats.shapes}/图${stats.imgs}) media=${t.media.length}`)
+  } catch (e) {
+    console.log(`${id}: FAIL ${e.message}`)
+  }
+}

package/scripts/dump-workflow-baseline.mjs

@@ -0,0 +1,38 @@
+/**
+ * 生成"工作流提示词基线"快照（用于「老用户不受影响」的可验证断言）。
+ *
+ * 为什么需要：用户反复强调"老用户更新后不能发现自己用不惯了"。所以每轮改动工作流段时，
+ * 必须有机器断言证明：**新段 ⊇ 旧段**（逐行超集）——只允许新增行，不允许改写/删除旧行。
+ * 本脚本在改动前跑一次，把当轮基线落到 scripts/fixtures/workflow-baseline.json。
+ *
+ * 用法：node scripts/dump-workflow-baseline.mjs
+ */
+import { writeFileSync, mkdirSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { workflowSection } from '../src/router.js'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+const variants = []
+for (const quick of [false, true]) {
+  for (const taskType of ['from-scratch', 'augment', 'edit', 'summarize', 'unknown']) {
+    const cfg = {
+      quick,
+      mode: 'auto',
+      fidelity: 'auto',
+      review: 'points',
+      quality: 'standard',
+      engine: 'auto',
+      template: null,
+      pauseAfter: [],
+      workflowActive: true,
+    }
+    const sec = workflowSection(taskType, cfg)
+    variants.push({ quick, taskType, name: sec.name, lines: sec.text.split('\n') })
+  }
+}
+const out = join(root, 'scripts', 'fixtures', 'workflow-baseline.json')
+mkdirSync(dirname(out), { recursive: true })
+writeFileSync(out, JSON.stringify({ note: '工作流提示词基线：新段必须是逐行超集（只增不改不删）', variants }, null, 2) + '\n', 'utf8')
+const total = variants.reduce((n, v) => n + v.lines.length, 0)
+console.log(`baseline 写入 ${out}：${variants.length} 个变体 / ${total} 行`)

package/scripts/e2e-1.0.mjs

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+/**
+ * 1.0.0 自包含端到端验证（不需要任何外部资产——夹具即案例）：
+ * ① 生成夹具 fx-pro(12页)/fx-mini(3页)/seed.pptx
+ * ② fx-pro：render → verify（断言 0 错误 / 声明命中 / 建议级仅提示）
+ * ③ crosscheck：审阅材料包（全页正文覆盖 + 不做判定；判定交审阅者）
+ * ④ measure（浏览器实测兜底：无浏览器自动降级并注明）
+ * ⑤ export → zip 结构（12 张 slide、无 chart 部件依赖）
+ * ⑥ splice（seed 第 3 页 ← fx-pro 第 6 页）→ 仅 2 条目变化；slice → 单页
+ * ⑦ Office COM（可用时）真渲染 spliced[3] / single[1]
+ * ⑧ 自产 seed 再导入 → 元素 id 唯一（导入去重回环验证）
+ */
+import { rm, mkdir, writeFile, readFile } from 'node:fs/promises'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { existsSync } from 'node:fs'
+import { genFixtures } from './fixtures.mjs'
+import { resolveDeck } from '../lib/pptd/schema.js'
+import { renderDeck } from '../lib/pptd/render-html.js'
+import { verifyDeck, measuredCrossCheck } from '../lib/verify.js'
+import { crosscheckDeck } from '../lib/crosscheck.js'
+import { exportPptx } from '../lib/pptd/export-pptx.js'
+import { importPptx } from '../lib/pptd/import-pptx.js'
+import { zipRead } from '../lib/zips.js'
+import { spliceIntoSource, sliceSource, zipDigests } from '../lib/splice.js'
+import { measureLayout } from '../lib/measurement.js'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+let pass = 0
+let fail = 0
+const ok = (name, cond, extra = '') => {
+  console.log(`${cond ? '✓' : '✗'} ${name}${extra ? `  — ${extra}` : ''}`)
+  cond ? pass++ : fail++
+}
+
+const { fx, seed, pages: seedPages } = await genFixtures()
+const pro = join(fx, 'fx-pro')
+const mini = join(fx, 'fx-mini')
+
+// ② fx-pro 全链路
+const ctx = await resolveDeck(pro)
+const rnd = await renderDeck(ctx, {})
+const v = verifyDeck(rnd.layout)
+const errLines = v.text.split('\n').filter((l) => l.includes('[✗]'))
+const confirmNotes = v.text.split('\n').filter((l) => l.includes('预期重叠') || l.includes('预期出界'))
+ok('② fx-pro verify 门禁 0 错误（声明制夹具）', errLines.length === 0, errLines.slice(0, 6).join(' | ').slice(0, 220))
+ok('② fx-pro 声明命中（预期重叠/预期出界确认出现）', confirmNotes.length > 0, `${confirmNotes.length} 条`)
+const hasDecor = v.text.includes('decoration') || v.text.includes('装饰')
+ok('② fx-pro 装饰豁免生效（09 页 deco 无重叠错误）', !errLines.some((l) => l.includes('deco')), '')
+const v08 = v.text.split('第 8 页')[1]?.split('## 第')[0] ?? ''
+ok('② fx-pro A8 场景无误报（08 页无 aesthetic-contrast——渐变深底白字不落背景）', !v08.includes('aesthetic-contrast'),
+  v08.match(/aesthetic-contrast|aesthetic-theme/g)?.join(',') ?? '')
+
+// ③ crosscheck = 内容审阅材料包（M3 重写 2026-09-18：数字必须放回整句语境，判定交审阅者）
+const cc = crosscheckDeck(ctx)
+const ccText = cc.pages.flatMap((p) => p.texts.map((t) => t.text)).join('\n')
+ok('③ 材料包覆盖全 12 页正文（含跨页 45.6% 原句；表格/图表/讲稿/作者出处字段齐备）',
+  cc.pages.length === seedPages && /45\.6%/.test(ccText)
+  && cc.pages.every((p) => Array.isArray(p.texts) && Array.isArray(p.tables) && Array.isArray(p.charts)
+    && Array.isArray(p.images) && typeof p.notes === 'string' && 'authorSource' in p),
+  `${cc.pages.length} 页 / 正文 ${ccText.length} 字符 / 素材清单 ${cc.materials.length} 项`)
+ok('③ 材料包不做判定（无 groups、无 status 状态机）——判定由审阅者按协议给出',
+  cc.groups === undefined && cc.pages.every((p) => p.status === undefined),
+  Object.keys(cc).join(', '))
+
+// ④ measure（浏览器；降级则标注不判失败）
+const m = await measureLayout(pro)
+if (m.measured) {
+  const x = measuredCrossCheck(rnd.layout, m.measured)
+  const bad = x.filter((f) => ['error', 'warning'].includes(f.severity))
+  ok('④ M2 实测（浏览器）→ 与估算零分歧', bad.length === 0, bad.slice(0, 3).map((f) => f.code).join(',') || `${m.pages} 页`)
+} else {
+  ok('④ M2 实测不可用（无浏览器/降级）——标注后继续', true, m.notes?.[0] ?? '')
+}
+
+// ⑤ export 结构
+const exp = await exportPptx(ctx, { out: join(fx, 'fx-pro.pptx'), engine: 'pptd' })
+const z = zipRead(await readFile(exp.file))
+const slides = [...z.keys()].filter((k) => /^ppt\/slides\/slide\d+\.xml$/.test(k))
+const chartParts = [...z.keys()].filter((k) => k.startsWith('ppt/charts/'))
+ok('⑤ export = 12 张 slide + 无 chart 部件（矢量拼绘）', slides.length === seedPages && chartParts.length === 0, `${slides.length} slides`)
+// 连线方向自证（2026-09-14 真实反馈：预览对、PowerPoint 里线镜像/× 掉一笔）
+ok('⑤ export parity 自证：表/图/线方向全绿（线逐条从 OOXML 反推端点）',
+  exp.parity?.ok === true && exp.parity.linesExp > 0 && exp.parity.linesExp === exp.parity.linesOut && exp.parity.linesWrong === 0,
+  JSON.stringify(exp.parity))
+
+// ⑥ splice / slice（自产 seed：12 页同源工程）
+const spl = await spliceIntoSource({ deckDir: pro, source: seed, page: 6, sourcePage: 3, out: join(fx, 'spliced.pptx') })
+const sd = zipDigests(await readFile(seed))
+const od = zipDigests(await readFile(spl.out))
+const delta = [...sd.keys()].filter((k) => sd.get(k) !== od.get(k))
+ok('⑥ splice：仅目标页 2 条目变化（其余 SHA256 一致）', delta.length === 2 && spl.unchangedCount > 0,
+  `delta=${JSON.stringify(delta)} unchanged=${spl.unchangedCount}`)
+const slc = await sliceSource({ source: spl.out, page: 3, out: join(fx, 'single.pptx') })
+const zs = zipRead(await readFile(slc.out))
+const sSingle = [...zs.keys()].filter((k) => /^ppt\/slides\/slide\d+\.xml$/.test(k))
+ok('⑥ slice：仅 1 张 slide + 母版布局保留', sSingle.length === 1 && slc.masters >= 1 && slc.layouts >= 1, `m=${slc.masters} l=${slc.layouts}`)
+
+// ⑦ Office COM（可选）
+const { findPowerPoint, renderPptxToPng } = await import('../lib/msrender.js')
+if (findPowerPoint()) {
+  // P5 回归：多页参数 pages=[1,3] 应产出两页 PNG（此前 "4,1" 被 PS 解析成 41）
+  const r1 = await renderPptxToPng(spl.out, join(fx, 'ren-spliced'), { pages: [1, 3], timeoutMs: 150000 })
+  const r2 = await renderPptxToPng(slc.out, join(fx, 'ren-single'), { pages: [1], timeoutMs: 150000 })
+  ok('⑦ Office COM 真渲染：spliced pages=[1,3]（多页 P5 回归）+ single[1] 产出 PNG',
+    r1.files.length === 2 && r2.files.length === 1,
+    `spliced=${r1.files.map((f) => f.split(/[\\/]/).pop()).join(',')} single=${r2.files[0]?.split(/[\\/]/).pop()}`)
+} else {
+  ok('⑦ Office COM 不可用——标注后继续', true, '无 PowerPoint')
+}
+
+// ⑧ 自产 seed 再导入 → id 唯一 + 可渲染（导入去重回环）
+const reDir = join(fx, 'reimport')
+const ri = await importPptx(exp.file, reDir)
+const fsp = await import('node:fs/promises')
+const pageFiles = (await fsp.readdir(join(reDir, 'pages'))).filter((f) => f.endsWith('.yaml'))
+let dup = null
+for (const f of pageFiles) {
+  const txt = await readFile(join(reDir, 'pages', f), 'utf8')
+  const ids = (txt.match(/elementId: .+$/gm) ?? []).map((s) => s.replace(/^.*elementId: /, '').trim())
+  const seen = new Set()
+  for (const id of ids) { if (seen.has(id)) { dup = id; break } seen.add(id) }
+  if (dup) break
+}
+ok('⑧ 自产 seed 回导：无重复 elementId（导入去重 P5 有效）', dup === null, dup ? `dup=${dup}` : `${pageFiles.length} pages`)
+await rm(reDir, { recursive: true, force: true })
+
+console.log(`\n==== E2E(1.0.0) 结果：${pass} 通过 / ${fail} 失败 ====`)
+process.exit(fail > 0 ? 1 : 0)

package/scripts/eval-skills-blind.mjs

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+/**
+ * eval-skills-blind.mjs —— 把两个 arm 的产物**匿名化 + 随机化**，生成盲评材料（配合 docs/06 §7.6 协议）。
+ *
+ * 为什么需要：内置技能是"软收益"，自评容易有偏；照 docs/06 的方法做**结构化盲评**时，
+ * 必须让评审员只看到产物、看不到来源（否则会从目录名/命名习惯猜到哪份是"新版"）。
+ *
+ * 产出（<out> 下）：
+ *   <out>/盲评-1/deck/{deck.yaml,pages/*.yaml}   源描述（可读文本）
+ *   <out>/盲评-1/render/NN.png                   Office 真渲染整页（有 Office 时；无则跳过并提示）
+ *   <out>/盲评-2/…                               另一份
+ *   <out>/mapping.json                           真实映射（**只留档，不给评审员**）
+ *
+ * 用法：node scripts/eval-skills-blind.mjs <deckA 目录> <deckB 目录> [--out <目录>]
+ */
+import { readFileSync, writeFileSync, mkdirSync, rmSync, existsSync, readdirSync, copyFileSync } from 'node:fs'
+import { join, resolve } from 'node:path'
+import { dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { resolveDeck } from '../lib/pptd/schema.js'
+import { exportPptx } from '../lib/pptd/export-pptx.js'
+import { renderPptxToPng, findPowerPoint } from '../lib/msrender.js'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+const args = process.argv.slice(2)
+const opt = (k, d) => {
+  const i = args.indexOf(k)
+  return i >= 0 && args[i + 1] ? args[i + 1] : d
+}
+const positional = args.filter((a, i) => !a.startsWith('--') && !(i > 0 && args[i - 1].startsWith('--')))
+if (positional.length < 2) {
+  console.error('用法：node scripts/eval-skills-blind.mjs <deckA 目录> <deckB 目录> [--out <目录>]')
+  process.exit(2)
+}
+const [dirA, dirB] = positional
+const outRoot = resolve(opt('--out', join(root, 'examples', 'blind-review')))
+
+/** 找到目录下的 deck（本身是 deck 目录，或第一层子目录里含 deck.yaml）。 */
+function deckOf(dir) {
+  const base = resolve(dir)
+  if (existsSync(join(base, 'deck.yaml'))) return base
+  for (const e of readdirSync(base, { withFileTypes: true })) {
+    if (e.isDirectory() && existsSync(join(base, e.name, 'deck.yaml'))) return join(base, e.name)
+  }
+  throw new Error(`找不到 deck.yaml：${dir}`)
+}
+
+rmSync(outRoot, { recursive: true, force: true })
+mkdirSync(outRoot, { recursive: true })
+
+// 随机分配：真 = 第一份放「盲评-1」
+const aFirst = Math.random() < 0.5
+const order = aFirst ? [['A', dirA], ['B', dirB]] : [['B', dirB], ['A', dirA]]
+const hasOffice = findPowerPoint() !== null
+
+const mapping = {}
+for (let i = 0; i < order.length; i++) {
+  const [arm, dir] = order[i]
+  const label = `盲评-${i + 1}`
+  mapping[label] = { arm, source: resolve(dir) }
+  const deckDir = deckOf(dir)
+  const target = join(outRoot, label)
+  mkdirSync(join(target, 'deck', 'pages'), { recursive: true })
+  copyFileSync(join(deckDir, 'deck.yaml'), join(target, 'deck', 'deck.yaml'))
+  for (const f of readdirSync(join(deckDir, 'pages'))) {
+    if (f.endsWith('.yaml')) copyFileSync(join(deckDir, 'pages', f), join(target, 'deck', 'pages', f))
+  }
+  // 取 pptx：优先复用已有 out.pptx，否则现导一份（不污染原目录的 deck.yaml）
+  let pptx = join(deckDir, 'out.pptx')
+  if (!existsSync(pptx)) {
+    const ctx = await resolveDeck(deckDir)
+    const r = await exportPptx(ctx, { out: join(target, 'blind-export.pptx'), engine: 'pptd' })
+    pptx = r.file
+    const out = ctx.pages.length === 1 ? 1 : r.slides
+    void out
+  }
+  if (hasOffice) {
+    try {
+      const r = await renderPptxToPng(pptx, join(target, 'render'), { noWatermark: true })
+      console.log(`${label}: ${arm} → Office 真渲染 ${r.pages} 页`)
+    } catch (error) {
+      console.log(`${label}: ${arm} → Office 渲染失败（${String(error?.message ?? error).split('\n')[0].slice(0, 80)}）——评审退化为只看文本`)
+    }
+  } else {
+    console.log(`${label}: ${arm} → 本机无 Office，跳过真渲染（评审只看文本，需在结论中标注）`)
+  }
+  console.log(`   源 deck：${deckDir}`)
+}
+writeFileSync(join(outRoot, 'mapping.json'), JSON.stringify({ aFirst, hasOffice, mapping }, null, 2) + '\n', 'utf8')
+console.log('\n真实映射（只留档，勿给评审员）：', JSON.stringify(mapping))
+console.log('盲评材料：', outRoot)

package/scripts/eval-skills-score.mjs

@@ -0,0 +1,129 @@
+#!/usr/bin/env node
+/**
+ * eval-skills-score.mjs —— 内置技能效果对照的**打分器**（纯本地，不调用模型）
+ *
+ * 用途：把两个 arm 各自产出的 deck 目录按同一口径度量，输出对照表。配合 docs/06 §7 的手工流程使用：
+ *   ① 用**前一版**包跑一次（无新技能）→ 产物 deckA
+ *   ② 用**当前**包跑一次（含新技能）→ 产物 deckB（两臂输入必须是同一份 brief）
+ *   ③ node scripts/eval-skills-score.mjs --a <deckA 目录> --b <deckB 目录>
+ * 门禁指标由本仓库的同一个 lib 事后复算，避免"自己评自己"。
+ *
+ * 指标：页数 / 元素数 / 文本字数 / 图表与表格数 / [✗]错误 / [⚠]警告 / [·]建议 /
+ *       AI 味信号命中（按 ppt-studio-copy §4-5 的信号表扫描页面文本）/ 标注 source 的页数。
+ *
+ * 用法：node scripts/eval-skills-score.mjs --a <dir> --b <dir> [--label-a X] [--label-b Y] [--out RESULT.md]
+ */
+import { writeFileSync, existsSync, readdirSync, statSync } from 'node:fs'
+import { join, dirname, resolve } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { resolveDeck } from '../lib/pptd/schema.js'
+import { renderDeck } from '../lib/pptd/render-html.js'
+import { verifyDeck } from '../lib/verify.js'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+const args = process.argv.slice(2)
+const opt = (k, d) => {
+  const i = args.indexOf(k)
+  return i >= 0 && args[i + 1] ? args[i + 1] : d
+}
+
+/** AI 味信号（与 ppt-studio-copy §4/§5 对齐；成组才算 tell，这里只做粗计数）。 */
+const AI_SIGNALS = [
+  ['里程碑/仪式感', /里程碑|标志着|见证了|是.{0,6}的体现|新篇章/],
+  ['宣传腔', /充满活力|令人瞩目|业界领先|坐落于|蓬勃发展|未来可期|迈上新台阶/],
+  ['模糊归因', /行业报告显示|专家认为|普遍认为|相关研究表明/],
+  ['否定式排比', /不仅.{0,18}(?:更|而且|还)|不是.{0,14}而是/],
+  ['填充连接词', /此外|与此同时|值得注意的是|深入探讨|格局/],
+  ['破折号揭示', /——/],
+  ['通用积极结尾', /坚定信心|再创佳绩|持续向好|奠定了坚实基础/],
+  ['系动词回避', /作为.{0,10}(?:的)?(?:重要|关键|核心)|拥有.{0,8}能力/],
+]
+
+/** 允许直接给 deck 目录，或给一个"里面第一个含 deck.yaml 的子目录"的父目录。 */
+function deckOf(dir) {
+  if (existsSync(join(dir, 'deck.yaml'))) return dir
+  try {
+    for (const e of readdirSync(dir, { withFileTypes: true })) {
+      if (e.isDirectory() && existsSync(join(dir, e.name, 'deck.yaml'))) return join(dir, e.name)
+    }
+  } catch { /* 目录不存在 */ }
+  return null
+}
+
+async function score(label, dir) {
+  const out = { label, deck: null }
+  const deckDir = deckOf(resolve(dir))
+  if (deckDir === null) return { ...out, error: `未在 ${dir} 下找到 deck.yaml` }
+  out.deck = deckDir
+  const ctx = await resolveDeck(deckDir)
+  const r = await renderDeck(ctx, {})
+  const v = verifyDeck(r.layout)
+  const lines = v.text.split('\n')
+  out.gates = {
+    errors: lines.filter((l) => l.includes('[✗]')).length,
+    warnings: lines.filter((l) => l.includes('[⚠]')).length,
+    suggestions: lines.filter((l) => l.includes('[·]')).length,
+  }
+  const texts = []
+  let elements = 0
+  let charts = 0
+  let tables = 0
+  for (const p of ctx.pages) {
+    for (const el of p.page.elements ?? []) {
+      elements++
+      if (el.elementType === 'chart') charts++
+      if (el.elementType === 'table') tables++
+      if (el.elementType === 'text') texts.push(String(el.content?.text ?? ''))
+    }
+  }
+  const all = texts.join('\n')
+  out.scale = { pages: ctx.pages.length, elements, charts, tables, textChars: all.length }
+  out.aiSignals = AI_SIGNALS
+    .map(([name, re]) => [name, (all.match(new RegExp(re.source, 'g')) ?? []).length])
+    .filter(([, n]) => n > 0)
+  out.aiTotal = out.aiSignals.reduce((n, [, c]) => n + c, 0)
+  out.dataQuality = {
+    pagesWithSource: ctx.pages.filter((p) => typeof p.page.source === 'string' && p.page.source.trim().length > 0).length,
+    unitKindsPresent: ['%', '小时', '分钟', '园区', '人'].filter((u) => all.includes(u)).length,
+    hasChart: charts > 0,
+    hasTable: tables > 0,
+    valueMentions: (all.match(/\d+/g) ?? []).length,
+  }
+  return out
+}
+
+const dirA = opt('--a')
+const dirB = opt('--b')
+if (dirA === undefined || dirB === undefined) {
+  console.error('用法：node scripts/eval-skills-score.mjs --a <deckA 目录> --b <deckB 目录> [--label-a X] [--label-b Y] [--out RESULT.md]')
+  process.exit(2)
+}
+const A = await score(opt('--label-a', 'A'), dirA)
+const Bd = await score(opt('--label-b', 'B'), dirB)
+
+const md = []
+md.push('# 内置技能效果对照（同一 brief、同一模型、同一装配下的两个 arm）', '')
+md.push('| 指标 | A | B |', '|---|---|---|')
+const row = (k, f) => md.push(`| ${k} | ${f(A)} | ${f(Bd)} |`)
+row('页数', (x) => x.scale?.pages ?? '—')
+row('元素数', (x) => x.scale?.elements ?? '—')
+row('文本总字数', (x) => x.scale?.textChars ?? '—')
+row('图表数 / 表格数', (x) => `${x.scale?.charts ?? '—'} / ${x.scale?.tables ?? '—'}`)
+row('门禁错误 [✗]', (x) => x.gates?.errors ?? '—')
+row('门禁警告 [⚠]', (x) => x.gates?.warnings ?? '—')
+row('审美建议 [·]', (x) => x.gates?.suggestions ?? '—')
+row('AI 味信号命中', (x) => x.aiTotal ?? '—')
+row('标注 source 的页数', (x) => x.dataQuality?.pagesWithSource ?? '—')
+row('出现的单位种类', (x) => x.dataQuality?.unitKindsPresent ?? '—')
+md.push('', '## 明细', '')
+for (const x of [A, Bd]) md.push(`### ${x.label}${x.deck ? `（${x.deck}）` : ''}`, '', '```json', JSON.stringify(x, null, 2), '```', '')
+const text = md.join('\n')
+console.log(text)
+const outFile = opt('--out')
+if (outFile !== undefined) {
+  writeFileSync(outFile, text + '\n', 'utf8')
+  console.log(`\n（已写入 ${outFile}）`)
+}
+if (A.error !== undefined || Bd.error !== undefined) process.exit(1)
+void statSync
+void root

package/scripts/export-orig-templates.ps1

@@ -0,0 +1,17 @@
+# 原始模板逐页 PNG 导出（保真对照用）：PowerPoint COM（本机有 Office 时可用）
+param([string]$Src = 'C:\Users\11867\Desktop\ppt模板库', [string]$Out = 'C:\Users\11867\.dsh\ppt-studio\fidelity\orig')
+$pp = New-Object -ComObject PowerPoint.Application
+$pp.Visible = -1
+foreach ($f in Get-ChildItem $Src -Filter '*.pptx') {
+  $dir = Join-Path $Out $f.BaseName
+  New-Item -ItemType Directory -Force -Path $dir | Out-Null
+  $pres = $pp.Presentations.Open($f.FullName, -1, 0, 0)
+  $n = $pres.Slides.Count
+  for ($i = 1; $i -le $n; $i++) {
+    $pres.Slides.Item($i).Export((Join-Path $dir ('{0:D2}.png' -f $i)), 'PNG', 1920, 1080)
+  }
+  $pres.Close()
+  Write-Output ("{0}: {1} slides" -f $f.Name, $n)
+}
+$pp.Quit()
+Write-Output 'DONE'