dsh-ppt 0.30.0 → 0.32.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.
@@ -1,14 +1,19 @@
1
1
  /**
2
- * deck-upgrader.mjs —— 弱模型兜底升维编译器(Weak-LLM Compensator & Anti-Slop Auto-Upgrader)。
2
+ * deck-upgrader.mjs —— 弱模型兜底升维编译器(Weak-LLM Compensator)、标杆槽位重排器与零模型自检修复闭环(v0.31.0)。
3
3
  *
4
- * 解决痛点:即使上游 LLM(如 DeepSeek 或轻量模型)偷懒输出了连续 bullets 文字墙、空洞名词标题、
5
- * 埋在文字里的前后对比数据/多维评分/代码块/原型描述,或只有“谢谢”的空洞封底,本引擎也在渲染前以
6
- * 100% 确定性规则无损升维为顶级咨询/发布会视觉版式(零额外 LLM 调用、零新增外部依赖、零幻觉编造)。
4
+ * 解决痛点:
5
+ * 1. 即使上游 LLM(如 DeepSeek 或轻量模型)偷懒输出了连续 bullets 文字墙、空洞名词标题、
6
+ * 埋在文字里的前后对比数据/多维评分/代码块/原型描述、乱序章节或只有“谢谢”的空洞封底,
7
+ * 本引擎也在渲染前以 100% 确定性规则无损升维为顶级咨询/发布会视觉版式;
8
+ * 2. 支持 `alignOrder: true` 按标杆范本槽位节奏(封面 → 摘要/KPI → 痛点对比 → 方案图谱 → 量化证明 → 排期路线 → 行动封底)重排乱序草稿;
9
+ * 3. 内置零额外 LLM 调用的确定性自检修复闭环(`selfRepairDeck`):渲染落盘前先跑 `checkManifest` + SLOP-01..12,
10
+ * 自动无损修复标题溢出、文字墙、卡片/表格过载、饼图碎块、缺图表焦点/结论、连续方框疲劳与刺眼/低对比配色,复检通过后再落盘。
7
11
  */
8
12
 
9
13
  import { stripInlineMarkdown } from './deck-layouts.mjs'
14
+ import { relativeLuminance, hexToHsl } from './deck-themes.mjs'
10
15
 
11
- const WEAK_GENERIC_TITLE_RE = /^(?:第?[一二三四五六七八九十\d]+[章节部分页、.\s-]*)?(?:项目背景|研究背景|背景介绍|现状分析|现状与问题|数据分析|核心指标|关键指标|性能提升|效能提升|技术实现|架构实现|核心功能|产品介绍|团队介绍|商业模式|未来规划|核心优势|工作进展|项目进展|阶段进展|竞品分析|竞品对比|解决方案|实施方案|行动计划|工作计划|总结|总结汇报|概述|目录页|关于我们|Overview|Introduction|Background|Status|Progress|Metrics|Performance|Implementation|Architecture|Product|Team|Data\s*Analysis|Analysis|Comparison|Solution|Plan|Summary|Results|Chart|Slide\s*\d+)$/i
16
+ export const WEAK_GENERIC_TITLE_RE = /^(?:(?:第?[一二三四五六七八九十\d]+[章节部分页、.\s·:-]*)|(?:(?:Part|Section|Step|Q[1-4]|FY\d{2,4}|20\d{2})\s*[\d.:·\-—\s]*))*(?:项目背景|研究背景|背景介绍|现状分析|业务现状|现状与问题|存在问题|问题分析|痛点分析|数据分析|数据概览|核心数据|财务情况|财务数据|经营数据|业绩情况|成本分析|市场分析|行业分析|用户分析|核心指标|关键指标|性能提升|效能提升|技术实现|技术方案|架构实现|架构设计|核心功能|核心功能介绍|产品介绍|产品规划|团队介绍|组织架构|商业模式|未来规划|下一步计划|项目排期|核心优势|核心亮点|主要成果|工作进展|工作汇报|工作总结|年度总结|季度总结|阶段总结|业务复盘|项目复盘|项目进展|阶段进展|竞品分析|竞品对比|解决方案|实施方案|改进措施|行动计划|工作计划|风险分析|总结|总结汇报|概述|目录页|关于我们|Overview|Introduction|Background|Current\s+State|Status|Progress|Metrics|Key\s+Metrics|Financials|Financial\s+Summary|Performance|Implementation|Architecture|Architecture\s+Overview|Product|Product\s+Overview|Team|Organization|Data\s+Analysis|Analysis|Market\s+Analysis|Comparison|Solution|Plan|Roadmap|Next\s+Steps|Risks?(?:\s*(?:&|and)\s*Mitigations?)?|Summary|Executive\s+Summary|Project\s+Update|Results|Highlights|Chart|Slide\s*\d+)$/i
12
17
  const BARE_CLOSING_RE = /^(?:谢谢|谢谢观看|谢谢聆听|感谢(?:聆听|观看|大家|指导)?|敬请指正|Thank\s*You|Thanks|Q\s*&\s*A)[!!.。??\s]*$/i
13
18
  const LOWER_IS_BETTER_RE = /耗时|时延|延迟|周期|成本|返工|缺陷|故障|错误|流失|投诉|报错|开销|预算|疼痛|障碍|并发症|复发|住院|latency|cost|time|cycle|rework|defect|error|churn|bug|delay|mttr|pain|disability|complication|mortality/i
14
19
  const DUMBBELL_RE = /(?:从|由|from\s+)?(-?\d+(?:\.\d+)?)\s*(%|%|pp|bp|ms|s|分|pts|天|小时|分钟|h|m|x|倍|万|亿|元|例|k|M|B)?\s*(?:提升至|提升到|增长至|增长到|跃升至|上涨至|提高到|升至|升到|降至|降到|压缩至|压缩到|缩短至|缩短到|减少至|减少到|优化至|优化到|变为|→|->|to)\s*(-?\d+(?:\.\d+)?)\s*(%|%|pp|bp|ms|s|分|pts|天|小时|分钟|h|m|x|倍|万|亿|元|例|k|M|B)?/i
@@ -17,6 +22,50 @@ const HEATMAP_TITLE_RE = /热力|达成率|分布矩阵|覆盖率|完成度|矩
17
22
  const QUADRANT_TITLE_RE = /魔力象限|象限|竞争格局|波士顿|定位矩阵|市场定位|quadrant|positioning|bcg|competitive\s+landscape|magic\s+quadrant/i
18
23
  const MOCKUP_TITLE_RE = /界面|原型|工作台演示|产品演示|端体验|交互体验|移动端|app\s*体验|ui\s*展示|mockup|prototype|web\s*studio|dashboard|product\s*demo|mobile\s*app|companion/i
19
24
  const CODE_LINE_RE = /^\s*(?:export\s+|import\s+|const\s+|let\s+|var\s+|function\s+|async\s+function|class\s+|def\s+|fn\s+|pub\s+fn|package\s+|SELECT\s+|CREATE\s+|curl\s+|npm\s+|pnpm\s+|docker\s+|kubectl\s+|return\s+|\{|\})/
25
+ const DATA_BINDING_RE = /\{\{[^{}]+\}\}/
26
+
27
+ function measureWidth(text) {
28
+ return [...stripInlineMarkdown(String(text ?? ''))].reduce((n, c) => n + (/[^\x00-\xff]/.test(c) ? 1 : 0.55), 0)
29
+ }
30
+
31
+ function slideHasDataBinding(slide) {
32
+ if (!slide || typeof slide !== 'object') return false
33
+ try {
34
+ return DATA_BINDING_RE.test(JSON.stringify(slide))
35
+ } catch {
36
+ return false
37
+ }
38
+ }
39
+
40
+ function truncateCleanly(text, maxWidth) {
41
+ const s = String(text ?? '').trim()
42
+ if (!s || measureWidth(s) <= maxWidth) return s
43
+ // 优先在自然句读/标点/空格边界截断,绝不在数字或英文单词中间腰斩
44
+ const chars = [...s]
45
+ let acc = 0
46
+ let cutIdx = chars.length
47
+ let lastBoundary = -1
48
+ for (let i = 0; i < chars.length; i += 1) {
49
+ const ch = chars[i]
50
+ acc += /[^\x00-\xff]/.test(ch) ? 1 : 0.55
51
+ if (acc > maxWidth) {
52
+ cutIdx = i
53
+ break
54
+ }
55
+ if (/[,,。;;、::\s))]/.test(ch) && acc >= maxWidth * 0.48) {
56
+ lastBoundary = i
57
+ }
58
+ }
59
+ let chosen = lastBoundary > 0 ? chars.slice(0, lastBoundary).join('') : chars.slice(0, cutIdx).join('')
60
+ // 避免末尾停在半截数字/英文单词
61
+ if (lastBoundary <= 0 && cutIdx < chars.length && /[A-Za-z0-9.]/.test(chars[cutIdx - 1] || '') && /[A-Za-z0-9.]/.test(chars[cutIdx] || '')) {
62
+ chosen = chosen.replace(/[A-Za-z0-9.]+$/, '')
63
+ }
64
+ // 清理截断残留的未闭合括号与悬空介词/动词
65
+ chosen = chosen.replace(/[((][^))]*$/, '')
66
+ chosen = chosen.replace(/(?:降至|升至|由|从|较|的)\s*$/, '')
67
+ return chosen.replace(/[,,。;;、::\-—\s]+$/, '').trim()
68
+ }
20
69
 
21
70
  function splitLead(raw) {
22
71
  const clean = stripInlineMarkdown(String(raw ?? '')).trim()
@@ -80,7 +129,6 @@ function parseQuadrantBullet(raw, idx) {
80
129
  }
81
130
  }
82
131
  }
83
- // 无显式坐标时按象限关键词自动锚定位置
84
132
  if (/领航|领导|第一梯队|leader/i.test(plain)) {
85
133
  return { title: cleanTitle.slice(0, 24), x: 82 - (idx % 2) * 8, y: 84 - (idx % 2) * 6, size: idx === 0 ? 34 : 26, status: 'positive' }
86
134
  }
@@ -165,24 +213,244 @@ function autoBoldBullet(raw) {
165
213
  return s
166
214
  }
167
215
 
168
- function rescueWeakTitle(slide, langEn) {
216
+ function formatCompactNumber(v) {
217
+ if (!Number.isFinite(v)) return ''
218
+ return Math.abs(v) >= 100 ? String(Math.round(v * 10) / 10) : String(Number(v.toFixed(1)))
219
+ }
220
+
221
+ function extractChartEvidence(chart, langEn) {
222
+ if (!chart || !Array.isArray(chart.categories) || !Array.isArray(chart.series) || chart.series.length === 0) return null
223
+ const primary = chart.series[0]
224
+ const vals = Array.isArray(primary?.values) ? primary.values.map(Number) : []
225
+ const cats = chart.categories
226
+ if (vals.length === 0 || vals.length !== cats.length || vals.some((n) => !Number.isFinite(n))) return null
227
+
228
+ let maxIdx = 0
229
+ let minIdx = 0
230
+ for (let i = 1; i < vals.length; i += 1) {
231
+ if (vals[i] > vals[maxIdx]) maxIdx = i
232
+ if (vals[i] < vals[minIdx]) minIdx = i
233
+ }
234
+ const unit = chart.unit ? String(chart.unit).replace(/[()()]/g, '').trim() : ''
235
+ const unitSuffix = unit && unit.length <= 6 ? unit : ''
236
+ const maxValStr = `${formatCompactNumber(vals[maxIdx])}${unitSuffix}`
237
+ const maxCat = String(cats[maxIdx] ?? '').trim()
238
+ const first = vals[0]
239
+ const last = vals[vals.length - 1]
240
+ const firstCat = String(cats[0] ?? '').trim()
241
+ const lastCat = String(cats[cats.length - 1] ?? '').trim()
242
+ const sName = String(primary.name || '').trim()
243
+
244
+ if (chart.kind === 'pie' || chart.kind === 'doughnut') {
245
+ const sum = vals.reduce((a, b) => a + Math.max(0, b), 0)
246
+ const share = sum > 0 ? Math.round((Math.max(0, vals[maxIdx]) / sum) * 100) : 0
247
+ const shareStr = `${share}%`
248
+ const valNote = maxValStr && maxValStr !== shareStr ? `(${maxValStr})` : ''
249
+ const valNoteEn = maxValStr && maxValStr !== shareStr ? ` (${maxValStr})` : ''
250
+ return {
251
+ headline: langEn
252
+ ? `${maxCat} leads at ${shareStr}${valNoteEn}`
253
+ : `${maxCat}占比居首达 ${shareStr}${valNote}`,
254
+ takeaway: langEn
255
+ ? `${maxCat} accounts for ${shareStr}${valNoteEn} of total, outpacing ${String(cats[minIdx] ?? '').trim()} (${formatCompactNumber(vals[minIdx])}${unitSuffix}).`
256
+ : `${maxCat}以 ${shareStr}${valNote} 位居第一,显著领先末项 ${String(cats[minIdx] ?? '').trim()}(${formatCompactNumber(vals[minIdx])}${unitSuffix})。`,
257
+ }
258
+ }
259
+
260
+ if (vals.length >= 2 && Math.abs(first) > 1e-6 && last !== first && ['line', 'area', 'column', 'waterfall', 'combo'].includes(chart.kind || 'column')) {
261
+ const pct = Math.round(((last - first) / Math.abs(first)) * 100)
262
+ const sign = pct >= 0 ? '+' : ''
263
+ const headline = langEn
264
+ ? `${lastCat} reached ${formatCompactNumber(last)}${unitSuffix} (${sign}${pct}% vs ${firstCat})`
265
+ : `${lastCat} 达 ${formatCompactNumber(last)}${unitSuffix}(较 ${firstCat} ${sign}${pct}%)`
266
+ const peakClauseZh = maxIdx === vals.length - 1
267
+ ? (pct > 0 ? ',创周期新高' : '')
268
+ : `,峰值位于 ${maxCat}(${maxValStr})`
269
+ const peakClauseEn = maxIdx === vals.length - 1
270
+ ? (pct > 0 ? ', reaching a period high' : '')
271
+ : `; peak in ${maxCat} (${maxValStr})`
272
+ const verbZh = pct >= 0 ? '增长至' : '回落至'
273
+ const takeaway = langEn
274
+ ? `${sName || 'Primary metric'} moved from ${formatCompactNumber(first)}${unitSuffix} (${firstCat}) to ${formatCompactNumber(last)}${unitSuffix} (${lastCat}, ${sign}${pct}%)${peakClauseEn}.`
275
+ : `${sName || '核心指标'}由 ${firstCat} 的 ${formatCompactNumber(first)}${unitSuffix} ${verbZh} ${lastCat} 的 ${formatCompactNumber(last)}${unitSuffix}(${sign}${pct}%)${peakClauseZh}。`
276
+ return { headline, takeaway }
277
+ }
278
+
279
+ return {
280
+ headline: langEn
281
+ ? `${maxCat} leads at ${maxValStr}`
282
+ : `${maxCat}表现居首达 ${maxValStr}`,
283
+ takeaway: langEn
284
+ ? `${maxCat} leads at ${maxValStr}, while ${String(cats[minIdx] ?? '').trim()} sits at ${formatCompactNumber(vals[minIdx])}${unitSuffix}.`
285
+ : `${maxCat}以 ${maxValStr} 位居最高,${String(cats[minIdx] ?? '').trim()} 为 ${formatCompactNumber(vals[minIdx])}${unitSuffix}。`,
286
+ }
287
+ }
288
+
289
+ function extractTableEvidence(rows, langEn) {
290
+ if (!Array.isArray(rows) || rows.length < 2) return null
291
+ const header = rows[0].map((c) => stripInlineMarkdown(String(c ?? '')).trim())
292
+ let bestRow = null
293
+ let bestScore = -Infinity
294
+ let bestCell = ''
295
+ let bestCol = ''
296
+ for (let r = 1; r < rows.length; r += 1) {
297
+ const row = rows[r]
298
+ if (!Array.isArray(row) || row.length < 2) continue
299
+ const label = stripInlineMarkdown(String(row[0] ?? '')).trim()
300
+ if (!label) continue
301
+ const isBoldRow = /\*\*/.test(String(row[0] ?? ''))
302
+ for (let c = 1; c < row.length; c += 1) {
303
+ const rawCell = stripInlineMarkdown(String(row[c] ?? '')).trim()
304
+ const numMatch = /-?\d+(?:\.\d+)?/.exec(rawCell.replace(/,/g, ''))
305
+ if (!numMatch) continue
306
+ const val = Number(numMatch[0])
307
+ const score = (isBoldRow ? 1e9 : 0) + (Number.isFinite(val) ? Math.abs(val) : 0)
308
+ if (score > bestScore) {
309
+ bestScore = score
310
+ bestRow = label
311
+ bestCell = rawCell
312
+ bestCol = header[c] || ''
313
+ }
314
+ }
315
+ }
316
+ if (!bestRow || !bestCell) return null
317
+ const headline = langEn
318
+ ? `${bestRow} stands out at ${bestCell}${bestCol ? ' (' + bestCol + ')' : ''}`
319
+ : `${bestRow}${bestCol ? bestCol : ''}达 ${bestCell}`
320
+ return { headline }
321
+ }
322
+
323
+ /**
324
+ * 证据锚定式 Action-Title 提炼器(100% 源自当前页真实数据,零编造数字,严格控宽避免 title-overflow)。
325
+ */
326
+ export function synthesizeActionTitle(slide, langEn = false) {
327
+ if (!slide || typeof slide !== 'object' || slideHasDataBinding(slide)) return null
169
328
  const rawTitle = String(slide.title ?? '').trim()
170
329
  if (!rawTitle || !WEAK_GENERIC_TITLE_RE.test(rawTitle)) return null
171
330
 
172
- // 优先从 takeaway 或首条含数字的要点提炼短结论
331
+ const lay = slide.layout || 'bullets'
332
+ const cleanPrefix = rawTitle
333
+ .replace(/^(?:第?[一二三四五六七八九十\d]+[章节部分页、.\s·:-]*)/, '')
334
+ .trim()
335
+ const maxTotalWidth = langEn ? 32 : 31
336
+ const sep = langEn ? ': ' : ':'
337
+
338
+ const compose = (claim) => {
339
+ const cleanClaim = String(claim ?? '').replace(/[。.;;]+$/, '').trim()
340
+ if (!cleanClaim || cleanClaim.toLowerCase() === rawTitle.toLowerCase()) return null
341
+ const merged = `${cleanPrefix || rawTitle}${sep}${cleanClaim}`
342
+ if (measureWidth(merged) <= maxTotalWidth) return merged
343
+ const trimmedClaim = truncateCleanly(cleanClaim, maxTotalWidth)
344
+ if (!trimmedClaim) return null
345
+ const mergedShort = `${cleanPrefix || rawTitle}${sep}${truncateCleanly(cleanClaim, Math.max(10, maxTotalWidth - measureWidth(cleanPrefix || rawTitle) - 1.5))}`
346
+ return measureWidth(mergedShort) <= maxTotalWidth && measureWidth(mergedShort) > measureWidth(cleanPrefix || rawTitle) + 4
347
+ ? mergedShort
348
+ : trimmedClaim
349
+ }
350
+
351
+ // 1. 已有明确 takeaway:优先取其核心句
352
+ const tk = stripInlineMarkdown(String(slide.takeaway ?? '')).trim()
353
+ if (tk && tk.length >= 6 && /\d/.test(tk)) {
354
+ const built = compose(tk)
355
+ if (built) return built
356
+ }
357
+
358
+ // 2. KPI 指标页:取前 1-2 个带核心数值与涨跌的指标
359
+ if (lay === 'kpi' && Array.isArray(slide.items) && slide.items.length > 0) {
360
+ const top = slide.items.slice(0, 2).map((it) => {
361
+ const t = stripInlineMarkdown(it?.title || '').trim()
362
+ const v = stripInlineMarkdown(it?.value || '').trim()
363
+ const d = stripInlineMarkdown(it?.delta || '').trim()
364
+ return `${t}${v ? (langEn ? ' ' : '达 ') + v : ''}${d ? ` (${d})` : ''}`.trim()
365
+ }).filter(Boolean)
366
+ if (top.length > 0) {
367
+ const joined = top.join(langEn ? ', ' : ',')
368
+ const built = compose(measureWidth(joined) <= 24 ? joined : top[0])
369
+ if (built) return built
370
+ }
371
+ }
372
+
373
+ // 3. Dumbbell 哑铃跃迁页:提取最大改善幅度项
374
+ if (lay === 'dumbbell' && Array.isArray(slide.items) && slide.items.length > 0) {
375
+ const scored = slide.items
376
+ .filter((it) => Number.isFinite(Number(it?.before)) && Number.isFinite(Number(it?.after)))
377
+ .sort((a, b) => {
378
+ const ra = Math.abs(Number(a.after) - Number(a.before)) / Math.max(1, Math.abs(Number(a.before)))
379
+ const rb = Math.abs(Number(b.after) - Number(b.before)) / Math.max(1, Math.abs(Number(b.before)))
380
+ return rb - ra
381
+ })
382
+ if (scored.length > 0) {
383
+ const best = scored[0]
384
+ const u = best.unit || ''
385
+ const verbZh = Number(best.after) < Number(best.before) ? '降至' : '升至'
386
+ const claim = langEn
387
+ ? `${best.title} moved from ${best.before}${u} to ${best.after}${u}`
388
+ : `${best.title}由 ${best.before}${u} ${verbZh} ${best.after}${u}`
389
+ const built = compose(claim)
390
+ if (built) return built
391
+ }
392
+ }
393
+
394
+ // 4. Chart / Chart-Split 页:基于真实序列极值/增长率提炼
395
+ if ((lay === 'chart' || lay === 'chart-split') && slide.chart) {
396
+ const ev = extractChartEvidence(slide.chart, langEn)
397
+ if (ev?.headline) {
398
+ const built = compose(ev.headline)
399
+ if (built) return built
400
+ }
401
+ }
402
+
403
+ // 5. Quadrant 魔力象限:取右上领航者
404
+ if (lay === 'quadrant' && Array.isArray(slide.items) && slide.items.length > 0) {
405
+ const leader = [...slide.items].sort((a, b) => ((Number(b.x) || 0) + (Number(b.y) || 0)) - ((Number(a.x) || 0) + (Number(a.y) || 0)))[0]
406
+ if (leader?.title) {
407
+ const claim = langEn ? `${leader.title} leads in top-right quadrant` : `${leader.title}位居右上领航象限`
408
+ const built = compose(claim)
409
+ if (built) return built
410
+ }
411
+ }
412
+
413
+ // 6. Table / Heatmap / Radar 页:提取代表行
414
+ if ((lay === 'table' || lay === 'heatmap' || lay === 'radar') && Array.isArray(slide.rows) && slide.rows.length >= 2) {
415
+ const ev = extractTableEvidence(slide.rows, langEn)
416
+ if (ev?.headline) {
417
+ const built = compose(ev.headline)
418
+ if (built) return built
419
+ }
420
+ }
421
+
422
+ // 7. 通用候选(items / bullets / takeaway)
173
423
  const candidates = [
174
- String(slide.takeaway ?? '').trim(),
175
- ...(Array.isArray(slide.items) ? slide.items.map((it) => `${it.title || ''}${it.value ? ' ' + it.value : ''}${it.delta ? ' ' + it.delta : ''}${it.after !== undefined ? ' → ' + it.after + (it.unit || '') : ''}`.trim()) : []),
424
+ tk,
425
+ ...(Array.isArray(slide.items) ? slide.items.map((it) => `${stripInlineMarkdown(it?.title || '')}${it?.value ? ' ' + it.value : ''}${it?.delta ? ' ' + it.delta : ''}${it?.text ? (langEn ? ': ' : ':') + stripInlineMarkdown(it.text) : ''}`.trim()) : []),
176
426
  ...(Array.isArray(slide.bullets) ? slide.bullets.map(stripInlineMarkdown) : []),
177
427
  ].filter(Boolean)
178
428
 
179
429
  const best = candidates.find((c) => /\d/.test(c) && c.length >= 6) || candidates[0]
180
430
  if (!best) return null
181
- const concise = best.replace(/[。.;;]+$/, '').slice(0, langEn ? 48 : 22).trim()
182
- if (!concise || concise.toLowerCase() === rawTitle.toLowerCase()) return null
183
- const sep = langEn ? ': ' : ':'
184
- const merged = `${rawTitle}${sep}${concise}`
185
- return merged.length <= (langEn ? 68 : 32) ? merged : concise
431
+ return compose(best)
432
+ }
433
+
434
+ function synthesizeGroundedTakeaway(slide, langEn = false) {
435
+ if (!slide || typeof slide !== 'object' || slideHasDataBinding(slide)) return null
436
+ if (String(slide.takeaway ?? '').trim()) return null
437
+ const lay = slide.layout || 'bullets'
438
+
439
+ if ((lay === 'chart' || lay === 'chart-split') && slide.chart && !String(slide.chart.caption ?? '').trim()) {
440
+ const ev = extractChartEvidence(slide.chart, langEn)
441
+ if (ev?.takeaway) return ev.takeaway
442
+ }
443
+ if (lay === 'dumbbell' && Array.isArray(slide.items) && slide.items.length >= 2) {
444
+ const pos = slide.items.filter((it) => it?.status === 'positive')
445
+ if (pos.length > 0) {
446
+ const top = pos[0]
447
+ const u = top.unit || ''
448
+ return langEn
449
+ ? `${pos.length} of ${slide.items.length} tracked indicators improved, led by ${top.title} (${top.before}${u} → ${top.after}${u}).`
450
+ : `${pos.length}/${slide.items.length} 项核心指标实现正向跃迁,其中${top.title}由 ${top.before}${u} 优化至 ${top.after}${u}。`
451
+ }
452
+ }
453
+ return null
186
454
  }
187
455
 
188
456
  function synthesizeKicker(slide, index, langEn) {
@@ -212,6 +480,10 @@ function synthesizeKicker(slide, index, langEn) {
212
480
  org: '组织保障',
213
481
  callout: '关键结论',
214
482
  bullets: '重点解析',
483
+ chart: '数据趋势',
484
+ 'chart-split': '数据解读',
485
+ waterfall: '盈利桥接',
486
+ statement: '核心判断',
215
487
  }
216
488
  const mapEn = {
217
489
  kpi: 'KEY METRICS',
@@ -237,29 +509,532 @@ function synthesizeKicker(slide, index, langEn) {
237
509
  org: 'TEAM & ORG',
238
510
  callout: 'KEY TAKEAWAYS',
239
511
  bullets: 'HIGHLIGHTS',
512
+ chart: 'DATA TREND',
513
+ 'chart-split': 'DATA INSIGHT',
514
+ waterfall: 'VALUE BRIDGE',
515
+ statement: 'CORE THESIS',
240
516
  }
241
517
  const label = (langEn ? mapEn[lay] : mapZh[lay]) || (langEn ? 'INSIGHTS' : '核心要点')
242
518
  return `${num} · ${label}`
243
519
  }
244
520
 
521
+ // ---------------------------------------------------------------------------
522
+ // Exemplar Narrative-Arc Re-sequencer (alignOrder: true)
523
+ // ---------------------------------------------------------------------------
524
+
525
+ function inferNarrativePhase(slide) {
526
+ const lay = slide?.layout || 'bullets'
527
+ const title = String(slide?.title ?? '').toLowerCase()
528
+ const role = String(slide?.role ?? '').toLowerCase()
529
+ const text = `${role} ${title}`
530
+
531
+ if (lay === 'cover') return -1
532
+ if (lay === 'closing') return 99
533
+ if (lay === 'agenda' || lay === 'statement' || lay === 'quote' || /执行摘要|核心判断|目录|议程|exec-summary|thesis|agenda|overview/i.test(text)) {
534
+ return 0
535
+ }
536
+ if (lay === 'kpi' || /核心指标|财务快照|营收|headline|kpi|metric|financial/i.test(text)) {
537
+ return 1
538
+ }
539
+ if (lay === 'comparison' || lay === 'swot' || lay === 'tam' || /痛点|问题|现状|瓶颈|挑战|风险|市场空间|pain|problem|challenge|bottleneck|tam/i.test(text)) {
540
+ return 2
541
+ }
542
+ if (lay === 'gantt' || lay === 'org' || /排期|路线图|里程碑|实施计划|下一步|甘特|组织|团队|roadmap|milestone|gantt|timeline|schedule|next\s+phase/i.test(text)) {
543
+ return 5
544
+ }
545
+ if (['chart', 'chart-split', 'waterfall', 'dumbbell', 'radar', 'quadrant', 'heatmap', 'table', 'harvey', 'marimekko', 'sankey'].includes(lay)) {
546
+ return 4
547
+ }
548
+ // architecture, mermaid, mockup, code, process, value-chain, cards, callout, bullets
549
+ return 3
550
+ }
551
+
552
+ function buildExemplarPhaseRank(exemplar) {
553
+ const baseOrder = { 0: 0, 1: 1, 2: 2, 3: 3, 4: 4, 5: 5 }
554
+ if (!exemplar || !Array.isArray(exemplar.slots) || exemplar.slots.length === 0) return baseOrder
555
+ const firstSeen = {}
556
+ exemplar.slots.forEach((sl, idx) => {
557
+ const p = inferNarrativePhase(sl)
558
+ if (p >= 0 && p <= 5 && firstSeen[p] === undefined) firstSeen[p] = idx
559
+ })
560
+ const rank = {}
561
+ for (let p = 0; p <= 5; p += 1) {
562
+ rank[p] = firstSeen[p] !== undefined ? firstSeen[p] : (10 + p)
563
+ }
564
+ return rank
565
+ }
566
+
567
+ /**
568
+ * 将乱序草稿幻灯片按目标标杆范本的叙事弧线重排(保持封面置顶、封底置尾、章节边界完整)。
569
+ *
570
+ * @param {Array<object>} slides
571
+ * @param {object|null} exemplar
572
+ * @returns {{ slides: Array<object>, orderChanged: boolean, movedCount: number }}
573
+ */
574
+ export function resequenceSlidesToExemplar(slides, exemplar = null) {
575
+ if (!Array.isArray(slides) || slides.length <= 3) {
576
+ return { slides: Array.isArray(slides) ? [...slides] : [], orderChanged: false, movedCount: 0 }
577
+ }
578
+ const hasCover = slides[0]?.layout === 'cover'
579
+ const hasClosing = slides[slides.length - 1]?.layout === 'closing'
580
+ const head = hasCover ? [slides[0]] : []
581
+ const tail = hasClosing ? [slides[slides.length - 1]] : []
582
+ const middle = slides.slice(hasCover ? 1 : 0, hasClosing ? slides.length - 1 : slides.length)
583
+
584
+ if (middle.length <= 1) {
585
+ return { slides: [...slides], orderChanged: false, movedCount: 0 }
586
+ }
587
+
588
+ // 若包含多个显式 section 章节分隔页,则按章节块内部重排,绝不打散人工分章
589
+ const sectionIndices = middle.map((s, i) => (s?.layout === 'section' ? i : -1)).filter((i) => i >= 0)
590
+ const phaseRank = buildExemplarPhaseRank(exemplar)
591
+
592
+ const sortBlock = (block) => {
593
+ if (block.length <= 1) return block
594
+ const decorated = block.map((slide, origIdx) => {
595
+ const phase = inferNarrativePhase(slide)
596
+ const slotPos = phaseRank[phase] ?? (10 + phase)
597
+ return { slide, origIdx, phase, slotPos }
598
+ })
599
+ decorated.sort((a, b) => (a.slotPos - b.slotPos) || (a.origIdx - b.origIdx))
600
+
601
+ // 1-pass 相邻同版式错峰微调(仅在同一阶段带内或相邻非封面/排期页间互换,避免连续同布局)
602
+ for (let i = 1; i < decorated.length - 1; i += 1) {
603
+ const prevLay = decorated[i - 1].slide?.layout || 'bullets'
604
+ const curLay = decorated[i].slide?.layout || 'bullets'
605
+ const nextLay = decorated[i + 1].slide?.layout || 'bullets'
606
+ if (curLay === prevLay && nextLay !== curLay && Math.abs(decorated[i + 1].slotPos - decorated[i].slotPos) <= 2) {
607
+ const tmp = decorated[i]
608
+ decorated[i] = decorated[i + 1]
609
+ decorated[i + 1] = tmp
610
+ }
611
+ }
612
+ return decorated.map((d) => d.slide)
613
+ }
614
+
615
+ let sortedMiddle
616
+ if (sectionIndices.length >= 2) {
617
+ sortedMiddle = []
618
+ let cursor = 0
619
+ for (const secIdx of sectionIndices) {
620
+ if (secIdx > cursor) sortedMiddle.push(...sortBlock(middle.slice(cursor, secIdx)))
621
+ sortedMiddle.push(middle[secIdx])
622
+ cursor = secIdx + 1
623
+ }
624
+ if (cursor < middle.length) sortedMiddle.push(...sortBlock(middle.slice(cursor)))
625
+ } else {
626
+ sortedMiddle = sortBlock(middle)
627
+ }
628
+
629
+ const reordered = [...head, ...sortedMiddle, ...tail]
630
+ let movedCount = 0
631
+ for (let i = 0; i < reordered.length; i += 1) {
632
+ if (reordered[i] !== slides[i]) movedCount += 1
633
+ }
634
+ return {
635
+ slides: reordered,
636
+ orderChanged: movedCount > 0,
637
+ movedCount,
638
+ }
639
+ }
640
+
641
+ // ---------------------------------------------------------------------------
642
+ // Zero-LLM Deterministic Self-Repair Loop (checkManifest + SLOP-01..12)
643
+ // ---------------------------------------------------------------------------
644
+
645
+ function contrastRatioHex(a, b) {
646
+ if (!/^#[0-9a-f]{6}$/i.test(String(a || '')) || !/^#[0-9a-f]{6}$/i.test(String(b || ''))) return 7
647
+ const x = relativeLuminance(a)
648
+ const y = relativeLuminance(b)
649
+ return (Math.max(x, y) + 0.05) / (Math.min(x, y) + 0.05)
650
+ }
651
+
652
+ function splitOverflowTitle(slide, maxWidth, langEn) {
653
+ const title = String(slide.title ?? '').trim()
654
+ if (!title || measureWidth(title) <= maxWidth || slideHasDataBinding(slide)) return false
655
+ // 1. 优先在冒号/破折号/分号处拆分主标题与副标题
656
+ const delimMatch = /^(.+?)\s*([::]|——|—|;\s*|;)\s*(.+)$/.exec(title)
657
+ let head = ''
658
+ let tail = ''
659
+ if (delimMatch && measureWidth(delimMatch[1]) >= 4 && measureWidth(delimMatch[1]) <= maxWidth) {
660
+ head = delimMatch[1].trim()
661
+ tail = delimMatch[3].trim()
662
+ } else {
663
+ head = truncateCleanly(title, maxWidth - 1)
664
+ if (!head || head.length >= title.length) return false
665
+ tail = title.slice(head.length).replace(/^[::,,。;;、\-—\s]+/, '').trim()
666
+ }
667
+ if (!head || measureWidth(head) > maxWidth) return false
668
+ slide.title = head
669
+ if (tail) {
670
+ if (!String(slide.subtitle ?? '').trim()) {
671
+ slide.subtitle = tail
672
+ } else if (!String(slide.takeaway ?? '').trim() && !['cover', 'closing', 'section'].includes(slide.layout)) {
673
+ slide.takeaway = tail
674
+ } else if (measureWidth(`${slide.subtitle} · ${tail}`) <= 68) {
675
+ slide.subtitle = `${String(slide.subtitle).trim()}${langEn ? ' — ' : ' · '}${tail}`
676
+ }
677
+ }
678
+ return true
679
+ }
680
+
681
+ function splitLongBulletStrings(bullets) {
682
+ const out = []
683
+ for (const raw of bullets) {
684
+ const s = String(raw ?? '').trim()
685
+ if (!s) continue
686
+ if (measureWidth(s) <= 68) {
687
+ out.push(s)
688
+ continue
689
+ }
690
+ const parts = s.split(/(?<=[。;;!?!?])\s*|\.\s+(?=[A-Z0-9])/).map((p) => p.trim()).filter(Boolean)
691
+ if (parts.length >= 2) {
692
+ out.push(...parts.map(autoBoldBullet))
693
+ } else {
694
+ // 超长无句号文本按逗号切半,确保 100% 无损保留原文
695
+ const commaParts = s.split(/[,,]\s*/).filter(Boolean)
696
+ if (commaParts.length >= 2) {
697
+ const mid = Math.ceil(commaParts.length / 2)
698
+ out.push(autoBoldBullet(commaParts.slice(0, mid).join(',')), autoBoldBullet(commaParts.slice(mid).join(',')))
699
+ } else {
700
+ out.push(s)
701
+ }
702
+ }
703
+ }
704
+ return out
705
+ }
706
+
707
+ function makeSplitSlideCopy(base, suffixTitle, overrides) {
708
+ const copy = { ...base, ...overrides, title: suffixTitle }
709
+ delete copy.id
710
+ return copy
711
+ }
712
+
713
+ /**
714
+ * 零模型调用确定性自检修复闭环:
715
+ * 在渲染落盘前运行 `checkFn(manifest)`,对所有可确定性无损修复的版式/密度/图表/对比度告警执行最多 `maxPasses` 轮修复并复检。
716
+ *
717
+ * @param {object} manifest
718
+ * @param {{ checkFn: (m: object) => object, maxPasses?: number, maxSlides?: number, lang?: string, allowSplit?: boolean }} options
719
+ * @returns {{ manifest: object, report: { passes: number, initialWarnings: number, finalWarnings: number, fixedCount: number, repairs: Array<object> } }}
720
+ */
721
+ export function selfRepairDeck(manifest, options = {}) {
722
+ const checkFn = options.checkFn
723
+ if (!manifest || !Array.isArray(manifest.slides) || typeof checkFn !== 'function') {
724
+ return {
725
+ manifest,
726
+ report: { passes: 0, initialWarnings: 0, finalWarnings: 0, fixedCount: 0, repairs: [] },
727
+ }
728
+ }
729
+ const maxPasses = Math.max(1, Math.min(3, Number(options.maxPasses) || 2))
730
+ const maxSlides = Math.max(manifest.slides.length, Number(options.maxSlides) || 60)
731
+ const langEn = String(options.lang || manifest.language || 'zh').toLowerCase() === 'en'
732
+ const allowSplit = options.allowSplit !== false
733
+
734
+ const working = {
735
+ ...manifest,
736
+ ...(manifest.brand ? { brand: { ...manifest.brand } } : {}),
737
+ slides: manifest.slides.map((s) => (s && typeof s === 'object' ? { ...s, ...(s.chart ? { chart: { ...s.chart } } : {}) } : s)),
738
+ }
739
+
740
+ let check = checkFn(working)
741
+ const initialWarnings = check.warningCount ?? 0
742
+ const repairs = []
743
+ let passes = 0
744
+
745
+ for (let pass = 1; pass <= maxPasses; pass += 1) {
746
+ if (!Array.isArray(check.issues) || check.issues.length === 0) break
747
+ let changedThisPass = false
748
+
749
+ // 1. 画布级配色修复(SLOP-07 刺眼饱和底色 / low-contrast WCAG < 4.5:1)
750
+ const hasSatCanvas = check.issues.some((iss) => iss.code === 'saturated-canvas')
751
+ const hasLowContrast = check.issues.some((iss) => iss.code === 'low-contrast')
752
+ if (hasSatCanvas && working.brand?.backgroundColor) {
753
+ const hsl = hexToHsl(working.brand.backgroundColor)
754
+ const lum = relativeLuminance(working.brand.backgroundColor)
755
+ if (hsl.s > 0.38 && lum > 0.06 && lum < 0.80) {
756
+ const oldBg = working.brand.backgroundColor
757
+ working.brand.backgroundColor = '#F8FAFC'
758
+ if (!working.brand.textColor || contrastRatioHex('#F8FAFC', working.brand.textColor) < 4.5) {
759
+ working.brand.textColor = '#0F172A'
760
+ }
761
+ repairs.push({ pass, slide: 1, code: 'saturated-canvas', action: 'sanitize-canvas', detail: `${oldBg} → #F8FAFC` })
762
+ changedThisPass = true
763
+ }
764
+ }
765
+ if (hasLowContrast && working.brand) {
766
+ const bg = working.brand.backgroundColor || '#FFFFFF'
767
+ const fg = working.brand.textColor || '#0F172A'
768
+ if (contrastRatioHex(bg, fg) < 4.5) {
769
+ const darkCanvas = relativeLuminance(bg) < 0.28
770
+ const nextInk = darkCanvas ? '#F8FAFC' : '#0F172A'
771
+ working.brand.textColor = nextInk
772
+ repairs.push({ pass, slide: 1, code: 'low-contrast', action: 'fix-wcag-ink', detail: `${fg} → ${nextInk} on ${bg}` })
773
+ changedThisPass = true
774
+ }
775
+ }
776
+
777
+ // 2. 逐页修复(按页序收集,支持安全拆页)
778
+ const issuesBySlide = new Map()
779
+ for (const iss of check.issues) {
780
+ const idx = Math.max(0, (iss.slide || 1) - 1)
781
+ if (!issuesBySlide.has(idx)) issuesBySlide.set(idx, [])
782
+ issuesBySlide.get(idx).push(iss)
783
+ }
784
+
785
+ const nextSlides = []
786
+ let contentOrd = 0
787
+ const needsKickerSweep = check.issues.some((iss) => iss.code === 'repetitive-kicker')
788
+
789
+ for (let i = 0; i < working.slides.length; i += 1) {
790
+ const slide = working.slides[i]
791
+ if (!slide || typeof slide !== 'object') {
792
+ nextSlides.push(slide)
793
+ continue
794
+ }
795
+ const lay = slide.layout || 'bullets'
796
+ const isFraming = ['cover', 'section', 'closing', 'agenda', 'quote'].includes(lay)
797
+ if (!isFraming) contentOrd += 1
798
+
799
+ const slideIssues = issuesBySlide.get(i) || []
800
+ const codes = new Set(slideIssues.map((x) => x.code))
801
+ const bound = slideHasDataBinding(slide)
802
+
803
+ // 2a. SLOP-01 空洞标题二次救援
804
+ if (codes.has('weak-topic-title') && !bound) {
805
+ const rescued = synthesizeActionTitle(slide, langEn)
806
+ if (rescued && rescued !== slide.title) {
807
+ repairs.push({ pass, slide: i + 1, code: 'weak-topic-title', action: 'synthesize-action-title', detail: `${slide.title} → ${rescued}` })
808
+ slide.title = rescued
809
+ changedThisPass = true
810
+ }
811
+ }
812
+
813
+ // 2b. SLOP-02 机械重复 kicker 清理
814
+ if (needsKickerSweep && !isFraming && /^(?:要点|Key\s*point)(?:\s*\d+)?$/i.test(String(slide.kicker ?? '').trim())) {
815
+ const nextKicker = synthesizeKicker(slide, contentOrd, langEn)
816
+ repairs.push({ pass, slide: i + 1, code: 'repetitive-kicker', action: 'repair-kicker', detail: `${slide.kicker} → ${nextKicker}` })
817
+ slide.kicker = nextKicker
818
+ changedThisPass = true
819
+ }
820
+
821
+ // 2c. 标题溢出无损拆分到 subtitle/takeaway
822
+ if (codes.has('title-overflow') && !bound) {
823
+ const limit = ['cover', 'closing', 'statement', 'quote', 'section'].includes(lay) ? 39 : 33
824
+ if (splitOverflowTitle(slide, limit, langEn)) {
825
+ repairs.push({ pass, slide: i + 1, code: 'title-overflow', action: 'split-title-to-subtitle', detail: slide.title })
826
+ changedThisPass = true
827
+ }
828
+ }
829
+
830
+ // 2d. SLOP-05 碎块饼图 (>6 扇区) → 横向条形图 bar(100% 无损,关闭不适用于分类项的增长飞线)
831
+ if (codes.has('chart-spaghetti') && slide.chart && ['pie', 'doughnut'].includes(slide.chart.kind)) {
832
+ const prevKind = slide.chart.kind
833
+ slide.chart = { ...slide.chart, kind: 'bar', highlight: slide.chart.highlight ?? 'max', spotlight: true, showGrowthCallout: false }
834
+ repairs.push({ pass, slide: i + 1, code: 'chart-spaghetti', action: 'promote-pie-to-bar', detail: `${prevKind} → bar` })
835
+ changedThisPass = true
836
+ }
837
+
838
+ // 2e. 图表横轴拥挤 → 转为横向 bar(100% 无损)
839
+ if (codes.has('chart-density') && slide.chart && ['column', 'stacked-column'].includes(slide.chart.kind || 'column')) {
840
+ const prevKind = slide.chart.kind || 'column'
841
+ const nextKind = prevKind === 'stacked-column' ? 'stacked-bar' : 'bar'
842
+ slide.chart = { ...slide.chart, kind: nextKind }
843
+ repairs.push({ pass, slide: i + 1, code: 'chart-density', action: 'flip-to-horizontal-bar', detail: `${prevKind} → ${nextKind}` })
844
+ changedThisPass = true
845
+ }
846
+
847
+ // 2f. SLOP-12 单系列柱/条图自动补聚光灯焦点
848
+ if (codes.has('chart-emphasis-missing') && slide.chart) {
849
+ slide.chart = { ...slide.chart, highlight: 'max', spotlight: true }
850
+ repairs.push({ pass, slide: i + 1, code: 'chart-emphasis-missing', action: 'add-chart-spotlight', detail: 'highlight=max, spotlight=true' })
851
+ changedThisPass = true
852
+ }
853
+
854
+ // 2g. SLOP-10 图表页缺结论自动补齐 grounded takeaway
855
+ if (codes.has('missing-chart-callout') && slide.chart && !bound) {
856
+ const tk = synthesizeGroundedTakeaway(slide, langEn)
857
+ if (tk) {
858
+ slide.takeaway = tk
859
+ repairs.push({ pass, slide: i + 1, code: 'missing-chart-callout', action: 'synthesize-chart-takeaway', detail: tk.slice(0, 48) })
860
+ changedThisPass = true
861
+ }
862
+ }
863
+
864
+ // 2h. SLOP-09 空洞收尾页兜底
865
+ if (codes.has('bare-closing') && lay === 'closing' && !bound) {
866
+ const takeaways = working.slides
867
+ .filter((s) => s && s !== slide && !['cover', 'section', 'closing', 'agenda'].includes(s.layout))
868
+ .slice(-3)
869
+ .map((s) => String(s.takeaway || s.title || '').trim())
870
+ .filter(Boolean)
871
+ if (takeaways.length > 0) {
872
+ slide.title = langEn ? 'Thank You · Key Decisions & Next Steps' : '感谢聆听 · 核心结论与下一步行动'
873
+ slide.variant = slide.variant || 'cta-cards'
874
+ slide.subtitle = langEn ? 'Confirm owners and milestone dates to lock execution' : '请重点确认以下核心推进方向与交付节点'
875
+ slide.items = takeaways.map((tkText, ti) => ({
876
+ tag: `0${ti + 1}`,
877
+ title: truncateCleanly(tkText, langEn ? 22 : 18),
878
+ text: tkText.length > 18 ? truncateCleanly(tkText, 48) : (langEn ? 'Confirm owner & target date' : '确认责任人与落实节点'),
879
+ status: ti === 0 ? 'accent' : 'positive',
880
+ }))
881
+ repairs.push({ pass, slide: i + 1, code: 'bare-closing', action: 'rescue-closing-cta', detail: 'closing[cta-cards]' })
882
+ changedThisPass = true
883
+ }
884
+ }
885
+
886
+ // 2i. SLOP-04 组件数量越界自动无损拆页(kpi > 4 / cards|process > 6 / matrix != 4)
887
+ if (codes.has('card-count-overflow') && Array.isArray(slide.items) && !bound) {
888
+ if (lay === 'matrix' && slide.items.length !== 4) {
889
+ slide.layout = 'cards'
890
+ slide.variant = slide.items.length <= 4 ? 'bento-hero' : 'frameless'
891
+ repairs.push({ pass, slide: i + 1, code: 'card-count-overflow', action: 'matrix-to-cards', detail: `matrix(${slide.items.length}) → cards` })
892
+ changedThisPass = true
893
+ } else if (allowSplit && nextSlides.length + (working.slides.length - i) < maxSlides) {
894
+ const cap = lay === 'kpi' ? 4 : 6
895
+ if (slide.items.length > cap) {
896
+ const mid = Math.ceil(slide.items.length / 2)
897
+ const partA = slide.items.slice(0, mid)
898
+ const partB = slide.items.slice(mid)
899
+ const slideA = { ...slide, items: partA }
900
+ let contTitle = `${slide.title}${langEn ? ' (Cont.)' : '(续)'}`
901
+ if (lay === 'kpi' && partB[0]?.title && partB[0]?.value) {
902
+ const prefix = String(slide.title ?? '').split(/[::]/)[0].trim()
903
+ const candidate = langEn
904
+ ? `${prefix} (Cont.): ${partB[0].title} ${partB[0].value}${partB[0].delta ? ' (' + partB[0].delta + ')' : ''}`
905
+ : `${prefix}(续):${partB[0].title}达 ${partB[0].value}${partB[0].delta ? ' (' + partB[0].delta + ')' : ''}`
906
+ if (measureWidth(candidate) <= 32) contTitle = candidate
907
+ }
908
+ const slideB = makeSplitSlideCopy(slide, contTitle, {
909
+ items: partB,
910
+ ...(lay === 'cards' ? { variant: partB.length <= 4 ? 'frameless' : 'pillars' } : {}),
911
+ })
912
+ nextSlides.push(slideA, slideB)
913
+ repairs.push({ pass, slide: i + 1, code: 'card-count-overflow', action: 'split-overflow-items', detail: `${lay}(${slide.items.length}) → ${partA.length}+${partB.length}` })
914
+ changedThisPass = true
915
+ continue
916
+ }
917
+ }
918
+ }
919
+
920
+ // 2j. SLOP-06 超长表格 (> 9 行) 重复表头无损分页
921
+ if (codes.has('table-overload') && lay === 'table' && Array.isArray(slide.rows) && slide.rows.length > 9 && !bound && allowSplit) {
922
+ const header = slide.rows[0]
923
+ const dataRows = slide.rows.slice(1)
924
+ const chunks = []
925
+ for (let r = 0; r < dataRows.length; r += 8) {
926
+ chunks.push([header, ...dataRows.slice(r, r + 8)])
927
+ }
928
+ if (chunks.length > 1 && nextSlides.length + chunks.length + (working.slides.length - i - 1) <= maxSlides) {
929
+ chunks.forEach((chunkRows, ci) => {
930
+ const sCopy = ci === 0
931
+ ? { ...slide, rows: chunkRows }
932
+ : makeSplitSlideCopy(slide, `${slide.title}${langEn ? ` (${ci + 1}/${chunks.length})` : `(续 ${ci + 1}/${chunks.length})`}`, { rows: chunkRows, notes: undefined })
933
+ nextSlides.push(sCopy)
934
+ })
935
+ repairs.push({ pass, slide: i + 1, code: 'table-overload', action: 'paginate-table', detail: `${slide.rows.length} rows → ${chunks.length} slides` })
936
+ changedThisPass = true
937
+ continue
938
+ }
939
+ }
940
+
941
+ // 2k. SLOP-03 文字墙 / dense-bullets / body-overflow 自动无损拆页并结构化
942
+ if ((codes.has('wall-of-text') || codes.has('dense-bullets') || codes.has('body-overflow')) && Array.isArray(slide.bullets) && slide.bullets.length > 0 && !slide.image && !slide.chart && !bound) {
943
+ const expanded = splitLongBulletStrings(slide.bullets)
944
+ if (expanded.length >= 2 && allowSplit && nextSlides.length + (working.slides.length - i) < maxSlides) {
945
+ const mid = Math.ceil(expanded.length / 2)
946
+ const toItems = (arr, offset) => arr.map((b, bi) => {
947
+ const { title: t, text: d } = splitLead(b)
948
+ return { tag: String(offset + bi + 1).padStart(2, '0'), title: t, ...(d ? { text: d } : {}), ...(bi === 0 ? { status: 'accent' } : {}) }
949
+ })
950
+ const partA = expanded.slice(0, mid)
951
+ const partB = expanded.slice(mid)
952
+ const slideA = { ...slide, layout: 'cards', variant: partA.length <= 4 ? 'bento-hero' : 'frameless', items: toItems(partA, 0) }
953
+ delete slideA.bullets
954
+ const slideB = makeSplitSlideCopy(slide, `${slide.title}${langEn ? ' (Cont.)' : '(续)'}`, {
955
+ layout: partB.length <= 4 ? 'callout' : 'cards',
956
+ variant: partB.length <= 4 ? 'takeaways' : 'frameless',
957
+ items: toItems(partB, mid),
958
+ })
959
+ delete slideB.bullets
960
+ nextSlides.push(slideA, slideB)
961
+ repairs.push({ pass, slide: i + 1, code: codes.has('wall-of-text') ? 'wall-of-text' : 'body-overflow', action: 'split-text-wall', detail: `bullets(${slide.bullets.length}) → cards(${partA.length})+${slideB.layout}(${partB.length})` })
962
+ changedThisPass = true
963
+ continue
964
+ }
965
+ }
966
+
967
+ nextSlides.push(slide)
968
+ }
969
+
970
+ // 3. SLOP-11 连续等宽方框卡片疲劳破冰
971
+ if (check.issues.some((iss) => iss.code === 'visual-card-monotony')) {
972
+ let run = 0
973
+ const altVariants = ['bento-hero', 'frameless', 'bento-hero']
974
+ let altIdx = 0
975
+ for (let i = 0; i < nextSlides.length; i += 1) {
976
+ const s = nextSlides[i]
977
+ const lay = s?.layout || 'bullets'
978
+ const v = String(s?.variant || '').toLowerCase()
979
+ const isPlainBoxed = (lay === 'cards' && (!v || v === 'pillars')) || (lay === 'kpi' && (!v || v === 'grid'))
980
+ if (isPlainBoxed) {
981
+ run += 1
982
+ if (run >= 2) {
983
+ if (lay === 'kpi') {
984
+ s.variant = 'spotlight'
985
+ } else {
986
+ const cnt = Array.isArray(s.items) ? s.items.length : 3
987
+ const pick = altVariants[altIdx++ % altVariants.length]
988
+ s.variant = pick === 'bento-hero' && (cnt < 2 || cnt > 4) ? 'frameless' : pick
989
+ }
990
+ repairs.push({ pass, slide: i + 1, code: 'visual-card-monotony', action: 'vary-card-variant', detail: `${lay}[${s.variant}]` })
991
+ changedThisPass = true
992
+ run = 0
993
+ }
994
+ } else {
995
+ run = 0
996
+ }
997
+ }
998
+ }
999
+
1000
+ working.slides = nextSlides
1001
+ passes = pass
1002
+ if (!changedThisPass) break
1003
+ check = checkFn(working)
1004
+ }
1005
+
1006
+ const finalWarnings = check.warningCount ?? 0
1007
+ return {
1008
+ manifest: working,
1009
+ report: {
1010
+ passes,
1011
+ initialWarnings,
1012
+ finalWarnings,
1013
+ fixedCount: Math.max(0, initialWarnings - finalWarnings),
1014
+ repairs,
1015
+ },
1016
+ }
1017
+ }
1018
+
245
1019
  /**
246
- * 将弱模型生成的平庸幻灯片数组进行确定性无损升维(Auto-Upgrader)。
1020
+ * 将弱模型生成的平庸幻灯片数组进行确定性无损升维(Auto-Upgrader v2)。
247
1021
  *
248
1022
  * @param {Array<object>} rawSlides
249
- * @param {{ exemplar?: object|null, lang?: string, allowSplit?: boolean, rescueTitles?: boolean }} [options]
250
- * @returns {{ slides: Array<object>, report: { applied: boolean, exemplarId: string|null, upgrades: Array<object> } }}
1023
+ * @param {{ exemplar?: object|null, lang?: string, allowSplit?: boolean, rescueTitles?: boolean, alignOrder?: boolean }} [options]
1024
+ * @returns {{ slides: Array<object>, report: { applied: boolean, exemplarId: string|null, resequenced: boolean, upgrades: Array<object> } }}
251
1025
  */
252
1026
  export function upgradeWeakDeck(rawSlides, options = {}) {
253
1027
  if (!Array.isArray(rawSlides) || rawSlides.length === 0) {
254
- return { slides: rawSlides || [], report: { applied: false, exemplarId: null, upgrades: [] } }
1028
+ return { slides: rawSlides || [], report: { applied: false, exemplarId: null, resequenced: false, upgrades: [] } }
255
1029
  }
256
1030
  const exemplar = options.exemplar || null
257
1031
  const langEn = String(options.lang || 'zh').toLowerCase() === 'en'
258
1032
  const allowSplit = options.allowSplit !== false
259
1033
  const rescueTitles = options.rescueTitles !== false
1034
+ const alignOrder = options.alignOrder === true
260
1035
  const upgrades = []
261
1036
 
262
- const working = rawSlides.map((s) => (s && typeof s === 'object' ? { ...s } : s))
1037
+ let working = rawSlides.map((s) => (s && typeof s === 'object' ? { ...s } : s))
263
1038
 
264
1039
  // --- PASS 1: 语义自动升格 v2(覆盖 v0.28.0 六大王牌版式 + KPI Spotlight) ---
265
1040
  for (let i = 0; i < working.length; i += 1) {
@@ -283,7 +1058,6 @@ export function upgradeWeakDeck(rawSlides, options = {}) {
283
1058
  }
284
1059
  }
285
1060
 
286
- // 仅对 plain bullets(且无 image / chart / mermaid / formula / items)做语义升维
287
1061
  const isPlainBullets = lay === 'bullets' && !slide.image && !slide.images && !slide.chart && !slide.mermaid && !slide.formula && !(Array.isArray(slide.items) && slide.items.length > 0)
288
1062
  if (!isPlainBullets) continue
289
1063
 
@@ -410,11 +1184,32 @@ export function upgradeWeakDeck(rawSlides, options = {}) {
410
1184
  }
411
1185
  }
412
1186
 
413
- // --- PASS 2: Exemplar 节奏投影(覆盖封面/封底/剩余 bullets 视觉多样性) ---
1187
+ // --- PASS 1.5: 标杆叙事弧线重排(alignOrder: true 时激活) ---
1188
+ let resequenced = false
1189
+ if (alignOrder && working.length >= 4) {
1190
+ const seq = resequenceSlidesToExemplar(working, exemplar)
1191
+ if (seq.orderChanged) {
1192
+ working = seq.slides
1193
+ resequenced = true
1194
+ upgrades.push({
1195
+ slide: 1,
1196
+ action: 'resequence-exemplar',
1197
+ from: 'raw-order',
1198
+ to: exemplar?.id || 'narrative-arc',
1199
+ reason: `re-aligned ${seq.movedCount} slides to exemplar narrative cadence`,
1200
+ })
1201
+ }
1202
+ }
1203
+
1204
+ // --- PASS 2: Exemplar 语义槽位亲和投影 + 相邻防撞节奏 ---
414
1205
  if (exemplar && Array.isArray(exemplar.slots) && exemplar.slots.length > 0) {
415
1206
  const coverSlot = exemplar.slots.find((s) => s.layout === 'cover')
416
1207
  const closingSlot = exemplar.slots.find((s) => s.layout === 'closing')
1208
+ const kpiSlot = exemplar.slots.find((s) => s.layout === 'kpi')
1209
+ const tableSlot = exemplar.slots.find((s) => s.layout === 'table' && s.tableStyle)
1210
+ const proseSlots = exemplar.slots.filter((s) => ['cards', 'comparison', 'process', 'callout'].includes(s.layout))
417
1211
  const proseFallbackLayouts = [
1212
+ ...proseSlots.map((s) => ({ layout: s.layout, variant: s.variant || '' })),
418
1213
  { layout: 'cards', variant: 'bento-hero' },
419
1214
  { layout: 'comparison', variant: 'issue-action' },
420
1215
  { layout: 'cards', variant: 'frameless' },
@@ -422,6 +1217,7 @@ export function upgradeWeakDeck(rawSlides, options = {}) {
422
1217
  { layout: 'callout', variant: 'takeaways' },
423
1218
  ]
424
1219
  let fallbackCursor = 0
1220
+ let prevVisualSig = ''
425
1221
 
426
1222
  working.forEach((slide, idx) => {
427
1223
  if (!slide || typeof slide !== 'object') return
@@ -435,17 +1231,31 @@ export function upgradeWeakDeck(rawSlides, options = {}) {
435
1231
  }
436
1232
  } else if (slide.layout === 'closing' && closingSlot && !slide.variant && closingSlot.variant) {
437
1233
  slide.variant = closingSlot.variant
1234
+ } else if (slide.layout === 'kpi' && kpiSlot && !slide.variant && kpiSlot.variant) {
1235
+ slide.variant = kpiSlot.variant
1236
+ } else if (slide.layout === 'table' && tableSlot && !slide.tableStyle && tableSlot.tableStyle) {
1237
+ slide.tableStyle = tableSlot.tableStyle
438
1238
  } else if (slide.layout === 'bullets' && Array.isArray(slide.bullets) && slide.bullets.length >= 2 && slide.bullets.length <= 6 && !slide.image && !slide.chart) {
439
- // 寻找对应序号的 exemplar 文本型槽位,若不匹配则轮转高质感结构化卡片
440
1239
  const aligned = exemplar.slots[Math.min(idx, exemplar.slots.length - 1)]
441
- const compatibleSlot = aligned && ['cards', 'comparison', 'process', 'callout'].includes(aligned.layout)
1240
+ let pick = aligned && ['cards', 'comparison', 'process', 'callout'].includes(aligned.layout)
442
1241
  ? { layout: aligned.layout, variant: aligned.variant || '' }
443
- : proseFallbackLayouts[fallbackCursor++ % proseFallbackLayouts.length]
444
- if (compatibleSlot.layout === 'cards' && compatibleSlot.variant === 'bento-hero' && (slide.bullets.length < 2 || slide.bullets.length > 4)) {
445
- compatibleSlot.variant = 'frameless'
1242
+ : { ...proseFallbackLayouts[fallbackCursor++ % proseFallbackLayouts.length] }
1243
+ if (pick.layout === 'cards' && pick.variant === 'bento-hero' && (slide.bullets.length < 2 || slide.bullets.length > 4)) {
1244
+ pick = { layout: 'cards', variant: 'frameless' }
1245
+ }
1246
+ // 避免与上一页视觉撞车
1247
+ const sig = `${pick.layout}:${pick.variant}`
1248
+ if (sig === prevVisualSig) {
1249
+ const alt = proseFallbackLayouts.find((cand) => {
1250
+ const cSig = `${cand.layout}:${cand.variant}`
1251
+ if (cSig === prevVisualSig) return false
1252
+ if (cand.layout === 'cards' && cand.variant === 'bento-hero' && (slide.bullets.length < 2 || slide.bullets.length > 4)) return false
1253
+ return true
1254
+ })
1255
+ if (alt) pick = { ...alt }
446
1256
  }
447
- slide.layout = compatibleSlot.layout
448
- if (compatibleSlot.variant) slide.variant = compatibleSlot.variant
1257
+ slide.layout = pick.layout
1258
+ if (pick.variant) slide.variant = pick.variant
449
1259
  slide.items = slide.bullets.map((b, bi) => {
450
1260
  const { title: t, text: d } = splitLead(b)
451
1261
  return {
@@ -460,10 +1270,11 @@ export function upgradeWeakDeck(rawSlides, options = {}) {
460
1270
  slide: idx + 1,
461
1271
  action: 'exemplar-slot',
462
1272
  from: 'bullets',
463
- to: compatibleSlot.variant ? `${compatibleSlot.layout}[${compatibleSlot.variant}]` : compatibleSlot.layout,
1273
+ to: pick.variant ? `${pick.layout}[${pick.variant}]` : pick.layout,
464
1274
  reason: `aligned to exemplar ${exemplar.id}`,
465
1275
  })
466
1276
  }
1277
+ prevVisualSig = `${slide.layout || 'bullets'}:${slide.variant || ''}`
467
1278
  })
468
1279
  }
469
1280
 
@@ -479,10 +1290,8 @@ export function upgradeWeakDeck(rawSlides, options = {}) {
479
1290
  }
480
1291
  const lay = slide.layout || 'bullets'
481
1292
  if (lay === 'bullets' && Array.isArray(slide.bullets) && slide.bullets.length > 0 && !slide.image && !slide.chart) {
482
- // 自动为长散文要点提取加粗引导词
483
1293
  slide.bullets = slide.bullets.map(autoBoldBullet)
484
1294
 
485
- // 超过 6 条要点强制无损拆页,防止文字墙溢出
486
1295
  if (allowSplit && slide.bullets.length > 6 && finalSlides.length < 100) {
487
1296
  const mid = Math.ceil(slide.bullets.length / 2)
488
1297
  const partA = slide.bullets.slice(0, mid)
@@ -514,7 +1323,6 @@ export function upgradeWeakDeck(rawSlides, options = {}) {
514
1323
  continue
515
1324
  }
516
1325
 
517
- // 严禁连续 >= 2 页纯 bullets
518
1326
  bulletStreak += 1
519
1327
  if (bulletStreak >= 2 && slide.bullets.length >= 2 && slide.bullets.length <= 6) {
520
1328
  const nextLayout = diversityToggle % 2 === 0 ? 'cards' : 'callout'
@@ -538,7 +1346,7 @@ export function upgradeWeakDeck(rawSlides, options = {}) {
538
1346
  finalSlides.push(slide)
539
1347
  }
540
1348
 
541
- // --- PASS 4: Action Title 救援 + Kicker 叙事脉络修复 + 空洞封底补全 ---
1349
+ // --- PASS 4: 证据锚定 Action Title 救援 + Grounded Takeaway + Kicker 叙事脉络 + 空洞封底补全 ---
542
1350
  const genericKickers = finalSlides.filter((s) => /^(?:要点|Key\s*point)(?:\s*\d+)?$/i.test(String(s?.kicker ?? '').trim())).length
543
1351
  const shouldRepairKickers = genericKickers >= 2 || (finalSlides.length >= 5 && finalSlides.filter((s) => !['cover', 'section', 'closing', 'agenda'].includes(s?.layout) && !s?.kicker).length >= 3)
544
1352
  let contentOrd = 0
@@ -552,12 +1360,17 @@ export function upgradeWeakDeck(rawSlides, options = {}) {
552
1360
  if (!isFraming) {
553
1361
  contentOrd += 1
554
1362
  if (rescueTitles) {
555
- const rescued = rescueWeakTitle(slide, langEn)
1363
+ const rescued = synthesizeActionTitle(slide, langEn)
556
1364
  if (rescued) {
557
1365
  upgrades.push({ slide: i + 1, action: 'rescue-action-title', from: slide.title, to: rescued, reason: 'SLOP-01 weak topic label' })
558
1366
  slide.title = rescued
559
1367
  }
560
1368
  }
1369
+ const groundedTk = synthesizeGroundedTakeaway(slide, langEn)
1370
+ if (groundedTk) {
1371
+ slide.takeaway = groundedTk
1372
+ upgrades.push({ slide: i + 1, action: 'synthesize-takeaway', from: '(empty)', to: groundedTk.slice(0, 48), reason: 'SLOP-10 grounded insight takeaway' })
1373
+ }
561
1374
  const curKicker = String(slide.kicker ?? '').trim()
562
1375
  if (shouldRepairKickers && (!curKicker || /^(?:要点|Key\s*point)(?:\s*\d+)?$/i.test(curKicker))) {
563
1376
  slide.kicker = synthesizeKicker(slide, contentOrd, langEn)
@@ -565,30 +1378,30 @@ export function upgradeWeakDeck(rawSlides, options = {}) {
565
1378
  }
566
1379
  }
567
1380
 
568
- // SLOP-09 空洞封底救援
569
1381
  if (lay === 'closing' && BARE_CLOSING_RE.test(String(slide.title ?? '').trim())) {
570
1382
  const hasDetail = Boolean(String(slide.subtitle ?? '').trim() || (slide.bullets?.length > 0) || (slide.items?.length > 0))
571
1383
  if (!hasDetail) {
572
1384
  const seenRoots = new Set()
573
- const takeaways = []
1385
+ const cards = []
574
1386
  for (const s of [...finalSlides].reverse()) {
575
1387
  if (!s || s === slide || ['cover', 'section', 'closing', 'agenda'].includes(s.layout)) continue
576
- const raw = String(s.takeaway || s.title || '').trim()
577
- const root = raw.replace(/(?:(续)|\s*\(Cont\.\))$/i, '')
578
- if (!raw || seenRoots.has(root)) continue
1388
+ const titleRaw = String(s.title || '').trim()
1389
+ const tkRaw = String(s.takeaway || '').trim()
1390
+ const root = titleRaw.replace(/(?:(续)|\s*\(Cont\.\))$/i, '')
1391
+ if (!titleRaw || seenRoots.has(root)) continue
579
1392
  seenRoots.add(root)
580
- takeaways.unshift(raw)
581
- if (takeaways.length >= 3) break
1393
+ cards.unshift({ title: titleRaw, text: tkRaw })
1394
+ if (cards.length >= 3) break
582
1395
  }
583
- if (takeaways.length > 0) {
1396
+ if (cards.length > 0) {
584
1397
  const origTitle = slide.title
585
1398
  slide.title = langEn ? 'Thank You · Key Decisions & Next Steps' : '感谢聆听 · 核心结论与下一步行动'
586
1399
  slide.variant = slide.variant || 'cta-cards'
587
1400
  slide.subtitle = langEn ? 'Confirm owners and milestone dates to lock execution' : '请重点确认以下三项核心推进方向与交付节点'
588
- slide.items = takeaways.map((tkText, ti) => ({
1401
+ slide.items = cards.map((card, ti) => ({
589
1402
  tag: `0${ti + 1}`,
590
- title: tkText.slice(0, langEn ? 42 : 20),
591
- text: tkText.length > (langEn ? 42 : 20) ? tkText.slice(0, 56) : (langEn ? 'Confirm owner & target date' : '确认责任人与落实节点'),
1403
+ title: truncateCleanly(card.title, langEn ? 24 : 20),
1404
+ text: card.text ? truncateCleanly(card.text, 52) : (langEn ? 'Confirm owner & target date' : '确认责任人与落实节点'),
592
1405
  status: ti === 0 ? 'accent' : 'positive',
593
1406
  }))
594
1407
  upgrades.push({ slide: i + 1, action: 'rescue-closing-cta', from: origTitle, to: 'closing[cta-cards]', reason: 'SLOP-09 bare thank-you slide' })
@@ -607,6 +1420,7 @@ export function upgradeWeakDeck(rawSlides, options = {}) {
607
1420
  report: {
608
1421
  applied: upgrades.length > 0 || Boolean(exemplar),
609
1422
  exemplarId: exemplar?.id || null,
1423
+ resequenced,
610
1424
  upgradeCount: upgrades.length,
611
1425
  promotedCount,
612
1426
  splitCount,