dsh-ppt 0.33.0 → 0.35.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/CHANGELOG.md +42 -0
  2. package/README.en.md +8 -10
  3. package/README.md +8 -10
  4. package/docs/USAGE.en.md +44 -35
  5. package/docs/USAGE.md +45 -36
  6. package/docs/VALIDATION.md +8 -0
  7. package/lib/client.js +116 -17
  8. package/lib/ecosystem.js +10 -0
  9. package/lib/execution.js +36 -5
  10. package/lib/tools.js +74 -4
  11. package/lib/types.d.ts +79 -1
  12. package/lib/workbench.js +255 -14
  13. package/package.json +2 -2
  14. package/skills/dsh-ppt/SKILL.md +34 -31
  15. package/skills/dsh-ppt/package.json +1 -1
  16. package/skills/dsh-ppt/references/office-pack.md +124 -0
  17. package/skills/dsh-ppt/references/research-plan.md +93 -62
  18. package/skills/dsh-ppt/scripts/build-deck.mjs +109 -3
  19. package/skills/dsh-ppt/scripts/deck-absorb.mjs +21 -0
  20. package/skills/dsh-ppt/scripts/deck-advanced.mjs +330 -37
  21. package/skills/dsh-ppt/scripts/deck-brand-kit.mjs +257 -0
  22. package/skills/dsh-ppt/scripts/deck-charts-exec.mjs +805 -0
  23. package/skills/dsh-ppt/scripts/deck-chrome.mjs +47 -1
  24. package/skills/dsh-ppt/scripts/deck-compose.mjs +386 -0
  25. package/skills/dsh-ppt/scripts/deck-core.mjs +136 -16
  26. package/skills/dsh-ppt/scripts/deck-delivery.mjs +750 -17
  27. package/skills/dsh-ppt/scripts/deck-evidence.mjs +811 -118
  28. package/skills/dsh-ppt/scripts/deck-export.mjs +652 -0
  29. package/skills/dsh-ppt/scripts/deck-i18n.mjs +170 -0
  30. package/skills/dsh-ppt/scripts/deck-layouts.mjs +72 -8
  31. package/skills/dsh-ppt/scripts/deck-media.mjs +22 -0
  32. package/skills/dsh-ppt/scripts/deck-office.mjs +1455 -14
  33. package/skills/dsh-ppt/scripts/deck-remix.mjs +471 -0
@@ -516,10 +516,16 @@ export function normalizeSlideItems(rawItems, layout) {
516
516
  const before = Number.isFinite(beforeNum) ? beforeNum : undefined
517
517
  const afterNum = entry.after !== undefined && entry.after !== null && entry.after !== '' ? Number(entry.after) : NaN
518
518
  const after = Number.isFinite(afterNum) ? afterNum : undefined
519
+ const actualNum = entry.actual !== undefined && entry.actual !== null && entry.actual !== '' ? Number(entry.actual) : NaN
520
+ const actual = Number.isFinite(actualNum) ? actualNum : undefined
521
+ const targetNum = entry.target !== undefined && entry.target !== null && entry.target !== '' ? Number(entry.target) : NaN
522
+ const target = Number.isFinite(targetNum) ? targetNum : undefined
523
+ const maxNum = entry.max !== undefined && entry.max !== null && entry.max !== '' ? Number(entry.max) : NaN
524
+ const max = Number.isFinite(maxNum) ? maxNum : undefined
519
525
  const bullets = Array.isArray(entry.bullets ?? entry.items)
520
526
  ? (entry.bullets ?? entry.items).map((b) => cleanRichText(String(b))).filter(Boolean).slice(0, 8)
521
527
  : undefined
522
- if (!title && !text && !value && x === undefined && before === undefined && (!bullets || bullets.length === 0)) return null
528
+ if (!title && !text && !value && x === undefined && before === undefined && actual === undefined && (!bullets || bullets.length === 0)) return null
523
529
  return {
524
530
  ...(tag ? { tag } : {}),
525
531
  ...(title ? { title } : {}),
@@ -539,6 +545,9 @@ export function normalizeSlideItems(rawItems, layout) {
539
545
  ...(size !== undefined ? { size } : {}),
540
546
  ...(before !== undefined ? { before } : {}),
541
547
  ...(after !== undefined ? { after } : {}),
548
+ ...(actual !== undefined ? { actual } : {}),
549
+ ...(target !== undefined ? { target } : {}),
550
+ ...(max !== undefined ? { max } : {}),
542
551
  ...(status ? { status } : {}),
543
552
  ...(bullets?.length ? { bullets } : {}),
544
553
  }
@@ -1409,6 +1418,39 @@ export function renderSlideChromePptx(slide, index, total, theme, langAttr, mani
1409
1418
  ],
1410
1419
  }))
1411
1420
  }
1421
+
1422
+ const watermarkText = typeof manifest?.brand?.watermark === 'string' ? manifest.brand.watermark.trim() : ''
1423
+ if (watermarkText) {
1424
+ const hasLogo = Boolean(manifest?.brand?.logoAssetId)
1425
+ const wmW = computeBadgePillWidth(watermarkText.toUpperCase(), 8.5, 4.1, 1.3)
1426
+ const wmRight = chromeCfg.folioPos === 'top-right'
1427
+ ? (hasLogo ? 9.85 : 10.45)
1428
+ : (hasLogo ? 11.35 : 12.71)
1429
+ const wmY = chromeCfg.folioPos === 'top-right'
1430
+ ? 0.24
1431
+ : (chromeCfg.folioPos === 'beamer-bar' ? 0.14 : 0.10)
1432
+ shapes.push(ooxmlShape(nextIdFn(), 'Brand watermark', { x: +(wmRight - wmW).toFixed(3), y: wmY, w: wmW, h: 0.23 }, {
1433
+ preset: 'roundRect',
1434
+ adj: 22000,
1435
+ fill: tk.surface1,
1436
+ stroke: tk.hairline,
1437
+ strokePt: 0.5,
1438
+ anchor: 'ctr',
1439
+ marginsIn: { l: 0.06, r: 0.06, t: 0.01, b: 0.01 },
1440
+ paragraphs: [
1441
+ ooxmlRichParagraph(watermarkText.toUpperCase(), {
1442
+ sizePt: 8.5,
1443
+ color: tk.inkMuted,
1444
+ bold: true,
1445
+ lang: langAttr,
1446
+ align: 'ctr',
1447
+ font: theme.fonts.body,
1448
+ lineHeight: 1.05,
1449
+ spc: 110,
1450
+ }),
1451
+ ],
1452
+ }))
1453
+ }
1412
1454
  }
1413
1455
 
1414
1456
  return shapes.join('')
@@ -1833,4 +1875,8 @@ export const CHROME_CSS = `
1833
1875
  .slide[data-chrome="academic-minimal"] .slide-takeaway{background:transparent;border:0;border-top:1px solid var(--accent);border-bottom:1px solid var(--hairline);border-radius:0;padding:8px 0}
1834
1876
  .slide[data-chrome="gov-ceremonial"] .gov-header{border-bottom:2px solid var(--accent);box-shadow:0 4px 0 0 var(--bg),0 5.5px 0 0 var(--accent2);padding-bottom:12px;margin-bottom:4px}
1835
1877
  .slide[data-chrome="gov-ceremonial"] .gov-ribbon{letter-spacing:.08em}
1878
+ .brand-watermark{position:absolute;top:1.35%;right:4.65%;z-index:4;padding:2px 9px;border-radius:4px;border:1px solid var(--hairline);background:var(--surface1);color:var(--muted);font-size:clamp(9px,.82vw,11px);font-weight:700;letter-spacing:.11em;text-transform:uppercase;line-height:1.25;pointer-events:none;white-space:nowrap;opacity:.88}
1879
+ .slide.has-brand-logo .brand-watermark{right:14.2%}
1880
+ .slide[data-chrome="editorial-folio"] .brand-watermark{top:3.1%;right:14.8%}
1881
+ .slide[data-chrome="editorial-folio"].has-brand-logo .brand-watermark{right:21.5%}
1836
1882
  `
@@ -0,0 +1,386 @@
1
+ /**
2
+ * deck-compose.mjs —— 企业金页组件库(.dsh-ppt/slide-bank.json)与多工程无损拼装引擎(mergeDecks)。
3
+ *
4
+ * 零新增运行时依赖:
5
+ * 1. Workspace Slide Bank:将任意高质量单页(连同嵌入图片资产与关联证据)收藏至 `.dsh-ppt/slide-bank.json` 跨项目复用;
6
+ * 2. Multi-Deck Composer(`mergeDecks`):从多个 `.json` 工程和/或金页库中精选指定页,
7
+ * 自动按 SHA-256 资产去重,并将跨工程的 `[E1..En]` 证据编号无冲突重映射,统一主题与母版后直接产出新三件套。
8
+ */
9
+
10
+ import { existsSync, readFileSync } from 'node:fs'
11
+ import { join, resolve } from 'node:path'
12
+ import { randomUUID } from 'node:crypto'
13
+ import { writeWorkspaceJson } from './deck-store.mjs'
14
+ import { extractSlideEvidenceRefs } from './deck-evidence.mjs'
15
+
16
+ const BANK_REL_PATH = join('.dsh-ppt', 'slide-bank.json')
17
+ const MAX_BANK_ENTRIES = 100
18
+ const INLINE_REF_RE = /\[([Ee]\d{1,3})\]/g
19
+
20
+ function fail(msg) {
21
+ throw new Error('dsh-ppt:' + msg)
22
+ }
23
+
24
+ function cleanStr(val, max = 120) {
25
+ return String(val ?? '').replace(/\s+/g, ' ').trim().slice(0, max)
26
+ }
27
+
28
+ export function slideBankPathFor(cwd = '.') {
29
+ return join(resolve(String(cwd || '.')), BANK_REL_PATH)
30
+ }
31
+
32
+ export function loadSlideBank(cwd = '.') {
33
+ const file = slideBankPathFor(cwd)
34
+ if (!existsSync(file)) return { schemaVersion: 1, entries: [] }
35
+ try {
36
+ const parsed = JSON.parse(readFileSync(file, 'utf8'))
37
+ if (parsed && Array.isArray(parsed.entries)) {
38
+ return { schemaVersion: 1, entries: parsed.entries }
39
+ }
40
+ } catch { /* ignore corrupt bank */ }
41
+ return { schemaVersion: 1, entries: [] }
42
+ }
43
+
44
+ function collectSlideAssets(slide, assetsMap = {}) {
45
+ const out = {}
46
+ if (slide?.image?.assetId && assetsMap[slide.image.assetId]) {
47
+ out[slide.image.assetId] = structuredClone(assetsMap[slide.image.assetId])
48
+ }
49
+ if (Array.isArray(slide?.images)) {
50
+ for (const img of slide.images) {
51
+ if (img?.assetId && assetsMap[img.assetId]) {
52
+ out[img.assetId] = structuredClone(assetsMap[img.assetId])
53
+ }
54
+ }
55
+ }
56
+ return out
57
+ }
58
+
59
+ function hydrateSlideImageDataUris(slide, assetsMap = {}) {
60
+ const copy = structuredClone(slide)
61
+ delete copy.id
62
+ delete copy.dataTemplate
63
+ if (copy.image?.assetId && assetsMap[copy.image.assetId]?.data) {
64
+ const { assetId, ...rest } = copy.image
65
+ copy.image = { ...rest, src: assetsMap[assetId].data }
66
+ }
67
+ if (Array.isArray(copy.images)) {
68
+ copy.images = copy.images.map((img) => {
69
+ if (img?.assetId && assetsMap[img.assetId]?.data) {
70
+ const { assetId, ...rest } = img
71
+ return { ...rest, src: assetsMap[assetId].data }
72
+ }
73
+ return img
74
+ })
75
+ }
76
+ return copy
77
+ }
78
+
79
+ export function saveSlideToBank(cwd = '.', manifest, slideRef, meta = {}) {
80
+ if (!manifest || !Array.isArray(manifest.slides) || manifest.slides.length === 0) {
81
+ fail('无法保存金页:工程缺少有效 slides')
82
+ }
83
+ const idx = typeof slideRef === 'number' && Number.isInteger(slideRef)
84
+ ? slideRef - 1
85
+ : manifest.slides.findIndex(s => s.id === slideRef)
86
+ if (idx < 0 || idx >= manifest.slides.length) {
87
+ fail('找不到要收藏的页面:' + slideRef)
88
+ }
89
+ const slide = manifest.slides[idx]
90
+ const bank = loadSlideBank(cwd)
91
+ const bankId = cleanStr(meta.bankId || meta.id || `bank-${randomUUID().slice(0, 8)}`, 48)
92
+ .toLowerCase()
93
+ .replace(/[^a-z0-9_-]/g, '-') || `bank-${randomUUID().slice(0, 8)}`
94
+ const name = cleanStr(meta.name || slide.title || `Slide ${idx + 1}`, 80)
95
+ const tags = [...new Set(
96
+ (Array.isArray(meta.tags) ? meta.tags : (typeof meta.tags === 'string' ? meta.tags.split(/[,,\s]+/) : []))
97
+ .map(t => cleanStr(t, 28).toLowerCase())
98
+ .filter(Boolean),
99
+ )].slice(0, 10)
100
+
101
+ const refs = extractSlideEvidenceRefs(slide)
102
+ const evById = new Map((Array.isArray(manifest.evidence) ? manifest.evidence : []).map(e => [String(e.id || '').toUpperCase(), e]))
103
+ const boundEvidence = refs.map(id => evById.get(id)).filter(Boolean).map(e => structuredClone(e))
104
+
105
+ const entry = {
106
+ bankId,
107
+ name,
108
+ tags,
109
+ layout: slide.layout || 'bullets',
110
+ variant: slide.variant || undefined,
111
+ sourceDeckTitle: cleanStr(manifest.title || '', 100),
112
+ savedAt: new Date().toISOString(),
113
+ slide: structuredClone(slide),
114
+ assets: collectSlideAssets(slide, manifest.assets || {}),
115
+ ...(boundEvidence.length > 0 ? { evidence: boundEvidence } : {}),
116
+ }
117
+
118
+ const nextEntries = [
119
+ ...bank.entries.filter(e => e.bankId !== bankId),
120
+ entry,
121
+ ].slice(-MAX_BANK_ENTRIES)
122
+
123
+ const file = slideBankPathFor(cwd)
124
+ writeWorkspaceJson(file, { schemaVersion: 1, entries: nextEntries })
125
+ return {
126
+ ok: true,
127
+ path: file,
128
+ bankId,
129
+ name,
130
+ tags,
131
+ layout: entry.layout,
132
+ totalCount: nextEntries.length,
133
+ }
134
+ }
135
+
136
+ export function listSlideBank(cwd = '.', tag = '') {
137
+ const bank = loadSlideBank(cwd)
138
+ const needle = cleanStr(tag, 40).toLowerCase()
139
+ const filtered = needle
140
+ ? bank.entries.filter(e =>
141
+ (Array.isArray(e.tags) && e.tags.some(t => t.toLowerCase().includes(needle))) ||
142
+ String(e.name || '').toLowerCase().includes(needle) ||
143
+ String(e.layout || '').toLowerCase().includes(needle)
144
+ )
145
+ : bank.entries
146
+ return {
147
+ ok: true,
148
+ path: slideBankPathFor(cwd),
149
+ count: filtered.length,
150
+ entries: filtered.map(e => ({
151
+ bankId: e.bankId,
152
+ name: e.name,
153
+ layout: e.layout,
154
+ ...(e.variant ? { variant: e.variant } : {}),
155
+ tags: e.tags || [],
156
+ sourceDeckTitle: e.sourceDeckTitle || '',
157
+ savedAt: e.savedAt || '',
158
+ evidenceCount: Array.isArray(e.evidence) ? e.evidence.length : 0,
159
+ })),
160
+ }
161
+ }
162
+
163
+ export function removeBankSlide(cwd = '.', bankId) {
164
+ const id = cleanStr(bankId, 48).toLowerCase()
165
+ const bank = loadSlideBank(cwd)
166
+ const next = bank.entries.filter(e => String(e.bankId || '').toLowerCase() !== id)
167
+ if (next.length === bank.entries.length) fail('金页库中找不到条目:' + bankId)
168
+ const file = slideBankPathFor(cwd)
169
+ writeWorkspaceJson(file, { schemaVersion: 1, entries: next })
170
+ return { ok: true, removed: id, totalCount: next.length }
171
+ }
172
+
173
+ // ---------------------------------------------------------------------------
174
+ // Multi-Deck Composer with SHA-256 Asset Dedup & Collision-Free [E#] Remapping
175
+ // ---------------------------------------------------------------------------
176
+
177
+ function rewriteInlineRefs(text, idMap) {
178
+ if (typeof text !== 'string' || !text.includes('[')) return text
179
+ return text.replace(INLINE_REF_RE, (full, rawId) => {
180
+ const mapped = idMap.get(String(rawId).toUpperCase())
181
+ return mapped ? `[${mapped}]` : full
182
+ })
183
+ }
184
+
185
+ function stripAutoProvenanceBlock(notes) {
186
+ if (typeof notes !== 'string') return notes
187
+ return notes.split(/\n{1,2}\[(?:证据溯源|Evidence Provenance)\]/)[0].trim()
188
+ }
189
+
190
+ function remapSlideEvidence(slide, idMap) {
191
+ if (!idMap || idMap.size === 0) return slide
192
+ const next = structuredClone(slide)
193
+ if (Array.isArray(next.evidenceIds)) {
194
+ next.evidenceIds = [...new Set(next.evidenceIds.map(id => idMap.get(String(id).toUpperCase()) || String(id).toUpperCase()))]
195
+ }
196
+ for (const key of ['title', 'subtitle', 'takeaway', 'source', 'text']) {
197
+ if (typeof next[key] === 'string') next[key] = rewriteInlineRefs(next[key], idMap)
198
+ }
199
+ if (typeof next.notes === 'string') {
200
+ const cleaned = stripAutoProvenanceBlock(next.notes)
201
+ next.notes = cleaned ? rewriteInlineRefs(cleaned, idMap) : undefined
202
+ if (next.notes === undefined) delete next.notes
203
+ }
204
+ if (Array.isArray(next.bullets)) {
205
+ next.bullets = next.bullets.map(b => rewriteInlineRefs(b, idMap))
206
+ }
207
+ if (Array.isArray(next.items)) {
208
+ next.items = next.items.map(it => {
209
+ if (!it || typeof it !== 'object') return it
210
+ const copy = { ...it }
211
+ for (const k of ['tag', 'title', 'value', 'delta', 'text']) {
212
+ if (typeof copy[k] === 'string') copy[k] = rewriteInlineRefs(copy[k], idMap)
213
+ }
214
+ if (Array.isArray(copy.bullets)) copy.bullets = copy.bullets.map(b => rewriteInlineRefs(b, idMap))
215
+ return copy
216
+ })
217
+ }
218
+ if (Array.isArray(next.rows)) {
219
+ next.rows = next.rows.map(r => (Array.isArray(r) ? r.map(c => rewriteInlineRefs(c, idMap)) : r))
220
+ }
221
+ if (next.chart?.caption) next.chart.caption = rewriteInlineRefs(next.chart.caption, idMap)
222
+ return next
223
+ }
224
+
225
+ /**
226
+ * 跨工程拼装器:从 2+ 份 `.json` 工程和/或 `.dsh-ppt/slide-bank.json` 金页库中精选指定页,
227
+ * 自动完成图片资产 SHA-256 去重与跨来源 `[E1..En]` 证据无冲突重映射,统一母版后重建完整三件套。
228
+ */
229
+ export async function mergeDecks(options = {}) {
230
+ options.signal?.throwIfAborted?.()
231
+ const cwd = resolve(String(options.cwd || '.'))
232
+ const sources = Array.isArray(options.sources) ? options.sources : []
233
+ if (sources.length === 0) {
234
+ fail('mergeDecks 至少需要提供 1 个 sources 来源(deckPath 或 bankIds)')
235
+ }
236
+
237
+ const bank = loadSlideBank(cwd)
238
+ const bankMap = new Map(bank.entries.map(e => [String(e.bankId).toLowerCase(), e]))
239
+
240
+ const mergedSlides = []
241
+ const mergedEvidence = []
242
+ const evidenceDedupKey = new Map()
243
+ let evCounter = 0
244
+ let firstTheme = ''
245
+ let firstLang = ''
246
+ const mergedAssetHashes = new Set()
247
+ const sourceStats = []
248
+
249
+ const registerEvidenceEntry = (ev) => {
250
+ const dedup = `${cleanStr(ev.claim, 200).toLowerCase()}||${cleanStr(ev.source, 120).toLowerCase()}`
251
+ if (evidenceDedupKey.has(dedup)) return evidenceDedupKey.get(dedup)
252
+ evCounter += 1
253
+ const newId = `E${evCounter}`
254
+ const normalized = { ...structuredClone(ev), id: newId }
255
+ mergedEvidence.push(normalized)
256
+ evidenceDedupKey.set(dedup, newId)
257
+ return newId
258
+ }
259
+
260
+ for (let sIdx = 0; sIdx < sources.length; sIdx += 1) {
261
+ const spec = sources[sIdx]
262
+ if (!spec || typeof spec !== 'object') continue
263
+
264
+ // Source Kind A: Slide Bank entries
265
+ if (Array.isArray(spec.bankIds) && spec.bankIds.length > 0) {
266
+ let pickedCount = 0
267
+ for (const bid of spec.bankIds) {
268
+ const entry = bankMap.get(String(bid || '').trim().toLowerCase())
269
+ if (!entry) fail('金页库中找不到条目:' + bid)
270
+ const idMap = new Map()
271
+ for (const ev of (entry.evidence || [])) {
272
+ idMap.set(String(ev.id || '').toUpperCase(), registerEvidenceEntry(ev))
273
+ }
274
+ Object.keys(entry.assets || {}).forEach(h => mergedAssetHashes.add(h))
275
+ const hydrated = hydrateSlideImageDataUris(entry.slide, entry.assets || {})
276
+ mergedSlides.push(remapSlideEvidence(hydrated, idMap))
277
+ pickedCount += 1
278
+ }
279
+ sourceStats.push({ kind: 'slide-bank', count: pickedCount })
280
+ continue
281
+ }
282
+
283
+ // Source Kind B: Project JSON deck
284
+ if (typeof spec.deckPath === 'string' && spec.deckPath.trim()) {
285
+ const fullPath = resolve(cwd, spec.deckPath.trim())
286
+ if (!existsSync(fullPath)) fail('找不到待拼装工程:' + fullPath)
287
+ let doc
288
+ try { doc = JSON.parse(readFileSync(fullPath, 'utf8')) } catch { fail('无法解析待拼装工程 JSON:' + fullPath) }
289
+ if (!doc || !Array.isArray(doc.slides) || doc.slides.length === 0) fail('无效的 dsh-ppt 工程文件:' + fullPath)
290
+ if (!firstTheme && doc.theme) firstTheme = doc.theme
291
+ if (!firstLang && doc.language) firstLang = doc.language
292
+
293
+ const explicitRange = Array.isArray(spec.slides) && spec.slides.length > 0
294
+ const chosenSlides = explicitRange
295
+ ? spec.slides.map((ref) => {
296
+ const sl = typeof ref === 'number' && Number.isInteger(ref) ? doc.slides[ref - 1] : doc.slides.find(x => x.id === ref)
297
+ if (!sl) fail(`工程 ${spec.deckPath} 中找不到第 ${ref} 页`)
298
+ return sl
299
+ })
300
+ : doc.slides.filter((sl) => {
301
+ if (sIdx > 0 && (sl.layout === 'cover' || sl.layout === 'closing')) return false
302
+ if (sIdx === 0 && sources.length > 1 && sl.layout === 'closing') return false
303
+ if (sl.kicker && /附录 · 事实溯源|APPENDIX · SOURCES/i.test(sl.kicker)) return false
304
+ return true
305
+ })
306
+
307
+ const idMap = new Map()
308
+ const docEvById = new Map((Array.isArray(doc.evidence) ? doc.evidence : []).map(e => [String(e.id || '').toUpperCase(), e]))
309
+ for (const sl of chosenSlides) {
310
+ for (const oldId of extractSlideEvidenceRefs(sl)) {
311
+ const ev = docEvById.get(oldId)
312
+ if (ev && !idMap.has(oldId)) {
313
+ idMap.set(oldId, registerEvidenceEntry(ev))
314
+ }
315
+ }
316
+ }
317
+
318
+ for (const sl of chosenSlides) {
319
+ if (sl.image?.assetId) mergedAssetHashes.add(sl.image.assetId)
320
+ if (Array.isArray(sl.images)) sl.images.forEach(im => { if (im?.assetId) mergedAssetHashes.add(im.assetId) })
321
+ const hydrated = hydrateSlideImageDataUris(sl, doc.assets || {})
322
+ mergedSlides.push(remapSlideEvidence(hydrated, idMap))
323
+ }
324
+ sourceStats.push({ kind: 'deck', deckPath: fullPath, count: chosenSlides.length })
325
+ }
326
+ }
327
+
328
+ if (mergedSlides.length === 0) {
329
+ fail('拼装结果为空,请检查 sources 指定的页码或 bankIds')
330
+ }
331
+
332
+ const lang = options.lang || firstLang || 'zh'
333
+ const en = lang === 'en'
334
+ const title = cleanStr(options.title || (en ? 'Composed Presentation' : '跨工程融合演示文稿'), 120)
335
+
336
+ // Ensure clean cover & closing framing when composing body slides
337
+ if (mergedSlides[0]?.layout !== 'cover') {
338
+ mergedSlides.unshift({
339
+ layout: 'cover',
340
+ kicker: en ? 'COMPOSED DECK' : '多工程融合汇编',
341
+ title,
342
+ subtitle: en
343
+ ? `Curated from ${sourceStats.length} source(s) · ${mergedSlides.length} core slides`
344
+ : `精选拼装自 ${sourceStats.length} 组来源 · 共 ${mergedSlides.length} 页核心内容`,
345
+ })
346
+ } else if (options.title) {
347
+ mergedSlides[0] = { ...mergedSlides[0], title }
348
+ }
349
+
350
+ if (mergedSlides[mergedSlides.length - 1]?.layout !== 'closing') {
351
+ mergedSlides.push({
352
+ layout: 'closing',
353
+ kicker: en ? 'NEXT STEPS' : '总结与行动',
354
+ title: en ? 'Align priorities and kick off execution' : '共识确认与下一步推进计划',
355
+ subtitle: title,
356
+ })
357
+ }
358
+
359
+ const { buildDeckAsync } = await import('./deck-advanced.mjs')
360
+ const built = await buildDeckAsync({
361
+ title,
362
+ slides: mergedSlides,
363
+ theme: options.theme || firstTheme || 'consulting',
364
+ lang,
365
+ motion: options.motion,
366
+ motionProfile: options.motionProfile,
367
+ brand: options.brand,
368
+ ...(mergedEvidence.length > 0 ? { evidence: mergedEvidence, evidenceAppendix: options.evidenceAppendix !== false } : {}),
369
+ outputDir: options.outputDir || '.',
370
+ fileName: options.fileName || title,
371
+ overwrite: options.overwrite === true,
372
+ smartLayout: false,
373
+ autoUpgrade: false,
374
+ selfRepair: false,
375
+ ...(Array.isArray(options.exports) && options.exports.length > 0 ? { exports: options.exports } : {}),
376
+ cwd,
377
+ signal: options.signal,
378
+ })
379
+
380
+ return {
381
+ ...built,
382
+ composedFrom: sourceStats,
383
+ dedupedAssetCount: mergedAssetHashes.size,
384
+ remappedEvidenceCount: mergedEvidence.length,
385
+ }
386
+ }