dsh-ppt-studio 1.1.0 → 1.1.2

package/lib/pptd/export-pptx.js

@@ -12,6 +12,7 @@
  */
 import { writeFile, readFile } from 'node:fs/promises'
 import { join, isAbsolute } from 'node:path'
+import { createHash } from 'node:crypto'
 import { zipWrite } from '../zips.js'
 import { normalizePage } from './layout.js'
 import { chartData, chartColors, chartIssue } from './svgCharts.js'
@@ -36,6 +37,37 @@ export async function exportPptx(ctx, { out = 'out.pptx', engine = 'pptd' } = {}
   const lineProof = { exp: 0, out: 0, wrong: [] }
   UID = 1000
 
+  // 媒体部件命名（2026-09-26 修复"同名静默错图"）——**整册共享**（不能按页各算一套，否则同一 srcPath
+  // 在不同页会拿到不同部件名，parity 会假红）。要防的事故：旧实现 addMedia 按**完整路径**去重（rId 不同），
+  // 但包内部件名与 rels Target 都取 `basename` ⇒ `media/a/logo.png` 与 `media/b/logo.png` 共用一个
+  // `ppt/media/logo.png`，后写覆盖先写 —— **成品里一张图被静默换成另一张**，而 parity（只数 `<p:pic>`）与
+  // warnings 全绿（2026-09-26 实测复现）。
+  // 规则：ASCII 安全且未被占用 ⇒ **原名不动**（既有产物零变化）；非 ASCII/空格或重名 ⇒ `stem-<hash8>.<ext>`
+  // （hash 取相对路径，跨机器/跨运行确定；`ppt/media/` 是包内部件名，用户看不到）。
+  const usedParts = new Map() // srcPath → 部件名
+  const takenParts = new Set()
+  const renamedMedia = new Map() // srcPath → 改名后的部件名（供报告"不静默"）
+  const mediaPartName = (srcPath) => {
+    if (usedParts.has(srcPath)) return usedParts.get(srcPath)
+    const key = String(srcPath)
+    const base = key.split(/[\\/]/).pop() || 'image'
+    const dot = base.lastIndexOf('.')
+    const ext = dot > 0 ? base.slice(dot) : ''
+    const stem = dot > 0 ? base.slice(0, dot) : base
+    let part = base
+    if (!/^[A-Za-z0-9._-]+$/.test(base) || takenParts.has(base)) {
+      const slug = stem.replace(/[^A-Za-z0-9._-]+/g, '-').replace(/^-+|-+$/g, '') || 'image'
+      const h = createHash('sha1').update(key).digest('hex').slice(0, 8)
+      part = `${slug}-${h}${ext}`
+      let n = 1
+      while (takenParts.has(part)) part = `${slug}-${h}-${n++}${ext}`
+      renamedMedia.set(key, part)
+    }
+    takenParts.add(part)
+    usedParts.set(srcPath, part)
+    return part
+  }
+
   for (const page of ctx.pages) {
     const els = normalizePage(page, ctx)
     const shapes = []
@@ -46,7 +78,7 @@ export async function exportPptx(ctx, { out = 'out.pptx', engine = 'pptd' } = {}
       if (mediaSeen.has(srcPath)) return mediaSeen.get(srcPath)
       const rId = `rId${media.length + 2}`
       mediaSeen.set(srcPath, rId)
-      media.push({ srcPath, rId })
+      media.push({ srcPath, rId, part: mediaPartName(srcPath) })
       return rId
     }
 
@@ -136,13 +168,13 @@ export async function exportPptx(ctx, { out = 'out.pptx', engine = 'pptd' } = {}
       '<?xml version="1.0" encoding="UTF-8" standalone="yes"?>',
       '<Relationships xmlns="http://schemas.openxmlformats.org/package/2006/relationships">',
       '<Relationship Id="rId1" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/slideLayout" Target="../slideLayouts/slideLayout1.xml"/>',
-      ...s.media.map((m) => `<Relationship Id="${m.rId}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/image" Target="../media/${m.srcPath.split(/[\\/]/).pop()}"/>`),
+      ...s.media.map((m) => `<Relationship Id="${m.rId}" Type="http://schemas.openxmlformats.org/officeDocument/2006/relationships/image" Target="../media/${m.part}"/>`),
       notesRel,
       '</Relationships>',
     ].join('')
     files[`ppt/slides/_rels/slide${n}.xml.rels`] = srels
     for (const m of s.media) {
-      const bn = m.srcPath.split(/[\\/]/).pop()
+      const bn = m.part
       try {
         files[`ppt/media/${bn}`] = await readFile(join(ctx.dir, m.srcPath))
       } catch {
@@ -171,13 +203,20 @@ export async function exportPptx(ctx, { out = 'out.pptx', engine = 'pptd' } = {}
   const notesParts = Object.keys(files).filter((k) => /^ppt\/notesSlides\/notesSlide\d+\.xml$/.test(k))
   const notesOut = notesParts.length
   const notesRelOk = slides.filter((s) => s.notes).every((s) => String(files[`ppt/slides/_rels/slide${slides.indexOf(s) + 1}.xml.rels`]).includes(`notesSlide${s.notesNo}.xml`))
+  // 媒体 parity（2026-09-26 新增）：**不同 srcPath 数 == 包内媒体部件数**。
+  // 为什么必须单独加一条：图数量 parity（imagesExp/imagesOut）只数 `<p:pic>`，两张不同的图塌成同一个部件时
+  // 它依然是 2/2、ok=true（实测）。而"两张不同的图被写成同一个部件"= 成品里静默用错图，正是本插件最不能出的错。
+  const mediaExpSet = new Set()
+  for (const s of slides) for (const m of s.media) mediaExpSet.add(m.srcPath)
+  const mediaOut = Object.keys(files).filter((k) => /^ppt\/media\//.test(k)).length
   report.parity = {
     tablesExp, tablesOut, imagesExp, imagesOut, illegalFrames: illegal,
     linesExp: lineProof.exp, linesOut: lineProof.out, linesWrong: lineProof.wrong.length,
     notesExp, notesOut,
+    mediaExp: mediaExpSet.size, mediaOut,
     ok: tablesExp === tablesOut && imagesExp === imagesOut && illegal === 0 &&
       lineProof.exp === lineProof.out && lineProof.wrong.length === 0 &&
-      notesExp === notesOut && notesRelOk,
+      notesExp === notesOut && notesRelOk && mediaExpSet.size === mediaOut,
   }
 
   // out：绝对路径原样使用；相对路径相对 deck 目录（反馈 E1 ★）
@@ -186,6 +225,8 @@ export async function exportPptx(ctx, { out = 'out.pptx', engine = 'pptd' } = {}
   report.file = outPath
   report.slides = slides.length
   report.engine = engine
+  // 改名必须**可见**（不静默）：非 ASCII/空格或重名时部件名变了，报告里说明改成了什么。
+  if (renamedMedia.size) report.mediaRenamed = [...renamedMedia].map(([src, part]) => `${src} → ppt/media/${part}`)
   return report
 }
 

package/lib/preview-server.js

@@ -6,7 +6,7 @@
  * - URL 为同源相对路径（/ppt-preview/<token>/pages/deck.html）：GUI 页面本身就在 host 上，
  *   点击/iframe 均同源，不依赖端口探测。
  */
-import { mkdir, rm, copyFile, readFile, stat } from 'node:fs/promises'
+import { mkdir, rm, copyFile, cp, readFile, stat } from 'node:fs/promises'
 import { existsSync } from 'node:fs'
 import { join, dirname, extname, normalize } from 'node:path'
 import { homedir } from 'node:os'
@@ -44,13 +44,14 @@ export async function buildPreview(dir) {
     await copyFile(join(dir, 'preview', f), join(root, 'pages', f))
   }
   await copyFile(join(dir, 'preview', 'deck.html'), join(root, 'pages', 'deck.html'))
-  // media（含页面背景图；html 以 ../media/ 引用）
+  // media（含页面背景图与**子目录**；html 以 ../media/ 引用）
+  // 2026-09-26 修复：旧实现只 `readdir` 顶层再逐个 `copyFile` —— 目录条目会被当文件拷，Windows 上直接
+  //   `EPERM: operation not permitted, copyfile '<deck>\media\sub' -> '<preview>\media\sub'`
+  //   ⇒ `buildPreview` 整体抛出、`ppt_preview` 直接失败（**不是"缺图"**），预览根还留下半成品。
+  //   DSL 允许 `media/子目录/x.png`（schema 对 image.src 只校验是字符串、未禁止子目录），文档也从未声明"平铺"，
+  //   所以这里改成整目录镜像。`cp(recursive)` 保留相对路径 ⇒ 路由层（previewFileFor + join）本就能服务子路径。
   if (existsSync(join(dir, 'media'))) {
-    const mediaDir = join(root, 'media')
-    await mkdir(mediaDir, { recursive: true })
-    for (const name of await import('node:fs/promises').then((f) => f.readdir(join(dir, 'media')))) {
-      await copyFile(join(dir, 'media', name), join(mediaDir, name))
-    }
+    await cp(join(dir, 'media'), join(root, 'media'), { recursive: true })
   }
   tokens.set(token, root)
   // 持久化映射（跨进程/重启后链接仍可用）：.meta.json 记录源目录
@@ -103,6 +104,27 @@ async function releaseRouteWhenZero() {
   }
 }
 
+/**
+ * 调用 `webServer.register` 并**归一化**它的返回值与异常。
+ *
+ * 真契约（2026-09-26 实测 DSH 0.1.7-rc.2，源码 `dsh-host-webserver/lib/index.js:177-184`）：
+ * register 是**同步**方法 —— 成功返回 disposer **函数**，重复注册**同步抛错**（不是 Promise！）。
+ * 历史实现写的是 `ws.register({...}).then(...)`：
+ *   对同步返回的函数调 `.then` 立即 TypeError，而它是在 `apply()` 里**同步抛出**的
+ *   ⇒ **整个插件条目激活失败**（桌面端实测："1 entry did not activate ppt-studio"），
+ *   用户连 `ppt_state` 都调不到。假对象当时写成 async，给这个 bug 背了书（smoke §29 已改真契约）。
+ *
+ * 这里吃三种返回形态：同步函数 / Promise<函数> / `{dispose()}` 对象；同步抛错归一成 `{ thrown }`
+ * （不向外抛：预览只是附加能力，不该让插件整体装不上）。
+ */
+function attemptRegister(ws, makeRoute) {
+  try {
+    return { value: ws.register(makeRoute()) }
+  } catch (error) {
+    return { thrown: error }
+  }
+}
+
 /** 注册预览路由（返回 disposer；无 webServer 环境返回 null）。 */
 export function registerPreviewRoute(ctx) {
   const ws = ctx.get('webServer')
@@ -118,7 +140,7 @@ export function registerPreviewRoute(ctx) {
     return ctx.effect(() => () => { ROUTE_REG.count--; void releaseRouteWhenZero() }, 'ppt-studio: preview route (ref)')
   }
   let cancelled = false
-  const unregPromise = ws.register({
+  const reg = attemptRegister(ws, () => ({
     kind: 'prefix',
     path: '/ppt-preview', // prefix 语义：path 不带尾斜杠（实测：带斜杠不命中）
     async handler(req, res) {
@@ -128,10 +150,8 @@ export function registerPreviewRoute(ctx) {
         const m = u.pathname.match(/^\/ppt-preview\/([a-zA-Z0-9-]+)\/(.*)$/)
         if (!m) return notFound(res)
         const root = await resolveToken(m[1])
-        const rel = normalize(m[2]).replace(/^([/\\])+/, '')
-        if (!root || rel.includes('..')) return notFound(res)
-        const file = join(root, rel)
-        if (!existsSync(file)) return notFound(res)
+        const file = root ? previewFileFor(root, m[2]) : null
+        if (!file || !existsSync(file)) return notFound(res)
         const st = await stat(file)
         if (st.isDirectory()) return notFound(res)
         const buf = await readFile(file)
@@ -142,10 +162,17 @@ export function registerPreviewRoute(ctx) {
         res.end('preview error')
       }
     },
-  }).then(async (u) => {
-    if (cancelled) { try { await u() } catch { /* 幂等 */ } ; return null }
-    ROUTE_REG.unreg = u
-    return u
+  }))
+  if (reg.thrown) {
+    // 重复注册（并发装配的另一路已抢先注册）⇒ 按上方表判据语义：只计数，不再注册。
+    ROUTE_REG.count++
+    return ctx.effect(() => () => { ROUTE_REG.count--; void releaseRouteWhenZero() }, 'ppt-studio: preview route (dup)')
+  }
+  const unregPromise = Promise.resolve(reg.value).then(async (u) => {
+    const dispose = typeof u === 'function' ? u : (u && typeof u.dispose === 'function' ? () => u.dispose() : null)
+    if (cancelled) { if (dispose) { try { await dispose() } catch { /* 幂等 */ } } ; return null }
+    ROUTE_REG.unreg = dispose
+    return dispose
   }).catch(() => null)
   ROUTE_REG.count++
   // 同上：cb 立即执行、返回值是 disposer —— 清理逻辑必须包在**返回的函数**里。
@@ -158,6 +185,30 @@ export function registerPreviewRoute(ctx) {
   }, 'ppt-studio: preview route')
 }
 
+/**
+ * 把 `/ppt-preview/<token>/` 之后的**原始请求路径**解析成预览根内的文件；越界或畸形编码返回 null。
+ * 抽成导出函数是为了可单测（smoke §54 直接断言，不必起 HTTP）。
+ *
+ * 2026-09-26 修复两件事：
+ *  ① **必须 `decodeURIComponent` 一次**：浏览器会把 `media/中文 图.png` 编码成 `%E4%B8%AD…%20…` 再请求，
+ *     而 `new URL().pathname` **保留编码形式** ⇒ 旧实现拼出的磁盘路径里含 `%E4%B8%AD`，`existsSync` 必失败。
+ *     实测：图片已正确拷进预览根，预览仍 404（导出正常）——中文/空格文件名是中文用户的常态。
+ *  ② 穿越判定改为**按路径段**看 `..`：旧实现 `rel.includes('..')` 会顺带误杀 `a..b.png` 这类合法文件名。
+ */
+export function previewFileFor(root, rawRel) {
+  let decoded = String(rawRel ?? '')
+  try { decoded = decodeURIComponent(decoded) } catch { return null } // 畸形百分号编码 → 当作不存在
+  if (decoded.includes('\0')) return null
+  // 任何 `..` **路径段**一律拒绝（保守策略：浏览器发出的请求路径本已规范化，代价为零）。
+  // 注意必须**先判再 normalize**——`path.normalize` 会把 `media/../x` 折叠成 `x`，折叠后就看不出越级意图了。
+  // 旧实现用 `rel.includes('..')`，会顺带误杀 `a..b.png` 这类合法文件名；这里只拦真正的上级目录段。
+  if (decoded.split(/[/\\]+/).some((seg) => seg === '..')) return null
+  const norm = normalize(decoded).replace(/^([/\\])+/, '')
+  if (!norm) return null
+  if (norm.split(/[/\\]+/).some((seg) => seg === '..')) return null // 归一化后仍越界（双保险）
+  return join(root, norm)
+}
+
 function notFound(res) {
   res.writeHead(404, { 'Content-Type': 'text/plain; charset=utf-8' })
   res.end('not found')

package/lib/scaffold.js

@@ -83,7 +83,7 @@ elements:
 - elementId: img
   elementType: image
   bounds: [60, 100, 400, 300]
-  src: media/pic.png          # 相对 deck 根
+  src: media/pic.png          # 相对 deck 根；子目录与中文/空格名都可以（media/子目录/图.png）
   fit: cover                  # cover|contain|fill
 - elementId: tbl
   elementType: table

package/lib/templates.js

@@ -211,9 +211,12 @@ export async function registerTemplate(dir, opts = {}, { targetDir = userTemplat
     const ctx3 = await resolveDeck(tplDir)
     const r3 = await renderDeck(ctx3, { out: '_cleanup-tmp' })
     const v3 = verifyDeck(r3.layout)
+    // 结构化消费（2026-09-26）：旧实现 `line.match(/\[✗\] (\w+)/)` 用的是 `\w+`，而所有门禁码都带连字符
+    // （out-of-page / text-overflow / theme-conformance…）⇒ 直方图里全是截断码（`out×3`、`text×2`），
+    // 而这份报告是模型读的。改用 verifyDeck 新增的结构化 errors。
     const detail = {}
-    for (const line of v3.text.split('\n').filter((l) => l.includes('[✗]'))) {
-      const code = (line.match(/\[✗\] (\w+)/) ?? [])[1] ?? 'other'
+    for (const f of v3.errors) {
+      const code = f.code ?? 'other'
       detail[code] = (detail[code] ?? 0) + 1
     }
     cleanup = { declared: cleanup.declared, outSafe, remainingErrors: Object.values(detail).reduce((a, b) => a + b, 0), detail }

package/lib/tools.js

@@ -541,7 +541,7 @@ export function registerTools(ctx) {
           const ctx1 = await loadCtx(dir)
           const r = await renderDeck(ctx1, {})
           const v = verifyDeck(r.layout)
-          const errors = v.text.split('\n').filter((l) => l.includes('[✗]')).length
+          const errors = v.errors.length
           const addedNote = added.length
             ? `\n已写入声明：${added.map((a) => `第${a.page}页 +${a.added}对`).join('，')}`
             : '\n未发现可自动声明的警告级重叠（全部已声明/内容互压/豁免）。'
@@ -559,13 +559,15 @@ export function registerTools(ctx) {
           layout = r.layout
         }
         let localNote = ''
+        let pageScope = null
         if (pagesSel) {
           const before = (layout.pages ?? []).length
           layout = { ...layout, pages: (layout.pages ?? []).filter((p) => pagesSel.has(p.index + 1)) }
-          localNote = `\n\n> 局部校验：仅审阅第 [${[...pagesSel].sort((a, b) => a - b).join(', ')}] 页（共 ${before} 页；其余页本次未检查）`
+          pageScope = { sel: [...pagesSel].sort((a, b) => a - b), covered: pagesSel.size, total: before }
+          localNote = `\n\n> 局部校验：仅审阅第 [${pageScope.sel.join(', ')}] 页（共 ${before} 页；其余页本次未检查）`
         }
         const v = verifyDeck(layout)
-        const errors = v.text.split('\n').filter((l) => l.includes('[✗]')).length
+        const errors = v.errors.length
         // M2：实测交叉（D3：实测=终审、估算=预检）
         let measuredText = ''
         let measuredErrors = 0
@@ -585,7 +587,16 @@ export function registerTools(ctx) {
         }
         const gate = errors + measuredErrors
         const head = v.text
-        return `# 数字审阅${localNote}\n${head}${measuredText}\n\n---\n门禁：${gate === 0 ? '✓ 通过' : `✗ ${gate} 个错误（必须清零${measuredErrors ? `，含 M2 实测 ${measuredErrors} 个` : ''}`}\n${pptxSnapshotText}${degradeNote}`
+        // 门禁行必须带**审阅范围**（2026-09-26 修复"局部审阅假绿"）：pages= 生效时，旧实现把
+        // `layout.pages` 先过滤再计数，于是"只审 1 页且该页干净"会打印与整册通过**完全同形**的
+        // `门禁：✓ 通过`——而本工具自述写着"不改写 layout.json（防部分校验静默漏检其余页）"
+        // （tools.js 的 pages 参数说明 / docs/02 §174）⇒ 用户与模型会得出"整册通过"的错误结论。
+        const gateText = gate === 0
+          ? (pageScope
+            ? `✓ 选中的 ${pageScope.covered} 页通过 —— 其余 ${Math.max(0, pageScope.total - pageScope.covered)} 页**本次未检查**（要整册结论请去掉 pages 重跑）`
+            : '✓ 通过')
+          : `✗ ${gate} 个错误（必须清零${measuredErrors ? `，含 M2 实测 ${measuredErrors} 个` : ''}）`
+        return `# 数字审阅${localNote}\n${head}${measuredText}\n\n---\n门禁${pageScope ? '（局部）' : ''}：${gateText}\n${pptxSnapshotText}${degradeNote}`
       } catch (error) {
         return `✗ 验证失败：\n${errText(error)}`
       }
@@ -654,10 +665,16 @@ export function registerTools(ctx) {
           const phNote = r.mediaPlaceholders?.length
             ? `\n\n⚠ 缺失媒体 ${r.mediaPlaceholders.length} 个（${r.mediaPlaceholders.join('、')}）已用 1×1 白色占位导出——请替换真实图片或删除页面引用（可重新 ppt_import 提取或人工补图）`
             : ''
+          // 媒体部件改名必须可见（2026-09-26）：同名冲突/非 ASCII 名会让包内部件名变化——内容不变，
+          // 但用户至少要能看到"发生过什么"，而不是只看到 parity 数字。
+          const renamedNote = r.mediaRenamed?.length
+            ? `\n\nℹ 媒体部件改名 ${r.mediaRenamed.length} 个（原因：不同目录同名，或文件名含非 ASCII/空格；` +
+              `PPT 里的图片内容与位置不变，改的只是包内部件名）：\n${r.mediaRenamed.map((x) => `   - ${x}`).join('\n')}`
+            : ''
           const parityNote = r.parity
             ? (r.parity.ok
-              ? `\n✅ 元素 parity 回读：表 ${r.parity.tablesExp}/${r.parity.tablesOut} · 图 ${r.parity.imagesExp}/${r.parity.imagesOut} · 线方向 ${r.parity.linesExp ?? 0}/${r.parity.linesOut ?? 0}（逐条从 OOXML 反推端点自证） · 结构合法（无 PowerPoint 弃帧类嵌套 xfrm）`
-              : `\n✗ 元素 parity 不一致：表 期望${r.parity.tablesExp}/实际${r.parity.tablesOut} · 图 期望${r.parity.imagesExp}/实际${r.parity.imagesOut} · 线 期望${r.parity.linesExp ?? 0}/实际${r.parity.linesOut ?? 0}/方向错${r.parity.linesWrong ?? 0} · 非法帧 ${r.parity.illegalFrames}——请勿交付，附本输出反馈插件团队`)
+              ? `\n✅ 元素 parity 回读：表 ${r.parity.tablesExp}/${r.parity.tablesOut} · 图 ${r.parity.imagesExp}/${r.parity.imagesOut} · 媒体部件 ${r.parity.mediaExp ?? '?'}/${r.parity.mediaOut ?? '?'} · 线方向 ${r.parity.linesExp ?? 0}/${r.parity.linesOut ?? 0}（逐条从 OOXML 反推端点自证） · 结构合法（无 PowerPoint 弃帧类嵌套 xfrm）`
+              : `\n✗ 元素 parity 不一致：表 期望${r.parity.tablesExp}/实际${r.parity.tablesOut} · 图 期望${r.parity.imagesExp}/实际${r.parity.imagesOut} · 媒体 期望${r.parity.mediaExp ?? '?'}/实际${r.parity.mediaOut ?? '?'} · 线 期望${r.parity.linesExp ?? 0}/实际${r.parity.linesOut ?? 0}/方向错${r.parity.linesWrong ?? 0} · 非法帧 ${r.parity.illegalFrames}——请勿交付，附本输出反馈插件团队`)
             : ''
           // P8（测试反馈）：真渲染抽查策略——含复杂元素的页必须覆盖（P1 事故的直接防线）
           const riskyPages = (ctx0.pages ?? []).map((p, i) => {
@@ -667,7 +684,7 @@ export function registerTools(ctx) {
           const renderNote = riskyPages.length
             ? `\nP8 真渲染抽查：建议优先覆盖含 table/chart/image/custGeom 的页 → 第 ${riskyPages.join('、')} 页（每类至少一页；audit 档导出自动全页真渲染）`
             : ''
-          return `✓ 已导出（pptd 引擎，${r.slides} 页）：${r.file}${fit}${phNote}${parityNote}${renderNote}${floorNote}${chartNote}${await withAudit(r.file)}${engineNote}`
+          return `✓ 已导出（pptd 引擎，${r.slides} 页）：${r.file}${fit}${phNote}${renamedNote}${parityNote}${renderNote}${floorNote}${chartNote}${await withAudit(r.file)}${engineNote}`
         } catch (error) {
           // 自动回退链（C1 决定）：auto 且 pptd 硬失败 → 有 python-pptx 则兜底并醒目标注降级（绝不静默）
           if (eff.allowFallback) {

package/lib/verify.js

@@ -452,6 +452,13 @@ export function verifyDeck(layout) {
   const size = layout.size ?? { width: 960, height: 540 }
   const theme = layout.theme ?? null
   let total = 0
+  // 结构化 findings（2026-09-26 新增，**纯增量**）：消费方（tools.js 的门禁计数、templates.js 的收纳报告）
+  // 此前靠 `text.split('\n').filter(l => l.includes('[✗]'))` 与正则 `\[✗\] (\w+)` 反解文本 —— 后者会把
+  // `out-of-page` 截成 `out`（`\w` 不含连字符），报告里的错误码直方图全是错的。这里把本就算出来的
+  // errors/warns/suggestions 直接带出去，文本格式保持原样（`text` 对用户与旧断言零变化）。
+  const allErrors = []
+  const allWarns = []
+  const allSuggestions = []
   for (const page of layout.pages ?? []) {
     const findings = analyzePage(page, size)
     const suggestions = theme ? aestheticSuggestions(page, size, theme) : []
@@ -461,6 +468,10 @@ export function verifyDeck(layout) {
     const confirmed = findings.filter((f) => f.severity === 'confirmed')
     const errors = findings.filter((f) => f.severity === 'error')
     const warns = findings.filter((f) => f.severity === 'warning')
+    const at = { page: page.index + 1, pageName: page.name }
+    allErrors.push(...errors.map((f) => ({ ...f, ...at })))
+    allWarns.push(...warns.map((f) => ({ ...f, ...at })))
+    allSuggestions.push(...suggestions.map((s) => ({ ...s, ...at })))
     total += findings.length + suggestions.length
     const confOverlap = confirmed.filter((f) => f.code === 'expected-overlap').length
     const confOut = confirmed.filter((f) => f.code === 'expected-out-of-safe').length
@@ -475,7 +486,7 @@ export function verifyDeck(layout) {
       out.push(`  - [·] ${s.code}｜${s.message}`)
     }
   }
-  return { text: out.join('\n'), total, size }
+  return { text: out.join('\n'), total, size, errors: allErrors, warns: allWarns, suggestions: allSuggestions }
 }
 
 /**

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-ppt-studio",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "在 DeepSeek Harness 里做 PPT：说需求 → 逐页制作 → 导出可编辑的 .pptx。含布局检查、Office 真渲染复核，以及可扩展的本地模板库",
-  "//publish": "2026-09-18 定：发 npm，**无 scope** 包名 `dsh-ppt-studio`。**状态（2026-09-26）：尚未发布** —— `npm login` 已通（`npm whoami` = `zbsph`）、包名未被占用（`npm view` 404）、构件已备好（发版那个 tgz，sha 与 Release 资产一致），但首次 `npm publish` 返回 **E403**：账号开了 2FA，普通登录凭据不能写入，需 `--otp=<6 位码>` 或勾了 Bypass 2FA 的 granular token。发布纪律：**用发版时那个 tgz**（`npm publish \"<.sync-state.json 里 localTgz 指向的文件>\"`），保证 registry 字节与 GitHub Release 资产**逐字节相同**；**别在 main 前进后跑裸 `npm publish`**（会按当前工作区重新打包）。成功后才做：核对 `npm view dsh-ppt-studio version dist.integrity`，并在隔离 DSH_HOME 里 `dsh plugin add dsh-ppt-studio` 真装一遍。见 docs/06 与 docs/03 的 1.1.0 条目。",
+  "//publish": "2026-09-18 定：发 npm，**无 scope** 包名 `dsh-ppt-studio`。**状态（2026-09-26）：已发布** —— `dsh-ppt-studio@1.1.0` 在 npm 上（`dist-tags.latest`、public，发布者 `zbsph`），registry 的 tarball 与 GitHub Release 资产**逐字节相同**（sha256 `9303cc5c…`）。首个版本是 `npm publish <发版 tgz>` 直发的；**从下一版起改走 Trusted Publishing（OIDC）全自动通道**：`.github/workflows/publish.yml` 由 release 事件触发 → 下载 Release 资产 → OIDC `npm publish` → 发后自证 integrity —— 零长期 token、零手工（npm 已公告：Bypass-2FA 直发 2027-01 移除）。发布纪律不变：**用发版时那个 tgz**（`.sync-state.json` 的 `localTgz`），**别在 main 前进后跑裸 `npm publish`**（会按当前工作区重新打包 ⇒ 破坏'两条通道同一份字节'）。手动补发入口：Actions → Publish to npm → Run workflow。见 README §10 与 docs/05「发布-同步纪律」。",
   "repository": { "type": "git", "url": "git+https://github.com/zbsph/dsh-ppt-studio.git" },
   "homepage": "https://github.com/zbsph/dsh-ppt-studio#readme",
   "bugs": { "url": "https://github.com/zbsph/dsh-ppt-studio/issues" },

package/scripts/install-desktop.mjs

@@ -2,7 +2,12 @@
 /**
  * dsh-ppt-studio 桌面端安装器（DSH Electron 应用）
  *
- * ── 为什么需要单独一个安装器（2026-09-26 实测，两条都是硬事实）──────────────────────
+ * ── 何时用它：**只在归档通道**（2026-09-26 起）──────────────────────────────────────
+ * **默认安装途径是 npm**：桌面端在「插件管理」里填包名 `dsh-ppt-studio` 即可（内部就是 `pnpm add`，
+ * 会写进 profile 的 `dependencies` + `dsh.profile.bundles`）。本脚本是**离线/归档备选**——
+ * 只有当你要用 GitHub Release 的 `.tgz` 资产、或干脆不经过 registry 时才需要它。
+ *
+ * ── 为什么"用资产 URL 装"在桌面端还得有单独一个安装器（2026-09-26 实测，两条都是硬事实）────
  * ① **独立 CLI 拒绝桌面 profile**：`@deepseek-ai/dsh` 的 `lib/bin.js` 写死了
  *      if (profile.toLowerCase() === "desktop") program.error('profile "desktop" is managed exclusively by the Electron application')
  *    启动与 `plugin` 两条路都过这道守卫，且**没有环境变量旁路**
@@ -12,7 +17,7 @@
  *      [ERR_PNPM_MISSING_TARBALL_INTEGRITY] … its lockfile entry has no "integrity" field
  *    隔离复现：同一份 pnpm/工作区，**去掉 nodeLinker** 就成功；**换 pnpm 11.21** 也成功。
  *    ⇒ 这是 pnpm 11.7 在 hoisted + tarball-URL 组合上的缺陷，不是本插件的代码问题；
- *      但它让"用发布资产 URL 装"这条**我们唯一公开的安装通道**在桌面端直接不可用。
+ *      但它让"用发布资产 URL 装"这条归档通道在桌面端直接不可用（npm 通道不受影响）。
  *
  * ── 本脚本怎么做 ────────────────────────────────────────────────────────────────
  *   1) 只用**应用自带的 pnpm/Node**（`resources/runtime/…`）——和应用的插件管理器同一套工具链，

package/scripts/install.mjs

@@ -6,6 +6,10 @@
  *   3) 校验"预设**声明**"所需的包内资产在位，并清理历史遗留产物
  * 装完：重启 dsh web → 新建会话时选「PPT 工作室」→ 直接提需求。
  *
+ * ── 何时用它：**只在归档通道**（2026-09-26 起）──────────────────────────────────────
+ * **默认安装途径是 npm**：web 端 `dsh plugin --profile web add dsh-ppt-studio`；桌面端在插件管理里填
+ * 同名包。本脚本是**离线/归档备选**——解压发布包后跑它，用于不进 registry / 内网 / 需要留档的场景。
+ *
  * ── 2026-09-24 适配 DSH 0.1.7-rc.1：**安装器不再写预设目录** ──────────────────────
  * 0.1.6 及以前，预设靠"往 `<dshHome>/.agent-presets/ppt/` 写文件"交付（宿主启动时扫描该目录）。
  * 0.1.7 把那条发现路径**整个删掉了**，预设改为向 `agentPresets` 注册表**声明**——本插件的