dsh-ppt 0.31.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.
@@ -0,0 +1,133 @@
1
+ # 零资料深度调研、事实核验与策划出稿协议(Zero-Material Research-to-Deck)
2
+
3
+ 当用户**没有现成文档、表格或数据**,只给出一个主题并要求「你去搜资料、核对准确性、先策划 PPT 方案再生成」时,必须走本协议的四阶段流水线。
4
+
5
+ > **架构红线**:`dsh-ppt` 引擎本身保持 100% 离线、零网络外联与零新增依赖;实时联网检索与一手网页阅读由**宿主 Agent 的联网搜索/浏览器工具**完成(学术场景可叠加 `dsh-cite`),校验后的结构化证据通过 `evidence[]` 证据账本交给 `dsh-ppt` 确定性绑定、审计(`SLOP-13`)并渲染成稿。
6
+
7
+ ---
8
+
9
+ ## 一、双模路由判定(Mode A vs Mode B)
10
+
11
+ | 模式 | 触发条件 | 动作 |
12
+ | --- | --- | --- |
13
+ | **Mode A:有资料直出** | 用户已提供大纲、文档、Excel/CSV/Word、参考 `.pptx` 或明确数字 | 零追问自动定调(`theme: 'auto'` / `exemplar: 'auto'`),直接出稿并做视觉验收 |
14
+ | **Mode B:零资料深研策划** | 用户只给主题且无资料,或明确要求「先搜索资料 / 查准数据 / 出方案再做 PPT」 | 严格执行下方 **4 步闭环**:定向检索 → 双源交叉核验 → 策划方案确认 → 证据溯源成稿 |
15
+
16
+ ---
17
+
18
+ ## 二、四阶段执行协议
19
+
20
+ ### Step 1:先调策划器定骨架 + 三轮定向检索(Research)
21
+
22
+ 1. 先调用 `ppt_templates({ topic: "<用户主题>", persona: "<可选画像>", lang: "zh" })`(或裸 CLI `--plan "<主题>"`),获取:
23
+ - 最佳匹配的 20 套内置标杆范本(`exemplar.id`、`theme`、`chromeStyle`);
24
+ - 三轮定向检索词建议(`researchRounds`);
25
+ - 逐页分镜蓝图与需要量化证据的槽位清单(`storyboard`、`evidenceAudit.gaps`)。
26
+ 2. 使用宿主 Agent 的联网搜索工具按**三轮递进法**采集一手资料(避免只搜一轮把营销软文当权威数据):
27
+ - **Round 1(权威基线)**:政府公报、监管机构、上市公司年报/财报、IEA/Gartner/IDC/麦肯锡/学术顶刊白皮书,确认核心规模、增速、年份与地域口径。
28
+ - **Round 2(竞品与实测)**:头部厂商官方发布、同口径市场份额、改造前后实测性能/成本数据。
29
+ - **Round 3(最新进展与反方风险)**:2025–2026 最新量产/政策节点、技术瓶颈、失败案例与机构预测分歧(避免一边倒的宣传稿)。
30
+
31
+ ### Step 2:一手优先与双源交叉核验(Fact-Check & Evidence Ledger)
32
+
33
+ 将搜集到的每条拟上屏事实整理为 `evidence[]` 账本,执行**三层信源分级与四条核验红线**:
34
+
35
+ - **信源可信度分级**:
36
+ - **Tier 1(直接采信)**:政府统计局/部委、央行/SEC/港交所财报、权威国际组织(IEA/IMF/WHO/ISO)、Peer-reviewed 学术期刊、厂商官方技术文档与财报。
37
+ - **Tier 2(须交叉验证)**:主流咨询/研究机构(Gartner/IDC/TrendForce/高工锂电等)报告、权威财经/科技媒体(FT/Reuters/Bloomberg/财新)转引。
38
+ - **Tier 3(禁止单独作为上屏数字依据)**:自媒体公众号、无原始出处二手榜单、匿名论坛贴、营销公关软文。
39
+ - **四条核验红线**:
40
+ 1. **关键大数字双源核验**:封面/KPI/核心图表中的决定性数字,须由至少 2 个独立可信来源相互印证,或直接定位至 Tier 1 原始发布文件;记清**时间窗口(`date`)与统计口径(`scope`)**,禁止把全球口径与中国口径、出货量与装机量混在同一张图里。
41
+ 2. **冲突不拍脑袋**:不同权威机构预测存在明显差异时,将 `confidence` 设为 `"conflicting"`,在 `note` 中写明双方口径,并在幻灯片展示**区间**(如 `18–25 GWh`)而非单点断言。
42
+ 3. **查不到就诚实降级**:某页规划为 `kpi` / `chart` 但检索后确实缺乏可靠量化数据时,**严禁凭训练记忆估算编造精确小数**!立刻将该页降级为定性图示(`comparison` / `architecture` / `process` / `matrix` / `cards`),或在 `evidence[]` 中明确标为 `estimated` / `unverified` 并在画面显眼处说明口径。
43
+ 4. **禁用空洞假出处**:绝对禁止写 `数据来源:网络整理` / `公开资料` / `综合整理` / `Internet`(会被 `SLOP-13` 自动拦截)。
44
+
45
+ ### Step 3:向用户展示策划方案并确认(Plan Gate)
46
+
47
+ 在搜集并核验完毕后,**先向用户输出结构化策划方案,再生成 PPT**(除非用户已明确指示「搜完直接出稿,不用问我」):
48
+
49
+ 1. **核心叙事主线与风格定位**:目标听众、推荐标杆范本(如 `daylight-earnings-research` / `mckinsey-strategy`)、主题色与预计页数/演讲时长;
50
+ 2. **核验后的核心事实账本摘要(`E1..En`)**:列出关键数字、一手出处、年份口径及核验状态(含任何已发现的口径分歧或待补项);
51
+ 3. **逐页分镜策划表(Storyboard)**:页码、叙事角色、结论先行标题(Action Title)、拟用版式、绑定证据 `[E#]`(可直接调用 `ppt_templates({ topic, evidence })` 自动生成 `planMarkdown` 并补齐真实标题)。
52
+
53
+ 等待用户确认或微调页数/口径/侧重点后,进入 Step 4。
54
+
55
+ ### Step 4:带证据账本成稿与 SLOP-13 门禁交付(Grounded Build)
56
+
57
+ 调用 `ppt_create`(或 CLI `build-deck.mjs`),一次性传入核验后的 `evidence[]`、`evidenceAppendix: true`、`exemplar`、`alignOrder: true` 与带 `evidenceIds: ["E1", ...]`(或内联 `[E1]`)的 `slides[]`:
58
+
59
+ ```json
60
+ {
61
+ "title": "2026 固态电池商业化进展与产业研报",
62
+ "exemplar": "daylight-earnings-research",
63
+ "alignOrder": true,
64
+ "evidenceAppendix": true,
65
+ "evidence": [
66
+ {
67
+ "id": "E1",
68
+ "claim": "2025 年全球半固态电池出货量突破 12 GWh,中国车企装车贡献超 75%",
69
+ "source": "GGII 高工产研《2025 固态电池产业蓝皮书》",
70
+ "date": "2026-01",
71
+ "scope": "全球出货口径",
72
+ "url": "https://example.org/ggii-solid-state-2025",
73
+ "confidence": "verified"
74
+ },
75
+ {
76
+ "id": "E2",
77
+ "claim": "全固态电芯小批量装车验证集中于 2027 年,规模化降本至 <0.6 元/Wh 预计需至 2030 年前后",
78
+ "source": "中汽协 & TrendForce 联合口径对比",
79
+ "date": "2026-02",
80
+ "scope": "全固态硫化物路线",
81
+ "confidence": "conflicting",
82
+ "note": "车企官方规划偏乐观(2027),供应链普遍预计量产平价在 2030 年"
83
+ }
84
+ ],
85
+ "slides": [
86
+ {
87
+ "layout": "kpi",
88
+ "kicker": "01 · 产业拐点",
89
+ "title": "半固态已跨越 12 GWh 商用门槛,全固态平价仍需 3–4 年攻坚",
90
+ "evidenceIds": ["E1", "E2"],
91
+ "items": [
92
+ { "tag": "2025 全球出货", "value": "12+ GWh", "delta": "中国占 >75% [E1]" },
93
+ { "tag": "全固态验证窗口", "value": "2027–2030", "delta": "多机构预测区间 [E2]" }
94
+ ],
95
+ "takeaway": "半固态率先贡献出货增量;全固态在车企与供应链口径间存在 2–3 年量产预期差。"
96
+ }
97
+ ]
98
+ }
99
+ ```
100
+
101
+ ### 引擎自动为你完成的 4 件事(零模型确定性保障)
102
+
103
+ 1. **清爽页面脚注自动注入**:凡带 `evidenceIds` 或内联 `[E#]` 的页面,若未手工写 `source`(或写了空洞占位词),引擎自动生成紧凑规范的 `source` 底栏(如 `GGII 高工产研 (2026-01) [E1];TrendForce (2026-02) [E2]`),不把冗长 URL 塞进正文污染排版。
104
+ 2. **演讲者备注完整溯源卡**:自动将完整 `claim`、发布方、年份、口径、核验状态与原文 `url` 写入对应页的 `notes`(在 HTML 按 `P` 进提词台或 PowerPoint 备注区答辩随时可查)。
105
+ 3. **封底前自动三线表附录页**:开启 `evidenceAppendix: true` 时,自动在 `closing` 页之前生成符合 `booktabs` 规范且零溢出(0 `table-density` 告警)的「核心论据溯源清单」页;若同步输出 `.handout.md`,末尾还会附带含可点击 Markdown 链接的完整《事实核验与证据账本》总表。
106
+ 4. **`SLOP-13` 事实出处门禁**:`ppt_check` 与生成阶段自动扫描 4 类事实卫生问题:
107
+ - `dangling-evidence-ref`:页面引用了 `evidence[]` 中不存在的 `[E99]`;
108
+ - `unverified-evidence-claim`:页面引用了 `unverified` 或 `conflicting` 证据,但未在页面可见文案中声明「待核实 / 口径差异 / 区间 / 估算」;
109
+ - `vague-placeholder-source`:出现「数据来源:网络整理 / 公开资料 / 综合整理 / Internet」等空洞假出处;
110
+ - `unsourced-research-numbers`:在启用 `evidence[]` 调研账本时,存在含数字的 `kpi / chart / chart-split / waterfall / marimekko / tam / dumbbell / heatmap` 页面既未绑定 `[E#]` 也无有效 `source` 出处。
111
+
112
+ ---
113
+
114
+ ## 三、裸 CLI 用法速查
115
+
116
+ ```bash
117
+ # 1. 先按主题生成 3 轮调研清单 + 逐页分镜策划表
118
+ node skills/dsh-ppt/scripts/build-deck.mjs --plan "2026 固态电池商业化进展与产业研报" --lang zh
119
+
120
+ # 2. 检索并核验后,带已核验 evidence.json 重新检查量化槽位缺口
121
+ node skills/dsh-ppt/scripts/build-deck.mjs --plan "2026 固态电池商业化进展与产业研报" --evidence @evidence.json --lang zh
122
+
123
+ # 3. 确认方案后,带证据账本 + 附录三线表 + 讲义一键出稿
124
+ node skills/dsh-ppt/scripts/build-deck.mjs \
125
+ --title "2026 固态电池商业化进展与产业研报" \
126
+ --slides @slides.json \
127
+ --exemplar daylight-earnings-research \
128
+ --align-order \
129
+ --evidence @evidence.json \
130
+ --evidence-appendix \
131
+ --handout \
132
+ --out dist
133
+ ```
@@ -17,7 +17,7 @@ import { resolve as resolvePath } from 'node:path'
17
17
  import { pathToFileURL } from 'node:url'
18
18
  import { listThemes, THEME_IDS, DEFAULT_THEME } from './deck-themes.mjs'
19
19
  import { CHROME_STYLE_IDS } from './deck-absorb.mjs'
20
- import { buildDeckAsync, listTemplates, editDeck, undoDeck, checkDeckAsync, renderDeck, absorbPptx, importPptxDeck, importOfficeDeck, listAllTasteRecipes, listCuratedExemplars, loadWorkspaceExemplars, ingestExemplarCorpus } from './deck-advanced.mjs'
20
+ import { buildDeckAsync, listTemplates, editDeck, undoDeck, checkDeckAsync, renderDeck, absorbPptx, importPptxDeck, importOfficeDeck, listAllTasteRecipes, listCuratedExemplars, loadWorkspaceExemplars, ingestExemplarCorpus, buildResearchPlan } from './deck-advanced.mjs'
21
21
 
22
22
  const HELP = `dsh-ppt —— 一句话 / 一篇文档 → HTML 放映 + PPTX 导出
23
23
 
@@ -34,8 +34,11 @@ const HELP = `dsh-ppt —— 一句话 / 一篇文档 → HTML 放映 + PPTX 导
34
34
  --clone-structure 配合 --reference-pptx 使用,克隆参考文稿的逐页版式骨架与母版 chrome
35
35
  --chrome <style> 母版骨架风格:${CHROME_STYLE_IDS.join(' / ')}
36
36
  --taste <id> 大师审美配方 ID(mckinsey-partner / apple-keynote-dark / apple-keynote-light / swiss-editorial / linear-craft / ft-data-journal / nature-academic / oriental-zen 或已吸收自定义 ID)
37
- --exemplar <id> 标杆范本槽位契约 ID(8 套内置满分范本或 .dsh-ppt/exemplars.json 已吸收范本,锁定叙事节奏与版式升维)
38
- --list-exemplars 列出内置 8 套满分标杆范本及工作区已吸收的标杆 .pptx 范本
37
+ --exemplar <id> 标杆范本槽位契约 ID(20 套内置满分范本、auto 或 .dsh-ppt/exemplars.json 已吸收范本,锁定叙事节奏与版式升维)
38
+ --list-exemplars 列出内置 20 套满分标杆范本及工作区已吸收的标杆 .pptx 范本
39
+ --plan <topic> 零资料调研策划器:按选题匹配标杆范本、生成 3 轮检索清单、证据缺口诊断与逐页分镜策划表
40
+ --evidence <json|@path> 外部调研并交叉核验后的结构化证据账本(自动注入 source 脚注、notes 溯源卡与 SLOP-13 核验)
41
+ --evidence-appendix 配合 --evidence 在封底前自动追加「事实核验与数据来源清单」三线表附录页
39
42
  --ingest-exemplars <dir> 批量吸收目录下所有优质 .pptx 语料并持久化至 .dsh-ppt/exemplars.json 与 taste-recipes.json
40
43
  --save-exemplar <id> 配合 --absorb 将单份标杆 .pptx 同步保存为可复用范本契约
41
44
  --no-auto-upgrade 关闭弱模型自动兜底升维与反文字墙拆分
@@ -102,6 +105,9 @@ export function parseArgv(argv) {
102
105
  else if (key === '--list-tastes') args.listTastes = true
103
106
  else if (key === '--list-exemplars') args.listExemplars = true
104
107
  else if (key === '--exemplar') args.exemplar = nextValue()
108
+ else if (key === '--plan') args.plan = nextValue()
109
+ else if (key === '--evidence') args.evidence = readJson(nextValue())
110
+ else if (key === '--evidence-appendix') args.evidenceAppendix = true
105
111
  else if (key === '--ingest-exemplars') args.ingestExemplars = nextValue()
106
112
  else if (key === '--save-exemplar') args.saveExemplar = nextValue()
107
113
  else if (key === '--align-order') args.alignOrder = true
@@ -179,6 +185,18 @@ export async function main(argv = process.argv.slice(2), io = {}) {
179
185
  if (args.listTemplates) { log(JSON.stringify({ templates: listTemplates(args.lang) }, null, 2)); return 0 }
180
186
  if (args.listTastes) { log(JSON.stringify({ tasteRecipes: listAllTasteRecipes(process.cwd()) }, null, 2)); return 0 }
181
187
  if (args.listExemplars) { log(JSON.stringify({ exemplars: listCuratedExemplars(loadWorkspaceExemplars(process.cwd())) }, null, 2)); return 0 }
188
+ if (args.plan) {
189
+ const plan = buildResearchPlan({
190
+ topic: args.plan,
191
+ persona: args.persona,
192
+ exemplarId: args.exemplar,
193
+ evidence: args.evidence,
194
+ lang: args.lang,
195
+ workspaceExemplars: loadWorkspaceExemplars(process.cwd()),
196
+ })
197
+ log(JSON.stringify(plan, null, 2))
198
+ return 0
199
+ }
182
200
  if (args.ingestExemplars) {
183
201
  const report = await ingestExemplarCorpus({ dirPath: args.ingestExemplars, cwd: process.cwd() })
184
202
  log(JSON.stringify(report, null, 2))
@@ -305,6 +323,8 @@ export async function main(argv = process.argv.slice(2), io = {}) {
305
323
  template: args.template,
306
324
  brand: effectiveBrand,
307
325
  dataModel: args.dataModel,
326
+ ...(args.evidence !== undefined ? { evidence: args.evidence } : {}),
327
+ ...(args.evidenceAppendix ? { evidenceAppendix: true } : {}),
308
328
  ...(args.handout ? { handout: true } : {}),
309
329
  ...(args.onePager ? { onePager: true } : {}),
310
330
  ...(args.targetMinutes !== undefined ? { targetMinutes: args.targetMinutes } : {}),
@@ -38,6 +38,7 @@ import {
38
38
  renderExemplarPromptGuide,
39
39
  } from './deck-exemplars.mjs'
40
40
  import { upgradeWeakDeck, resequenceSlidesToExemplar, selfRepairDeck, synthesizeActionTitle } from './deck-upgrader.mjs'
41
+ import { normalizeEvidenceLedger, applyEvidenceLedgerToSlides, auditEvidenceAndSourcing, buildResearchPlan } from './deck-evidence.mjs'
41
42
  export { readRenderReceipt } from './deck-render.mjs'
42
43
  export { dataNotes, dataReport } from './deck-data.mjs'
43
44
  export { buildDeck, resolveLanguage } from './deck-core.mjs'
@@ -63,6 +64,7 @@ export {
63
64
  renderExemplarPromptGuide,
64
65
  } from './deck-exemplars.mjs'
65
66
  export { upgradeWeakDeck, resequenceSlidesToExemplar, selfRepairDeck, synthesizeActionTitle } from './deck-upgrader.mjs'
67
+ export { normalizeEvidenceLedger, applyEvidenceLedgerToSlides, auditEvidenceAndSourcing, buildResearchPlan } from './deck-evidence.mjs'
66
68
 
67
69
  export async function ingestExemplarCorpus(options = {}) {
68
70
  return ingestExemplarDirectory({
@@ -269,7 +271,7 @@ function validateRawSlides(slides) {
269
271
  }
270
272
 
271
273
  function snapshot(manifest) {
272
- return clone(Object.fromEntries(['title', 'theme', 'language', 'motion', 'slides', 'brand', 'template', 'dataModel', 'targetMinutes', 'taste'].filter(k => manifest[k] !== undefined).map(k => [k, manifest[k]])))
274
+ return clone(Object.fromEntries(['title', 'theme', 'language', 'motion', 'slides', 'brand', 'template', 'dataModel', 'evidence', 'targetMinutes', 'taste'].filter(k => manifest[k] !== undefined).map(k => [k, manifest[k]])))
273
275
  }
274
276
 
275
277
  function collectAssets(manifest) {
@@ -373,10 +375,14 @@ export function checkManifest(manifest) {
373
375
  if (manifest.brand?.logoAssetId && !manifest.assets?.[manifest.brand.logoAssetId]) issue(0, 'missing-logo', '品牌 Logo 资产不存在', '重新提供 Logo', 'error')
374
376
  else if (manifest.brand?.logoAssetId && assetError(manifest.brand.logoAssetId)) issue(0, 'invalid-logo', assetError(manifest.brand.logoAssetId), '重新提供 Logo', 'error')
375
377
 
376
- // 追加 SLOP-01..10 审美反模式静态诊断
378
+ // 追加 SLOP-01..12 审美反模式静态诊断
377
379
  for (const aestheticIssue of auditSlideAesthetics(manifest, theme, textWidth)) {
378
380
  issues.push(aestheticIssue)
379
381
  }
382
+ // 追加 SLOP-13 事实出处与证据账本静态门禁
383
+ for (const evidenceIssue of auditEvidenceAndSourcing(manifest)) {
384
+ issues.push(evidenceIssue)
385
+ }
380
386
 
381
387
  return { ok: !issues.some(i => i.severity === 'error'), slideCount: manifest.slides.length,
382
388
  errorCount: issues.filter(i => i.severity === 'error').length, warningCount: issues.filter(i => i.severity === 'warning').length,
@@ -525,6 +531,7 @@ function result(manifest, paths, writeHandout = false, writeOnePager = false) {
525
531
  quality: manifest.quality, paceBudget, verification: { static: 'checked', pptxRender: 'not-verified', visual: 'not-verified' }, outputDir: dirname(paths.json),
526
532
  files: paths, htmlPath: paths.html, pptxPath: paths.pptx, jsonPath: paths.json,
527
533
  ...(manifest.exemplar ? { exemplar: manifest.exemplar } : {}),
534
+ ...(Array.isArray(manifest.evidence) && manifest.evidence.length > 0 ? { evidenceCount: manifest.evidence.length } : {}),
528
535
  ...(writeHandout ? { handoutPath } : {}),
529
536
  ...(writeOnePager ? { onePagerPath } : {}) }
530
537
  }
@@ -588,6 +595,7 @@ function validateSnapshot(value, assets) {
588
595
  }
589
596
  validateRawSlides(value.slides)
590
597
  validateDataSnapshot(value, normalizeSlides)
598
+ if (value.evidence !== undefined) normalizeEvidenceLedger(value.evidence)
591
599
  if (value.brand != null) {
592
600
  if (Object.hasOwn(value.brand, 'logo')) fail('工程品牌仅支持嵌入的 logoAssetId,不读取本地 logo 路径')
593
601
  for (const key of ['primaryColor', 'secondaryColor', 'backgroundColor', 'textColor', 'fontFamily', 'headingFont', 'coverMode', 'coverBg', 'name', 'footer', 'chromeStyle', 'cardMaterial', 'iconMode', 'taste']) {
@@ -773,6 +781,15 @@ export async function buildDeckAsync(options = {}) {
773
781
  normalized.deck.slides = optimizeVisualRhythm(normalized.deck.slides, resolvedTaste)
774
782
  }
775
783
 
784
+ const evidence = normalizeEvidenceLedger(options.evidence)
785
+ if (evidence.length > 0) {
786
+ const appliedEvidence = applyEvidenceLedgerToSlides(normalized.deck.slides, evidence, {
787
+ lang: langId,
788
+ evidenceAppendix: options.evidenceAppendix === true,
789
+ })
790
+ normalized.deck.slides = appliedEvidence.slides
791
+ }
792
+
776
793
  const assets = {}
777
794
  let brandInput = options.brand
778
795
  if (resolvedTaste && options.brand !== null) {
@@ -825,6 +842,7 @@ export async function buildDeckAsync(options = {}) {
825
842
  ...(scenario ? { template: scenario.id } : {}),
826
843
  ...(brand ? { brand } : {}),
827
844
  ...(dataModel ? { dataModel } : {}),
845
+ ...(evidence.length > 0 ? { evidence } : {}),
828
846
  assets,
829
847
  history: [],
830
848
  slides: embedSlides(normalized.deck.slides, assets, cwd).map(s => ({ ...s, id: randomUUID() })),
@@ -952,7 +970,7 @@ export async function editDeck(options = {}) {
952
970
  }
953
971
  const used = new Set()
954
972
  const allowed = new Set([
955
- 'layout', 'variant', 'chrome', 'cardMaterial', 'iconMode', 'coverPattern', 'title', 'subtitle', 'kicker', 'takeaway', 'source',
973
+ 'layout', 'variant', 'chrome', 'cardMaterial', 'iconMode', 'coverPattern', 'title', 'subtitle', 'kicker', 'takeaway', 'source', 'evidenceIds',
956
974
  'text', 'formula', 'mermaid', 'code', 'language', 'filename', 'url', 'xLabel', 'yLabel', 'activeIndex', 'tableStyle',
957
975
  'bullets', 'items', 'cards', 'metrics', 'columns', 'steps', 'quadrants', 'rows', 'notes', 'image', 'images', 'chart', 'visual',
958
976
  ])
@@ -1150,6 +1150,10 @@ function normalizeSlideContent(raw, index) {
1150
1150
  ?? (layout === 'sankey' && bullets.length > 0 ? bullets : undefined)
1151
1151
  const items = normalizeSlideItems(rawItemsInput, layout)
1152
1152
 
1153
+ const rawEvidenceIds = Array.isArray(source.evidenceIds)
1154
+ ? [...new Set(source.evidenceIds.map((id) => stripInlineMarkdown(id).trim().toUpperCase()).filter(Boolean))].slice(0, 12)
1155
+ : undefined
1156
+
1153
1157
  const commonExtras = {
1154
1158
  ...(variant !== '' ? { variant } : {}),
1155
1159
  ...(chrome ? { chrome } : {}),
@@ -1167,6 +1171,7 @@ function normalizeSlideContent(raw, index) {
1167
1171
  ...(quadrantLabels ? { quadrants: quadrantLabels } : {}),
1168
1172
  ...(takeaway !== '' ? { takeaway } : {}),
1169
1173
  ...(slideSource !== '' ? { source: slideSource } : {}),
1174
+ ...(rawEvidenceIds?.length ? { evidenceIds: rawEvidenceIds } : {}),
1170
1175
  ...(activeIndex !== undefined ? { activeIndex } : {}),
1171
1176
  ...(columns?.length ? { columns } : {}),
1172
1177
  ...(start !== undefined ? { start } : {}),
@@ -3,6 +3,7 @@ import { deriveBrandedTheme, resolveTheme, relativeLuminance } from './deck-them
3
3
  import { renderChartSvg } from './deck-media.mjs'
4
4
  import { renderMermaidHtml, MERMAID_CSS } from './deck-mermaid.mjs'
5
5
  import { latexToMathMl } from './deck-math.mjs'
6
+ import { renderEvidenceHandoutSection } from './deck-evidence.mjs'
6
7
 
7
8
  const escape = value => String(value ?? '').replace(/[&<>"']/g, c => ({ '&': '&amp;', '<': '&lt;', '>': '&gt;', '"': '&quot;', "'": '&#39;' })[c])
8
9
 
@@ -301,6 +302,9 @@ export function renderHandoutMarkdown(manifest, language) {
301
302
  lines.push('')
302
303
  })
303
304
 
305
+ const evidenceSection = renderEvidenceHandoutSection(manifest, lang)
306
+ if (evidenceSection) lines.push(evidenceSection)
307
+
304
308
  return lines.join('\n')
305
309
  }
306
310