dsh-ppt-studio 1.1.0

package/lib/measurement.js

@@ -0,0 +1,209 @@
+/**
+ * M2 文本实测档（渲染回读精确测量，D3 落地）：
+ * 浏览器真测量通道——Edge headless 加载预览 HTML，页面内 JS 采集每个元素的实际
+ * 排版几何（getBoundingClientRect / Range.getClientRects 行盒 / scrollHeight），
+ * JSON 回传（<script id="__ppt_measured"> 注入 DOM，--dump-dom 提取）。
+ * 输出 preview/measured.json（measured 档）供 ppt_verify measured=true 消费。
+ *
+ * 与估算的关系（D3）：实测=终审、估算=预检——估算报错必须处理（保持门禁）；
+ * 实测报错（估算没报）= M2 的核心捕获（估算漏报 → 新增 error）；
+ * 无浏览器/路径失败 → 降级估算 + 标注"未实测"（绝不静默）。
+ *
+ * 诚实声明：测量 = Chromium 排版真值（系统字库）——仍非 PowerPoint 引擎；
+ * 与 ppt_shot 同一渲染链（HTML 预览），因此字体/尺寸差异同源。
+ */
+import { readFile, writeFile, mkdir, rm, cp, readdir } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { spawn } from 'node:child_process'
+import { fileURLToPath } from 'node:url'
+
+export function findEdge() {
+  const candidates = [
+    'C:\\Program Files (x86)\\Microsoft\\Edge\\Application\\msedge.exe',
+    'C:\\Program Files\\Microsoft\\Edge\\Application\\msedge.exe',
+    'C:\\Program Files\\Google\\Chrome\\Application\\chrome.exe',
+    'C:\\Program Files (x86)\\Google\\Chrome\\Application\\chrome.exe',
+  ]
+  for (const c of candidates) if (existsSync(c)) return c
+  return null
+}
+
+/**
+ * 测量脚本（注入每个页面 HTML 尾部）：
+ * 文本元素 → 行盒（Range.getClientRects）行数/内容高/溢出；其余元素 → 实际几何对照。
+ * 结果写入 <script id="__ppt_measured" type="application/json">，dump-dom 可提取。
+ */
+const MEASURE_JS = `(function(){
+  function collect(){
+    var out=[];
+    var els=document.querySelectorAll('.el');
+    for(var i=0;i<els.length;i++){
+      var el=els[i]; var r=el.getBoundingClientRect();
+      var rec={id:el.id,kind:el.dataset.kind||el.dataset.shape||'',x:Math.round(r.left*100)/100,y:Math.round(r.top*100)/100,w:Math.round(r.width*100)/100,h:Math.round(r.height*100)/100};
+      if(el.dataset&&el.dataset.kind==='text'){
+        var rects=[];
+        var walker=document.createTreeWalker(el,NodeFilter.SHOW_TEXT);
+        var n;
+        while((n=walker.nextNode())){
+          if(!n.textContent||!n.textContent.trim())continue;
+          var rng=document.createRange();
+          rng.selectNodeContents(n);
+          var qs=rng.getClientRects();
+          for(var j=0;j<qs.length;j++)rects.push(qs[j]);
+        }
+        var tops=[];
+        for(var k=0;k<rects.length;k++){var t=Math.round(rects[k].top*10)/10;if(tops.indexOf(t)<0)tops.push(t);}
+        rec.lines=tops.length;
+        rec.clientHeight=el.clientHeight;
+        rec.contentHeight=el.scrollHeight;
+        rec.overflowY=Math.round((el.scrollHeight-el.clientHeight)*10)/10;
+      }
+      out.push(rec);
+    }
+    return out;
+  }
+  window.addEventListener('load',function(){setTimeout(function(){
+    var s=document.createElement('script');
+    s.id='__ppt_measured';s.type='application/json';
+    try{s.textContent=JSON.stringify(collect());}catch(e){s.textContent='{"__error":'+JSON.stringify(String(e))+'}'}
+    document.head.appendChild(s);
+  },250)});
+})();`
+
+const xmlEscape = (s) => String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;')
+
+/** 注入测量脚本到 HTML（返回新内容）。script 是 raw text：内容原样嵌入（不实体转义——JS 里的 < 会被转坏）。 */
+export function injectMeasureScript(html) {
+  const tag = `<script>\n${MEASURE_JS}\n</script>`
+  if (!html.includes('</body>')) return html + tag
+  return html.replace('</body>', tag + '\n</body>')
+}
+
+/** 从 dump-dom 输出提取 __ppt_measured JSON。 */
+export function extractMeasured(dom) {
+  const m = /<script id="__ppt_measured"[^>]*>([\s\S]*?)<\/script>/.exec(dom)
+  if (!m) return null
+  try {
+    const data = JSON.parse(m[1])
+    return data && typeof data === 'object' ? data : null
+  } catch {
+    return null
+  }
+}
+
+/**
+ * 测量一个 deck 项目：render → 每页注入脚本 → Edge dump-dom → 采集 → preview/measured.json。
+ * @param dir deck 目录
+ * @returns { measured, outDir, browser, pages, notes }（measured.json 已写入 preview/）
+ */
+export async function measureLayout(dir, { edge } = {}) {
+  const { resolveDeck } = await import('./pptd/schema.js')
+  const { renderDeck } = await import('./pptd/render-html.js')
+  const ctx = await resolveDeck(dir)
+  const r = await renderDeck(ctx, {})
+  const browser = edge ?? findEdge()
+  const notes = []
+  if (!browser) {
+    notes.push('⚠ 未检测到 Edge/Chrome：实测档不可用（降级估算 + 标注"未实测"）——请用 ppt_verify 保持估算门禁')
+    return { measured: null, outDir: r.outDir, browser: null, pages: 0, notes }
+  }
+  // 每次运行用**唯一**临时目录：上一轮 Edge 退出慢会短暂锁住 profile（EBUSY），
+  // 用固定目录名会让"连续两次 ppt_measure"直接崩（2026-09-14 自检实测）。
+  const tmp = join(dir, 'preview', `_measure-tmp-${process.pid}-${Date.now().toString(36)}`)
+  // 先清理历史遗留（跳过本次目录，尽力而为：锁住就留到下次），再建自己的目录
+  await sweepStaleMeasureTmp(join(dir, 'preview'), tmp)
+  await mkdir(tmp, { recursive: true })
+  const pages = []
+  const t0 = Date.now()
+  try {
+    // 并发测量（D5 基准：顺序 3.2s/页 → 并发 4 ≈ 0.9s/页；Edge 每页独立实例无共享状态）
+    const CONCURRENCY = 4
+    const jobs = r.htmlFiles.map((f, i) => ({ f, i }))
+    let cursor = 0
+    const results = new Array(r.htmlFiles.length).fill(null)
+    const errors = new Array(r.htmlFiles.length).fill(null)
+    const worker = async () => {
+      while (cursor < jobs.length) {
+        const idx = cursor++
+        const { f, i } = jobs[idx]
+        try {
+          const src = join(r.outDir, f)
+          const html = injectMeasureScript(await readFile(src, 'utf8'))
+          const probe = join(tmp, `p${i + 1}.html`)
+          await writeFile(probe, html, 'utf8')
+          // 独立 user-data-dir：Edge 多实例共用默认 profile → Singleton 锁串行化 + 变慢（shotOne 同款修复）
+          const profile = join(tmp, `profile-${i + 1}`)
+          await mkdir(profile, { recursive: true })
+          const url = 'file:///' + probe.replace(/\\/g, '/')
+          const dom = await new Promise((resolve, reject) => {
+            const child = spawn(browser, ['--headless=new', '--disable-gpu', '--no-first-run', '--hide-scrollbars',
+              '--dump-dom', '--virtual-time-budget=2500', `--user-data-dir=${profile}`,
+              `--window-size=${ctx.size.width},${ctx.size.height}`, url], { stdio: ['ignore', 'pipe', 'pipe'], windowsHide: true })
+            let outBuf = ''
+            child.stdout.on('data', (d) => { outBuf += d })
+            child.on('error', reject)
+            child.on('exit', (code) => code === 0 ? resolve(outBuf) : reject(new Error(`Edge 退出码 ${code}`)))
+          })
+          const data = extractMeasured(dom)
+          if (!data) { errors[idx] = `第 ${i + 1} 页测量回传失败（DOM 提取空）`; continue }
+          if (data.__error) { errors[idx] = `第 ${i + 1} 页测量脚本异常：${data.__error}`; continue }
+          // pageNo = 1 基页号（**跨档配对键**，与 layout.json 同名字段）；index = 内部数组下标（0 基）。
+          // 【2026-09-18 修】此前这里只有 `index: i + 1`（1 基），而 layout.json 的 index 是 0 基，
+          // 两者被 measuredCrossCheck 按 `index` 相等配对 ⇒ **永远配不上**、M2 通道恒返空结果（假绿灯）。
+          // 语义分工写死在这里：index = 数组下标，pageNo = 页号。
+          results[idx] = { pageNo: i + 1, index: i, file: f, elements: data }
+        } catch (e) {
+          errors[idx] = `第 ${i + 1} 页测量失败：${String(e)}`
+        }
+      }
+    }
+    await Promise.all(Array.from({ length: CONCURRENCY }, () => worker()))
+    for (let i = 0; i < results.length; i++) {
+      if (results[i]) pages.push(results[i])
+      else if (errors[i]) notes.push(`⚠ ${errors[i]}；该页无实测数据`)
+    }
+  } finally {
+    // 尽力而为 + 短重试：Edge 句柄释放有延迟，EBUSY/EPERM 不该让测量失败
+    await rmWithRetry(tmp)
+  }
+  const measured = {
+    browser: 'Edge/Chrome headless',
+    ts: new Date().toISOString(),
+    size: { width: ctx.size.width, height: ctx.size.height },
+    pages,
+  }
+  await writeFile(join(r.outDir, 'measured.json'), JSON.stringify(measured, null, 2))
+  return { measured, outDir: r.outDir, browser, pages: pages.length, notes, elapsedMs: Date.now() - t0 }
+
+/**
+ * 删除目录：对 EBUSY/EPERM 做短重试后放弃（临时目录清理不该让主流程失败）。
+ * Edge 退出后句柄释放有延迟，Windows 上尤其明显。
+ */
+async function rmWithRetry(target, attempts = 5) {
+  for (let i = 0; i < attempts; i++) {
+    try {
+      await rm(target, { recursive: true, force: true })
+      return true
+    } catch (error) {
+      const code = error?.code
+      if (code !== 'EBUSY' && code !== 'EPERM' && code !== 'ENOTEMPTY') return false
+      await new Promise((r) => setTimeout(r, 120 * (i + 1)))
+    }
+  }
+  return false
+}
+
+/** 清理历史遗留的 `_measure-tmp*`（跳过 keep＝本次目录；被锁住就留到下次）。 */
+async function sweepStaleMeasureTmp(previewDir, keep) {
+  try {
+    const entries = await readdir(previewDir, { withFileTypes: true })
+    for (const e of entries) {
+      if (!e.isDirectory() || !e.name.startsWith('_measure-tmp')) continue
+      const full = join(previewDir, e.name)
+      if (keep !== undefined && full === keep) continue
+      await rmWithRetry(full, 2)
+    }
+  } catch { /* 目录不存在或不给读：忽略 */ }
+}
+}

package/lib/msrender.js

@@ -0,0 +1,123 @@
+/**
+ * Office 真渲染通道（v0.8.0，问题 2 落地）：
+ * 有 Microsoft Office 时，用 PowerShell + PowerPoint COM 把任意 .pptx 逐页渲染成 PNG——
+ * ① 理解用户原稿（先看后做）② 成品视觉审核（P2-2 的 Office 答案）③ 原版 vs 导入版对照。
+ * 无 Office 时 findPowerPoint() 返回 null，整条通道自动隐藏（不影响既有工作流）。
+ * 安全：只读打开 + finally Quit + 超时 kill 残留 POWERPNT 进程。
+ */
+import { writeFile, mkdir, rm } from 'node:fs/promises'
+import { existsSync, readdirSync } from 'node:fs'
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { spawn } from 'node:child_process'
+import { tmpdir } from 'node:os'
+
+const PS1 = `param(
+  [string]$Pptx,
+  [string]$Out,
+  [int]$W = 1920,
+  [int]$H = 1080,
+  [string]$PagesJson = '',
+  [switch]$NoWatermark
+)
+$ErrorActionPreference = 'Stop'
+$pp = $null
+try {
+  $pp = New-Object -ComObject PowerPoint.Application
+  $pp.Visible = -1
+  $pres = $pp.Presentations.Open($Pptx, -1, 0, 0)
+  $n = $pres.Slides.Count
+  New-Item -ItemType Directory -Force -Path $Out | Out-Null
+  # P5 修复：多页解析（"4,1" 按逗号拆——此前 -Pages 4,1 被绑定成 41）
+  $list = if ($PagesJson -ne '') { ($PagesJson -split ',') | ForEach-Object { [int]$_ } | Sort-Object -Unique } else { 1..$n }
+  foreach ($i in $list) {
+    $pres.Slides.Item($i).Export((Join-Path $Out ('{0:D2}.png' -f $i)), 'PNG', $W, $H)
+  }
+  $pres.Close()
+  # P9：真渲染图叠加轻量比例标注（1px=1pt · 960×540）+ 细边框——降低人工读图坐标误判
+  if (-not $NoWatermark) {
+    Add-Type -AssemblyName System.Drawing
+    foreach ($f in Get-ChildItem $Out -Filter '*.png') {
+      try {
+        $img = [System.Drawing.Image]::FromFile($f.FullName)
+        $g = [System.Drawing.Graphics]::FromImage($img)
+        $g.SmoothingMode = 'AntiAlias'
+        $font = New-Object System.Drawing.Font('Microsoft YaHei', 12, [System.Drawing.FontStyle]::Regular)
+        $brush = New-Object System.Drawing.SolidBrush([System.Drawing.Color]::FromArgb(110, 60, 60, 60))
+        $g.DrawString('1px=1pt · 960×540（比例参考）', $font, $brush, 8, ($img.Height - 34))
+        $pen = New-Object System.Drawing.Pen([System.Drawing.Color]::FromArgb(80, 90, 90, 90), 1)
+        $g.DrawRectangle($pen, 0, 0, ($img.Width - 1), ($img.Height - 1))
+        $g.Dispose(); $img.Dispose(); $font.Dispose(); $brush.Dispose(); $pen.Dispose()
+      } catch { }
+    }
+  }
+  Write-Output ("OK:" + $list.Count)
+} finally {
+  if ($pp) { try { $pp.Quit() } catch { } }
+}
+`
+
+const EDGE_CANDIDATES = [
+  'C:\\Program Files (x86)\\Microsoft Office\\root\\Office16\\POWERPNT.EXE',
+  'C:\\Program Files\\Microsoft Office\\root\\Office16\\POWERPNT.EXE',
+  'C:\\Program Files\\Microsoft Office\\root\\Office16\\POWERPNT.EXE',
+  'C:\\Program Files (x86)\\Microsoft Office\\root\\Office15\\POWERPNT.EXE',
+  'C:\\Program Files\\Microsoft Office\\root\\Office15\\POWERPNT.EXE',
+]
+
+/** 能力探测：本机是否有 PowerPoint（后续真用 COM 时再验证，失败视为不可用）。 */
+export function findPowerPoint() {
+  for (const p of EDGE_CANDIDATES) if (existsSync(p)) return p
+  const base = ['C:\\Program Files\\Microsoft Office', 'C:\\Program Files (x86)\\Microsoft Office']
+  for (const b of base) {
+    try {
+      const found = readdirSync(b).filter((d) => /^Office\d+$/.test(d)).map((d) => join(b, d, 'POWERPNT.EXE')).find((p) => existsSync(p))
+      if (found) return found
+    } catch { /* 目录不存在 */ }
+  }
+  return null
+}
+
+/**
+ * 渲染 pptx → 逐页 PNG。
+ * @returns { pages, outDir, files }；COM 不可用/渲染失败抛错（调用方负责降级）。
+ */
+export async function renderPptxToPng(pptx, outDir, { width = 1920, height = 1080, timeoutMs = 240000, pages, noWatermark = false } = {}) {
+  if (!existsSync(pptx)) throw new Error(`pptx 不存在：${pptx}`)
+  await mkdir(outDir, { recursive: true })
+  const ps1 = join(tmpdir(), `dsh-ppt-render-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.ps1`)
+  await writeFile(ps1, '\ufeff' + PS1, 'utf8') // BOM：Windows PowerShell 5.1 按 GBK 读无 BOM 文件 → 中文路径乱码
+  try {
+    const args = ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File', ps1,
+      '-Pptx', pptx, '-Out', outDir, '-W', String(width), '-H', String(height)]
+    // A5/P5：按页渲染（单参数 JSON 串，避免 PS 数组绑定把 "4,1" 解析成 41）；水印默认开（P9）
+    if (pages && pages.length) args.push('-PagesJson', pages.join(','))
+    if (noWatermark) args.push('-NoWatermark')
+    const stdout = await new Promise((resolve, reject) => {
+      const child = spawn('powershell.exe', args, { windowsHide: true, stdio: ['ignore', 'pipe', 'pipe'] })
+      let out = ''
+      let err = ''
+      child.stdout.on('data', (d) => { out += d })
+      child.stderr.on('data', (d) => { err += d })
+      const killer = setTimeout(() => { child.kill('SIGKILL'); reject(new Error(`PowerPoint 渲染超时（${timeoutMs}ms）`)) }, timeoutMs)
+      child.on('exit', (code) => {
+        clearTimeout(killer)
+        code === 0 ? resolve(out) : reject(new Error(`PowerPoint COM 渲染失败（code ${code}）：${(err || out).slice(0, 500)}`))
+      })
+      child.on('error', (e) => { clearTimeout(killer); reject(e) })
+    })
+    const m = stdout.match(/OK:(\d+)/)
+    const files = []
+    if (m) {
+      // 文件名 = 原页号（两位数补零）；按参数/全量存在者收集
+      const find = pages && pages.length ? pages : Array.from({ length: Number(m[1]) }, (_, i) => i + 1)
+      for (const i of find) {
+        const f = join(outDir, `${String(i).padStart(2, '0')}.png`)
+        if (existsSync(f)) files.push(f)
+      }
+    }
+    return { pages: Number(m?.[1] ?? 0), outDir, files }
+  } finally {
+    await rm(ps1, { force: true }).catch(() => {})
+  }
+}