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.
- package/CHANGELOG.md +22 -0
- package/README.en.md +3 -2
- package/README.md +3 -2
- package/docs/USAGE.en.md +2 -0
- package/docs/USAGE.md +2 -0
- package/docs/VALIDATION.md +8 -0
- package/lib/client.js +10 -2
- package/lib/execution.d.ts +7 -0
- package/lib/execution.js +22 -0
- package/lib/tools.js +39 -5
- package/lib/types.d.ts +21 -2
- package/lib/workbench.js +2 -0
- package/package.json +2 -2
- package/skills/dsh-ppt/SKILL.md +12 -6
- package/skills/dsh-ppt/package.json +1 -1
- package/skills/dsh-ppt/references/exemplars.md +8 -4
- package/skills/dsh-ppt/references/research-plan.md +133 -0
- package/skills/dsh-ppt/scripts/build-deck.mjs +27 -3
- package/skills/dsh-ppt/scripts/deck-advanced.mjs +54 -7
- package/skills/dsh-ppt/scripts/deck-core.mjs +5 -0
- package/skills/dsh-ppt/scripts/deck-delivery.mjs +4 -0
- package/skills/dsh-ppt/scripts/deck-evidence.mjs +628 -0
- package/skills/dsh-ppt/scripts/deck-upgrader.mjs +860 -46
package/lib/types.d.ts
CHANGED
|
@@ -219,6 +219,16 @@ export interface PptDataModel {
|
|
|
219
219
|
sources: PptDataSource[];
|
|
220
220
|
metrics: PptDataMetric[];
|
|
221
221
|
}
|
|
222
|
+
export interface PptEvidenceEntry {
|
|
223
|
+
id?: string;
|
|
224
|
+
claim: string;
|
|
225
|
+
source: string;
|
|
226
|
+
date?: string;
|
|
227
|
+
scope?: string;
|
|
228
|
+
url?: string;
|
|
229
|
+
confidence?: 'verified' | 'estimated' | 'conflicting' | 'unverified';
|
|
230
|
+
note?: string;
|
|
231
|
+
}
|
|
222
232
|
export interface PptSlideSpec {
|
|
223
233
|
id?: string;
|
|
224
234
|
layout?: PptSlideLayout;
|
|
@@ -231,6 +241,7 @@ export interface PptSlideSpec {
|
|
|
231
241
|
kicker?: string;
|
|
232
242
|
takeaway?: string;
|
|
233
243
|
source?: string;
|
|
244
|
+
evidenceIds?: string[];
|
|
234
245
|
text?: string;
|
|
235
246
|
formula?: string;
|
|
236
247
|
mermaid?: string;
|
|
@@ -280,9 +291,11 @@ export interface PptCreateArgs {
|
|
|
280
291
|
slides?: PptSlideSpec[];
|
|
281
292
|
theme?: string;
|
|
282
293
|
taste?: PptTasteRecipeId | string | PptTasteRecipe;
|
|
283
|
-
/** Curated exemplar ID (
|
|
294
|
+
/** Curated exemplar ID (20 built-in or "auto") or workspace absorbed exemplar ID for slot-filling & auto-upgrade. */
|
|
284
295
|
exemplar?: string;
|
|
285
|
-
/**
|
|
296
|
+
/** Re-sequence slides to match the active exemplar's narrative arc (cover -> thesis/KPI -> problem -> solution -> proof -> roadmap -> closing). Default false. */
|
|
297
|
+
alignOrder?: boolean;
|
|
298
|
+
/** Deterministic weak-LLM compensator, anti-slop upgrader & zero-LLM self-repair loop (default true in async mode; set false to keep raw slides verbatim). */
|
|
286
299
|
autoUpgrade?: boolean;
|
|
287
300
|
persona?: PptPersonaId | string;
|
|
288
301
|
referencePptx?: string;
|
|
@@ -301,6 +314,10 @@ export interface PptCreateArgs {
|
|
|
301
314
|
targetMinutes?: number;
|
|
302
315
|
/** Optional explicit source facts, assumptions and safe arithmetic; bind slides with {{metricId}}. */
|
|
303
316
|
dataModel?: PptDataModel;
|
|
317
|
+
/** Structured verified Evidence Ledger from external research & fact-checking; binds [E#] / evidenceIds to source footers, speaker notes & SLOP-13 audit. */
|
|
318
|
+
evidence?: PptEvidenceEntry[];
|
|
319
|
+
/** When evidence[] is supplied, automatically insert a booktabs Sources & Fact-Verification Ledger appendix slide before closing. */
|
|
320
|
+
evidenceAppendix?: boolean;
|
|
304
321
|
}
|
|
305
322
|
export interface PptThemeInfo {
|
|
306
323
|
id: string;
|
|
@@ -493,6 +510,7 @@ export interface PptCreateResult {
|
|
|
493
510
|
importedFrom?: string;
|
|
494
511
|
syncedProject?: boolean;
|
|
495
512
|
exemplar?: string;
|
|
513
|
+
evidenceCount?: number;
|
|
496
514
|
upgradeReport?: Record<string, unknown>;
|
|
497
515
|
quality?: PptQualityResult;
|
|
498
516
|
verification?: PptVerification;
|
|
@@ -510,6 +528,7 @@ export interface DeckEngine {
|
|
|
510
528
|
resolveExemplar?(idOrObj: unknown, workspaceExemplars?: Record<string, unknown>): PptExemplarSummary | null;
|
|
511
529
|
renderExemplarPromptGuide?(exemplar: unknown, lang?: string): string;
|
|
512
530
|
getExemplarFewShotSlides?(exemplarId: string, lang?: string): Array<Record<string, unknown>>;
|
|
531
|
+
buildResearchPlan?(options?: Record<string, unknown>): Record<string, unknown>;
|
|
513
532
|
extractExemplarFromAbsorbed?(absorbed: unknown, options?: Record<string, unknown>): Record<string, unknown>;
|
|
514
533
|
importPptxDeck(options: Record<string, unknown>): Promise<PptCreateResult>;
|
|
515
534
|
importOfficeDeck?(options: Record<string, unknown>): Promise<PptCreateResult>;
|
package/lib/workbench.js
CHANGED
|
@@ -1076,6 +1076,7 @@ export class PptWorkbench {
|
|
|
1076
1076
|
exemplar = body.exemplar.trim();
|
|
1077
1077
|
}
|
|
1078
1078
|
const autoUpgrade = typeof body.autoUpgrade === 'boolean' ? body.autoUpgrade : undefined;
|
|
1079
|
+
const alignOrder = body.alignOrder === true;
|
|
1079
1080
|
const brand = body.brand !== undefined ? this.brandPatch(body.brand) : undefined;
|
|
1080
1081
|
const cloneStructure = body.cloneStructure === true;
|
|
1081
1082
|
const engine = await this.loadEngine();
|
|
@@ -1127,6 +1128,7 @@ export class PptWorkbench {
|
|
|
1127
1128
|
...(fallbackContent ? { content: fallbackContent } : {}),
|
|
1128
1129
|
...(template ? { template } : {}),
|
|
1129
1130
|
...(exemplar ? { exemplar } : {}),
|
|
1131
|
+
...(alignOrder ? { alignOrder: true } : {}),
|
|
1130
1132
|
...(autoUpgrade !== undefined ? { autoUpgrade } : {}),
|
|
1131
1133
|
theme,
|
|
1132
1134
|
lang,
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "dsh-ppt",
|
|
3
|
-
"version": "0.
|
|
4
|
-
"description": "DeepSeek Harness
|
|
3
|
+
"version": "0.32.0",
|
|
4
|
+
"description": "DeepSeek Harness 大师级演示文稿引擎与工作台:支持零资料调研核验与 SLOP-13 事实溯源、20 套标杆范本与弱模型零调用自检修复、24 主题 / 35+ 原生可编辑图谱(Mermaid/公式/代码/魔力象限/雷达/哑铃/热力图)、Office 直吞与双屏提词台,导出离线 HTML + 100% 可编辑 PPTX。欢迎 PR 与 Issues。",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "lib/index.js",
|
|
7
7
|
"types": "lib/index.d.ts",
|
package/skills/dsh-ppt/SKILL.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: dsh-ppt
|
|
3
|
-
description: "Turn one sentence, a Markdown document, structured slides, Office files (.xlsx/.csv/.docx), or a benchmark .pptx corpus into a world-class presentation deck: standalone HTML web slideshow (with Dual-Screen Presenter Console & Executive One-Pager) + 100% native-editable PPTX (with
|
|
3
|
+
description: "Turn one sentence, a zero-material research topic, a Markdown document, structured slides, Office files (.xlsx/.csv/.docx), or a benchmark .pptx corpus into a world-class presentation deck: standalone HTML web slideshow (with Dual-Screen Presenter Console & Executive One-Pager) + 100% native-editable PPTX (with 20 Curated Gold Exemplars & Slot-Filling Contracts, Zero-Material Research-to-Deck Planner, Verified Evidence Ledger & SLOP-13 Fact-Grounding Gate, Deterministic Weak-LLM Compensator & Zero-LLM Self-Repair Loop, 8 Curated Taste Recipes, 4 poster covers + Hero Photo Split + coverPattern, 61 native <a:custGeom> vector icons, glass/frameless/editorial materiality, device mockups, 9-language syntax-highlighted code terminals, Magic Quadrant, Radar, Dumbbell, Heatmap, native <m:oMath> formulas, Mermaid flowcharts/sequences, Marimekko, Sankey, Porter Value Chain, SWOT) + project manifest + Speaker Handout. Supports batch .pptx exemplar ingestion (.dsh-ppt/exemplars.json), Zero-Question Scenario Auto-Direction (theme: auto), 24 curated themes, 6 Master Chrome Skeletons, 35+ native-editable layouts, 20 industry blueprints, 13 publication-grade charts, and bilingual ZH/EN support. 中文:内置 20 套标杆范本、零资料深度调研与事实核验协议(Evidence Ledger + SLOP-13 出处门禁)、确定性防退化升维器与零模型自检修复闭环,支持有资料直出与无资料先调研策划再出稿双模式。"
|
|
4
4
|
compatibility: "Node ^22.19.0 or >=24.0.0. Images/charts/PPTX absorption use @office-kit/pptx@0.21.0; optional data models use jsep@1.4.0 and csv-parse@6.1.0. Optional PNG/PDF renderer: @deepseek-ai/libreoffice-kit@0.2.3 (bundled by DSH 0.2.2+; 0.1.5 also supported). Cross-harness: copy the full directory and run npm install --ignore-scripts there."
|
|
5
5
|
allowed-tools: "Bash, Read, Write, Edit"
|
|
6
6
|
---
|
|
@@ -21,7 +21,7 @@ allowed-tools: "Bash, Read, Write, Edit"
|
|
|
21
21
|
2. **结论先行(Action Titles)**:除封面、目录与章节页外,每页标题必须是**完整的结论判断句**(如「异步评审将工程师周均例会耗时压缩 75%」),严禁使用「项目背景」「数据分析」「周末到馆人次」等空洞名词标签。
|
|
22
22
|
3. **版式节奏与反要点墙(Anti-Bullet-Wall)**:优先传**结构化 `slides`**(或使用 `::: kpi / cards / comparison / process / chevron / matrix / callout / gantt / architecture / harvey / tam / org` 指令)充分利用 **24+ 套原生版式与专业图示**。**整套文稿严禁连续超过 2 页使用普通 `bullets` 要点列表**;8 页以上文稿须有节奏地交替视觉密度(指标用 `kpi`、端到端价值链用 `chevron`、排期用 `gantt`、系统分层用 `architecture`、竞品能力用 `harvey`、市场空间用 `tam`、组织团队用 `org`、并列支柱用 `cards[pillars/bento]`、痛点整改用 `comparison[issue-action]`、演进/闭环用 `process[timeline/steps/flywheel/funnel]`、四象限用 `matrix`、数据配洞察用 `chart-split`、学术对比用 `table[booktabs]` 三线表)。
|
|
23
23
|
4. **出版级图表与三线表**:单系列图表自动隐藏冗余图例,使用 `spotlight: true` / `highlight: 'max' | 'last'` 突出焦点色柱、其余灰阶退后,按需叠加 `referenceLine` 基准虚线与 `showGrowthCallout: true` 麦肯锡增长飞线批注,左下角附 `source` 数据来源;学术与严谨数据对比使用无竖线的 `booktabs` 三线表。
|
|
24
|
-
5. **20
|
|
24
|
+
5. **20 套标杆范本槽位填空 + 标杆弧线重排(`alignOrder: true`)+ 零模型自检修复闭环**:不要从零发明排版!直接传 `exemplar: 'auto'` 智能匹配或从内置 **20 套标杆范本**(8 套核心场景 + 12 套源自 Apache-2.0 / MIT / CC-BY-4.0 开源 GitHub 优质 `.pptx` 经实机渲染甄选蒸馏的标杆:`mckinsey-evolution` / `luxury-budget-review` / `swiss-bauhaus-workshop` / `dark-stage-investor` / `blueprint-ai-factory` / `warm-brand-story` / `ted-storytelling-keynote` / `msft-enterprise-discovery` / `daylight-earnings-research` / `okr-performance-review` / `quiet-canvas-keynote` / `medical-clinical-course`)中择一,先调 `ppt_templates({ exemplarId })` 获取逐页槽位契约、满分标题示范与 **Few-Shot JSON 样板**,再按槽位调用 `ppt_create({ exemplar, alignOrder: true, ... })`;引擎内置 **确定性弱模型补偿器 + 落盘前两轮 `checkManifest`/`SLOP-01..12` 零模型自检修复闭环(`autoUpgrade`,默认开启)**,即使输入为乱序粗糙 `bullets` / 碎块饼图 / 超载指标 / 刺眼配色也能以 0 额外模型开销 100% 无损升维并修复至零告警成品。用户手头有优质 GitHub / 企业 `.pptx` 目录时,直接调 `ppt_absorb({ pptxPath: "<目录路径>" })`(或 CLI `--ingest-exemplars <dir>`)批量投喂至 `.dsh-ppt/exemplars.json` 与 `.dsh-ppt/taste-recipes.json` 持久化复用。
|
|
25
25
|
6. **8 套大师品味配方(Taste Recipes)与单份母版吸收**:无外部模板时也可独立选用 `taste: 'mckinsey-partner' | 'apple-keynote-dark' | 'apple-keynote-light' | 'swiss-editorial' | 'linear-craft' | 'ft-data-journal' | 'nature-academic' | 'oriental-zen'` 驱动 4 套海报封面、4 种卡片材质与 61 枚原生矢量图标;单份标杆 `.pptx` 用 `ppt_absorb`(`saveTasteAs` / `saveExemplarAs`)或 `referencePptx` + `cloneStructure: true` 吸收。
|
|
26
26
|
|
|
27
27
|
## 执行纪律(每次都要遵守)
|
|
@@ -32,9 +32,12 @@ allowed-tools: "Bash, Read, Write, Edit"
|
|
|
32
32
|
- **字体与跨平台零缺字**:正文最小字号硬底线 `13.5pt`,超长内容必须拆页而非强行缩字。若 `ppt_render` 报告 `missingFonts` 非空,必须替换为环境与接收方可用字体(Windows `Microsoft YaHei`、macOS `PingFang SC`/`Songti SC`、Linux `Noto Sans/Serif CJK SC`),重新生成并逐页复核;未解决前不得声称已验收。CLI 与工具报错信息统一为中文。
|
|
33
33
|
- **语言分工**:`lang`(`zh | en | bilingual`)仅控制播放器界面与默认标签;正文与双语表达由你在写作阶段完成。
|
|
34
34
|
|
|
35
|
-
##
|
|
35
|
+
## 核心流水线(双模路由)
|
|
36
36
|
|
|
37
|
-
|
|
37
|
+
- **Mode A(有资料直出)**:用户已给出文档、大纲、表格、数据或参考 `.pptx` 时,零追问自动定调并直接生成可交付三件套。
|
|
38
|
+
- **Mode B(零资料深研策划)**:用户**没有资料**、只给主题或明确要求「你去搜索资料、核验准确性、先策划 PPT 方案再生成」时,**严禁凭训练记忆编造具体统计数字**!必须先读 `references/research-plan.md`,按四步闭环执行:① 调 `ppt_templates({ topic })`(或 CLI `--plan`)获取标杆分镜与 3 轮检索指南 → ② 用宿主 Agent 联网搜索工具开展 3 轮一手源检索与双源交叉核验,沉淀 `evidence[]` 账本(冲突报区间、缺数改定性图示)→ ③ 向用户展示策划方案(含核验事实摘要与逐页分镜表)并获确认(除非用户明示跳过确认直出)→ ④ 带 `evidence[]` + `evidenceAppendix: true` + `slides[].evidenceIds` 调 `ppt_create` 出稿并通过 `SLOP-13` 事实出处门禁。
|
|
39
|
+
|
|
40
|
+
1. **Probe & Auto-Direct 定调**:读入用户句子/文档/数据(或 Mode B 核验后的证据账本),静默判定听众与六大画像(见 `references/themes.md`)。若用户给了参考 `.pptx`,调 `ppt_absorb` 查看提取结果或在创建时传 `referencePptx`。Mode A 一句话输入不反问,直接推断并生成完整成品。
|
|
38
41
|
2. **Storyline & Choreography 叙事与排布**:先读 `references/copywriting.md`。按金字塔原理 / SCQA 组织 5–16 页大纲,为每页撰写结论先行 Action Title、章节面包屑 `kicker`(如 `01 · 市场诊断`,禁止满屏重复「要点」)、底栏核心结论 `takeaway` 与数据出处 `source`,并规划多版式交替节奏。可调 `ppt_templates` 参考 **20 套行业结构蓝图**(`weekly | defense | project | pitch | consulting | keynote | gov-report | workshop | architecture-review | financial-earnings | medical-case | postmortem | marketing-campaign | promotion-review | legal-compliance | creative-lookbook | quarterly-okr | product-prd | vc-daylight | industry-research`)。
|
|
39
42
|
3. **Theme 选主题与骨架**:不确定时在 `ppt_create` 传 `theme: 'auto'`(自动路由至明亮高质感场景主题与匹配骨架),或从 **24 套内置主题**中精确指定(调 `ppt_themes` 查看),并可通过 `brand.chromeStyle` 或单页 `chrome` 覆盖 6 套母版骨架。
|
|
40
43
|
- **重要 CLI 差异**:跨 harness 直接运行 `build-deck.mjs` 时,裸 CLI 缺省 `--theme` 为兼容旧脚本仍回退 `data`,因此 **CLI 调用请务必显式传 `--theme auto` 或具体场景主题 ID(如 `--theme consulting` / `--theme exec-jilan`)**!
|
|
@@ -49,7 +52,8 @@ allowed-tools: "Bash, Read, Write, Edit"
|
|
|
49
52
|
|
|
50
53
|
| 何时必读 | 参考文件 | 核心内容 |
|
|
51
54
|
| --- | --- | --- |
|
|
52
|
-
|
|
|
55
|
+
| **零资料联网调研、核验准确性与先策划再出稿** | `references/research-plan.md` | 双模路由、3 轮定向检索法、Tier 1/2/3 交叉核验红线、`evidence[]` 账本、分镜策划确认与 `SLOP-13` 门禁 |
|
|
56
|
+
| 按标杆范本槽位填空或批量投喂 `.pptx` 语料 | `references/exemplars.md` | 20 套标杆范本槽位契约、`ppt_templates(exemplarId)`、批量 `--ingest-exemplars` 与弱模型升维补偿器 |
|
|
53
57
|
| 写大纲、标题与正文前 | `references/copywriting.md` | 六大画像叙事骨架、Action Title 写法、字数预算、反空话与双语规范 |
|
|
54
58
|
| 选主题、配色、骨架或吸收母版 | `references/themes.md` | 18 套大师主题色板(12 浅 6 深)、6 套母版骨架(Chrome)、18 语义 Token、六大画像选型树 |
|
|
55
59
|
| 写结构化 `slides` 或扩展 Markdown | `references/syntax.md` | 24 套原生版式与专业图示 + `variant`、统一 `items` 结构、`:::` 容器指令、三线表与 `takeaway` |
|
|
@@ -57,7 +61,7 @@ allowed-tools: "Bash, Read, Write, Edit"
|
|
|
57
61
|
| 数字溯源、公式与现场推演 | `references/data.md` | `dataModel` 源绑定、公式约束、全字段 `{{metricId}}` 联动与预览确认流 |
|
|
58
62
|
| 遇到报错或渲染异常 | `references/troubleshooting.md` | 症状 → 根因与处理速查表 |
|
|
59
63
|
|
|
60
|
-
## 质量与反土味门禁(SLOP-01..
|
|
64
|
+
## 质量与反土味门禁(SLOP-01..13,交付前逐项核对)
|
|
61
65
|
|
|
62
66
|
- [ ] **SLOP-01 结论标题**:内容页与图表页标题均为完整判断句(Action Title),无「项目背景 / 数据图表 / 总结」等纯名词短标题。
|
|
63
67
|
- [ ] **SLOP-02 章节面包屑**:`kicker` 体现章节脉络(如 `01 · 增长引擎`),未连续多页硬编码重复「要点 / Point」。
|
|
@@ -69,6 +73,8 @@ allowed-tools: "Bash, Read, Write, Edit"
|
|
|
69
73
|
- [ ] **SLOP-08 版式多样性**:≥ 6 页的文稿至少组合 4 种不同版式原型,封面与封底不误印页码。
|
|
70
74
|
- [ ] **SLOP-09 可执行收尾**:`closing` 页包含明确的下一步行动号召(CTA / 里程碑 / 联络方式),绝不仅写两个字「谢谢」。
|
|
71
75
|
- [ ] **SLOP-10 真实性与跨平台完备**:无未填占位草稿(除非用户明确要求空模板并标注 `draft`),全部产物为工作区绝对路径;若已运行渲染,确认 `missingFonts: []` 且收据匹配最新 PPTX。
|
|
76
|
+
- [ ] **SLOP-11/12 卡片材质节奏与图表聚光灯**:长篇文稿避免连续 ≥ 4 页等宽方框卡片;单系列 ≥ 5 项柱状/条形图须通过 `highlight` / `spotlight` / `referenceLine` 聚焦核心主角。
|
|
77
|
+
- [ ] **SLOP-13 事实出处与证据账本卫生**:严禁「数据来源:网络整理 / 公开资料 / 综合整理」等空洞假出处;零资料调研模式下所有量化数据页均须绑定已核验 `evidenceIds`(或一手 `source`),无悬空 `[E#]` 引用,`unverified` / `conflicting` 证据必须在画面可见文案中如实注明口径差异或区间。
|
|
72
78
|
|
|
73
79
|
## 跨 harness 安装
|
|
74
80
|
|
|
@@ -131,7 +131,11 @@ node skills/dsh-ppt/scripts/build-deck.mjs --title "2026 Q1 汇报" --exemplar c
|
|
|
131
131
|
- 单页 `>6` 条 bullets 自动拆分为两页(`(续)` / `(Cont.)`),杜绝挤压溢出;
|
|
132
132
|
- 连续 `>=2` 页 `bullets` 自动打断为 `cards` / `comparison` / `process`;
|
|
133
133
|
- 无加粗引导词的长要点自动切分加粗 `**主语**:说明`,提升扫视效率。
|
|
134
|
-
4.
|
|
135
|
-
-
|
|
136
|
-
- 自动补齐有意义的章节面包屑 `kicker`;
|
|
137
|
-
- 仅写「谢谢 / Thank you
|
|
134
|
+
4. **证据锚定 Action-Title 与结尾兜底(`SLOP-01 / 02 / 09 / 10`)**:
|
|
135
|
+
- 「财务数据 / 工作总结 / 核心指标 / 市场分析 / 性能提升 / Financials / Key Metrics」等空洞标签按各版式原生数据(KPI 数值、哑铃最大改善项、图表峰值/涨幅、表格领跑行)100% 依据原文提炼控宽 Action Title,绝不编造数字、绝不篡改 `{{metricId}}` 绑定;
|
|
136
|
+
- 自动补齐有意义的章节面包屑 `kicker` 与图表/哑铃页底部量化 `takeaway`;
|
|
137
|
+
- 仅写「谢谢 / Thank you」的裸结尾自动补齐 3 卡片行动封底 `closing[cta-cards]`。
|
|
138
|
+
5. **标杆叙事弧线自动重排(`alignOrder: true` / CLI `--align-order`)**:
|
|
139
|
+
- 当草稿页序散乱(如把甘特排期塞在开篇、把核心 KPI 放到末尾)时,传 `alignOrder: true` 自动按标杆范本经典弧线(封面 → 核心判断 → 关键 KPI → 痛点对比 → 方案图谱 → 量化证明 → 排期路线 → 行动封底)确定性重排,完整保留显式 `section` 分章边界。
|
|
140
|
+
6. **零模型落盘前自检修复闭环(`selfRepairDeck`)**:
|
|
141
|
+
- 渲染落盘前自动执行最多 2 轮 `checkManifest` + `SLOP-01..12` 复检与无损修复:自动拆分超长标题至 `subtitle`、无损分页 `kpi(>4)` / `cards(>6)` / `table(>9行)` 与长文本墙、把 >6 扇区碎块饼图转为聚光灯横向 `bar`、为单系列长柱图补聚光灯焦点、打破连续方框疲劳并净化高饱和/低对比画布,确保落盘即零告警成品(传 `--no-self-repair` 或 `autoUpgrade: false` 可关闭)。
|
|
@@ -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(
|
|
38
|
-
--list-exemplars 列出内置
|
|
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,9 +105,14 @@ 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()
|
|
113
|
+
else if (key === '--align-order') args.alignOrder = true
|
|
107
114
|
else if (key === '--no-auto-upgrade') args.autoUpgrade = false
|
|
115
|
+
else if (key === '--no-self-repair') args.selfRepair = false
|
|
108
116
|
else if (key === '--overwrite') args.overwrite = true
|
|
109
117
|
else if (key === '--smart-layout') args.smartLayout = true
|
|
110
118
|
else if (key === '--no-smart-layout') args.smartLayout = false
|
|
@@ -177,6 +185,18 @@ export async function main(argv = process.argv.slice(2), io = {}) {
|
|
|
177
185
|
if (args.listTemplates) { log(JSON.stringify({ templates: listTemplates(args.lang) }, null, 2)); return 0 }
|
|
178
186
|
if (args.listTastes) { log(JSON.stringify({ tasteRecipes: listAllTasteRecipes(process.cwd()) }, null, 2)); return 0 }
|
|
179
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
|
+
}
|
|
180
200
|
if (args.ingestExemplars) {
|
|
181
201
|
const report = await ingestExemplarCorpus({ dirPath: args.ingestExemplars, cwd: process.cwd() })
|
|
182
202
|
log(JSON.stringify(report, null, 2))
|
|
@@ -288,7 +308,9 @@ export async function main(argv = process.argv.slice(2), io = {}) {
|
|
|
288
308
|
theme: args.theme,
|
|
289
309
|
...(args.taste ? { taste: args.taste } : {}),
|
|
290
310
|
...(args.exemplar ? { exemplar: args.exemplar } : {}),
|
|
311
|
+
...(args.alignOrder ? { alignOrder: true } : {}),
|
|
291
312
|
...(args.autoUpgrade !== undefined ? { autoUpgrade: args.autoUpgrade } : {}),
|
|
313
|
+
...(args.selfRepair !== undefined ? { selfRepair: args.selfRepair } : {}),
|
|
292
314
|
persona: args.persona,
|
|
293
315
|
referencePptx: args.referencePptx,
|
|
294
316
|
cloneStructure: args.cloneStructure,
|
|
@@ -301,6 +323,8 @@ export async function main(argv = process.argv.slice(2), io = {}) {
|
|
|
301
323
|
template: args.template,
|
|
302
324
|
brand: effectiveBrand,
|
|
303
325
|
dataModel: args.dataModel,
|
|
326
|
+
...(args.evidence !== undefined ? { evidence: args.evidence } : {}),
|
|
327
|
+
...(args.evidenceAppendix ? { evidenceAppendix: true } : {}),
|
|
304
328
|
...(args.handout ? { handout: true } : {}),
|
|
305
329
|
...(args.onePager ? { onePager: true } : {}),
|
|
306
330
|
...(args.targetMinutes !== undefined ? { targetMinutes: args.targetMinutes } : {}),
|
|
@@ -37,7 +37,8 @@ import {
|
|
|
37
37
|
matchBestExemplar,
|
|
38
38
|
renderExemplarPromptGuide,
|
|
39
39
|
} from './deck-exemplars.mjs'
|
|
40
|
-
import { upgradeWeakDeck } from './deck-upgrader.mjs'
|
|
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'
|
|
@@ -62,7 +63,8 @@ export {
|
|
|
62
63
|
matchBestExemplar,
|
|
63
64
|
renderExemplarPromptGuide,
|
|
64
65
|
} from './deck-exemplars.mjs'
|
|
65
|
-
export { upgradeWeakDeck } from './deck-upgrader.mjs'
|
|
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..
|
|
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']) {
|
|
@@ -760,6 +768,7 @@ export async function buildDeckAsync(options = {}) {
|
|
|
760
768
|
exemplar: resolvedExemplar,
|
|
761
769
|
lang: langId,
|
|
762
770
|
allowSplit: !fromMarkdown || normalized.deck.slides.length <= 24,
|
|
771
|
+
alignOrder: options.alignOrder === true,
|
|
763
772
|
})
|
|
764
773
|
normalized.deck.slides = upgraded.slides
|
|
765
774
|
if (upgraded.report.applied) upgradeReport = upgraded.report
|
|
@@ -772,6 +781,15 @@ export async function buildDeckAsync(options = {}) {
|
|
|
772
781
|
normalized.deck.slides = optimizeVisualRhythm(normalized.deck.slides, resolvedTaste)
|
|
773
782
|
}
|
|
774
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
|
+
|
|
775
793
|
const assets = {}
|
|
776
794
|
let brandInput = options.brand
|
|
777
795
|
if (resolvedTaste && options.brand !== null) {
|
|
@@ -824,11 +842,40 @@ export async function buildDeckAsync(options = {}) {
|
|
|
824
842
|
...(scenario ? { template: scenario.id } : {}),
|
|
825
843
|
...(brand ? { brand } : {}),
|
|
826
844
|
...(dataModel ? { dataModel } : {}),
|
|
845
|
+
...(evidence.length > 0 ? { evidence } : {}),
|
|
827
846
|
assets,
|
|
828
847
|
history: [],
|
|
829
848
|
slides: embedSlides(normalized.deck.slides, assets, cwd).map(s => ({ ...s, id: randomUUID() })),
|
|
830
849
|
}
|
|
831
|
-
|
|
850
|
+
let activeManifest = manifest
|
|
851
|
+
const hasUnfilledDraft = Boolean(scenario && !options.content?.trim() && !options.slides?.length)
|
|
852
|
+
const shouldSelfRepair = !dataModel && !hasUnfilledDraft && options.autoUpgrade !== false && options.selfRepair !== false && options.smartLayout !== false && (
|
|
853
|
+
options.selfRepair === true ||
|
|
854
|
+
shouldAutoUpgrade ||
|
|
855
|
+
Boolean(resolvedExemplar) ||
|
|
856
|
+
fromMarkdown
|
|
857
|
+
)
|
|
858
|
+
if (shouldSelfRepair) {
|
|
859
|
+
const repaired = selfRepairDeck(manifest, {
|
|
860
|
+
checkFn: checkManifest,
|
|
861
|
+
maxPasses: 2,
|
|
862
|
+
maxSlides: normalized.maxSlides || options.maxSlides || 60,
|
|
863
|
+
lang: langId,
|
|
864
|
+
allowSplit: !fromMarkdown || manifest.slides.length <= 24,
|
|
865
|
+
})
|
|
866
|
+
if (repaired.report.repairs.length > 0) {
|
|
867
|
+
repaired.manifest.slides = repaired.manifest.slides.map((s) => (s && !s.id ? { ...s, id: randomUUID() } : s))
|
|
868
|
+
activeManifest = repaired.manifest
|
|
869
|
+
upgradeReport = {
|
|
870
|
+
...(upgradeReport || { applied: true, exemplarId: resolvedExemplar?.id || null, resequenced: false, upgradeCount: 0, promotedCount: 0, splitCount: 0, brokenStreaks: 0, rescuedTitles: 0, upgrades: [] }),
|
|
871
|
+
applied: true,
|
|
872
|
+
selfRepair: repaired.report,
|
|
873
|
+
}
|
|
874
|
+
} else if (upgradeReport) {
|
|
875
|
+
upgradeReport = { ...upgradeReport, selfRepair: repaired.report }
|
|
876
|
+
}
|
|
877
|
+
}
|
|
878
|
+
const data = await generate(activeManifest, options.signal)
|
|
832
879
|
mkdirSync(normalized.outputDir, { recursive: true })
|
|
833
880
|
// Resolve collisions after asynchronous rendering; an earlier call may have committed meanwhile.
|
|
834
881
|
const file = resolveDeckFileName(normalized.outputDir, normalized.fileName, normalized.overwrite)
|
|
@@ -836,7 +883,7 @@ export async function buildDeckAsync(options = {}) {
|
|
|
836
883
|
const writeHandout = options.handout === true
|
|
837
884
|
const writeOnePager = options.onePager === true
|
|
838
885
|
withLock(paths.json, () => { abort(options.signal); commit(paths, data, writeHandout, writeOnePager) })
|
|
839
|
-
const builtResult = result(
|
|
886
|
+
const builtResult = result(activeManifest, paths, writeHandout, writeOnePager)
|
|
840
887
|
return upgradeReport ? { ...builtResult, upgradeReport } : builtResult
|
|
841
888
|
}
|
|
842
889
|
|
|
@@ -923,7 +970,7 @@ export async function editDeck(options = {}) {
|
|
|
923
970
|
}
|
|
924
971
|
const used = new Set()
|
|
925
972
|
const allowed = new Set([
|
|
926
|
-
'layout', 'variant', 'chrome', 'cardMaterial', 'iconMode', 'coverPattern', 'title', 'subtitle', 'kicker', 'takeaway', 'source',
|
|
973
|
+
'layout', 'variant', 'chrome', 'cardMaterial', 'iconMode', 'coverPattern', 'title', 'subtitle', 'kicker', 'takeaway', 'source', 'evidenceIds',
|
|
927
974
|
'text', 'formula', 'mermaid', 'code', 'language', 'filename', 'url', 'xLabel', 'yLabel', 'activeIndex', 'tableStyle',
|
|
928
975
|
'bullets', 'items', 'cards', 'metrics', 'columns', 'steps', 'quadrants', 'rows', 'notes', 'image', 'images', 'chart', 'visual',
|
|
929
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 => ({ '&': '&', '<': '<', '>': '>', '"': '"', "'": ''' })[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
|
|