dsh-ppt-studio 1.1.2 → 1.1.4

package/scripts/smoke.mjs

@@ -6,6 +6,7 @@ import { join, dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { rm, mkdir } from 'node:fs/promises'
 import { existsSync } from 'node:fs'
+import { homedir } from 'node:os'
 import zlib from 'node:zlib'
 import { resolveDeck } from '../lib/pptd/schema.js'
 import { renderDeck } from '../lib/pptd/render-html.js'
@@ -17,6 +18,16 @@ import { zipRead, decodeXml } from '../lib/zips.js'
 const root = join(dirname(fileURLToPath(import.meta.url)), '..')
 const smokeDir = join(root, 'examples', 'smoke')
 
+// ── 全局用户目录隔离（2026-09-26，方案 B 第二批）──────────────────────────────────────────
+// 为什么：`state.js` / `preview-server.js` 的用户目录此前是**模块常量** `homedir()/.dsh`（忽略 DSH_HOME），
+// 而 `templates.js` / `index.js`(diag) 是调用时求值 ⇒ 本机 `npm test` 会把 smoke 模板与预览缓存写进
+// 开发机**真实**的 `~/.dsh/ppt-studio/`（实测复现、清理过两次），与下面那句"不碰真实目录"的承诺冲突。
+// 现在四处都统一到 `src/home.js`（调用时求值）⇒ 这里把 DSH_HOME 指到构建目录内的临时 home，
+// **整轮 smoke 的用户层读写都关在里面**，真实用户目录一个字节都不碰。位置必须在任何用户目录解析之前。
+const PREV_SMOKE_HOME = process.env.DSH_HOME
+const SMOKE_HOME = join(smokeDir, '.tmp-home')
+process.env.DSH_HOME = SMOKE_HOME
+
 let pass = 0
 let fail = 0
 const ok = (name, cond, extra = '') => {
@@ -396,6 +407,24 @@ ok('v0.3.2：D4 导入探测跨页带 → 建议 safeArea 注释（未启用）'
 const bandPageYaml = await (await import('node:fs/promises')).readFile(join(bandDeck, 'imported', 'pages', 'slide_01.yaml'), 'utf8')
 ok('v0.4：导入保样式——text color/fontFamily/italic 回环', bandPageYaml.includes('fontFamily') && bandPageYaml.includes('2E4B9F'), bandPageYaml.split('\n').filter((l) => l.includes('fontFamily') || l.includes('color') || l.includes('italic')).join(' | '))
 ok('v0.4：import-styles.json 生成（含样式清单）', (await import('node:fs/promises')).stat(join(bandDeck, 'imported', 'import-styles.json')).then(() => true).catch(() => false))
+// ── 16b. 启发 B（审计半，2026-09-26 第二轮）：重建有损审计 ────────────────────────────────
+// 为什么必须钉：我们的导出来自 DSL 中间层，**不支持**阴影/动画/超链接/切换/SmartArt 等；
+// "整册重渲"对既有精美 PPT 是有损的，而这件事此前**不可见**（用户以为无损）。审计要放进导入产物与输出行。
+// 判据来源：`ppt_import` 落盘 `<outDir>/loss-audit.json`（独立文件，理由见 import-pptx.js 注释）。
+const { lossAuditLine } = await import('../lib/pptd/loss-audit.js')
+const lossAuditJson = JSON.parse(await (await import('node:fs/promises')).readFile(join(bandDeck, 'imported', 'loss-audit.json'), 'utf8'))
+ok('启发B：ppt_import 落盘 loss-audit.json（7 类齐全且每类 count === evidence.length）',
+  lossAuditJson.version === 1
+    && lossAuditJson.categories.map((c) => c.id).join(',') === 'animation,effect,hyperlink,transition,smartart,media,gradient'
+    && lossAuditJson.categories.every((c) => c.count === c.evidence.length),
+  `version=${lossAuditJson.version}｜类别=${lossAuditJson.categories.map((c) => c.id).join(',')}`)
+ok('启发B：自产导出回环审计 **0 命中**（防误报：空 a:effectLst / 主题 effectStyleLst 不算阴影）',
+  lossAuditJson.clean === true && lossAuditJson.total === 0 && String(bandImp.lossLine).includes('未发现'),
+  `clean=${lossAuditJson.clean} total=${lossAuditJson.total}`)
+ok('启发B：干净源稿的输出行**不制造噪声**（无 ⚠、无 ppt_splice 建议）',
+  !String(bandImp.lossLine).includes('ppt_splice') && !String(bandImp.lossLine).includes('⚠'), String(bandImp.lossLine).slice(0, 90))
+ok('启发B：输出行由报告生成（lossLine === lossAuditLine(落盘 JSON)），不是手写文案',
+  bandImp.lossLine === lossAuditLine(lossAuditJson), String(bandImp.lossLine).slice(0, 90))
 ok('v0.4：theme 聚合建议块写入 deck.yaml', bandDeckYaml.includes('# 建议主题') && bandDeckYaml.includes('textStyles'))
 const mnErr = validatePage({ elements: [{ elementId: 'l', elementType: 'line', points: [[10, 10], [100, 10], [200, 10]] }] }, 'test.yaml')
 ok('v0.4：多点折线显式报错（P2-3，不再静默截断）', mnErr !== null && mnErr.messages.some((m) => m.includes('仅支持 2 点')), mnErr?.messages?.join('; '))
@@ -437,13 +466,10 @@ ok('v0.6.2：随包模板每套都自包含（元数据齐 + 有预览图）',
   builtins.map((t) => `${t.id}:${t.preview ? 'png' : 'MISSING'}`).join(' '))
 
 // ── 17b. v1.0.6 用户自建模板库：两层目录 + 入库（.pptx）/ 物化 / 删除 ──
-// DSH_HOME 指到临时目录：`userTemplatesDir()` 是**按调用求值**的，所以这里能安全地隔离，
-// 不碰开发机/CI 上真实的 `~/.dsh/ppt-studio/templates`。
+// 用户层目录现在是**整轮隔离**的（见文件顶部：DSH_HOME → `examples/smoke/.tmp-home`），
+// 所以这里不必再单独切换 DSH_HOME，也不会碰到开发机/CI 上真实的 `~/.dsh/ppt-studio/templates`。
 {
-  const libHome = join(root, 'examples', '.tmp-tpl-home')
-  await rm(libHome, { recursive: true, force: true })
-  const prevHome = process.env.DSH_HOME
-  process.env.DSH_HOME = libHome
+  const libHome = SMOKE_HOME
   try {
     const libUserDir = tplMod.userTemplatesDir()
     ok('v1.0.6：用户模板层在插件包之外（升级重新物化包也丢不了）',
@@ -474,9 +500,8 @@ ok('v0.6.2：随包模板每套都自包含（元数据齐 + 有预览图）',
       !!libRefuse && /随包/.test(libRefuse.message) && existsSync(join(tplMod.TEMPLATES_DIR, 'business-blue', 'template.yaml')),
       libRefuse?.message?.slice(0, 46) ?? '(没拦住)')
   } finally {
-    if (prevHome === undefined) delete process.env.DSH_HOME
-    else process.env.DSH_HOME = prevHome
-    await rm(libHome, { recursive: true, force: true })
+    // 这里**不**恢复 DSH_HOME、也不删 SMOKE_HOME：隔离是本轮 smoke 的全局前提（见文件顶部），
+    // 整轮结束后统一恢复与清理。
   }
 }
 let tplAllOk = true
@@ -555,7 +580,7 @@ ok('v0.7：内置模板正式页（首母版副本）0 错误', tplV0.text.split
 // 收纳清洗升级：registerTemplate 声明出界元素 + 剩余错误分类（bandDeck safeArea 外元素）
 const reg2 = await tplMod.registerTemplate(bandDeck, { id: `smoke-wash-${Date.now().toString(36)}`, name: '洗涤测试' }, {})
 ok('v0.7：收纳清洗——出界声明/重叠声明/剩余分类进入 meta', typeof reg2.meta.cleanup === 'string' && reg2.meta.cleanup.includes('剩余'), reg2.meta.cleanup ?? '')
-await (await import('node:fs/promises')).rm(join(tplMod.TEMPLATES_DIR, reg2.id), { recursive: true, force: true })
+await (await import('node:fs/promises')).rm(join(tplMod.userTemplatesDir(), reg2.id), { recursive: true, force: true })
 
 // ── 18. v0.5.1：外部模板收纳（ppt_template_add）——导入工程 → 模板库 ──────
 const regId = `smoke-tpl-${Date.now().toString(36)}`
@@ -567,7 +592,7 @@ const regWS = await tplMod.templateWorkspace(regId)
 const ctxReg = await resolveDeck(regWS.dir)
 ok('v0.5.1：收纳模板工作区可校验（theme/页面保留）', ctxReg.theme.colors.primary === '#2563EB' && ctxReg.pages.length === 3, `pages=${ctxReg.pages.length}`)
 // 清理测试模板
-await (await import('node:fs/promises')).rm(join(tplMod.TEMPLATES_DIR, regId), { recursive: true, force: true })
+await (await import('node:fs/promises')).rm(join(tplMod.userTemplatesDir(), regId), { recursive: true, force: true })
 
 // ── 19. v0.6.0：对话内预览（ppt_preview）——预览根构建 + 同源相对 URL ────
 const { buildPreview } = await import('../lib/preview-server.js')
@@ -669,7 +694,7 @@ if (previewSrc) {
 const dualCtx = await resolveDeck(dualWS)
 ok('v0.9.0：带 referenceTemplate 的 deck 通过校验（非渲染字段）', dualCtx.pages.length === 1 && dualCtx.deck.referenceTemplate?.id === dualId)
 // 清理双轨测试模板 + 假 source
-await (await import('node:fs/promises')).rm(join(tplMod.TEMPLATES_DIR, dualId), { recursive: true, force: true }).catch(() => {})
+await (await import('node:fs/promises')).rm(join(tplMod.userTemplatesDir(), dualId), { recursive: true, force: true }).catch(() => {})
 await rm(dualSrc, { force: true }).catch(() => {})
 await rm(dualWS, { recursive: true, force: true })
 
@@ -1949,6 +1974,36 @@ if (pyEnv.has) {
 } else {
   ok('python-pptx 兜底：生成脚本真跑出 .pptx，且 python-pptx 能把它读回（无 python-pptx：跳过）', true)
 }
+// 43.3 原生图表（2026-09-26 第二轮 ③）：兜底引擎的图表必须是**原生可编辑图表**
+// ——包里要有 `ppt/charts/*.xml`（图表部件）**与** `ppt/embeddings/*.xlsx`（内嵌数据工作簿，数据随文件走）。
+// 旧行为是"图表降级为表格"（用户拿到成品看不见图、也改不了数据），这条断言挡住回退。
+if (pyEnv.has) {
+  const chartDeck = join(pyDeck, 'charts')
+  await mkdir(join(chartDeck, 'pages'), { recursive: true })
+  await writeFile(join(chartDeck, 'deck.yaml'), ['version: 1', 'title: chart-py', 'size: [960, 540]', 'theme:',
+    '  colors: {primary: "#2563EB", text: "#1F2937"}', '  textStyles:',
+    '    body: {fontSize: 16, color: "$text"}', 'pages:', '  - pages/01.yaml', ''].join('\n'), 'utf8')
+  await writeFile(join(chartDeck, 'pages', '01.yaml'), ['pageType: content', 'elements:',
+    '  - elementId: bar', '    elementType: chart', '    bounds: [60, 60, 400, 260]',
+    '    chart: {type: bar, data: {cols: ["季度", "营收"], rows: [["Q1", 12], ["Q2", 18]]}}',
+    '  - elementId: pie', '    elementType: chart', '    bounds: [500, 60, 300, 260]',
+    '    chart: {type: pie, data: {cols: ["份额", "值"], rows: [["甲", 60], ["乙", 40]]}}', ''].join('\n'), 'utf8')
+  let pass433 = false
+  let info433 = ''
+  try {
+    const outC = join(chartDeck, 'out-charts.pptx')
+    await runPythonExport(await resolveDeck(chartDeck), outC)
+    const { zipRead } = await import('../lib/zips.js')
+    const keys = [...zipRead(readFileSync(outC)).keys()]
+    const charts = keys.filter((k) => k.includes('/charts/') && k.endsWith('.xml') && !k.includes('_rels')).length
+    const embeds = keys.filter((k) => k.includes('embeddings')).length
+    pass433 = charts === 2 && embeds === 2
+    info433 = `chart 部件=${charts} 内嵌工作簿=${embeds}（期望各 2）`
+  } catch (e) { info433 = String(e.message).slice(0, 220) }
+  ok('python-pptx 兜底：图表是**原生可编辑图表**（`ppt/charts/*.xml` + 内嵌数据工作簿各就位，不再降级为表格）', pass433, info433)
+} else {
+  ok('python-pptx 兜底：图表是原生可编辑图表（无 python-pptx：跳过）', true)
+}
 await rm(pyDeck, { recursive: true, force: true })
 
 // ── 44. 表格字号：audit 档的最小字号断言不得被表格自己架空（2026-09-18 新增）──────────────
@@ -2203,27 +2258,36 @@ ok('bundle：已转为公开发布 npm（无 private + publishConfig.access=publ
     `package=${rootPkg.name}｜patch=${insertRow?.name ?? '(缺)'}｜预设行=${presetRowName ?? '无（正确：随包预设不含插件行）'}`)
 }
 
-// 回滚后的装配形状（2026-09-18 第二次修订）：`apply()` 在**它被装入的那一层**注册全部能力面
-// （工具 / `/ppt` 命令 / `ppt_state` / 4 本技能）⇒ 装上插件，**所有会话**都能用。
-// 为什么放弃按预设隔离（两件都实测过，代码见 src/index.js 顶部）：
-//   ① 空白会话**切换**预设时 `agent-presets.swap` 会 `recompose(agent.ctx, id)`，但那一刻该 agent 已存在，
-//      我们的 `agent/created` 监听者才刚在这次组合中注册 ⇒ **不会**为它触发 ⇒ 切过去永远没有工具；
-//   ② 技能注册表分层、技能工具在**预设层**读，而我们只能注册到 agent 子层或 profile 根 ⇒ 技能永不出现。
+// 第四次修订（2026-09-26）**按预设隔离**：`apply()` 按"作用域档"分两种——
+//   · profile 档（`config.scope` 缺省/`auto`/`profile`）＝ 全局管道 + 预设声明；缺省档还追加一行
+//     **自定位行**（本包入口的绝对 `file://`），让本包被自己的预设再挂一次 ⇒ 预设档。
+//   · preset 档（`config.scope === 'preset'`，由自定位行挂载）＝ 22 工具 / `/ppt` 命令 / 4 技能 /
+//     语义路由 / 提示段**全部注册在预设作用域** ⇒ 只对该预设的会话可见（其他预设零影响）。
+// 安全网：声明失败、注册表不可见、或"声明成功但预设档实例未装配" ⇒ **自动回落全局能力面**。
+// 历史两次失败的正确结论（2026-09-26 源码 + 真宿主实测）：① 只对"插件自己按 agent 动态门控"成立；
+// ② 只对**裸包名/相对名**成立——绝对 `file://` 行不受 baseUrl 影响，正是它的解药。
 {
   const indexMod = await import('../lib/index.js')
+  const presetMod = await import('../lib/preset-delivery.js')
   let tools = 0, cmds = 0, skills = 0, listeners = 0
   const handlers = new Map()
-  const skillsSvc = { register: () => { skills++ } }
+  const skillsSvc = { register: () => { skills++ }, get: () => undefined }
   // 预设注册表 stub（**按 DSH 0.1.7 的真实契约**）：`register()` 对重复 id **抛错**
   // （真源码：`if (this.definitions.has(definition.id)) throw new Error(\`Duplicate agent preset: ${def.id}\`)`），
   // 并返回注销函数。于是"双挂载会不会把同一个预设声明两次"在这里是可判定的。
   const declared = []
   const seenIds = new Set()
+  // 真实时序：预设档实例是在 `register()` **期间**被挂载并 apply 的 ⇒ 隔离信号晚于 `apply()` 起点。
+  // 只有本开关打开时 stub 才在 register 里置位信号（用于"隔离生效"场景），别处一律不置位（走回落）。
+  let publishSignalOnRegister = false
   const registry = {
     register: (def) => {
       if (seenIds.has(def.id)) return Promise.reject(new Error(`Duplicate agent preset: ${def.id}`))
       seenIds.add(def.id)
       declared.push(def)
+      if (publishSignalOnRegister) {
+        globalThis.__pptScopeApplied = { at: Date.now(), presetId: def.id, pid: process.pid }
+      }
       return Promise.resolve(async () => { seenIds.delete(def.id) })
     },
   }
@@ -2240,65 +2304,134 @@ ok('bundle：已转为公开发布 npm（无 private + publishConfig.access=publ
     effect: (fn) => { fn(); return () => {} },
     logger: () => ({ info: () => {}, warn: () => {} }),
   })
-  // 装配防重计数是**进程级**（globalThis）：本节要自己从 0 起算，否则会被前面的用例带偏
-  delete globalThis.__pptCoreReg
-  indexMod.apply(makeCtx(), { presetIds: ['ppt'] })
+  // 装配防重 / 隔离信号都是**进程级**（globalThis）：本节要自己从 0 起算，否则会被前面的用例带偏。
   const flush = () => new Promise((r) => setTimeout(r, 0))
+  const grace = () => new Promise((r) => setTimeout(r, 600)) // 健康判定宽限 400ms + 余量
+  const resetAll = () => {
+    delete globalThis.__pptCoreReg
+    delete globalThis.__pptScopeApplied
+    declared.length = 0
+    seenIds.clear()
+  }
+
+  // ── 自定位行：隔离的载体（本包入口的**绝对 file:// URL**，预设行按注册表 baseUrl 解析 ⇒ 只有绝对名不受影响）
+  const selfRow = presetMod.selfPresetRow()
+  ok('§40 自定位行：指向本包入口的绝对 `file://` URL，且 `config.scope=preset` / `autoPreset=false`',
+    typeof selfRow?.name === 'string' && selfRow.name.startsWith('file:///') && /\/lib\/index\.js$/.test(selfRow.name)
+      && selfRow?.config?.scope === 'preset' && selfRow?.config?.autoPreset === false,
+    JSON.stringify(selfRow))
+  ok('§40 自定位行：入口文件真实存在（拿不到入口就不追加该行——宁可不隔离，也不加一行注定 broken 的）',
+    selfRow !== null && existsSync(fileURLToPath(selfRow.name)), String(selfRow?.name))
+
+  // ── 缺省档（auto）：声明 20 行（19 + 自定位行）→ 预设档实例未出现 ⇒ 自动回落全局 ────────────
+  resetAll()
+  indexMod.apply(makeCtx(), { presetIds: ['ppt'] })
   await flush() // 声明走的是异步队列（inject → register），让它落地
-  ok('回滚：apply 在**装入层**注册工具与命令面（22 工具 + /ppt 命令）——"装上即可用"',
-    tools === 22 && cmds >= 1, `tools=${tools} cmds=${cmds}`)
-  ok('回滚：4 本内嵌技能注册在**同一层**（技能注册表分层，技能工具在父层读——注册到子层就永远看不见）',
-    skills === 4, `skills=${skills}（应=4）`)
-  ok('回滚：隔离代码已移除（不再导出 mountForAgent，也不再用 roster 决定装配）',
-    indexMod.mountForAgent === undefined && tools === 22, `mountForAgent=${typeof indexMod.mountForAgent}｜tools=${tools}`)
-  // ── 0.1.7 的**真适配**：预设靠"向注册表声明"交付（写目录那条路已被上游删除）────────────
-  // 判据分三层：① 真的调到 register 了；② 声明形状对（id/名/序/行数/内容）；③ 双挂载不会声明两次。
-  const d0 = declared[0]
-  ok('0.1.7：预设靠 `agentPresets.register()` **声明**（不再写目录——上游已无目录发现路径）',
-    declared.length === 1 && d0?.id === 'ppt', `声明次数=${declared.length}｜id=${d0?.id ?? '(无)'}`)
-  ok('0.1.7：声明形状取自包内 `agent-presets/ppt/`（名字/简介/序号 + 19 条 standard 组合行）',
-    d0?.name === 'PPT 工作室' && d0?.order === 2 && d0?.plugins?.length === 19
-      && typeof d0?.description === 'string' && d0.description.length > 10,
-    `name=${d0?.name ?? '(无)'}｜order=${d0?.order}｜rows=${d0?.plugins?.length}｜desc=${d0?.description?.length ?? 0} 字`)
-  // `!!js` 必须**保真**成 Loader 认的 `{__jsExpr}`：降级成普通字符串会让
-  // `Boolean(<非空字符串>) === true` ⇒ Windows 上 pwsh 行被误停用（= 没有 shell）。
-  const rowOf = (def, id) => def?.plugins?.find((r) => r.id === id)
-  const bashD = rowOf(d0, 'tool-bash')?.disabled
-  const pwshD = rowOf(d0, 'tool-pwsh')?.disabled
-  ok('0.1.7：`!!js` 表达式保真为 `{__jsExpr}`（降级成字符串 ⇒ Windows 上 pwsh 行会被误停用）',
-    bashD?.__jsExpr === "process.platform === 'win32'" && pwshD?.__jsExpr === "process.platform !== 'win32'",
-    `bash=${JSON.stringify(bashD)}｜pwsh=${JSON.stringify(pwshD)}`)
-  const first = { tools, cmds, skills }
-  indexMod.apply(makeCtx(), { presetIds: ['ppt'] }) // 第二次装配（双挂载场景）
-  await flush()
-  ok('回滚：同进程第二次装配被防重拦下（首个生效 + 计数），不重复注册',
-    tools === first.tools && cmds === first.cmds && skills === first.skills,
-    `二次后 tools=${tools}（应=${first.tools}）cmds=${cmds} skills=${skills}｜refcount=${globalThis.__pptCoreReg?.count ?? '?'}`)
-  ok('0.1.7：双挂载也**不会重复声明**预设（真注册表对重复 id 直接 throw ⇒ 声明只发一次）',
-    declared.length === 1, `声明次数=${declared.length}（应=1）`)
-  ok('回滚：apply 装的全局管道仍在（预览路由/语义路由/提示段注入靠这些监听器）',
-    listeners >= 2, `listeners=${listeners}`)
+  ok('§40 缺省档：声明 20 行 = 19 条 standard 组合行 + 第 20 行自定位行（"只在预设里可见"靠它）',
+    declared.length === 1 && declared[0]?.plugins?.length === 20 && declared[0]?.plugins?.at(-1)?.id === 'ppt-studio-scope',
+    `声明=${declared.length} 次｜行数=${declared[0]?.plugins?.length}｜末行=${declared[0]?.plugins?.at(-1)?.id ?? '(无)'}`)
+  ok('§40 缺省档：健康判定期间**不注册**能力面（隔离生效时 profile 档必须零能力面）',
+    tools === 0 && cmds === 0 && skills === 0 && listeners === 0,
+    `tools=${tools} cmds=${cmds} skills=${skills} listeners=${listeners}`)
+  await grace()
+  ok('§40 自动回落：声明成功但预设档实例未装配 ⇒ 回落注册全局能力面（**功能不丢**，只是没隔离）',
+    tools === 22 && cmds >= 1 && skills === 4 && listeners >= 2
+      && presetMod.presetDeliveryStatus().isolation === 'profile-fallback',
+    `tools=${tools} cmds=${cmds} skills=${skills} listeners=${listeners}｜isolation=${presetMod.presetDeliveryStatus().isolation}`)
   let promptOk = false
   try {
     const h = handlers.get('system-prompt/assemble')
     const out = h ? await h({ sections: [] }, { agent: { session: { id: 'no-such-session-xyz' } } }, async () => ({ sections: [] })) : null
     promptOk = Boolean(out)
   } catch { promptOk = false }
-  ok('回滚：提示段注入不按预设门控（读不到会话状态时原样返回，不抛）', promptOk, promptOk ? '原样返回 ✓' : '未注册/抛错')
-  // 注册表缺失时必须**只告警不抛**（极简部署没有 agentPresets）：插件仍要完整可用
+  ok('§40 回落档：提示段注入仍在（读不到会话状态时原样返回，不抛）', promptOk, promptOk ? '原样返回 ✓' : '未注册/抛错')
+
+  // ── 隔离生效：预设档实例置位信号 ⇒ profile 档零能力面 ─────────────────────────────
+  resetAll()
+  const isoBase = { tools, cmds, skills, listeners }
+  publishSignalOnRegister = true // 忠实模拟：预设档实例在 register() 期间装配 ⇒ 信号晚于 apply 起点
+  indexMod.apply(makeCtx(), {})
+  await grace()
+  publishSignalOnRegister = false
+  ok('§40 隔离生效：预设档实例已装配 ⇒ profile 档**一个能力面都不注册**（其他预设零影响）',
+    tools === isoBase.tools && cmds === isoBase.cmds && skills === isoBase.skills && listeners === isoBase.listeners
+      && presetMod.presetDeliveryStatus().isolation === 'preset',
+    `增量 tools=${tools - isoBase.tools} cmds=${cmds - isoBase.cmds} skills=${skills - isoBase.skills} listeners=${listeners - isoBase.listeners}｜isolation=${presetMod.presetDeliveryStatus().isolation}`)
+
+  // ── 预设档（由自定位行挂载）：能力面 + 路由全在预设作用域；**不声明**预设 ─────────────────
+  resetAll()
+  const tierBase = { tools, cmds, skills, listeners }
+  indexMod.apply(makeCtx(), { scope: 'preset', autoPreset: false, presetIds: ['ppt'] })
+  await flush()
+  ok('§40 预设档：22 工具 + `/ppt` 命令 + 4 技能 + 2 监听器**全部注册在预设作用域**（隔离的实现主体）',
+    tools - tierBase.tools === 22 && cmds - tierBase.cmds >= 1 && skills - tierBase.skills === 4 && listeners - tierBase.listeners === 2,
+    `增量 tools=${tools - tierBase.tools} cmds=${cmds - tierBase.cmds} skills=${skills - tierBase.skills} listeners=${listeners - tierBase.listeners}`)
+  ok('§40 预设档：**不声明**预设（否则注册表对重复 id 直接 throw ⇒ 预设消失）',
+    declared.length === 0, `声明次数=${declared.length}`)
+  ok('§40 预设档：置位"预设档实例已装配"信号（profile 档据此判定隔离生效）',
+    typeof globalThis.__pptScopeApplied?.at === 'number' && globalThis.__pptScopeApplied.at > 0,
+    JSON.stringify(globalThis.__pptScopeApplied))
+
+  // ── 传统档（scope=profile）：不隔离、能力面全局，声明回到 19 行（不含自定位行）──────────────
+  resetAll()
+  const trBase = { tools, skills }
+  indexMod.apply(makeCtx(), { scope: 'profile' })
+  await grace()
+  ok('§40 传统档：能力面注册在装入层（全局可见），且声明**不含**自定位行（19 行）',
+    tools - trBase.tools === 22 && skills - trBase.skills === 4 && declared.length === 1
+      && declared[0]?.plugins?.length === 19 && declared[0]?.plugins?.at(-1)?.id !== 'ppt-studio-scope'
+      && presetMod.presetDeliveryStatus().isolation === 'profile',
+    `增量 tools=${tools - trBase.tools} skills=${skills - trBase.skills}｜行数=${declared[0]?.plugins?.length}｜isolation=${presetMod.presetDeliveryStatus().isolation}`)
+
+  // ── 注册表不可见：只告警不抛 + **立即**回落（不留"装上了却什么都没有"的窗口）──────────────
+  resetAll()
+  const noRegBase = { tools, skills }
   let noRegThrew = false
-  delete globalThis.__pptCoreReg
   try {
     indexMod.apply({
-      tools: { register: () => {} }, commands: { register: () => {} }, skills: skillsSvc,
-      get: () => undefined, inject: () => {}, on: () => {}, effect: (fn) => { fn(); return () => {} },
+      tools: { register: () => { tools++ } }, commands: { register: () => { cmds++ } }, skills: skillsSvc,
+      get: () => undefined, inject: () => {}, on: (ev, fn) => { listeners++; handlers.set(ev, fn) },
+      effect: (fn) => { fn(); return () => {} },
       logger: () => ({ info: () => {}, warn: () => {} }),
     }, {})
-    await flush()
+    // 真实场景：本部署**没有** agentPresets 服务 ⇒ `inject(['agentPresets'], cb)` 的回调**永不触发**
+    // （不是"触发并给 undefined"）⇒ 声明既不成功也不失败 ⇒ 必须靠兜底超时回落（否则零能力面）。
+    await new Promise((r) => setTimeout(r, 3400))
   } catch { noRegThrew = true }
-  ok('0.1.7：注册表不可用时只告警不抛（预设没了也不能让插件挂不上）',
-    noRegThrew === false, noRegThrew ? '装配抛错了' : '静默降级 ✓')
-  delete globalThis.__pptCoreReg
+  ok('§40 注册表不可见：只告警不抛，并靠**兜底超时**回落全局能力面（极简部署仍完整可用）',
+    // 注意：这个假 ctx 连 `skills` 服务都没有（`get` 恒 undefined）⇒ 技能数应为 0，不是 4。
+    noRegThrew === false && tools - noRegBase.tools === 22 && cmds >= 1
+      && presetMod.presetDeliveryStatus().isolation === 'profile-fallback',
+    `抛错=${noRegThrew}｜增量 tools=${tools - noRegBase.tools} cmds=${cmds}｜isolation=${presetMod.presetDeliveryStatus().isolation}`)
+
+  // ── 防重（按作用域）：同一 ctx 重复 apply 只装配一次 ───────────────────────────────
+  resetAll()
+  const dedupeCtx = makeCtx()
+  const ddBase = { tools }
+  indexMod.apply(dedupeCtx, {})
+  indexMod.apply(dedupeCtx, {})
+  await grace()
+  ok('§40 防重：同一作用域重复 apply 只装配一次（profile 与 preset 是两个不同作用域，各自只该装配一次）',
+    tools - ddBase.tools === 22 && declared.length === 1 && [...(globalThis.__pptCoreReg?.keys ?? [])].join() === 'profile',
+    `增量 tools=${tools - ddBase.tools}（应 22）｜声明=${declared.length}｜keys=${[...(globalThis.__pptCoreReg?.keys ?? [])].join()}`)
+  resetAll()
+  // ── 0.1.7 的**真适配**：预设靠"向注册表声明"交付（写目录那条路已被上游删除）────────────
+  // 判据分三层：① 真的调到 register 了；② 声明形状对（id/名/序/行数/内容）；③ 双挂载不会声明两次。
+  const declDirect = presetMod.presetDeclaration()
+  ok('§40 预设组合：名字/简介/序号取自包内 `agent-presets/ppt/`（19 条 standard 组合行；选择器里显示的就是这些）',
+    declDirect.name === 'PPT 工作室' && declDirect.order === 2 && declDirect.plugins.length === 19
+      && typeof declDirect.description === 'string' && declDirect.description.length > 10,
+    `name=${declDirect.name}｜order=${declDirect.order}｜行数=${declDirect.plugins.length}｜desc=${declDirect.description.length} 字`)
+  // `!!js` 必须**保真**成 Loader 认的 `{__jsExpr}`：降级成普通字符串会让
+  // `Boolean(<非空字符串>) === true` ⇒ Windows 上 pwsh 行被误停用（= 没有 shell）。
+  const rowOf = (def, id) => def?.plugins?.find((r) => r.id === id)
+  const bashD = rowOf(declDirect, 'tool-bash')?.disabled
+  const pwshD = rowOf(declDirect, 'tool-pwsh')?.disabled
+  ok('§40 预设组合：`!!js` 表达式保真为 `{__jsExpr}`（降级成字符串 ⇒ Windows 上 pwsh 行会被误停用）',
+    bashD?.__jsExpr === "process.platform === 'win32'" && pwshD?.__jsExpr === "process.platform !== 'win32'",
+    `bash=${JSON.stringify(bashD)}｜pwsh=${JSON.stringify(pwshD)}`)
+  ok('§40 隔离代码历史：`mountForAgent` 那套"插件自己按 agent 门控"仍不恢复（实现改走预设作用域）',
+    indexMod.mountForAgent === undefined, `mountForAgent=${typeof indexMod.mountForAgent}`)
 }
 
 // ── 41. 安装器 + 预设**声明**（2026-09-24 为 DSH 0.1.7-rc.1 重写）──────────────────────
@@ -2553,7 +2686,9 @@ ok('npm 发布通道：发布的是**下载下来的 Release 资产**（等 .tgz
   delete globalThis.__pptCoreReg
   delete globalThis.__pptRouteReg
   let applyThrew = null
-  try { indexMod2.apply(pipeCtx, { presetIds: ['ppt'] }) } catch (e) { applyThrew = e }
+  // 本节测的是**管道韧性**（附加能力坏掉只该降级），与隔离无关 ⇒ 用传统档（`scope: 'profile'`）
+  // 让能力面直接落在装入层；隔离路径的判定见 §40。
+  try { indexMod2.apply(pipeCtx, { scope: 'profile', presetIds: ['ppt'] }) } catch (e) { applyThrew = e }
   ok('§52 装配韧性：全局管道抛错时 apply 仍完成装配（22 工具 / 命令面 / 4 技能）——附加能力坏掉只该降级',
     applyThrew === null && pTools === 22 && pCmds >= 1 && pSkills === 4,
     `threw=${applyThrew ? String(applyThrew.message) : 'null'}｜tools=${pTools} cmds=${pCmds} skills=${pSkills}`)
@@ -2588,7 +2723,7 @@ ok('npm 发布通道：发布的是**下载下来的 Release 资产**（等 .tgz
   delete globalThis.__pptCoreReg
   delete globalThis.__pptRouteReg
   let injThrew = null
-  try { indexMod2.apply(injCtx, { presetIds: ['ppt'] }) } catch (e) { injThrew = e }
+  try { indexMod2.apply(injCtx, { scope: 'profile', presetIds: ['ppt'] }) } catch (e) { injThrew = e }
   await new Promise((r) => setTimeout(r, 10))
   ok('§52 预览路由：`webServer` 比插件晚激活时（真宿主实测的组合顺序）走 `inject` 仍要真的挂上路由',
     injThrew === null && iTools === 22 && injPrefixes.has('/ppt-preview'),
@@ -2695,6 +2830,189 @@ ok('npm 发布通道：发布的是**下载下来的 Release 资产**（等 .tgz
   await fsp.rm(gWork, { recursive: true, force: true })
 }
 
+// ── 55. 用户目录口径统一 + 测试隔离（2026-09-26，方案 B 第二批）──────────────────────────
+// 事故形状：`state.js` / `preview-server.js` 的用户目录曾是**模块常量** `homedir()/.dsh`（忽略 DSH_HOME），
+// 而 `templates.js` / `index.js`(diag) 是调用时求值 ⇒ ① 设了 DSH_HOME 的隔离部署里，会话状态与预览
+// 逃出隔离目录（实测：状态文件落在真实 `~/.dsh`）；② 本机 `npm test` 把 smoke 模板与预览缓存写进
+// 开发机真实 `~/.dsh/ppt-studio/`（实测复现、清理过两次）。修法 = 统一到 `src/home.js`（调用时求值）。
+{
+  const homeMod = await import('../lib/home.js')
+  const stateMod = await import('../lib/state.js')
+  const { previewRoot } = await import('../lib/preview-server.js')
+  const { userTemplatesDir } = await import('../lib/templates.js')
+  const prevHome55 = process.env.DSH_HOME
+  const probeHome = join(smokeDir, '.tmp-home-probe')
+  process.env.DSH_HOME = probeHome
+  const set55 = { home: homeMod.dshHome(), studio: homeMod.pptStudioDir(), session: stateMod.sessionDir(), preview: previewRoot(), tpl: userTemplatesDir() }
+  delete process.env.DSH_HOME
+  const unset55 = { home: homeMod.dshHome(), studio: homeMod.pptStudioDir(), session: stateMod.sessionDir(), preview: previewRoot(), tpl: userTemplatesDir() }
+  process.env.DSH_HOME = prevHome55
+  ok('§55 用户目录：`dshHome()` 认 DSH_HOME（设/未设两种），未设时回落 `~/.dsh` —— 普通用户行为零变化',
+    set55.home === probeHome && unset55.home === join(homedir(), '.dsh'),
+    `设=${set55.home}｜未设=${unset55.home}`)
+  ok('§55 用户目录：state / preview / templates / diag 四个消费方**同源**（都挂在同一个 ppt-studio 根下，不再各写一套）',
+    set55.studio === join(probeHome, 'ppt-studio') && unset55.studio === join(homedir(), '.dsh', 'ppt-studio')
+      && [set55.session, set55.preview, set55.tpl].every((p) => p.startsWith(set55.studio))
+      && [unset55.session, unset55.preview, unset55.tpl].every((p) => p.startsWith(unset55.studio)),
+    `studio=${set55.studio}｜session=${set55.session}｜preview=${set55.preview}｜templates=${set55.tpl}`)
+
+  // 真写一遍：会话状态必须落在**当前** DSH_HOME 下，且真实家目录里不出现这个 probe 文件
+  const sid55 = `probe-${Date.now().toString(36)}`
+  await stateMod.saveSession(sid55, { routing: 'auto', probe55: true })
+  const inIso = join(SMOKE_HOME, 'ppt-studio', `session-${sid55}.json`)
+  const inReal = join(homedir(), '.dsh', 'ppt-studio', `session-${sid55}.json`)
+  const back55 = await stateMod.loadSession(sid55)
+  ok('§55 会话状态：写进当前 DSH_HOME 下的 `<home>/ppt-studio/`，真实家目录不出现该文件（此前漏掉的正是这一半）',
+    existsSync(inIso) && back55.probe55 === true && !existsSync(inReal),
+    `隔离内=${existsSync(inIso)}｜真实家目录=${existsSync(inReal)}｜读回 probe=${back55.probe55}`)
+  ok('§55 测试隔离：整轮 smoke 的 DSH_HOME 指向构建目录内的临时 home（本轮所有用户层写入都被关在里面）',
+    process.env.DSH_HOME === SMOKE_HOME && SMOKE_HOME.startsWith(root) && SMOKE_HOME.includes('.tmp-'),
+    `DSH_HOME=${process.env.DSH_HOME}`)
+}
+
+// ── 56. 兜底增强（2026-09-26，第二轮）：能力探测 + 优先用捆绑 Python ─────────────────────
+// 背景：官方三个 office 技能（`office-docx/pptx/xlsx`）只在桌面端具备，它们假定的运行时
+// （捆绑 Python + LibreOffice kit）也只在桌面端；于是兜底路径必须**先探测再说话**。
+// 本节钉四件事：① 探测契约与磁盘一致（不编造）；② 候选根的顺序（env > 安装副本 > carrier）；
+// ③ python-pptx 兜底**优先**用捆绑 Python；④ `ppt_state` 把能力与装配状态一次暴露。
+{
+  const capMod = await import('../lib/capabilities.js')
+  const caps = capMod.detectCapabilities()
+  ok('§56 能力探测：契约形状完整（平台 / 捆绑 Python·Node / LibreOffice kit / office 资产 / primary-runtime 候选）',
+    ['platform', 'bundledPython', 'bundledNode', 'libreofficeKit', 'officeSkillsAssets', 'primaryRuntime'].every((k) => k in caps)
+      && Array.isArray(caps.primaryRuntime) && caps.primaryRuntime.length >= 1 // 候选根数**随部署变化**（桌面 3 个 / CLI 1 个），别写死
+      && caps.primaryRuntime.every((r) => typeof r.root === 'string' && typeof r.source === 'string' && r.present === existsSync(r.root)),
+    `platform=${caps.platform}｜python=${caps.bundledPython ? '有' : '无'}｜kit=${caps.libreofficeKit ? '有' : '无'}｜候选根=${caps.primaryRuntime.length}`)
+  ok('§56 能力探测：探测不到就给 null（**不编造**），给出的路径都真实存在',
+    (caps.bundledPython === null || existsSync(caps.bundledPython.path))
+      && (caps.libreofficeKit === null || existsSync(caps.libreofficeKit.cli))
+      && (caps.officeSkillsAssets === null || existsSync(caps.officeSkillsAssets.skillsDir)),
+    `python=${caps.bundledPython?.path ?? '(无)'}｜kit=${caps.libreofficeKit?.cli ?? '(无)'}｜office=${caps.officeSkillsAssets?.skillsDir ?? '(无)'}`)
+  const cands = capMod.pythonCandidates()
+  const order = cands.map((c) => (c.source.startsWith('env') ? 'env' : c.source.startsWith('installed') ? 'installed' : 'carrier'))
+  ok('§56 候选顺序：env 缝（若设置）> 安装副本（`dsh-runtimes/dsh-primary-runtime`）> carrier（`resources/runtime`）',
+    // 顺序要**单调**；carrier 只在桌面端存在、env 只在 SDK/容器部署设置 ⇒ 不要求三者齐全。
+    cands.length >= 1
+      && cands.every((c, i) => i === 0 || ({ env: 0, installed: 1, carrier: 2 })[order[i - 1]] <= ({ env: 0, installed: 1, carrier: 2 })[order[i]])
+      && order[0] === ((process.env.DSH_PRIMARY_RUNTIME || process.env.DSH_BUNDLED_PRIMARY_RUNTIME) ? 'env' : 'installed')
+      && cands.every((c) => typeof c.root === 'string' && typeof c.node === 'string'),
+    order.join(' > '))
+  const bundled = capMod.findBundledPython()
+  const found = (await import('../lib/pptxPy.js')).findPython()
+  ok('§56 解释器优先级：探测到捆绑 Python 就必须优先用它（`source=bundled:…`），否则才退回 PATH',
+    bundled === null
+      ? found.source !== 'bundled'
+      : (found.has === true && found.cmd === bundled.path && String(found.source).startsWith('bundled:')),
+    `bundled=${bundled?.path ?? '(无)'}｜findPython=${JSON.stringify(found)}`)
+  const fakeNone = await capMod.probeOfficeSkills({ get: () => undefined })
+  const fakeAll = await capMod.probeOfficeSkills({
+    get: (k) => (k === 'skills' ? { get: async () => ({ provider: 'dsh-office', source: 'bundled', content: 'x' }) } : undefined),
+  })
+  ok('§56 官方 office 技能探测：服务缺失 ⇒ available=false（带原因）；三本都在 ⇒ available=true',
+    fakeNone.available === false && typeof fakeNone.reason === 'string' && fakeNone.found.length === 0
+      && fakeAll.available === true && fakeAll.found.length === 3,
+    `无服务=${fakeNone.available}（${String(fakeNone.reason).slice(0, 24)}）｜齐全=${fakeAll.available}（${fakeAll.found.join(',')}）`)
+  // resources 上溯：桌面端里插件可能跑在深层子进程 node 中 ⇒ 必须能从任意深度找回 `<install>/resources`。
+  // 用一棵合成目录树验证（与真实安装无关，机器无关）。
+  const synth = join(smokeDir, '.tmp-resources-probe')
+  await rm(synth, { recursive: true, force: true })
+  const deep = join(synth, 'install', 'resources', 'runtime', 'primary-runtime', 'dependencies', 'node', 'bin')
+  await mkdir(deep, { recursive: true })
+  await writeFile(join(synth, 'install', 'resources', 'app.asar'), 'x', 'utf8')
+  await writeFile(join(deep, 'node.exe'), 'x', 'utf8')
+  const foundRes = capMod.resourcesFrom(deep)
+  ok('§56 resources 上溯：从深层子进程 node 的目录能找回 `<install>/resources`（以 app.asar 为锚点）',
+    foundRes === join(synth, 'install', 'resources'),
+    `${String(foundRes).replace(synth, '<合成树>')}`)
+  await rm(synth, { recursive: true, force: true })
+  // 官方 QA 通道（②）：用**合成资产树 + 桩 checker**验证契约（与桌面端是否安装无关，机器无关）
+  const qaMod = await import('../lib/office-qa.js')
+  const qaSynth = join(smokeDir, '.tmp-qa-probe')
+  await rm(qaSynth, { recursive: true, force: true })
+  const qaSkills = join(qaSynth, 'runtime', 'office-skills')
+  await mkdir(join(qaSkills, 'scripts'), { recursive: true })
+  await writeFile(join(qaSynth, 'app.asar'), 'x', 'utf8') // 让 resourcesFrom 认这棵树
+  const prevRes = process.env.PPT_STUDIO_RESOURCES_DIR
+  process.env.PPT_STUDIO_RESOURCES_DIR = qaSynth
+  const anyPy = capMod.findAnyPython()
+  const qaDummy = join(qaSynth, 'dummy.pptx')
+  await writeFile(qaDummy, 'not-a-real-pptx', 'utf8') // 桩 checker 不读内容，但我们的入口会先做存在性检查
+  if (anyPy !== null) {
+    await writeFile(join(qaSkills, 'scripts', 'check_office.py'),
+      'import json\nprint(json.dumps({"format":"pptx","verdict":"pass","checks":[],"summary":{"slides":3}}))\n', 'utf8')
+    const qa1 = qaMod.runOfficeStructureCheck(qaDummy, { count: 3 })
+    ok('§56 官方 QA：有资产 + 有 Python 时真的跑 `check_office.py` 并解析 JSON 判定（pass ⇒ ok，带回 summary）',
+      qa1.available === true && qa1.ok === true && qa1.summary?.slides === 3, JSON.stringify(qa1).slice(0, 150))
+    await writeFile(join(qaSkills, 'scripts', 'check_office.py'),
+      'import json\nprint(json.dumps({"format":"pptx","verdict":"fail","checks":[{"id":"package","status":"fail","detail":"boom"}]}))\n', 'utf8')
+    const qa2 = qaMod.runOfficeStructureCheck(qaDummy, { count: 3 })
+    ok('§56 官方 QA：`verdict=fail` 必须判失败，并把失败项带回（不吞诊断）',
+      qa2.available === true && qa2.ok === false && /boom/.test(String(qa2.reason)), String(qa2.reason).slice(0, 150))
+  } else {
+    const qa0 = qaMod.runOfficeStructureCheck(qaDummy, {})
+    ok('§56 官方 QA：本机没有任何 Python ⇒ 明确报"不可用 + 原因"（不假装跑过）', qa0.available === false && qa0.reason.length > 0, String(qa0.reason).slice(0, 90))
+    ok('§56 官方 QA：无 Python 时 `officeQaStatus()` 也不该声称可用', qaMod.officeQaStatus().available === false, JSON.stringify(qaMod.officeQaStatus()))
+  }
+  const qa3 = qaMod.runLibreOfficeRender(qaDummy, join(qaSynth, 'out'))
+  ok('§56 官方 QA：资产树里没有 LibreOffice kit ⇒ 渲染通道明确报"不可用 + 原因"，不假装跑过',
+    qa3.available === false && typeof qa3.reason === 'string' && qa3.reason.length > 0, String(qa3.reason).slice(0, 90))
+  if (prevRes === undefined) delete process.env.PPT_STUDIO_RESOURCES_DIR
+  else process.env.PPT_STUDIO_RESOURCES_DIR = prevRes
+  await rm(qaSynth, { recursive: true, force: true })
+
+  const captured56 = new Map()
+  const idxMod56 = await import('../lib/index.js')
+  idxMod56.statusToolFor({ effect: (cb) => { cb(); return () => {} }, tools: { register: (d) => captured56.set(d.name, d) }, get: () => undefined }, 'profile')
+  const out56 = JSON.parse(await captured56.get('ppt_state').execute({}, { agent: { session: { id: 'probe-56' } } }))
+  ok('§56 ppt_state：一次看全"装配作用域 + 隔离是否生效 + 能力（含 office 技能）+ 路径"',
+    out56.assembly?.isolation !== undefined && out56.capabilities?.platform !== undefined
+      && out56.capabilities?.officeSkills?.available !== undefined && out56.paths?.pptStudio !== undefined,
+    `assembly=${out56.assembly?.isolation}｜capabilities=${Object.keys(out56.capabilities ?? {}).join(',')}`)
+}
+
+// ── 57. 成品内容自证（2026-09-26 第二轮 启发 A）：从**产物**反推"该写的字/该画的图形在不在" ──────
+// 为什么必须补：此前 parity 只有计数（表/图/线/媒体）+ audit 的页数/尺寸/字号 ⇒
+// "预览层对、成品层丢字/串行/表格漏格"这一类抓不到；图表更是**一条 parity 都没有**。
+{
+  const work57 = join(smokeDir, '.tmp-content-proof')
+  await rm(work57, { recursive: true, force: true })
+  await mkdir(join(work57, 'pages'), { recursive: true })
+  await writeFile(join(work57, 'deck.yaml'), ['version: 1', 'title: content-proof', 'size: [960, 540]', 'theme:',
+    '  colors: {primary: "#2563EB", text: "#1F2937"}', '  textStyles:',
+    '    body: {fontSize: 16, color: "$text"}', 'pages:', '  - pages/01.yaml', ''].join('\n'), 'utf8')
+  await writeFile(join(work57, 'pages', '01.yaml'), ['pageType: content', 'elements:',
+    '  - elementId: t1', '    elementType: text', '    bounds: [40, 40, 700, 60]',
+    '    content: {text: "第一行 <a&b> \\"引号\\"", style: "$body"}',
+    '  - elementId: tb', '    elementType: table', '    bounds: [40, 120, 400, 90]',
+    '    cols: ["指标", "值"]', '    rows: [["营收 <2026>", "1,234"], ["毛利 & 净利", "56%"]]',
+    '  - elementId: ch57', '    elementType: chart', '    bounds: [40, 240, 500, 200]',
+    '    chart: {type: bar, data: {cols: ["季度", "值"], rows: [["Q1", 12], ["Q2", 18]]}}',
+    '  - elementId: t2', '    elementType: text', '    bounds: [560, 40, 360, 40]',
+    '    content: {text: "第二行\\n第三行", style: "$body"}', ''].join('\n'), 'utf8')
+  const r57 = await exportPptx(await resolveDeck(work57), { out: join(work57, 'out.pptx') })
+  const p57 = r57.parity ?? {}
+  ok('§57 成品内容自证：文本/表格内容在产物里**逐条**能反查到（含 <>& 引号与 \\n 多行）——"预览对、成品丢字"这类抓得到',
+    (p57.textExp ?? 0) >= 8 && (p57.textMissing ?? ['x']).length === 0 && p57.ok === true,
+    `textExp=${p57.textExp}｜缺失=${JSON.stringify(p57.textMissing ?? null)}｜ok=${p57.ok}`)
+  // 默认走原生（用户 2026-09-26 拍板）：包里必须出现图表部件 + 内嵌数据工作簿，且数据与 deck **逐格**一致
+  ok('§57 成品内容自证：图表默认 = **原生可编辑图表部件**（`ppt/charts/*.xml` + 内嵌数据工作簿），数据与 deck 逐格一致',
+    p57.chartsExp === 1 && p57.chartsOut === 1 && p57.chartEmbedsOut === 1 && p57.chartSheetsChecked === 1
+      && (p57.chartDataMismatch ?? ['x']).length === 0 && (p57.chartRelsMissing ?? ['x']).length === 0 && p57.ok === true,
+    `部件=${p57.chartsOut}/${p57.chartsExp}｜工作簿=${p57.chartEmbedsOut}｜已比对工作表=${p57.chartSheetsChecked}｜数据不符=${JSON.stringify(p57.chartDataMismatch ?? null)}`)
+  // 显式 render: vector 的降级路必须**还在**（形状计数自证不丢，且该页不产图表部件）
+  await writeFile(join(work57, 'pages', '02.yaml'), ['pageType: content', 'elements:',
+    '  - elementId: vbar', '    elementType: chart', '    bounds: [40, 40, 500, 300]',
+    '    chart: {type: bar, data: {cols: ["季度", "值"], rows: [["Q1", 12], ["Q2", 18]]}, render: vector}', ''].join('\n'), 'utf8')
+  const deckText57 = await (await import('node:fs/promises')).readFile(join(work57, 'deck.yaml'), 'utf8')
+  await writeFile(join(work57, 'deck.yaml'), deckText57.replace('  - pages/01.yaml', '  - pages/01.yaml\n  - pages/02.yaml'), 'utf8')
+  const r57v = await exportPptx(await resolveDeck(work57), { out: join(work57, 'out-v.pptx') })
+  const p57v = r57v.parity ?? {}
+  ok('§57 成品内容自证：`chart.render=vector` 仍走矢量拼绘（形状计数自证不丢，且该页不产图表部件）',
+    p57v.chartShapesExp === 2 && p57v.chartShapesOut === 2 && p57v.chartsOut === 1 && r57v.slides === 2,
+    `形状=${p57v.chartShapesOut}/${p57v.chartShapesExp}｜全册图表部件=${p57v.chartsOut}（只第 1 页有原生）｜页数=${r57v.slides}`)
+  await rm(work57, { recursive: true, force: true })
+}
+
 // 37.10 【必须是最后一条断言】引用计数自证：文档里 "smoke … N 断言" 必须等于本次真实断言总数。
 // 历史形状：加断言后 README×3 + docs/02 + docs/06×2 + 手册 全靠人工同步，迟早漏一处。
 // 只扫"当前状态"文档（README / 技术报告 / 评审测试矩阵 / 使用手册）；docs/01/03/04 里的历史数字是记录，不动。
@@ -2721,5 +3039,11 @@ for (const rel of countFiles) {
 ok('文档计数自证：所有"smoke … N 断言 / N/N"都等于本次真实断言数（加断言必须同步 6 处引用）',
   staleCounts.length === 0, staleCounts.length ? `过期引用：${staleCounts.join('、')}` : `全部 = ${liveTotal}`)
 
+// 收尾：恢复 DSH_HOME 并清掉整轮隔离目录（用户层产物都在里面，见文件顶部的全局隔离说明）。
+try { await rm(SMOKE_HOME, { recursive: true, force: true }) } catch { /* 忽略 */ }
+try { await rm(join(smokeDir, '.tmp-home-probe'), { recursive: true, force: true }) } catch { /* 忽略 */ }
+if (PREV_SMOKE_HOME === undefined) delete process.env.DSH_HOME
+else process.env.DSH_HOME = PREV_SMOKE_HOME
+
 console.log(`\n==== 结果：${pass} 通过 / ${fail} 失败 ====`)
 process.exit(fail > 0 ? 1 : 0)