dsh-ppt-studio 1.1.0

package/scripts/preflight-1.0.mjs

@@ -0,0 +1,198 @@
+#!/usr/bin/env node
+/**
+ * 1.0.0 发布前预检（preflight）：
+ * 在 smoke（139 断言）之外补"鲁棒性/边界/重复调用/性能"簇——坏输入不崩溃、防呆到位、
+ * 幂等成立、百页仍快、媒体/几何元组经 splice 链路不坏。
+ * 独立于 smoke 运行：`node scripts/preflight-1.0.mjs`（全绿方可用于发布）。
+ */
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { rm, mkdir, writeFile, readFile } from 'node:fs/promises'
+import { existsSync } from 'node:fs'
+import { tmpdir } from 'node:os'
+import { resolveDeck, PptError } from '../lib/pptd/schema.js'
+import { renderDeck } from '../lib/pptd/render-html.js'
+import { verifyDeck } from '../lib/verify.js'
+import { exportPptx } from '../lib/pptd/export-pptx.js'
+import { zipRead, decodeXml } from '../lib/zips.js'
+import { spliceIntoSource, sliceSource } from '../lib/splice.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 fixture = async (name, deckYaml, pages) => {
+  const dir = join(tmpdir(), `ppt-preflight-${name}-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`)
+  await mkdir(join(dir, 'pages'), { recursive: true })
+  await writeFile(join(dir, 'deck.yaml'), deckYaml)
+  for (const [ref, text] of Object.entries(pages)) await writeFile(join(dir, ref), text)
+  return dir
+}
+const rmFixture = (dir) => rm(dir, { recursive: true, force: true }).catch(() => {})
+
+// ── A. 坏输入不崩溃 ─────────────────────────────────────────────
+{
+  // A1 无 deck.yaml
+  let e1 = null
+  try { await resolveDeck(join(tmpdir(), 'no-such-deck-xx')) } catch (e) { e1 = e }
+  ok('A1 缺 deck.yaml → 明确报错（非崩溃）', e1 !== null && /deck\.yaml not found/.test(String(e1)),
+    String(e1).slice(0, 40))
+  // A2 空 pages（1.0.0 拦截：0 页会产出打不开的 pptx）
+  const d2 = await fixture('empty', ['version: 1', 'title: empty', 'size: [960, 540]', 'pages: []', ''].join('\n'), {})
+  let e2 = null
+  try { await resolveDeck(d2) } catch (e) { e2 = e }
+  ok('A2 空 pages → 拦截（防静默产 0 页 pptx）', e2 !== null && /at least 1 page/.test(String(e2)),
+    e2 ? 'blocked' : 'NOT BLOCKED (bug)')
+  await rmFixture(d2)
+  // A3 YAML 语法错误 → B2 指引
+  const d3 = await fixture('badyaml', ['version: 1', 'title: x', 'size: [960, 540]', 'pages:', '  - pages/01.yaml', ''].join('\n'),
+    { 'pages/01.yaml': ['pageType: content', 'elements: [', ''].join('\n') })
+  let e3 = null
+  try { await resolveDeck(d3) } catch (e) { e3 = e }
+  ok('A3 页面 YAML 语法错误 → 提示（非 JSON 狗血堆栈）', e3 !== null && /YAML 解析失败/.test(String(e3)),
+    String(e3).slice(0, 60))
+  await rmFixture(d3)
+  // A4 expectedOverlaps 指向不存在 id → 防呆（1.0.0 新增）
+  const d4 = await fixture('ghostid', ['version: 1', 'title: x', 'size: [960, 540]', 'pages:', '  - pages/01.yaml', ''].join('\n'),
+    { 'pages/01.yaml': ['pageType: content', 'elements:', '  - elementId: a', '    elementType: text', '    bounds: [10, 20, 100, 30]', '    content: {text: "hi"}', 'expectedOverlaps:', '  - {pair: [a, ghost]}', ''].join('\n') })
+  let e4 = null
+  try { await resolveDeck(d4) } catch (e) { e4 = e }
+  ok('A4 expectedOverlaps id 防呆（ghost 元素 → 报错）', e4 !== null && /ghost.*不是本页元素 id/.test(String(e4)),
+    e4 ? 'blocked' : 'NOT BLOCKED (bug)')
+  await rmFixture(d4)
+  // A5 极长文本（2000 字）不崩溃
+  const longText = '标'.repeat(2000)
+  const d5 = await fixture('long', ['version: 1', 'title: x', 'size: [960, 540]', 'pages:', '  - pages/01.yaml', ''].join('\n'),
+    { 'pages/01.yaml': [`pageType: content`, 'elements:', '  - elementId: t', '    elementType: text', '    bounds: [10, 20, 200, 60]', `    content: {text: ${JSON.stringify(longText)}, fontSize: 14}`, ''].join('\n') })
+  let e5 = null
+  let v5 = null
+  try {
+    const c = await resolveDeck(d5)
+    const r = await renderDeck(c, {})
+    v5 = verifyDeck(r.layout)
+  } catch (e) { e5 = e }
+  ok('A5 2000 字文本 → 渲染/校验不崩溃（估算保守报溢出）', e5 === null && v5 !== null && v5.text.includes('text-overflow'),
+    e5 ? String(e5).slice(0, 60) : '')
+  await rmFixture(d5)
+  // A6 零元素页面 → 审阅无断言错误
+  const d6 = await fixture('noel', ['version: 1', 'title: x', 'size: [960, 540]', 'pages:', '  - pages/01.yaml', ''].join('\n'),
+    { 'pages/01.yaml': ['pageType: content', '', ''].join('\n') })
+  let e6 = null
+  try {
+    const c = await resolveDeck(d6)
+    const r = await renderDeck(c, {})
+    const t = verifyDeck(r.layout).text
+    if (/✗/.test(t)) e6 = new Error('unexpected errors in empty page')
+  } catch (e) { e6 = e }
+  ok('A6 空页面 → 渲染/校验正常（无断言崩溃）', e6 === null, '')
+  await rmFixture(d6)
+}
+
+// ── B. 边界形态 ─────────────────────────────────────────────────
+{
+  // B1 单页 deck 全链路（render → verify → export → zip 有 1 张 slide）
+  const d1 = await fixture('single', ['version: 1', 'title: single', 'size: [960, 540]',
+    'theme: {colors: {ink: "#3E4E63"}, textStyles: {body: {fontSize: 14, color: "$ink"}}}',
+    'pages:', '  - pages/01.yaml', ''].join('\n'),
+    { 'pages/01.yaml': ['pageType: content', 'elements:', '  - elementId: t', '    elementType: text', '    bounds: [10, 20, 300, 40]', '    content: {text: "单页文档", style: "$body"}', ''].join('\n') })
+  let b1 = null
+  try {
+    const c = await resolveDeck(d1)
+    await renderDeck(c, {})
+    const r = await exportPptx(c, { out: join(d1, 'out.pptx'), engine: 'pptd' })
+    const z = zipRead(await readFile(r.file))
+    const slides = [...z.keys()].filter((k) => /^ppt\/slides\/slide\d+\.xml$/.test(k))
+    if (slides.length !== 1) b1 = new Error(`slides=${slides.length}`)
+  } catch (e) { b1 = e }
+  ok('B1 单页 deck → export 恰 1 张 slide', b1 === null, b1 ? String(b1) : '')
+  await rmFixture(d1)
+  // B2 wrap=false 水平溢出门禁
+  const d2 = await fixture('wrap', ['version: 1', 'title: x', 'size: [960, 540]', 'pages:', '  - pages/01.yaml', ''].join('\n'),
+    { 'pages/01.yaml': ['pageType: content', 'elements:', '  - elementId: t', '    elementType: text', '    bounds: [10, 20, 100, 30]', '    content: {text: "这是一段非常长的文本用来触发水平溢出判断", fontSize: 14, wrap: false}', ''].join('\n') })
+  let b2 = null
+  try {
+    const c = await resolveDeck(d2)
+    const r = await renderDeck(c, {})
+    if (!verifyDeck(r.layout).text.includes('水平溢出')) b2 = new Error('no horizontal overflow error')
+  } catch (e) { b2 = e }
+  ok('B2 wrap=false 水平溢出 → 门禁 error', b2 === null, b2 ? String(b2) : '')
+  await rmFixture(d2)
+}
+
+// ── C. 幂等 / 重复调用 ──────────────────────────────────────────
+{
+  // C1 同一导出路径写两次（覆盖）→ 成功且 zip 可读
+  const d1 = await fixture('idem', ['version: 1', 'title: idem', 'size: [960, 540]', 'pages:', '  - pages/01.yaml', ''].join('\n'),
+    { 'pages/01.yaml': ['pageType: content', 'elements:', '  - elementId: t', '    elementType: text', '    bounds: [10, 20, 200, 40]', '    content: {text: "幂等"}', ''].join('\n') })
+  let c1 = null
+  try {
+    const c = await resolveDeck(d1)
+    await exportPptx(c, { out: join(d1, 'x.pptx'), engine: 'pptd' })
+    const r = await exportPptx(c, { out: join(d1, 'x.pptx'), engine: 'pptd' })
+    const z = zipRead(await readFile(r.file))
+    if (!z.has('ppt/presentation.xml')) c1 = new Error('rewritten zip unreadable')
+  } catch (e) { c1 = e }
+  ok('C1 同路径导出两次（覆盖）→ 产物可读', c1 === null, c1 ? String(c1) : '')
+  await rmFixture(d1)
+}
+
+// ── D. 性能上限（100 页渲染 < 10s）───────────────────────────────
+{
+  const pagesRefs = []
+  const pages = {}
+  for (let i = 1; i <= 100; i++) {
+    pagesRefs.push(`  - pages/${String(i).padStart(2, '0')}.yaml`)
+    pages[`pages/${String(i).padStart(2, '0')}.yaml`] = [
+      'pageType: content', 'elements:',
+      '  - elementId: t', '    elementType: text', '    bounds: [60, 60, 400, 40]',
+      `    content: {text: "第 ${i} 页 / 性能基线样本 0123456789"}`, ''].join('\n')
+  }
+  const d = await fixture('perf', ['version: 1', 'title: perf', 'size: [960, 540]', 'pages:', ...pagesRefs, ''].join('\n'), pages)
+  let d1 = null
+  let ms = 0
+  try {
+    const c = await resolveDeck(d)
+    const t0 = Date.now()
+    const r = await renderDeck(c, {})
+    ms = Date.now() - t0
+    if (r.htmlFiles.length !== 100) d1 = new Error(`html=${r.htmlFiles.length}`)
+  } catch (e) { d1 = e }
+  ok('D1 100 页渲染 < 10s（性能上限）', d1 === null && ms < 10000, `${ms}ms`)
+  await rmFixture(d)
+}
+
+// ── E. 媒体元组经 splice 链路不坏（image 页 → splice 进 seed）─────
+{
+  const tinyPng = Buffer.from('iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mP8z8BQDwAEhQGAhKmMIQAAAABJRU5ErkJggg==', 'base64')
+  const d = await fixture('media', ['version: 1', 'title: media', 'size: [960, 540]',
+    'theme: {colors: {ink: "#3E4E63"}, textStyles: {body: {fontSize: 14, color: "$ink"}}}',
+    'pages:', '  - pages/01.yaml', '  - pages/02.yaml', ''].join('\n'),
+    {
+      'pages/01.yaml': ['pageType: content', 'elements:', '  - elementId: img', '    elementType: image', '    bounds: [10, 20, 120, 90]', '    src: "media/dot.png"', '    fit: cover', ''].join('\n'),
+      'pages/02.yaml': ['pageType: content', 'elements:', '  - elementId: t', '    elementType: text', '    bounds: [10, 20, 200, 40]', '    content: {text: "第二页"}', ''].join('\n'),
+    })
+  await mkdir(join(d, 'media'), { recursive: true })
+  await writeFile(join(d, 'media', 'dot.png'), tinyPng)
+  let e1 = null
+  let spl = null
+  try {
+    const c = await resolveDeck(d)
+    const seed = await exportPptx(c, { out: join(d, 'seed.pptx'), engine: 'pptd' })
+    spl = await spliceIntoSource({ deckDir: d, source: seed.file, page: 1, sourcePage: 1, out: join(d, 'spliced.pptx') })
+    const z = zipRead(await readFile(spl.out))
+    if (!z.has('ppt/media/dot.png')) e1 = new Error('media not merged')
+    if (![...z.keys()].some((k) => k.includes('_rels/slide1.xml.rels'))) e1 = e1 ?? new Error('rels missing')
+    const rels = decodeXml(z.get('ppt/slides/_rels/slide1.xml.rels'))
+    if (!rels.includes('ppt/media/dot.png') && !rels.includes('../media/dot.png')) e1 = e1 ?? new Error('media rel not referenced')
+  } catch (e) { e1 = e }
+  ok('E1 含图片页 splice → 媒体合并 + rels 引用 + 产物可读', e1 === null && spl !== null,
+    e1 ? String(e1).slice(0, 120) : `${spl?.mediaAdded} added`)
+  await rmFixture(d)
+}
+
+// ── F. 鲁棒性统计输出 ───────────────────────────────────────────
+console.log(`\n==== 预检结果：${pass} 通过 / ${fail} 失败 ====`)
+process.exit(fail > 0 ? 1 : 0)

package/scripts/probe-asset-freshness.mjs

@@ -0,0 +1,57 @@
+/**
+ * 探针：同一 release 资产 URL 在中途被 --clobber 覆盖后，**这个 URL 到底还能不能拿到新字节**？
+ * 背景：release-sync 的发布纪律是"同 tag 资产原地更新（--clobber，updated_at 变化即新包）"，
+ * 而 `dsh plugin add <URL>` 装到的却是旧字节（挂载副本缺最新代码）。这里绕开 pnpm 直接 GET，
+ * 判断是 **CDN 缓存** 还是 **pnpm 按 URL 复用**。
+ *
+ * 判定口径（2026-09-15 修）：**sha256 说了算**。原来只有"marker 在不在包里"一条，而 marker 是按
+ * `scripts/release-sync.mjs` 这一个文件查的——传一个不在该文件里的 marker 会打印"URL 提供旧字节"这种
+ * **假阴性判决**（本机实测踩到：sha 明明等于新资产）。所以：
+ *   - 传 `<url> <marker> <期望 sha256>` → 判决完全按 sha 比对（权威）；
+ *   - 只传 marker 时，未命中会显式提示"marker 可能选错了文件"，不再直接断言"旧字节"。
+ * 用法：
+ *   node scripts/probe-asset-freshness.mjs <asset-url>                      # 默认 marker '⑤b'
+ *   node scripts/probe-asset-freshness.mjs <asset-url> 构建戳               # 指定 marker（须在 release-sync.mjs 里）
+ *   node scripts/probe-asset-freshness.mjs <asset-url> 构建戳 <期望sha256>  # **权威判决**：sha 比对
+ */
+import { writeFileSync, readFileSync, rmSync, existsSync } from 'node:fs'
+import { join } from 'node:path'
+import { tmpdir } from 'node:os'
+import { createHash } from 'node:crypto'
+import { execSync } from 'node:child_process'
+
+const url = process.argv[2]
+if (!url) { console.error('用法: node probe-asset-freshness.mjs <asset-url> [marker] [期望sha256]'); process.exit(2) }
+const marker = process.argv[3] ?? '⑤b'
+const expectSha = (process.argv[4] ?? '').trim().toLowerCase().replace(/^sha256:/, '')
+const shaDecided = /^[0-9a-f]{64}$/.test(expectSha)
+const MARKER_FILE = 'scripts/release-sync.mjs'
+
+const out = join(tmpdir(), `asset-probe-${Date.now()}.tgz`)
+console.log('URL:', url)
+const t0 = Date.now()
+const res = await fetch(url, { redirect: 'follow', headers: { 'cache-control': 'no-cache' } })
+console.log('HTTP', res.status, '→', res.url, `(${Date.now() - t0}ms)`)
+const buf = Buffer.from(await res.arrayBuffer())
+writeFileSync(out, buf)
+const gotSha = createHash('sha256').update(buf).digest('hex')
+console.log('下载字节数 =', buf.length, '｜ sha256 =', gotSha)
+
+// 解包找 marker（tar -xzf 到一个临时目录）
+const dir = out + '-x'
+execSync(`mkdir "${dir}" 2>nul & tar -xzf "${out}" -C "${dir}"`, { stdio: 'ignore', shell: 'cmd.exe' })
+const target = join(dir, 'package', ...MARKER_FILE.split('/'))
+const hit = existsSync(target) ? readFileSync(target, 'utf8').includes(marker) : null
+console.log(`包内 ${MARKER_FILE} 含 "${marker}"：${hit === null ? '(文件缺失)' : hit}`)
+rmSync(dir, { recursive: true, force: true })
+rmSync(out, { force: true })
+
+if (shaDecided) {
+  const same = gotSha === expectSha
+  console.log(`sha256 比对：期望 ${expectSha}\n          实际 ${gotSha} → ${same ? '一致' : '不一致'}`)
+  console.log(`\n==== 判定（按 sha256，权威）：URL 现在提供的是${same ? '**新字节**' : '**旧字节**'}${same ? '（CDN 未缓存旧版 → 若包管理器仍装到旧版，问题在 pnpm 按 URL 复用）' : '（URL 层面就是旧的 → GitHub 资产 CDN 缓存）'} ====`)
+} else {
+  console.log(hit
+    ? `\n==== 判定（按 marker，仅供线索）：URL 现在提供的是**新字节**（marker 命中 ${MARKER_FILE}）====`
+    : `\n==== 判定：**未按 sha 判定**——marker 未命中 ${MARKER_FILE}，这**不等于**"URL 是旧字节"（marker 可能选错文件）。\n     要权威判定请传第 3 个参数：<期望 sha256>（可从 .sync-state.json 的 remoteSha 取）====`)
+}

package/scripts/probe-effect-semantics.mjs

@@ -0,0 +1,69 @@
+/**
+ * Cordis `ctx.effect` 语义探针（docs/01 决策 12 / docs/02 §2.12 的证据）
+ *
+ * 结论（本脚本可复跑自证）：`ctx.effect(cb)` **立即执行 cb**，并把 **cb 的返回值**当作 disposer；
+ * 它**不是**"把 cb 当清理函数"。
+ *
+ * 为什么值得留一个脚本：本仓库曾有两处按相反理解写代码——
+ *   ① `preview-server` 的路由 refcount 把清理体写在 cb 体内 ⇒ 注册当刻就 `count--` 并置 `cancelled=true`，
+ *      文档承诺的"首个注册者真注册、最后卸载者真卸载"从未成立（路由注册后立即被取消）；
+ *   ② 新增的装配防重第一版同样写法 ⇒ 防重完全失效（smoke §40 行为断言当场抓到）。
+ * 而 smoke 里的**假 ctx** 当时也写反了契约，于是真 bug 在测试里看起来是对的——**测试替身错了，测试就在替 bug 背书**。
+ * 所以：契约可疑时跑这个探针，别靠读注释。
+ *
+ * 用法：`node scripts/probe-effect-semantics.mjs`（找不到 cordis 时跳过，退出码 0）。
+ */
+import { existsSync, readFileSync } from 'node:fs'
+import { join } from 'node:path'
+import { pathToFileURL } from 'node:url'
+import { homedir } from 'node:os'
+import { execSync } from 'node:child_process'
+
+const candidates = []
+// 候选路径（不依赖能 spawn npm：Windows 上 npm 是 npm.cmd，execFileSync 不带 shell 会 ENOENT）
+const relCordis = join('@deepseek-ai', 'dsh', 'node_modules', '@deepseek-ai', 'cordis', 'lib', 'index.js')
+if (process.env.APPDATA) candidates.push(join(process.env.APPDATA, 'npm', 'node_modules', relCordis))
+for (const cmd of ['npm', 'npm.cmd']) {
+  try {
+    // 用字符串命令（shell 执行）——避免 execFileSync(args)+shell 的 DEP0190 警告
+    const globalRoot = execSync(`${cmd} root -g`, { encoding: 'utf8' }).trim()
+    if (globalRoot) candidates.push(join(globalRoot, relCordis))
+    break
+  } catch { /* 该写法不可用，试下一个 */ }
+}
+const dshHome = process.env.DSH_HOME ?? join(homedir(), '.dsh')
+candidates.push(join(dshHome, 'profiles', 'web', 'node_modules', '@deepseek-ai', 'cordis', 'lib', 'index.js'))
+
+const found = candidates.find((p) => existsSync(p))
+if (!found) {
+  console.log('⚠ 跳过：找不到 @deepseek-ai/cordis（本探针需要一个可 import 的真库）')
+  console.log('  候选路径：\n   - ' + candidates.join('\n   - '))
+  process.exit(0)
+}
+
+const { Context } = await import(pathToFileURL(found).href)
+const ctx = new Context()
+const log = []
+
+const disposer = ctx.effect(() => {
+  log.push('cb-body')
+  return () => log.push('returned-cleanup')
+}, 'probe')
+
+const immediate = log.includes('cb-body')
+console.log(`cordis = ${found}`)
+console.log(`调用 effect 后立即观察到的回调执行：${immediate ? '已执行（真语义：cb 立即跑）' : '未执行'}`)
+console.log(`effect 返回值类型：${typeof disposer}`)
+
+let cleanupRan = false
+if (typeof disposer === 'function') {
+  const r = disposer()
+  if (r && typeof r.then === 'function') await r
+  await new Promise((res) => setTimeout(res, 10))
+  cleanupRan = log.includes('returned-cleanup')
+}
+console.log(`dispose 后"cb 返回的函数"被执行：${cleanupRan ? '是（返回值 = disposer）' : '否'}`)
+
+const okAll = immediate && typeof disposer === 'function' && cleanupRan
+console.log(`\n==== 语义探针：${okAll ? '符合预期（cb 立即执行 + 返回值为 disposer）' : '与预期不符——若 Cordis 升级改了语义，须复核 index.js 防重与 preview-server refcount'} ====`)
+process.exit(okAll ? 0 : 1)

package/scripts/probe-reparse-safety.mjs

@@ -0,0 +1,32 @@
+/**
+ * 重解析点安全探针：Node 的 rmSync(recursive) 会不会**跟随 junction**把目标目录也删掉？
+ * 背景：release-sync 会 `rmSync(D:\plugins\package, {recursive:true})`，而该目录里 install.mjs 建过
+ * `node_modules/yaml` → profile 的 yaml 目录（junction）。若 Node 跟随重解析点，就会**清空 profile 的 yaml**
+ *（2026-09-14 的真实事故形态——那次是 PowerShell 的 Remove-Item -Recurse 干的）。
+ * 结论直接决定 release-sync 的删除写法是否安全。
+ */
+import { mkdirSync, writeFileSync, readFileSync, rmSync, existsSync, symlinkSync, lstatSync } from 'node:fs'
+import { join } from 'node:path'
+import { tmpdir } from 'node:os'
+
+const base = join(tmpdir(), `reparse-probe-${Date.now()}`)
+const canary = join(base, 'canary')      // 被指向的"重要目录"
+const victim = join(base, 'victim')      // 将被递归删除的目录
+mkdirSync(canary, { recursive: true })
+mkdirSync(join(victim, 'node_modules'), { recursive: true })
+writeFileSync(join(canary, 'IMPORTANT.txt'), 'must survive', 'utf8')
+writeFileSync(join(victim, 'node_modules', 'filler.txt'), 'x', 'utf8')
+symlinkSync(canary, join(victim, 'node_modules', 'linked'), 'junction')
+
+const st = lstatSync(join(victim, 'node_modules', 'linked'))
+console.log(`junction 建立：isSymbolicLink=${st.isSymbolicLink()} isDirectory=${st.isDirectory()}`)
+
+rmSync(victim, { recursive: true, force: true })
+
+const canaryAlive = existsSync(join(canary, 'IMPORTANT.txt'))
+const victimGone = !existsSync(victim)
+console.log(`victim 已删除：${victimGone}`)
+console.log(`canary 内容仍在：${canaryAlive}${canaryAlive ? `（内容="${readFileSync(join(canary, 'IMPORTANT.txt'), 'utf8')}"）` : ' ← **被删空了！**'}`)
+console.log(`\n==== 结论：Node rmSync(recursive) ${canaryAlive ? '**不跟随** junction（release-sync 的删法安全）' : '**会跟随** junction（必须改成先 rmdir 链接）'} ====`)
+rmSync(base, { recursive: true, force: true })
+process.exit(canaryAlive ? 0 : 1)

package/scripts/rebuild-templates-c11.mjs

@@ -0,0 +1,69 @@
+/**
+ * v0.11.0 模板骨架层重建：4 套外部模板重导（custGeom/alpha/形状文本保真升级），
+ * 保留 styleAudit + 双轨字段（template.pptx/previews/），幂等。
+ * 流程：备份 template.yaml（styleAudit）→ rm 模板目录 → importPptx(桌面源) → registerTemplate →
+ *       迁移脚本补双轨资产 → 合并 styleAudit。
+ *
+ * 【2026-09-18 状态（1.0.4）】它重建的那 4 套模板已移出随包发行物，桌面源目录
+ * `C:/Users/11867/Desktop/ppt模板库` 也已不存在 ⇒ 默认调用必然失败。保留为**一次完整重建的参考流程**
+ * （收纳自己的模板时按同样顺序走：importPptx → ppt_template_add → 可选补双轨）。
+ */
+import { readFile, writeFile, mkdir, rm, readdir, copyFile } from 'node:fs/promises'
+import { join, dirname, basename } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { homedir } from 'node:os'
+import { existsSync } from 'node:fs'
+import YAML from 'yaml'
+
+const ROOT = join(dirname(fileURLToPath(import.meta.url)), '..')
+const TPL_DIR = join(ROOT, 'templates')
+const DESK = 'C:\\Users\\11867\\Desktop\\ppt模板库'
+const ORIG = join(homedir(), '.dsh', 'ppt-studio', 'fidelity', 'orig')
+
+const MODELS = [
+  { file: '实用毕业设计论文答辩PPT模板.pptx', id: '实用毕业设计论文答辩ppt模板', name: '实用毕业设计论文答辩PPT模板', style: '学术答辩', scene: '毕业设计论文答辩' },
+  { file: '极简实用部门工作总结PPT模板.pptx', id: '极简实用部门工作总结ppt模板', name: '极简实用部门工作总结PPT模板', style: '工作总结', scene: '部门工作总结' },
+  { file: '深蓝质感论文答辩PPT模板.pptx', id: '深蓝质感论文答辩ppt模板', name: '深蓝质感论文答辩PPT模板', style: '学术答辩', scene: '论文答辩' },
+  { file: '简约商务.pptx', id: '简约商务', name: '简约商务', style: '商务', scene: '商务汇报' },
+]
+
+const { importPptx } = await import('../src/pptd/import-pptx.js')
+const { registerTemplate } = await import('../src/templates.js')
+
+for (const m of MODELS) {
+  const tplDir = join(TPL_DIR, m.id)
+  if (!existsSync(tplDir)) { console.log(`SKIP（模板目录不存在）：${m.id}`); continue }
+  // ① 备份 styleAudit
+  const metaFile = join(tplDir, 'template.yaml')
+  const oldMeta = existsSync(metaFile) ? (YAML.parse(await readFile(metaFile, 'utf8')) ?? {}) : {}
+  // ② rm 模板目录（重建）
+  await rm(tplDir, { recursive: true, force: true })
+  // ③ 重导 + 收纳
+  const tmp = join(homedir(), '.dsh', 'ppt-studio', 'rebuild-tmp', m.id)
+  await rm(tmp, { recursive: true, force: true })
+  const src = join(DESK, m.file)
+  const imp = await importPptx(src, tmp)
+  const reg = await registerTemplate(tmp, { id: m.id, name: m.name, style: m.style, scene: m.scene }, {})
+  console.log(`+ 重建 ${m.id}：${imp.pages} 页（reg id=${reg.id} 冲突=${reg.id !== m.id ? reg.id : '无'}）`)
+  // ④ 双轨资产（template.pptx + previews/ 从桌面/已渲染 PNG 补）
+  const tplNew = join(TPL_DIR, reg.id)
+  if (!existsSync(join(tplNew, 'template.pptx')) && existsSync(src)) await copyFile(src, join(tplNew, 'template.pptx'))
+  if (!existsSync(join(tplNew, 'previews')) && existsSync(join(ORIG, m.file.replace(/\.pptx$/i, '')))) {
+    await mkdir(join(tplNew, 'previews'), { recursive: true })
+    for (const f of (await readdir(join(ORIG, m.file.replace(/\.pptx$/i, '')))).filter((x) => /\.png$/i.test(x))) {
+      await copyFile(join(ORIG, m.file.replace(/\.pptx$/i, ''), f), join(tplNew, 'previews', f))
+    }
+  }
+  // ⑤ 合并 styleAudit + 双轨字段
+  const metaNew = YAML.parse(await readFile(join(tplNew, 'template.yaml'), 'utf8')) ?? {}
+  const merged = {
+    ...metaNew,
+    ...(existsSync(join(tplNew, 'template.pptx')) ? { sourcePptx: 'template.pptx' } : {}),
+    ...(existsSync(join(tplNew, 'previews')) ? { previews: 'previews' } : {}),
+    ...(oldMeta.styleAudit ? { styleAudit: oldMeta.styleAudit } : {}),
+  }
+  await writeFile(join(tplNew, 'template.yaml'), YAML.stringify(merged))
+  console.log(`  meta：双轨字段 ✓ / styleAudit ${oldMeta.styleAudit ? '保留 ✓' : '（无）'}`)
+  await rm(tmp, { recursive: true, force: true }).catch(() => {})
+}
+console.log('\n完成')

package/scripts/regression-real.mjs

@@ -0,0 +1,84 @@
+/**
+ * 真实资产回归（L1 层，非 smoke 的合成样例）：
+ *  1. 19 页产能 deck（若存在）：resolveDeck → render → verify（0 错误）→ export（0 autoFit）→ zip 结构
+ *  2. WPS UTF-16 fixture：import → 页数/媒体正确
+ * 资产缺失时打印 skip（本机路径可配置）。
+ */
+import { join, dirname } from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { existsSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { resolveDeck } from '../lib/pptd/schema.js'
+import { renderDeck } from '../lib/pptd/render-html.js'
+import { verifyDeck } from '../lib/verify.js'
+import { exportPptx } from '../lib/pptd/export-pptx.js'
+import { importPptx } from '../lib/pptd/import-pptx.js'
+import { zipRead } from '../lib/zips.js'
+
+const root = join(dirname(fileURLToPath(import.meta.url)), '..')
+const REAL_DECK = process.env.PPT_REAL_DECK ?? 'D:/SharkCode/fighter_capacity/deck'
+const WPS_PPTX = process.env.PPT_WPS_FIXTURE ?? join(root, 'fixtures', 'Anomaly_Detection_Figures.pptx')
+
+let pass = 0
+let fail = 0
+let skip = 0
+const ok = (name, cond, extra = '') => {
+  console.log(`${cond ? '✓' : '✗'} ${name}${extra ? ' — ' + extra : ''}`)
+  cond ? pass++ : fail++
+}
+const skipNote = (name, path) => {
+  console.log(`⏭ ${name}（资产缺失，跳过：${path}）`)
+  skip++
+}
+
+// 1. 真实 deck（产能项目 19 页）
+if (existsSync(join(REAL_DECK, 'deck.yaml'))) {
+  try {
+    const ctx = await resolveDeck(REAL_DECK)
+    const r = await renderDeck(ctx, {})
+    const v = verifyDeck(r.layout)
+    const errors = v.text.split('\n').filter((l) => l.includes('[✗]')).length
+    ok('真实 deck：resolveDeck + render', ctx.pages.length >= 19, `${ctx.pages.length} pages`)
+    ok('真实 deck：verify 0 错误（门禁）', errors === 0, `errors=${errors}`)
+    const exp = await exportPptx(ctx, { out: 'out-real-regression.pptx', engine: 'pptd' })
+    ok('真实 deck：导出 0 缩字（E2 承诺）', exp.autoFit.length === 0, `autoFit=${JSON.stringify(exp.autoFit)}`)
+    const parts = zipRead(await readFile(exp.file))
+    ok('真实 deck：OOXML 结构完整', parts.has('[Content_Types].xml') && parts.has('ppt/presentation.xml'))
+    // 表格导出回读断言（1.0.1：表格空白事故 → graphicFrame 嵌套 a:xfrm 非法结构 / 缺 tableStyleId）
+    const tables = ctx.pages.flatMap((p) => (p.page.elements ?? []).filter((e) => e.elementType === 'table').map((e) => e.elementId))
+    if (tables.length) {
+      const slidesXml = []
+      for (let i = 1; i <= ctx.pages.length; i++) slidesXml.push(parts.get(`ppt/slides/slide${i}.xml`)?.toString('utf8') ?? '')
+      const badFrame = slidesXml.filter((x) => /<p:xfrm><a:xfrm>/.test(x))
+      ok('真实 deck：表格 graphicFrame 无嵌套 a:xfrm', badFrame.length === 0, `违规帧=${badFrame.length}`)
+      const styled = slidesXml.filter((x) => x.includes('<a:tableStyleId>'))
+      ok('真实 deck：表槽含 tableStyleId', styled.length >= tables.length, `tables=${tables.length} styled=${styled.length}`)
+    }
+  } catch (e) {
+    ok('真实 deck：全链回归', false, e?.message)
+  } finally {
+    const { rm } = await import('node:fs/promises')
+    await rm(join(REAL_DECK, 'out-real-regression.pptx'), { force: true })
+  }
+} else {
+  skipNote('真实 deck 回归', REAL_DECK)
+}
+
+// 2. WPS UTF-16 fixture
+if (existsSync(WPS_PPTX)) {
+  try {
+    const outDir = join(root, 'examples', 'import-realtest-regression')
+    const imp = await importPptx(WPS_PPTX, outDir)
+    ok('WPS fixture：导入页数/媒体', imp.pages === 2 && imp.media.length === 2, `${imp.pages} pages, ${imp.media.length} media`)
+    const ctxW = await resolveDeck(outDir)
+    const rW = await renderDeck(ctxW, { out: 'preview-regression' })
+    ok('WPS fixture：导入项目可渲染', rW.htmlFiles.length === 2)
+  } catch (e) {
+    ok('WPS fixture：导入回归', false, e?.message)
+  }
+} else {
+  skipNote('WPS fixture 回归', WPS_PPTX)
+}
+
+console.log(`\n==== 真实回归：${pass} 通过 / ${fail} 失败 / ${skip} 跳过 ====`)
+process.exit(fail > 0 ? 1 : 0)