dsh-ppt 0.5.1 → 0.7.0

package/skills/dsh-ppt/scripts/deck-delivery.mjs

@@ -0,0 +1,104 @@
+import { basename } from 'node:path'
+
+const escape = value => String(value ?? '').replace(/[&<>"']/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' })[c])
+
+/** Offline, sibling-file links only. No credentials or application server needed. */
+export function renderDelivery(manifest, files, language) {
+  const label = (zh, en) => language === 'en' ? en : language === 'bilingual' ? zh + ' · ' + en : zh
+  const issues = manifest.quality?.issues ?? []
+  const draft = issues.some(issue => issue.code === 'template-unfilled')
+  const href = path => './' + encodeURIComponent(basename(path))
+  const download = (kind, text, id) => files[kind] ? `<a id="${id}" href="${escape(href(files[kind]))}" download>${escape(text)}</a>` : ''
+  const pptxLabel = label('下载 PPTX', 'Download PPTX')
+  const reviewLabel = label('检查与导出', 'Review and export')
+  const outline = manifest.slides.map((slide, i) => `<li><button type="button" data-review-slide="${i + 1}"><span>${i + 1}</span>${escape(slide.title || label('无标题', 'Untitled'))}</button></li>`).join('')
+  const rows = issues.map(issue => `<li><button type="button" data-review-slide="${issue.slide}"><strong>${escape(label('第 ' + issue.slide + ' 页', 'Slide ' + issue.slide))} · ${escape(issue.message)}</strong><span>${escape(issue.suggestion)}</span></button></li>`).join('')
+  const summary = draft ? label('草稿中还有待填写内容，请补齐事实后再交付。', 'This draft still contains placeholders. Complete the facts before delivery.')
+    : manifest.quality ? label('静态检查发现 ' + issues.length + ' 项提示；请核对实际显示。', 'Static checks found ' + issues.length + ' item(s); review the actual slides.')
+    : label('此项目没有静态质量报告，请逐页检查。', 'No static quality report is available; review every slide.')
+  return {
+    body: `<div id="delivery-bar">
+  <span id="delivery-status">${escape(draft ? label('待补全草稿', 'Draft: content needed') : label('演示文稿 · 请检查后交付', 'Presentation · review before delivery'))}</span>
+  ${download('pptx', pptxLabel, 'download-pptx')}
+  <button id="review-toggle" type="button" aria-haspopup="dialog">${escape(reviewLabel)}</button>
+</div>
+<dialog id="review-panel" aria-labelledby="review-title">
+  <div class="review-head"><h2 id="review-title">${escape(reviewLabel)}</h2><button id="review-close" type="button">${escape(label('关闭', 'Close'))}</button></div>
+  <p id="review-summary">${escape(summary)}</p>
+  <div class="review-exports">${download('pptx', pptxLabel, 'review-download-pptx')}${download('json', label('保存可编辑项目', 'Save project'), 'download-project')}</div>
+  <p>${escape(label('用 PowerPoint / WPS 打开 PPTX 可直接修改文字、图片和图表。让 Agent 继续修改时，使用保存的项目文件。', 'Open the PPTX in PowerPoint / WPS to edit text, images and charts. Use the saved project when asking your Agent to revise it.'))}</p>
+  <h3>${escape(label('检查提示 · 点击定位页面', 'Review items · click to open slide'))}</h3>
+  ${issues.length ? `<ul id="review-issues">${rows}</ul>` : `<p>${escape(manifest.quality ? label('静态检查未发现问题；仍需核对实际排版和事实。', 'No static issues found; check the actual layout and facts.') : label('暂无报告。', 'No report available.'))}</p>`}
+  <p>${escape(label('文字尺寸是静态估算；这里不能证明 PowerPoint / WPS 排版已通过验收。', 'Text fit is estimated; this does not verify the rendered PowerPoint / WPS layout.'))}</p>
+  <h3>${escape(label('页面目录', 'Slides'))}</h3><ol id="review-outline">${outline}</ol>
+</dialog>`,
+    navigation: `<button id="previous-slide" type="button" aria-label="${escape(label('上一页', 'Previous slide'))}">←</button><input id="page-number" type="number" min="1" max="${manifest.slides.length}" value="1" aria-label="${escape(label('跳到第几页', 'Go to slide'))}"><button id="next-slide" type="button" aria-label="${escape(label('下一页', 'Next slide'))}">→</button>`,
+    css: DELIVERY_CSS,
+    script: `syncDelivery = (${initDelivery.toString()})(go, setOverview, () => index, total);`,
+  }
+}
+
+/** This function is embedded in the standalone HTML, with no module dependencies. */
+function initDelivery(go, setOverview, current, total) {
+  const previous = document.getElementById('previous-slide')
+  const next = document.getElementById('next-slide')
+  const number = document.getElementById('page-number')
+  const panel = document.getElementById('review-panel')
+  const toggle = document.getElementById('review-toggle')
+  previous.addEventListener('click', () => go(Math.max(0, current() - 1)))
+  next.addEventListener('click', () => go(Math.min(total - 1, current() + 1)))
+  const jump = () => {
+    const value = Number(number.value)
+    if (Number.isInteger(value) && value >= 1 && value <= total) go(value - 1)
+    else number.value = String(current() + 1)
+  }
+  number.addEventListener('change', jump)
+  number.addEventListener('keydown', event => { if (event.key === 'Enter') { event.preventDefault(); jump() } })
+  toggle.addEventListener('click', () => panel.showModal())
+  document.getElementById('review-close').addEventListener('click', () => panel.close())
+  panel.querySelectorAll('[data-review-slide]').forEach(button => button.addEventListener('click', () => {
+    const slide = Number(button.dataset.reviewSlide)
+    if (Number.isInteger(slide) && slide >= 1 && slide <= total) { go(slide - 1); setOverview(false); panel.close() }
+  }))
+  return index => {
+    number.value = String(index + 1)
+    previous.disabled = index === 0
+    next.disabled = index === total - 1
+  }
+}
+
+const DELIVERY_CSS = `
+#hud button:disabled{opacity:.4;cursor:default}
+#page-number{width:56px;padding:7px;border:1px solid var(--muted);border-radius:8px;background:var(--panel);color:var(--fg);font:inherit}
+#delivery-bar{position:fixed;top:18px;left:22px;right:22px;z-index:45;display:flex;align-items:center;gap:12px;font-size:13px}
+#delivery-status{flex:1;color:var(--muted)}
+#delivery-bar a,#delivery-bar button,.review-exports a{display:inline-block;text-decoration:none;border:1px solid var(--muted);border-radius:99px;padding:9px 14px;background:var(--panel);color:var(--fg);font:inherit;cursor:pointer}
+#delivery-bar a:hover,#delivery-bar button:hover,.review-exports a:hover{border-color:var(--accent);color:var(--accent)}
+#delivery-bar #download-pptx{background:var(--accent);color:var(--bg);border-color:var(--accent)}
+#review-panel{background:var(--panel);color:var(--fg);border:1px solid var(--muted);border-radius:18px;width:min(620px,calc(100vw - 24px));max-height:85vh;padding:24px;overflow:auto}
+#review-panel::backdrop{background:rgba(0,0,0,.65)}
+.review-head{display:flex;justify-content:space-between;align-items:center;gap:16px}
+.review-head h2{margin:0;font-size:24px}
+#review-close{border:1px solid var(--muted);border-radius:10px;background:transparent;color:var(--fg);padding:8px 12px;font:inherit;cursor:pointer}
+#review-panel p{line-height:1.65;color:var(--muted)}
+#review-panel h3{margin:24px 0 10px;font-size:17px}
+#review-panel ul,#review-panel ol{list-style:none;padding:0;margin:0}
+#review-panel li+li{margin-top:8px}
+#review-panel li button{width:100%;text-align:left;display:flex;gap:12px;align-items:center;background:var(--bg);color:var(--fg);border:1px solid transparent;border-radius:10px;padding:12px;font:inherit;cursor:pointer}
+#review-panel li button:hover{border-color:var(--accent)}
+#review-issues li button{display:block}
+#review-issues strong,#review-issues span{display:block;line-height:1.6}
+#review-issues span{color:var(--muted);font-size:13px;margin-top:4px}
+.review-exports{display:flex;flex-wrap:wrap;gap:8px}
+body.presenting #delivery-bar{display:none}
+button:focus-visible,a:focus-visible,input:focus-visible{outline:2px solid var(--accent);outline-offset:3px}
+@media(max-width:640px){
+  #delivery-bar{left:10px;right:10px;top:10px;gap:8px}
+  #delivery-status{display:none}
+  #delivery-bar a,#delivery-bar button{padding:10px 12px;min-height:44px}
+  #hud button{padding:9px 12px}
+  #notes-panel,#help-panel{bottom:160px}
+  #review-panel{padding:18px}
+}
+@media print{#delivery-bar,#review-panel{display:none!important}}
+`

package/skills/dsh-ppt/scripts/deck-media.mjs

@@ -0,0 +1,160 @@
+// Shared geometry and chart data for the offline player and native PPTX export.
+export const MEDIA_LAYOUTS = new Set(['image', 'image-left', 'image-right', 'chart'])
+export const CANVAS = { w: 13.3333333333, h: 7.5 }
+export const LOGO_BOX = { x: 11.55, y: 0.12, w: 0.95, h: 0.42 }
+export const FOOTER_BOX = { x: 0.85, y: 6.95, w: 9.3, h: 0.3 }
+
+export function mediaBoxes(layout) {
+  const title = { x: 0.85, y: 0.64, w: 11.6, h: 0.85 }
+  const left = { x: 0.85, y: 1.85, w: 5.55, h: 4.65 }
+  const right = { x: 6.88, y: 1.85, w: 5.6, h: 4.65 }
+  const full = { x: 0.85, y: 1.85, w: 11.6, h: 4.65 }
+  return { title, image: { ...(layout === 'image-left' ? left : layout === 'image-right' ? right : full), h: 4.45 },
+    body: layout === 'image-left' ? right : layout === 'image-right' ? left : null,
+    chart: { ...full, h: 4.45 }, caption: { x: 0.85, y: 6.38, w: 11.6, h: 0.35 } }
+}
+
+function numeric(value, page) {
+  if (typeof value !== 'number' && !(typeof value === 'string' && /^[+-]?(?:\d+(?:\.\d*)?|\.\d+)(?:e[+-]?\d+)?$/i.test(value.trim()))) {
+    throw new Error(`dsh-ppt：第 ${page} 页图表有非数值数据：${String(value).slice(0, 40)}`)
+  }
+  const result = Number(value)
+  if (!Number.isFinite(result)) throw new Error(`dsh-ppt：第 ${page} 页图表数值必须有限`)
+  return result
+}
+
+export function normalizeChart(input, page = 1) {
+  if (!input || typeof input !== 'object' || Array.isArray(input)) throw new Error(`dsh-ppt：第 ${page} 页缺少 chart 对象`)
+  const kind = input.kind ?? 'column'
+  if (!['column', 'bar', 'line', 'pie'].includes(kind)) throw new Error(`dsh-ppt：第 ${page} 页未知图表类型 ${kind}`)
+  let categories = input.categories
+  let series = input.series
+  if (input.rows !== undefined) {
+    const rows = input.rows
+    if (!Array.isArray(rows) || rows.length < 2 || !Array.isArray(rows[0]) || rows[0].length < 2
+      || rows.some(row => !Array.isArray(row) || row.length !== rows[0].length)) {
+      throw new Error(`dsh-ppt：第 ${page} 页图表 rows 需包含表头、类别和数值列，各行列数一致`)
+    }
+    categories = rows.slice(1).map(row => row[0])
+    series = rows[0].slice(1).map((name, column) => ({ name, values: rows.slice(1).map(row => row[column + 1]) }))
+  }
+  if (!Array.isArray(categories) || categories.length < 1 || categories.length > 24 || categories.some(c => String(c ?? '').trim() === '')) {
+    throw new Error(`dsh-ppt：第 ${page} 页图表需 1–24 个非空类别`)
+  }
+  if (!Array.isArray(series) || series.length < 1 || series.length > 6) throw new Error(`dsh-ppt：第 ${page} 页图表需 1–6 个数据系列`)
+  const clean = series.map((s, i) => {
+    if (!s || !Array.isArray(s.values) || s.values.length !== categories.length) throw new Error(`dsh-ppt：第 ${page} 页图表第 ${i + 1} 个系列与类别数量不一致`)
+    return { name: String(s.name ?? `系列 ${i + 1}`).trim() || `系列 ${i + 1}`, values: s.values.map(v => numeric(v, page)) }
+  })
+  if (kind === 'pie' && (clean.length !== 1 || categories.length > 12 || clean[0].values.some(v => v < 0) || clean[0].values.reduce((a, b) => a + b, 0) <= 0)) {
+    throw new Error(`dsh-ppt：第 ${page} 页饼图只支持一个系列、最多 12 个类别，数值需非负且总和大于零`)
+  }
+  return { kind, categories: categories.map(c => String(c).trim()), series: clean,
+    ...(input.unit ? { unit: String(input.unit) } : {}), ...(input.caption ? { caption: String(input.caption) } : {}) }
+}
+
+export function normalizeMediaSlide(source, normalized, index) {
+  if (!MEDIA_LAYOUTS.has(normalized.layout)) return normalized
+  if (normalized.layout === 'chart') return { ...normalized, chart: normalizeChart(source.chart, index + 1) }
+  const image = typeof source.image === 'string' ? { src: source.image } : source.image
+  if (!image || typeof image !== 'object' || (!image.src && !image.assetId)) throw new Error(`dsh-ppt：第 ${index + 1} 页缺少 image.src`)
+  const fit = image.fit ?? 'contain'
+  if (!['contain', 'cover'].includes(fit)) throw new Error(`dsh-ppt：第 ${index + 1} 页 image.fit 仅支持 contain / cover`)
+  return { ...normalized, image: { ...(image.src ? { src: String(image.src) } : {}), ...(image.assetId ? { assetId: String(image.assetId) } : {}),
+    alt: String(image.alt ?? normalized.title ?? ''), fit, ...(image.caption ? { caption: String(image.caption) } : {}) } }
+}
+
+const esc = value => String(value ?? '').replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replaceAll('"', '&quot;').replaceAll("'", '&#39;')
+const position = box => `left:${box.x / CANVAS.w * 100}%;top:${box.y / CANVAS.h * 100}%;width:${box.w / CANVAS.w * 100}%;height:${box.h / CANVAS.h * 100}%`
+export function chartColors(theme) { return [theme.palette.accent, theme.palette.accent2, '#55B5AA', '#A580D3', '#E67979', '#7EA4C4'] }
+
+export function renderChartSvg(chart, theme) {
+  const colors = chartColors(theme), fg = theme.palette.fg, muted = theme.palette.muted
+  const width = 1120, height = 430, n = chart.categories.length
+  const rect = (x, y, w, h, color) => `<rect x="${x}" y="${y}" width="${w}" height="${Math.max(0, h)}" fill="${color}"/>`
+  const text = (x, y, content, anchor = 'start', color = fg, size = 18) => `<text x="${x}" y="${y}" text-anchor="${anchor}" fill="${color}" font-size="${size}">${esc(content)}</text>`
+  const line = (x1, y1, x2, y2, color = muted) => `<line x1="${x1}" y1="${y1}" x2="${x2}" y2="${y2}" stroke="${color}" stroke-width="1"/>`
+  let shapes = ''
+  if (chart.kind === 'pie') {
+    const values = chart.series[0].values, sum = values.reduce((a, b) => a + b, 0)
+    let angle = -Math.PI / 2
+    values.forEach((value, i) => {
+      const next = angle + value / sum * Math.PI * 2
+      if (value === sum) shapes += `<circle cx="350" cy="205" r="173" fill="${colors[i % colors.length]}"/>`
+      else if (value > 0) shapes += `<path d="M 350 205 L ${350 + Math.cos(angle) * 173} ${205 + Math.sin(angle) * 173} A 173 173 0 ${next - angle > Math.PI ? 1 : 0} 1 ${350 + Math.cos(next) * 173} ${205 + Math.sin(next) * 173} Z" fill="${colors[i % colors.length]}"/>`
+      angle = next
+      const y = 35 + i * 30
+      shapes += rect(625, y - 15, 15, 15, colors[i % colors.length]) + text(651, y, chart.categories[i])
+        + text(1095, y, `${(value / sum * 100).toFixed(1)}%`, 'end')
+    })
+  } else {
+    const values = chart.series.flatMap(s => s.values), min = Math.min(0, ...values), max = Math.max(0, ...values)
+    const span = max - min || 1, left = chart.kind === 'bar' ? 170 : 82, right = 1090, top = 18, bottom = 340
+    const y = value => bottom - (value - min) / span * (bottom - top)
+    const x = value => left + (value - min) / span * (right - left)
+    for (let tick = 0; tick <= 4; tick++) {
+      const value = min + span * tick / 4, label = Number(value.toPrecision(4)).toLocaleString('en-US')
+      if (chart.kind === 'bar') shapes += line(x(value), top, x(value), bottom, `${muted}66`) + text(x(value), bottom + 28, label, 'middle', muted, 16)
+      else shapes += line(left, y(value), right, y(value), `${muted}66`) + text(left - 12, y(value) + 6, label, 'end', muted, 16)
+    }
+    chart.categories.forEach((category, i) => {
+      if (chart.kind === 'bar') shapes += text(left - 14, top + (i + 0.5) * (bottom - top) / n + 6, category, 'end', fg, 16)
+      else shapes += text(left + (i + 0.5) * (right - left) / n, bottom + 30, category, 'middle', fg, 16)
+    })
+    chart.series.forEach((series, s) => {
+      const color = colors[s % colors.length]
+      if (chart.kind === 'line') {
+        const points = series.values.map((v, i) => `${left + (i + 0.5) * (right - left) / n},${y(v)}`).join(' ')
+        shapes += `<polyline points="${points}" fill="none" stroke="${color}" stroke-width="4"/>`
+        series.values.forEach((v, i) => { shapes += `<circle cx="${left + (i + 0.5) * (right - left) / n}" cy="${y(v)}" r="5" fill="${color}"/>` })
+      } else series.values.forEach((v, i) => {
+        if (chart.kind === 'bar') {
+          const group = (bottom - top) / n, h = group * 0.7 / chart.series.length
+          shapes += rect(Math.min(x(0), x(v)), top + i * group + group * 0.15 + s * h, Math.abs(x(v) - x(0)), Math.max(1, h - 2), color)
+        } else {
+          const group = (right - left) / n, w = group * 0.7 / chart.series.length
+          shapes += rect(left + i * group + group * 0.15 + s * w, Math.min(y(0), y(v)), Math.max(1, w - 3), Math.abs(y(v) - y(0)), color)
+        }
+      })
+    })
+    shapes += chart.kind === 'bar' ? line(x(0), top, x(0), bottom, fg) : line(left, y(0), right, y(0), fg)
+    chart.series.forEach((s, i) => { shapes += rect(left + i * 175, 397, 14, 14, colors[i % colors.length]) + text(left + 22 + i * 175, 410, s.name, 'start', fg, 17) })
+  }
+  if (chart.unit) shapes += text(1095, 428, chart.unit, 'end', muted, 16)
+  // Accessible data remains available even when SVG cannot be viewed.
+  const table = '<table class="chart-data"><caption>' + esc(chart.caption || 'Chart data') + '</caption><thead><tr><th></th>' + chart.series.map(s => `<th>${esc(s.name)}</th>`).join('') + '</tr></thead><tbody>'
+    + chart.categories.map((c, i) => `<tr><th>${esc(c)}</th>${chart.series.map(s => `<td>${s.values[i]}</td>`).join('')}</tr>`).join('') + '</tbody></table>'
+  return `<svg class="native-chart" viewBox="0 0 ${width} ${height}" role="img" aria-label="${esc(chart.caption || chart.kind + ' chart')}"><title>${esc(chart.caption || chart.kind)}</title>${shapes}</svg>${table}`
+}
+
+export function renderMediaHtml(slide, manifest, theme) {
+  const boxes = mediaBoxes(slide.layout)
+  let body = `<h2 class="media-title" style="${position(boxes.title)}">${esc(slide.title)}</h2>`
+  if (slide.layout === 'chart') {
+    body += `<div class="media-chart" style="${position(boxes.chart)}">${renderChartSvg(slide.chart, theme)}</div>`
+    if (slide.chart.caption) body += `<div class="media-caption" style="${position(boxes.caption)}">${esc(slide.chart.caption)}</div>`
+  } else {
+    const image = slide.image, asset = manifest.assets?.[image?.assetId]
+    body += `<figure class="media-image" style="${position(boxes.image)}"><img src="${esc(asset?.data ?? '')}" alt="${esc(image?.alt)}" style="object-fit:${image?.fit || 'contain'}"/></figure>`
+    if (boxes.body) body += `<div class="media-body" style="${position(boxes.body)}">${slide.subtitle ? `<p>${esc(slide.subtitle)}</p>` : ''}${slide.bullets?.length ? `<ul>${slide.bullets.map(b => `<li>${esc(b)}</li>`).join('')}</ul>` : ''}</div>`
+    if (image?.caption) body += `<div class="media-caption" style="${position(boxes.caption)}">${esc(image.caption)}</div>`
+  }
+  return `<div class="media-canvas">${body}</div>`
+}
+
+export const MEDIA_CSS = `
+.slide--image,.slide--image-left,.slide--image-right,.slide--chart{padding:0;align-items:center}
+.slide--image .slide-inner,.slide--image-left .slide-inner,.slide--image-right .slide-inner,.slide--chart .slide-inner{width:100%;display:flex;justify-content:center}
+.media-canvas{position:relative;width:min(100vw,177.7778vh);height:min(100vh,56.25vw);container-type:inline-size}
+.media-title,.media-image,.media-body,.media-chart,.media-caption{position:absolute;margin:0;max-width:none;box-sizing:border-box}
+.media-title{font-size:3.54cqw;line-height:1.17;overflow-wrap:anywhere}
+.media-image img{width:100%;height:100%;display:block}
+.media-body{font-size:2.083cqw;line-height:1.45;overflow-wrap:anywhere}
+.media-body p{margin:0 0 1.2em}.media-body ul{margin:0;padding-left:1.1em}.media-body li{margin-bottom:.6em}
+.media-caption{color:var(--muted);font-size:1.4cqw;line-height:1.2}
+.native-chart{width:100%;height:100%;font-family:var(--font-body)}
+.chart-data{position:absolute;width:1px;height:1px;overflow:hidden;clip-path:inset(50%)}
+.brand-logo{position:absolute;right:6.2%;top:1.6%;width:7.1%;height:5.6%;object-fit:contain;pointer-events:none}
+.brand-footer{position:absolute;left:6.4%;bottom:3.4%;max-width:69%;font-size:clamp(10px,1vw,15px);color:var(--muted)}
+body.printing .brand-footer{display:block}
+`

package/skills/dsh-ppt/scripts/deck-render.mjs

@@ -0,0 +1,236 @@
+import { createHash, randomUUID } from 'node:crypto'
+import { existsSync, lstatSync, mkdirSync, readFileSync, renameSync, rmSync, rmdirSync, unlinkSync, writeFileSync } from 'node:fs'
+import { basename, dirname, extname, isAbsolute, join, relative, resolve, sep } from 'node:path'
+import { inflateRawSync } from 'node:zlib'
+
+export const RENDERER_PACKAGE = '@deepseek-ai/libreoffice-kit'
+export const RENDERER_VERSION = '0.1.3'
+const INPUT_LIMIT = 64 * 1024 * 1024
+const OUTPUT_LIMIT = 128 * 1024 * 1024
+const PAGE_LIMIT = 120
+const RECEIPT_LIMIT = 1024 * 1024
+const PNG_SIGNATURE = Buffer.from([137, 80, 78, 71, 13, 10, 26, 10])
+
+function fail(message, code = 'invalid-render') { throw Object.assign(new Error(message), { code }) }
+function abort(signal) { if (signal?.aborted) throw signal.reason }
+function sha256(bytes) { return createHash('sha256').update(bytes).digest('hex') }
+function integer(value, fallback, min, max, name) {
+  const result = value === undefined ? fallback : value
+  if (!Number.isSafeInteger(result) || result < min || result > max) fail(`${name} 需为 ${min}–${max} 的整数`)
+  return result
+}
+function absolute(path, name) {
+  if (typeof path !== 'string' || !isAbsolute(path)) fail(`${name} 需为绝对路径`)
+  return resolve(path)
+}
+function readBounded(path, limit, name) {
+  const info = lstatSync(path)
+  if (!info.isFile()) fail(`${name} 需为普通文件`)
+  if (info.size === 0 || info.size > limit) fail(`${name} 为空或超过 ${limit} 字节`, 'size-limit')
+  const bytes = readFileSync(path)
+  if (bytes.length !== info.size || bytes.length > limit) fail(`${name} 在读取时发生变化`, 'source-changed')
+  return bytes
+}
+
+// Read only the small presentation part to obtain slide geometry. The renderer
+// remains responsible for validating and importing the complete Office file.
+function presentationXml(bytes) {
+  let end = -1
+  for (let offset = bytes.length - 22; offset >= Math.max(0, bytes.length - 65557); offset--) {
+    if (bytes.readUInt32LE(offset) === 0x06054b50 && offset + 22 + bytes.readUInt16LE(offset + 20) === bytes.length) { end = offset; break }
+  }
+  if (end < 0 || bytes.readUInt16LE(end + 4) || bytes.readUInt16LE(end + 6)) fail('不支持的 PPTX ZIP 容器', 'invalid-document')
+  const count = bytes.readUInt16LE(end + 10), length = bytes.readUInt32LE(end + 12), start = bytes.readUInt32LE(end + 16)
+  if (count === 65535 || count > 20000 || start + length > end) fail('PPTX ZIP 目录无效或超过限制', 'invalid-document')
+  let offset = start
+  for (let index = 0; index < count; index++) {
+    if (offset + 46 > start + length || bytes.readUInt32LE(offset) !== 0x02014b50) fail('PPTX ZIP 目录损坏', 'invalid-document')
+    const flags = bytes.readUInt16LE(offset + 8), method = bytes.readUInt16LE(offset + 10)
+    const compressed = bytes.readUInt32LE(offset + 20), expanded = bytes.readUInt32LE(offset + 24)
+    const nameLength = bytes.readUInt16LE(offset + 28), extra = bytes.readUInt16LE(offset + 30), comment = bytes.readUInt16LE(offset + 32)
+    const next = offset + 46 + nameLength + extra + comment
+    if (next > start + length) fail('PPTX ZIP 文件名无效', 'invalid-document')
+    const name = bytes.toString('utf8', offset + 46, offset + 46 + nameLength)
+    if (name === 'ppt/presentation.xml') {
+      if (flags & 1 || expanded > RECEIPT_LIMIT || compressed > RECEIPT_LIMIT) fail('PPTX 页面信息加密或超过限制', 'invalid-document')
+      const local = bytes.readUInt32LE(offset + 42)
+      if (local + 30 > start || bytes.readUInt32LE(local) !== 0x04034b50) fail('PPTX 页面信息偏移无效', 'invalid-document')
+      const dataOffset = local + 30 + bytes.readUInt16LE(local + 26) + bytes.readUInt16LE(local + 28)
+      if (dataOffset + compressed > start) fail('PPTX 页面信息越界', 'invalid-document')
+      const data = bytes.subarray(dataOffset, dataOffset + compressed)
+      const xml = method === 0 ? data : method === 8 ? inflateRawSync(data, { maxOutputLength: RECEIPT_LIMIT }) : fail('PPTX 压缩格式不支持', 'invalid-document')
+      if (xml.length !== expanded) fail('PPTX 页面信息长度不匹配', 'invalid-document')
+      return xml.toString('utf8')
+    }
+    offset = next
+  }
+  fail('PPTX 缺少 ppt/presentation.xml', 'invalid-document')
+}
+function geometry(bytes, width) {
+  const xml = presentationXml(bytes), tag = xml.match(/<(?:[\w.-]+:)?sldSz\b[^>]*>/)?.[0]
+  const cx = Number(tag?.match(/\bcx\s*=\s*["'](\d+)["']/)?.[1])
+  const cy = Number(tag?.match(/\bcy\s*=\s*["'](\d+)["']/)?.[1])
+  const count = (xml.match(/<(?:[\w.-]+:)?sldId\b/g) ?? []).length
+  if (!Number.isSafeInteger(cx) || !Number.isSafeInteger(cy) || cx <= 0 || cy <= 0 || !count || count > PAGE_LIMIT) fail('PPTX 页面尺寸或页数无效（最多120页）', 'invalid-document')
+  const dpi = width * 914400 / cx
+  if (dpi < 24 || dpi > 600 || width * cy / cx > 8192) fail('目标宽度超出此 PPTX 页面尺寸的渲染限制', 'size-limit')
+  return { dpi, slideCount: count }
+}
+
+function unavailable(error) {
+  return { ok: false, status: 'unavailable', backend: 'libreoffice-kit',
+    message: `PPTX 渲染引擎不可用：${error?.message ?? String(error)}`,
+    installationHint: `在 dsh-ppt 所在项目或独立技能目录安装：npm install --ignore-scripts ${RENDERER_PACKAGE}@${RENDERER_VERSION}。Windows 还需与 Node 架构匹配的 Microsoft Visual C++ v14 运行库。` }
+}
+function missingDependency(error) { return ['ERR_MODULE_NOT_FOUND', 'MODULE_NOT_FOUND', 'unavailable'].includes(error?.code) }
+function reserveDirectory(base) {
+  mkdirSync(dirname(base), { recursive: true })
+  for (let index = 0; index < 10000; index++) {
+    const candidate = index ? `${base}-${index}` : base
+    try { mkdirSync(candidate); return candidate } catch (error) { if (error.code !== 'EEXIST') throw error }
+  }
+  fail('渲染目录重名过多，请指定新的 outputDir')
+}
+function cleanupOwned(root, owned) {
+  // Only delete the freshly created staging/artifacts subtree. Never recursively
+  // remove a requested directory or pre-existing user output.
+  if (root && owned && dirname(resolve(owned)) === resolve(root) && (basename(owned).startsWith('.partial-') || basename(owned) === 'artifacts')) rmSync(owned, { recursive: true, force: true })
+  if (root) { try { rmdirSync(root) } catch (error) { if (!['ENOENT', 'ENOTEMPTY', 'EEXIST'].includes(error.code)) throw error } }
+}
+function relativeFile(root, path) {
+  const value = relative(root, absolute(path, '引擎输出路径'))
+  if (!value || value === '..' || value.startsWith(`..${sep}`) || isAbsolute(value)) fail('引擎输出路径不在本次目录内')
+  return value.split(sep).join('/')
+}
+function fileRecord(root, path, budget) {
+  const file = relativeFile(root, path), bytes = readBounded(path, OUTPUT_LIMIT, '渲染输出')
+  budget.bytes += bytes.length
+  if (budget.bytes > OUTPUT_LIMIT) fail('本次渲染输出超过128MiB', 'size-limit')
+  return { record: { file, byteLength: bytes.length, sha256: sha256(bytes) }, bytes }
+}
+function fontNames(values) { return [...new Set(values.flat().filter(v => typeof v === 'string'))].sort() }
+
+/** Optional renderer; dependency/engine absence is a result, other errors throw.
+ * The second argument is an internal loader seam for testing and isolated hosts.
+ */
+export async function renderDeck(options = {}, loadKit = () => import('@deepseek-ai/libreoffice-kit')) {
+  abort(options.signal)
+  const pptxPath = absolute(options.pptxPath, 'pptxPath')
+  if (extname(pptxPath).toLowerCase() !== '.pptx') fail('pptxPath 需为 .pptx 文件')
+  const format = options.format ?? 'png'
+  if (!['png', 'pdf', 'both'].includes(format)) fail('format 需为 png / pdf / both')
+  const width = integer(options.width, 1440, 320, 3840, 'width')
+  const timeoutMs = integer(options.timeoutMs, 120000, 1000, 300000, 'timeoutMs')
+  const base = options.outputDir === undefined ? join(dirname(pptxPath), `${basename(pptxPath, extname(pptxPath))}-render`) : absolute(options.outputDir, 'outputDir')
+  let kit
+  try { kit = await loadKit() } catch (error) { abort(options.signal); if (missingDependency(error)) return unavailable(error); throw error }
+  abort(options.signal)
+  if (kit.ENGINE_VERSION !== RENDERER_VERSION || typeof kit.createConverter !== 'function') return unavailable(new Error(`需要 ${RENDERER_PACKAGE}@${RENDERER_VERSION}`))
+  const input = readBounded(pptxPath, INPUT_LIMIT, 'PPTX'), sourceSha256 = sha256(input), shape = geometry(input, width)
+  let converter
+  try { converter = await kit.createConverter({ timeoutMs, maxInputBytes: INPUT_LIMIT, maxOutputBytes: OUTPUT_LIMIT, maxArchiveEntries: 20000, maxUncompressedBytes: 512 * 1024 * 1024, fontMetadataCacheDirectory: false }) }
+  catch (error) { abort(options.signal); if (missingDependency(error)) return unavailable(error); throw error }
+  let root, staging, committed = false
+  const deadline = new AbortController()
+  const timer = setTimeout(() => deadline.abort(Object.assign(new Error(`PPTX 渲染超过 ${timeoutMs}ms`), { code: 'timeout' })), timeoutMs)
+  timer.unref()
+  const operationSignal = options.signal ? AbortSignal.any([options.signal, deadline.signal]) : deadline.signal
+  try {
+    abort(operationSignal)
+    root = reserveDirectory(base)
+    staging = join(root, `.partial-${randomUUID()}`)
+    mkdirSync(staging)
+    const snapshot = join(staging, 'source.pptx')
+    writeFileSync(snapshot, input, { flag: 'wx' })
+    const destination = join(root, 'artifacts'), budget = { bytes: 0 }, fonts = []
+    const receipt = { schemaVersion: 1, producer: 'dsh-ppt-render', status: 'rendered', visual: 'not-verified', createdAt: new Date().toISOString(),
+      renderer: { package: RENDERER_PACKAGE, version: RENDERER_VERSION, backend: converter.backend },
+      source: { sha256: sourceSha256, byteLength: input.length }, format, slideCount: shape.slideCount, missingFonts: [], pngs: [] }
+    if (!['native', 'wasm'].includes(converter.backend)) fail('引擎未返回有效 backend')
+    if (format !== 'pdf') {
+      const images = await converter.renderImages({ inputPath: snapshot, outputDir: join(staging, 'pages'), pages: 'all', dpi: shape.dpi, maxPages: PAGE_LIMIT, maxPixels: 16777216, maxDimension: 8192 }, operationSignal)
+      abort(operationSignal)
+      if (images.sourceSha256 !== sourceSha256 || !Number.isSafeInteger(images.pageCount) || images.pageCount < 1 || images.pageCount > PAGE_LIMIT || images.images?.length !== images.pageCount) fail('引擎未返回完整且匹配输入的逐页图片')
+      receipt.slideCount = images.pageCount
+      fonts.push(images.missingFonts ?? [])
+      const seen = new Set()
+      for (const item of images.images) {
+        const { record, bytes } = fileRecord(staging, item.path, budget)
+        if (!Number.isSafeInteger(item.page) || item.page < 1 || item.page > images.pageCount || seen.has(item.page)) fail('引擎返回重复或无效页码')
+        seen.add(item.page)
+        if (bytes.length < 24 || !bytes.subarray(0, 8).equals(PNG_SIGNATURE) || bytes.readUInt32BE(16) !== item.width || bytes.readUInt32BE(20) !== item.height || item.width * item.height > 16777216) fail('引擎PNG格式或尺寸不匹配')
+        receipt.pngs.push({ page: item.page, ...record, width: item.width, height: item.height })
+      }
+      receipt.pngs.sort((a, b) => a.page - b.page)
+      const manifest = { ...images, inputPath: pptxPath, images: images.images.map(item => ({ ...item, path: join(destination, relativeFile(staging, item.path)) })) }
+      const manifestPath = join(staging, 'pages', 'manifest.json')
+      writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n')
+      receipt.manifest = fileRecord(staging, manifestPath, budget).record
+    }
+    if (format !== 'png') {
+      const pdfPath = join(staging, 'document.pdf'), exported = await converter.convert({ inputPath: snapshot, outputPath: pdfPath }, operationSignal)
+      abort(operationSignal)
+      const { record, bytes } = fileRecord(staging, pdfPath, budget)
+      if (!bytes.subarray(0, 5).equals(Buffer.from('%PDF-'))) fail('引擎未生成有效PDF')
+      receipt.pdf = record
+      fonts.push(exported.missingFonts ?? [])
+    }
+    receipt.missingFonts = fontNames(fonts)
+    abort(operationSignal)
+    unlinkSync(snapshot)
+    writeFileSync(join(staging, 'render-receipt.json'), JSON.stringify(receipt, null, 2) + '\n', { flag: 'wx' })
+    // Await native cleanup before publishing the output directory.
+    await converter.dispose()
+    converter = undefined
+    abort(operationSignal)
+    if (sha256(readBounded(pptxPath, INPUT_LIMIT, 'PPTX')) !== sourceSha256) fail('PPTX 在渲染期间已修改，请重新渲染', 'source-changed')
+    if (existsSync(destination)) fail('本次渲染提交目录发生冲突')
+    renameSync(staging, destination)
+    staging = undefined
+    committed = true
+    return resultFromReceipt(receipt, join(destination, 'render-receipt.json'))
+  } finally {
+    if (converter) { try { await converter.dispose() } catch { /* Preserve the original operation/cancellation error. */ } }
+    clearTimeout(timer)
+    if (!committed) cleanupOwned(root, staging)
+  }
+}
+
+function resultFromReceipt(receipt, receiptPath) {
+  const root = dirname(receiptPath)
+  return { ok: true, status: 'rendered', backend: receipt.renderer.backend, rendererVersion: receipt.renderer.version,
+    slideCount: receipt.slideCount, sourceSha256: receipt.source.sha256, missingFonts: receipt.missingFonts,
+    ...(receipt.pngs.length ? { pngPaths: receipt.pngs.map(image => resolve(root, image.file)) } : {}),
+    ...(receipt.pdf ? { pdfPath: resolve(root, receipt.pdf.file) } : {}), receiptPath, outputDir: dirname(root), visual: 'not-verified' }
+}
+function unverified(message, reason) { return { ok: false, status: 'not-verified', message, reason, visual: 'not-verified' } }
+function receiptFile(root, record) {
+  if (!record || typeof record.file !== 'string' || isAbsolute(record.file) || record.file.includes('\\') || record.file.split('/').some(part => !part || part === '.' || part === '..') || !/^[0-9a-f]{64}$/.test(record.sha256) || !Number.isSafeInteger(record.byteLength) || record.byteLength < 1 || record.byteLength > OUTPUT_LIMIT) fail('渲染收据文件记录无效')
+  const path = resolve(root, record.file)
+  relativeFile(root, path)
+  const bytes = readBounded(path, OUTPUT_LIMIT, '渲染收据输出')
+  if (bytes.length !== record.byteLength || sha256(bytes) !== record.sha256) fail('渲染输出内容已变化')
+}
+
+/** Revalidate provenance and output integrity; this never certifies visual quality. */
+export function readRenderReceipt(pptxPath, receiptPath) {
+  try {
+    const inputPath = absolute(pptxPath, 'pptxPath'), path = absolute(receiptPath, 'receiptPath')
+    const receipt = JSON.parse(readBounded(path, RECEIPT_LIMIT, '渲染收据').toString('utf8'))
+    if (receipt.schemaVersion !== 1 || receipt.producer !== 'dsh-ppt-render' || receipt.status !== 'rendered' || receipt.renderer?.package !== RENDERER_PACKAGE || receipt.renderer?.version !== RENDERER_VERSION || !['native', 'wasm'].includes(receipt.renderer?.backend) || !['png', 'pdf', 'both'].includes(receipt.format) || !Number.isSafeInteger(receipt.slideCount) || receipt.slideCount < 1 || receipt.slideCount > PAGE_LIMIT || !Array.isArray(receipt.pngs) || !Array.isArray(receipt.missingFonts) || receipt.missingFonts.some(name => typeof name !== 'string') || !/^[0-9a-f]{64}$/.test(receipt.source?.sha256)) return unverified('收据格式或渲染版本不匹配', 'invalid-receipt')
+    const input = readBounded(inputPath, INPUT_LIMIT, 'PPTX')
+    if (input.length !== receipt.source.byteLength || sha256(input) !== receipt.source.sha256) return unverified('PPTX 与渲染时的内容不同', 'source-changed')
+    if ((receipt.format !== 'pdf' && (receipt.pngs.length !== receipt.slideCount || !receipt.manifest)) || (receipt.format !== 'png' && !receipt.pdf) || (receipt.format === 'pdf' && receipt.pngs.length) || (receipt.format === 'png' && receipt.pdf)) return unverified('收据缺少完整渲染输出', 'incomplete-output')
+    const pages = new Set()
+    const records = [...receipt.pngs, ...(receipt.pdf ? [receipt.pdf] : []), ...(receipt.manifest ? [receipt.manifest] : [])]
+    if (records.reduce((sum, record) => sum + (Number.isSafeInteger(record?.byteLength) ? record.byteLength : OUTPUT_LIMIT + 1), 0) > OUTPUT_LIMIT) return unverified('收据输出总量超过128MiB', 'invalid-receipt')
+    for (const image of receipt.pngs) {
+      if (!Number.isSafeInteger(image.page) || image.page < 1 || image.page > receipt.slideCount || pages.has(image.page) || !Number.isSafeInteger(image.width) || !Number.isSafeInteger(image.height) || image.width < 1 || image.height < 1 || image.width * image.height > 16777216) return unverified('收据页码或图片尺寸无效', 'invalid-receipt')
+      pages.add(image.page)
+      receiptFile(dirname(path), image)
+    }
+    if (receipt.pdf) receiptFile(dirname(path), receipt.pdf)
+    if (receipt.manifest) receiptFile(dirname(path), receipt.manifest)
+    return resultFromReceipt(receipt, path)
+  } catch (error) { return unverified(`收据验证失败：${error.message}`, 'invalid-or-changed-output') }
+}