dsh-ppt 0.33.0 → 0.35.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (33) hide show
  1. package/CHANGELOG.md +42 -0
  2. package/README.en.md +8 -10
  3. package/README.md +8 -10
  4. package/docs/USAGE.en.md +44 -35
  5. package/docs/USAGE.md +45 -36
  6. package/docs/VALIDATION.md +8 -0
  7. package/lib/client.js +116 -17
  8. package/lib/ecosystem.js +10 -0
  9. package/lib/execution.js +36 -5
  10. package/lib/tools.js +74 -4
  11. package/lib/types.d.ts +79 -1
  12. package/lib/workbench.js +255 -14
  13. package/package.json +2 -2
  14. package/skills/dsh-ppt/SKILL.md +34 -31
  15. package/skills/dsh-ppt/package.json +1 -1
  16. package/skills/dsh-ppt/references/office-pack.md +124 -0
  17. package/skills/dsh-ppt/references/research-plan.md +93 -62
  18. package/skills/dsh-ppt/scripts/build-deck.mjs +109 -3
  19. package/skills/dsh-ppt/scripts/deck-absorb.mjs +21 -0
  20. package/skills/dsh-ppt/scripts/deck-advanced.mjs +330 -37
  21. package/skills/dsh-ppt/scripts/deck-brand-kit.mjs +257 -0
  22. package/skills/dsh-ppt/scripts/deck-charts-exec.mjs +805 -0
  23. package/skills/dsh-ppt/scripts/deck-chrome.mjs +47 -1
  24. package/skills/dsh-ppt/scripts/deck-compose.mjs +386 -0
  25. package/skills/dsh-ppt/scripts/deck-core.mjs +136 -16
  26. package/skills/dsh-ppt/scripts/deck-delivery.mjs +750 -17
  27. package/skills/dsh-ppt/scripts/deck-evidence.mjs +811 -118
  28. package/skills/dsh-ppt/scripts/deck-export.mjs +652 -0
  29. package/skills/dsh-ppt/scripts/deck-i18n.mjs +170 -0
  30. package/skills/dsh-ppt/scripts/deck-layouts.mjs +72 -8
  31. package/skills/dsh-ppt/scripts/deck-media.mjs +22 -0
  32. package/skills/dsh-ppt/scripts/deck-office.mjs +1455 -14
  33. package/skills/dsh-ppt/scripts/deck-remix.mjs +471 -0
@@ -0,0 +1,124 @@
1
+ # 本地素材包编排、Mode C 混合深研与双向交付协议(Office Pack & Enterprise Workflow SOP)
2
+
3
+ 当用户交付本地混合素材(`.docx` / `.xlsx` / `.csv` / `.tsv` / `.pdf` / 照片截图 `.png`/`.jpg`/`.webp`),并附带特定呈现要求,或同时要求「结合外部权威资料补充对标」时,按本协议执行。
4
+
5
+ > **架构红线**:引擎保持 100% 离线、零新增依赖;外部权威检索由宿主 Agent(或 `dsh-cite`)完成,核验后的外部证据通过 `evidence[]` 与本地资料双轨融合并经 `SLOP-13` 审计。
6
+
7
+ ---
8
+
9
+ ## 一、Mode C 混合模式:本地资料 × 外部权威对标
10
+
11
+ 适用场景:用户提供了内部文档/财务表格/产品截图,但需要补充行业 TAM 规模、上市竞品财报、国家政策标准或第三方风险口径,或者给出了复杂定制编排指令(页数上限、重点章节、指定配图位置)。
12
+
13
+ ### 四步确定性流水线
14
+
15
+ 1. **先体检不盲出(`inspectOnly: true`)**:
16
+ 调用 `ppt_from_office({ filePath: "<文件或目录>", filePaths: [...], inspectOnly: true, instructions: "<用户原话要求>" })`(或 CLI `--from-office <path> --inspect-only`)。
17
+ 引擎以极低 Token 消耗返回 **Material Dossier(精炼素材档案)** 与 **`enrichmentPlan`**:
18
+ - `excelSheets[]`:每张表的行列维度、极值统计(`topMetrics`)、推荐图型(`recommendedLayout` / `recommendedChartKind`)与前 6 行预览;
19
+ - `docSections[]`:Word/PDF 章节提纲、表格维度、Mermaid/公式标记,以及 `.docx` 内嵌图片落盘缓存路径(`.dsh-ppt/office-media-cache/`);
20
+ - `photos[]`:每张图片的像素宽高、画幅方向、推荐角色与防裁歪 `recommendedFocalPoint`;
21
+ - `localEvidence[]`:本地文件自动编目为 `E1..Ek`(`origin: "local-file"`);
22
+ - `enrichmentPlan`:自动诊断已覆盖维度与缺失的外部支柱(`macro-market-tam` / `peer-benchmark` / `policy-standards` / `risk-counter-evidence`),给出带 `site:` / `filetype:pdf` / `-site:` 的权威检索式,以及**顺延起始编号 `nextEvidenceId`**(如 `E5`)。
23
+ 2. **宿主 Agent 开展 Tier 1/2 权威补充检索**:
24
+ 直接运行 `enrichmentPlan.recommendedQueries` / `missingPillars[].query`,只采信 Tier 1(政府/监管/财报/顶刊)与交叉印证的 Tier 2(权威咨询/行业机构),绝不将 Tier 3 自媒体/论坛标为 `verified`。
25
+ 3. **双轨标注证据账本(Zero-Conflict Hybrid Evidence)**:
26
+ 每条证据明确标清三大治理字段:
27
+ - `origin`: `'local-file'`(内部文件/报表) | `'web-research'`(外部权威检索)
28
+ - `tier`: `1`(一手官方/财报/顶刊) | `2`(主流研报/权威财经) | `3`(自媒体/二手转引,禁止单独作已核验定论)
29
+ - `claimType`: `'actual'`(历史实绩) | `'forecast'`(前瞻预测,上屏必须带「预计/预测/E」) | `'policy'`(政策/标准) | `'benchmark'`(行业对标基准)
30
+ 4. **精准建稿(两条路径)**:
31
+ - **定制编排(推荐)**:结合 Dossier 与外部 `evidence[]` 直接调 `ppt_create({ slides, evidence, evidenceAppendix: true, ... })`;
32
+ - **快速融合**:调 `ppt_from_office({ filePath, instructions, evidence: externalEvidence, evidenceAppendix: true, ... })`,引擎自动通过 `mergeHybridEvidence` 顺延外部 `[E#]` 编号避免冲突。
33
+
34
+ > 引擎自动在混源页脚注区分 `内部` 与 `外源T1/T2`(英文 `Internal` / `Ext·T1/T2`),演讲备注写入完整 URL 与口径,封底前 `evidenceAppendix: true` 自动生成双轨 `booktabs` 核验附录页。
35
+
36
+ ```json
37
+ {
38
+ "filePath": "materials/q3-review-pack",
39
+ "instructions": "控制 10 页,跳过目录,hero-factory.png 放封面,重点讲毛利率提升与竞品对标",
40
+ "bindDataModel": true,
41
+ "evidenceAppendix": true,
42
+ "evidence": [
43
+ {
44
+ "id": "E5",
45
+ "origin": "web-research",
46
+ "tier": 1,
47
+ "claimType": "benchmark",
48
+ "claim": "2025 年全球头部同行平均毛利率维持在 28.4%",
49
+ "source": "SEC 10-K Annual Filings",
50
+ "date": "2026-02",
51
+ "scope": "全球头部上市同行中位数",
52
+ "url": "https://www.sec.gov/edgar/example",
53
+ "confidence": "verified"
54
+ }
55
+ ]
56
+ }
57
+ ```
58
+
59
+ ---
60
+
61
+ ## 二、需求驱动的 Office / 照片智能编排
62
+
63
+ `ppt_from_office`(及 CLI `--from-office`)支持细粒度编排参数,避免「原样堆砌所有工作表与散落图片」:
64
+
65
+ | 参数(Tool / CLI) | 作用 | 示例 |
66
+ | --- | --- | --- |
67
+ | `instructions` / `--instructions` | 解析页数预算、跳过目录(`跳过目录`/`no agenda`)、指定图片归位与关键词加权 | `"控制 8 页,跳过目录,product.png 放封面,聚焦成本下降"` |
68
+ | `maxSlides` | 硬性页数上限:保留封面、封底,按 KPI/图表/焦点词权重精选核心页并保持原叙事顺序 | `maxSlides: 10` |
69
+ | `includeSheets` | 按工作表名或子串精准筛选 Excel 工作表 | `includeSheets: ["核心KPI", "毛利桥"]` |
70
+ | `photoRoles` | 显式覆盖每张照片的视觉角色(`cover` / `mockup` / `mockup-mobile` / `mockup-browser` / `gallery` / `full-bleed` / `section`) | `{"hero.png": "cover", "app.png": "mockup-mobile"}` |
71
+ | `bindDataModel: true` / `--bind-data` | 将 Excel/CSV 数值工作表自动注入 `dataModel` 并把主图表/KPI 绑定为 `{{metricId}}`,后续可直接用 `ppt_data` 无损刷新数字 | `bindDataModel: true` |
72
+
73
+ ### 照片画幅与焦距防裁歪规则(零依赖二进制头解析)
74
+
75
+ 引擎纯本地读取 `PNG` IHDR / `JPEG` SOF / `WebP` VP8 头部分析像素尺寸与宽高比(`landscape ≥ 1.15`、`portrait ≤ 0.85`、`square`):
76
+
77
+ - **人像 / 团队照防切头**:凡 `orientation === 'portrait'` 或文件名命中 `portrait / team / founder / ceo / speaker / avatar / 人像 / 团队 / 合影 / 头像 / 嘉宾`,一律自动设为 `focalPoint: 'top'`;手写 `slides` 编排人物照时同样必须显式设置 `image.focalPoint: 'top'`。
78
+ - **移动端截图 → `mockup[mobile]`**:文件名含 `mobile / phone / ios / android / app / 手机 / 移动端 / 小程序` 或窄竖屏(`aspectRatio ≤ 0.68`),自动套入灵动岛真机样机框。
79
+ - **桌面/看板截图 → `mockup[browser]`**:文件名含 `ui / screen / screenshot / dashboard / web / browser / console / 界面 / 截图 / 看板 / 工作台`,自动套入矢量浏览器样机框。
80
+ - **封面横图 → Hero Photo Split**:文件名含 `cover / hero / banner / 封面 / 主图` 且非竖屏,优先注入封面右半屏全出血主图。
81
+ - **其余实景图**:先按文件名关键词匹配正文页升级为 `image-right[framed]`,未匹配的多张图每 2–4 张聚合为 `image[gallery]` 整洁图集。
82
+
83
+ ---
84
+
85
+ ## 三、逆向 Office 导出、金页拼装、无损翻译与审阅回流
86
+
87
+ ### 1. 配套逆向导出(`exports[]` / CLI `--export`)
88
+
89
+ 在 `ppt_create`、`ppt_from_office`、`ppt_edit` 中传入 `exports` 数组(默认不额外落盘,严格保持三件套整洁):
90
+
91
+ | 导出 ID | 产物后缀 | 用途(零新增依赖) |
92
+ | --- | --- | --- |
93
+ | `'xlsx'` | `.xlsx` | 逆向 Excel 数据工作簿:含 `Summary` 总览页 + 各图表/表格/KPI/`treemap`/`gauge`/`pricing` 真数值工作表(`<c t="n">`)+ `Evidence_Ledger` 台账 |
94
+ | `'docx'` | `.docx` | 正式 Word 汇报文档:标准标题层级、正文要点、原生 `<w:tbl>` 表格与 `[E1..En]` 溯源附录 |
95
+ | `'qa-prep'` | `.qa-prep.md` | 会前高管质询与答辩预案:基于真实 KPI、超时页、冲突/估算/预测证据自动生成高频尖锐提问与作答思路 |
96
+ | `'memo'` | `.memo.md` | 高管散文体阅读备忘录(Amazon 6-Page 风格) |
97
+ | `'i18n'` | `.i18n.json` | 版式无损翻译槽位包(仅抽离可翻译文本,锁死版式/图表数值/嵌入图片与 `[E#]` 引用) |
98
+ | 其它已有交付物 | `'handout'` / `'one-pager'` / `'social-carousel'` / `'subtitles'` | 演讲讲义 `.handout.md`、高管一页纸 `.onepager.html`、4:5/1:1 社媒长图 `.carousel.html`、`.srt` 时间轴字幕 |
99
+
100
+ 工作台下载菜单同步支持直接下载 `.xlsx`、`.docx` 与 `.qa-prep.md`。
101
+
102
+ ### 2. 企业金页库(Slide Bank)与跨工程无损拼装(`mergeSources`)
103
+
104
+ - **收藏金页**:`ppt_edit({ deckPath, expectedRevision, saveToBank: { slide: 3, bankId: "q3-kpi", name: "核心经营大盘", tags: ["kpi", "board"] } })`(CLI `--edit deck.json --save-to-bank 3`),连同该页嵌入图片资产与关联 `[E#]` 证据持久化至 `.dsh-ppt/slide-bank.json`(上限 100 条;CLI `--list-bank` 列表)。
105
+ - **跨工程拼装**:`ppt_create({ title: "董事会汇报", mergeSources: [{ deckPath: "dept-a.json", slides: [2, 4] }, { bankIds: ["q3-kpi"] }], theme: "consulting" })`(CLI `--merge @sources.json`),自动完成图片 SHA-256 去重、跨工程 `[E1..En]` 证据编号无冲突重映射,并统一母版主题与品牌宪章。
106
+
107
+ ### 3. 100% 版式无损翻译与双语化(`translations` / `bilingualMode`)
108
+
109
+ 避免让 LLM 重写整份 `slides` JSON 导致丢图表或错位,严格按两步执行:
110
+ 1. 导出文案槽位:`ppt_edit({ deckPath, expectedRevision, exports: ['i18n'] })` → 读取 `.i18n.json`;
111
+ 2. 仅翻译 `fields` 中的自然语言后无损回填:
112
+ - **纯替换目标语**:`ppt_edit({ deckPath, expectedRevision, translations, targetLang: 'en', saveAs: true })`(CLI `--translate @en.json`);
113
+ - **中英双语安全对照**:附加 `bilingualMode: true`(CLI `--bilingual`),自动锁死纯数字单元格与字符上限,100% 保留原版式、图表、图片、品牌与 `[E#]` 证据。
114
+
115
+ ### 4. 分步动画(`reveal: 'step'`)与动效档位(`motionProfile`)
116
+
117
+ - 单页设置 `reveal: 'step'`(默认 `'all'`):HTML 放映按方向键/空格逐项显现卡片/条目,PPTX 同步写入原生 `<p:timing>` 多对象点击构建序列;
118
+ - 整套设置 `motionProfile: 'subtle' | 'executive' | 'keynote'`(CLI `--motion-profile`)调节动效节奏;严肃打印/归档仍传 `motion: 'off'`。
119
+
120
+ ### 5. 离线 `R` 键审阅批注 → AI 自动修订闭环
121
+
122
+ 1. 审阅人(老板/CFO/客户)在任意浏览器离线打开交付的 `.html` → 翻到目标页按 **`R`**(或点顶栏「批注 (R)」)输入审阅人名称与修改意见 → 点击 **「导出 Feedback JSON」** 下载 `review-feedback.json`;
123
+ 2. 将该文件交给 Agent,执行 `ppt_check({ deckPath: "deck.json", feedbackPath: "review-feedback.json" })`(CLI `--check deck.json --feedback review-feedback.json`);
124
+ 3. `ppt_check` 自动把每条批注转换为定位到精确页码与 `slideId` 的 `stakeholder-feedback` 告警,Agent 逐条用 `ppt_edit` 修订并复检交付。
@@ -1,60 +1,75 @@
1
- # 零资料深度调研、事实核验与策划出稿协议(Zero-Material Research-to-Deck)
1
+ # 深度调研、权威信源导航与事实核验协议(Research & Authority Protocol)
2
2
 
3
- 当用户**没有现成文档、表格或数据**,只给出一个主题并要求「你去搜资料、核对准确性、先策划 PPT 方案再生成」时,必须走本协议的四阶段流水线。
3
+ 当用户**没有现成文档/数据**(Mode B),或**有本地文件但要求补充行业规模/竞品财报/官方政策等外部权威对标**(Mode C)时,必须按本协议执行。
4
4
 
5
- > **架构红线**:`dsh-ppt` 引擎本身保持 100% 离线、零网络外联与零新增依赖;实时联网检索与一手网页阅读由**宿主 Agent 的联网搜索/浏览器工具**完成(学术场景可叠加 `dsh-cite`),校验后的结构化证据通过 `evidence[]` 证据账本交给 `dsh-ppt` 确定性绑定、审计(`SLOP-13`)并渲染成稿。
5
+ > **架构红线**:`dsh-ppt` 引擎保持 100% 离线、零网络外联与零新增依赖;实时联网检索与一手网页阅读由**宿主 Agent 的联网搜索/浏览器工具**完成(学术场景可叠加 `dsh-cite`),校验后的结构化证据通过 `evidence[]` 账本交给 `dsh-ppt` 进行代码级信源定级(`classifySourceAuthority`)、`SLOP-13` 深度审计与双轨溯源渲染。
6
6
 
7
7
  ---
8
8
 
9
- ## 一、双模路由判定(Mode A vs Mode B)
9
+ ## 一、三模路由判定(Tri-Mode Routing:Mode A / Mode B / Mode C)
10
10
 
11
- | 模式 | 触发条件 | 动作 |
11
+ | 模式 | 触发条件 | 核心动作 |
12
12
  | --- | --- | --- |
13
- | **Mode A:有资料直出** | 用户已提供大纲、文档、Excel/CSV/Word、参考 `.pptx` 或明确数字 | 零追问自动定调(`theme: 'auto'` / `exemplar: 'auto'`),直接出稿并做视觉验收 |
14
- | **Mode B:零资料深研策划** | 用户只给主题且无资料,或明确要求「先搜索资料 / 查准数据 / 出方案再做 PPT」 | 严格执行下方 **4 步闭环**:定向检索 → 双源交叉核验 → 策划方案确认 → 证据溯源成稿 |
13
+ | **Mode A:有资料直出** | 用户已给出完整大纲、文档、表格、参考 `.pptx` 或明确数据且无需外源对标 | 零追问自动定调(`theme: 'auto'` / `exemplar: 'auto'`),直接出稿并复核 |
14
+ | **Mode B:零资料深研策划** | 用户只给主题且无资料,或明确要求「先去搜资料、查准数据、出方案再做 PPT」 | 严格走 **4 步闭环**:调 `ppt_templates({ topic })` 拿 8 域权威检索式 → 3 轮定向检索与双源交叉核验 → 展示策划方案确认 → 带 `evidence[]` 成稿过 `SLOP-13` |
15
+ | **Mode C:混合资料 × 权威外源** | 用户给了本地 `.docx/.xlsx/.pdf/照片`,并要求结合外部权威行业数据、竞品或政策对标(或复杂编排要求) | 先调 `ppt_from_office({ inspectOnly: true })` 获取素材档案与 `enrichmentPlan`(详见 `references/office-pack.md`)→ 按顺延编号 `nextEvidenceId` 补齐 Tier 1/2 外源 `evidence[]` → 双轨融合出稿 |
15
16
 
16
17
  ---
17
18
 
18
- ## 二、四阶段执行协议
19
+ ## 二、v0.35 八大领域权威信源检索引擎(`buildAuthoritativeQueryPack`)
19
20
 
20
- ### Step 1:先调策划器定骨架 + 三轮定向检索(Research)
21
+ `ppt_templates({ topic })` / CLI `--plan` 与 `ppt_from_office({ inspectOnly: true })` 内置 `detectResearchDomain` + `buildAuthoritativeQueryPack`,自动将选题路由至 **8 大专业领域**,输出自带 **`site:` 权威白名单 + `filetype:pdf` 官方报告指令 + `-site:` 营销号排除清单** 的 3 轮检索式:
21
22
 
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 最新量产/政策节点、技术瓶颈、失败案例与机构预测分歧(避免一边倒的宣传稿)。
23
+ | 领域 ID | 覆盖场景 | Tier 1 一手权威域名白名单(示例) |
24
+ | --- | --- | --- |
25
+ | `gov-macro` | 宏观政务、规划与监管政策 | `gov.cn`, `stats.gov.cn`, `miit.gov.cn`, `ndrc.gov.cn`, `pbc.gov.cn`, `worldbank.org`, `imf.org`, `oecd.org` |
26
+ | `finance-filings` | 金融财报、估值与资本市场 | `sec.gov`, `hkexnews.hk`, `cninfo.com.cn`, `sse.com.cn`, `szse.cn`, `bis.org`, `federalreserve.gov` |
27
+ | `ai-tech` | AI、大模型、云计算与硬科技 | `caict.ac.cn`, `miit.gov.cn`, `nist.gov`, `arxiv.org`, `ieee.org`, `acm.org`, `nature.com`, `sec.gov` |
28
+ | `medical-clinical` | 医疗健康、临床与生物医药 | `who.int`, `pubmed.ncbi.nlm.nih.gov`, `nih.gov`, `fda.gov`, `nhc.gov.cn`, `nmpa.gov.cn`, `nejm.org`, `thelancet.com`, `bmj.com` |
29
+ | `energy-climate` | 新能源、电池、双碳与汽车 | `iea.org`, `irena.org`, `nea.gov.cn`, `miit.gov.cn`, `energy.gov`, `ipcc.ch`, `unep.org` |
30
+ | `academic-science` | 学术科研、答辩与工程基准 | `nature.com`, `science.org`, `arxiv.org`, `ieee.org`, `acm.org`, `springer.com`, `sciencedirect.com`, `pnas.org` |
31
+ | `consumer-retail` | 消费零售、品牌出海与电商 | `stats.gov.cn`, `mofcom.gov.cn`, `census.gov`, `sec.gov`, `hkexnews.hk`, `cninfo.com.cn` |
32
+ | `general-business` | 通用商业战略与行业研究 | `stats.gov.cn`, `gov.cn`, `sec.gov`, `hkexnews.hk`, `cninfo.com.cn`, `worldbank.org`, `oecd.org`, `imf.org` |
33
+
34
+ - **默认排除噪声域名(`NOISE_DOMAINS`,25 站)**:中文自动加 `-site:baijiahao.baidu.com -site:sohu.com -site:zhihu.com -site:163.com`(英文 `-site:medium.com -site:reddit.com -site:quora.com`),审计阶段同步覆盖 `mp.weixin.qq.com`、`toutiao.com`、`csdn.net`、`36kr.com`、`huxiu.com`、`tmtpost.com`、`xiaohongshu.com`、`weibo.com`、`eastmoney.com` 等 25 个自媒体/论坛/二手资讯域名。
35
+ - **工作区企业级信源治理(`.dsh-ppt/brand-kit.json`)**:
36
+ 通过 `ppt_absorb({ saveBrandKit: true, preferredSources: ["caict.ac.cn", "公司研究院"], blockedDomains: ["example-blog.com"] })` 持久化后:
37
+ - `preferredSources` 自动注入第 1 轮 `site:` 检索优先级,并在 `classifySourceAuthority` 中直接定级为 **Tier 1**;
38
+ - `blockedDomains` 自动追加至 `-site:` 排除列表,且在 `SLOP-13` 中强制按 `low-authority-source` 拦截。
30
39
 
31
- ### Step 2:一手优先与双源交叉核验(Fact-Check & Evidence Ledger)
40
+ ---
32
41
 
33
- 将搜集到的每条拟上屏事实整理为 `evidence[]` 账本,执行**三层信源分级与四条核验红线**:
42
+ ## 三、四阶段执行协议(Mode B)
34
43
 
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
+ ### Step 1:先调策划器定骨架 + 3 轮权威定向检索
44
45
 
45
- ### Step 3:向用户展示策划方案并确认(Plan Gate)
46
+ 1. 调 `ppt_templates({ topic: "<用户主题>", persona: "<可选画像>", lang: "zh" })`(或 CLI `--plan "<主题>"`),获取匹配标杆范本(20 套内置 + 工作区)、领域识别结果、`researchRounds`(含精准 `site:`/`filetype:pdf`/`-site:` 检索词)、`visualBriefs[]` 与逐页分镜蓝图(`storyboard`)。
47
+ 2. 用宿主 Agent 联网工具执行 **3 轮递进检索**:
48
+ - **Round 1(Tier 1 权威基线)**:部委/统计公报、SEC/港交所/巨潮年报、IEA/IMF/WHO/顶刊与 `filetype:pdf` 白皮书,锁定核心规模、增速、年份与地域口径。
49
+ - **Round 2(Tier 1–2 竞品与实测)**:同单位/同地域口径的头部上市同行财报、权威咨询机构(Gartner/IDC/McKinsey/TrendForce/GGII)基准;遇到媒体转引必须顺藤摸瓜核对原始官网链接。
50
+ - **Round 3(Tier 1–2 最新节点与反方风险)**:最新政策标准、落地瓶颈、失败案例与机构预测分歧;预测数字标 `claimType: "forecast"`。
46
51
 
47
- 在搜集并核验完毕后,**先向用户输出结构化策划方案,再生成 PPT**(除非用户已明确指示「搜完直接出稿,不用问我」):
52
+ ### Step 2:代码级信源定级(`classifySourceAuthority`)与核验红线
48
53
 
49
- 1. **核心叙事主线与风格定位**:目标听众、推荐标杆范本(如 `daylight-earnings-research` / `mckinsey-strategy`)、主题色与预计页数/演讲时长;
50
- 2. **核验后的核心事实账本摘要(`E1..En`)**:列出关键数字、一手出处、年份口径及核验状态(含任何已发现的口径分歧或待补项);
51
- 3. **逐页分镜策划表(Storyboard)**:页码、叙事角色、结论先行标题(Action Title)、拟用版式、绑定证据 `[E#]`(可直接调用 `ppt_templates({ topic, evidence })` 自动生成 `planMarkdown` 并补齐真实标题)。
54
+ 每条拟上屏证据整理为结构化 `evidence[]` 条目(完整字段见下例),引擎通过 `classifySourceAuthority` 自动定级:
52
55
 
53
- 等待用户确认或微调页数/口径/侧重点后,进入 Step 4。
56
+ - **Tier 1(直接采信)**:`local-file` 本地一手原件、政府/监管/央行/统计局、SEC/港交所/交易所财报、国际组织(WHO/IEA/IMF/World Bank/OECD/IPCC)、顶刊论文与工作区 `preferredSources`。
57
+ - **Tier 2(须交叉印证)**:主流咨询/行研机构(Gartner/IDC/McKinsey/BCG/Bain/PwC/Deloitte/TrendForce/GGII/Nielsen/Kantar/BNEF)与权威财经媒体(FT/Reuters/Bloomberg/Economist/财新)。
58
+ - **Tier 3(禁止单独作为 `verified` 依据)**:25 个 `NOISE_DOMAINS` 自媒体/论坛/二手资讯站及工作区 `blockedDomains`。
59
+ - **四条核验红线**:
60
+ 1. **关键大数字双源或一手定位**:严禁混拼全球与中国口径、出货量与装机量;外源必须带准确 `date`(如 `"2026-01"` / `"2025"`)。
61
+ 2. **预测与实绩清晰分轨**:前瞻预测必须传 `claimType: "forecast"` 并在画面可见文案标注 `预计 / 预测 / 2028E / Forecast`。
62
+ 3. **冲突报区间、缺数改定性**:多方口径差异设为 `confidence: "conflicting"` 并在画面写区间;查无确凿数字一律降级为定性图示(`comparison` / `issue-tree` / `architecture` / `process` / `matrix`),严禁编造小数。
63
+ 4. **禁用空洞假出处与二手冒充一手**:禁止「网络整理 / 公开资料 / 综合整理 / Internet」,且禁止名义写权威机构却挂自媒体转引 URL。
54
64
 
55
- ### Step 4:带证据账本成稿与 SLOP-13 门禁交付(Grounded Build)
65
+ ### Step 3:向用户展示策划方案并确认(Plan Gate)
56
66
 
57
- 调用 `ppt_create`(或 CLI `build-deck.mjs`),一次性传入核验后的 `evidence[]`、`evidenceAppendix: true`、`exemplar`、`alignOrder: true` 与带 `evidenceIds: ["E1", ...]`(或内联 `[E1]`)的 `slides[]`:
67
+ 检索核验后先输出结构化策划方案待确认(除非用户明确指示直接出稿):
68
+ 1. 核心叙事主线、目标受众、推荐标杆范本、主题与页数/时长预算;
69
+ 2. 核验后的核心证据账本摘要(`E1..En`,含来源级别 `T1/T2`、年份口径与冲突说明);
70
+ 3. 逐页分镜策划表(可调 `ppt_templates({ topic, evidence })` 自动诊断缺口并生成 `planMarkdown`)。
71
+
72
+ ### Step 4:带证据账本成稿与 `SLOP-13` 深度门禁交付
58
73
 
59
74
  ```json
60
75
  {
@@ -65,62 +80,78 @@
65
80
  "evidence": [
66
81
  {
67
82
  "id": "E1",
68
- "claim": "2025 年全球半固态电池出货量突破 12 GWh,中国车企装车贡献超 75%",
69
- "source": "GGII 高工产研《2025 固态电池产业蓝皮书》",
83
+ "origin": "web-research",
84
+ "tier": 1,
85
+ "claimType": "actual",
86
+ "claim": "2025 年全球动力电池装车量达 894 GWh,固态路线进入中试放量期",
87
+ "source": "IEA Global EV Outlook",
70
88
  "date": "2026-01",
71
- "scope": "全球出货口径",
72
- "url": "https://example.org/ggii-solid-state-2025",
89
+ "scope": "全球动力电池口径",
90
+ "url": "https://www.iea.org/reports/global-ev-outlook-2026",
73
91
  "confidence": "verified"
74
92
  },
75
93
  {
76
94
  "id": "E2",
77
- "claim": "全固态电芯小批量装车验证集中于 2027 年,规模化降本至 <0.6 元/Wh 预计需至 2030 年前后",
78
- "source": "中汽协 & TrendForce 联合口径对比",
95
+ "origin": "web-research",
96
+ "tier": 2,
97
+ "claimType": "forecast",
98
+ "claim": "预计 2030E 全固态电芯规模化成本区间为 0.55–0.72 元/Wh",
99
+ "source": "TrendForce 集邦咨询研究报告",
79
100
  "date": "2026-02",
80
101
  "scope": "全固态硫化物路线",
102
+ "url": "https://www.trendforce.com/presscenter/example",
81
103
  "confidence": "conflicting",
82
- "note": "车企官方规划偏乐观(2027),供应链普遍预计量产平价在 2030 年"
104
+ "note": "车企官方规划偏乐观(2027),供应链预计平价窗口在 2030E"
83
105
  }
84
106
  ],
85
107
  "slides": [
86
108
  {
87
109
  "layout": "kpi",
88
110
  "kicker": "01 · 产业拐点",
89
- "title": "半固态已跨越 12 GWh 商用门槛,全固态平价仍需 3–4 年攻坚",
111
+ "title": "全球装车迈过 894 GWh,2030E 全固态平价预计落在 0.55–0.72 元/Wh 区间",
90
112
  "evidenceIds": ["E1", "E2"],
91
113
  "items": [
92
- { "tag": "2025 全球出货", "value": "12+ GWh", "delta": "中国占 >75% [E1]" },
93
- { "tag": "全固态验证窗口", "value": "2027–2030", "delta": "多机构预测区间 [E2]" }
114
+ { "tag": "2025 全球装车", "value": "894 GWh", "delta": "IEA 一手年报 [E1]" },
115
+ { "tag": "2030E 预计成本区间", "value": "0.55–0.72 元/Wh", "delta": "多机构口径区间 [E2]" }
94
116
  ],
95
- "takeaway": "半固态率先贡献出货增量;全固态在车企与供应链口径间存在 2–3 年量产预期差。"
117
+ "takeaway": "实绩数据源自 IEA [E1];全固态 2030E 成本为预测口径区间 [E2],需持续跟踪硫化物良率。"
96
118
  }
97
119
  ]
98
120
  }
99
121
  ```
100
122
 
101
- ### 引擎自动为你完成的 4 件事(零模型确定性保障)
123
+ ---
124
+
125
+ ## 四、`SLOP-13` 事实出处与权威信源静态门禁(9 项确定性审计)
102
126
 
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` 出处。
127
+ `ppt_check` 与生成前审计自动执行以下 9 项零误报检查:
128
+
129
+ | 规则代码 | 拦截场景 | 修复动作 |
130
+ | --- | --- | --- |
131
+ | `dangling-evidence-ref` | 页面引用了 `evidence[]` 中不存在的 `[E99]` | 补齐对应条目或移除悬空引用 |
132
+ | `unverified-evidence-claim` | 引用 `unverified`/`conflicting` 证据,但画面未说明口径差异/区间/待核实 | 完成双源核验,或在标题/`takeaway`/正文中显式标注区间与口径 |
133
+ | `vague-placeholder-source` | 出现「网络整理 / 公开资料 / 综合整理 / Internet」等空洞假出处 | 替换为真实机构、报告名与年份 |
134
+ | `unsourced-research-numbers` | 启用 `evidence[]` 时,量化页(含 `kpi`/`chart`/`treemap`/`gauge` 等)既无 `[E#]` 也无有效 `source` | 绑定 `evidenceIds` 或改用定性版式 |
135
+ | `secondary-relay-source` | **v0.35**:`source` 声称 T1/T2 权威机构,但 `url` 实际指向自媒体/资讯站等 T3 二手转引域名 | 追溯原机构官网/PDF 链接,或在 `source`/`note` 中注明「媒体转引」 |
136
+ | `low-authority-source` | **v0.35**:属于 Tier 3 噪声站或工作区 `blockedDomains` 却标成 `verified` 且无口径免责 | 替换为 Tier 1/2 一手权威源,或改为 `estimated` 并如实标注 |
137
+ | `unmarked-forecast-claim` | **v0.35**:`claimType: 'forecast'` 预测数据上屏,却未在可见文案标注「预计 / 预测 / E / Forecast」 | 在标题、指标或 `takeaway` 中显式区分预测值与历史实绩 |
138
+ | `missing-external-date` | **v0.35**:`origin: 'web-research'` 且 `confidence: 'verified'` 的外部权威数据缺少 `date` | 补齐准确年份或季度(如 `"2026-Q1"` / `"2025"`) |
139
+ | `stale-evidence-date` | **v0.35**:外部基准数据年份距今 ≥ 4 年,且未注明「历史基线 / 演变回溯」 | 替换为近 2 年最新数据,或在页面中注明历史基线对比 |
140
+
141
+ > 引擎同时自动完成:单行精简脚注注入(混源时标注 `内部` vs `外源T1/T2`)、演讲备注完整 URL/口径溯源卡、封底前零溢出 4 列 `booktabs` 附录页(`evidenceAppendix: true`)以及讲义 `.handout.md` / `.xlsx` / `.docx` 同步附带完整证据台账。
111
142
 
112
143
  ---
113
144
 
114
- ## 三、裸 CLI 用法速查
145
+ ## 五、裸 CLI 用法速查
115
146
 
116
147
  ```bash
117
- # 1. 先按主题生成 3 轮调研清单 + 逐页分镜策划表
148
+ # 1. Mode B:按选题自动识别 8 大领域并生成 3 轮权威 site: 检索包 + 分镜策划表
118
149
  node skills/dsh-ppt/scripts/build-deck.mjs --plan "2026 固态电池商业化进展与产业研报" --lang zh
119
150
 
120
- # 2. 检索并核验后,带已核验 evidence.json 重新检查量化槽位缺口
121
- node skills/dsh-ppt/scripts/build-deck.mjs --plan "2026 固态电池商业化进展与产业研报" --evidence @evidence.json --lang zh
151
+ # 2. Mode C:先体检本地素材包,拿 Material Dossier + 外部权威顺延检索计划
152
+ node skills/dsh-ppt/scripts/build-deck.mjs --from-office ./materials --inspect-only --instructions "控制10页,补充行业规模与竞品对标"
122
153
 
123
- # 3. 确认方案后,带证据账本 + 附录三线表 + 讲义一键出稿
154
+ # 3. 核验确认后带证据账本 + 附录三线表 + 配套逆向导出出稿
124
155
  node skills/dsh-ppt/scripts/build-deck.mjs \
125
156
  --title "2026 固态电池商业化进展与产业研报" \
126
157
  --slides @slides.json \
@@ -128,6 +159,6 @@ node skills/dsh-ppt/scripts/build-deck.mjs \
128
159
  --align-order \
129
160
  --evidence @evidence.json \
130
161
  --evidence-appendix \
131
- --handout \
162
+ --export xlsx,docx,qa-prep,handout \
132
163
  --out dist
133
164
  ```
@@ -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, buildResearchPlan } from './deck-advanced.mjs'
20
+ import { buildDeckAsync, listTemplates, editDeck, remixDeck, undoDeck, checkDeckAsync, renderDeck, absorbPptx, importPptxDeck, importOfficeDeck, listAllTasteRecipes, listCuratedExemplars, loadWorkspaceExemplars, ingestExemplarCorpus, buildResearchPlan, saveWorkspaceBrandKit, loadWorkspaceBrandKit, listSlideBank, mergeDecks } from './deck-advanced.mjs'
21
21
 
22
22
  const HELP = `dsh-ppt —— 一句话 / 一篇文档 → HTML 放映 + PPTX 导出
23
23
 
@@ -46,13 +46,30 @@ const HELP = `dsh-ppt —— 一句话 / 一篇文档 → HTML 放映 + PPTX 导
46
46
  --list-tastes 列出内置 8 套大师审美配方及当前工作区已吸收的标杆配方
47
47
  --absorb <deck.pptx> 只读检查并输出参考 .pptx 的净化主题、推荐内置主题/骨架、深度审美配方 styleRecipe 与逐页分布 JSON
48
48
  --import-pptx <path> 导入外部 .pptx 全量内容(标题/要点/表格/图表/图片/备注)并一键翻新为 dsh-ppt 工程
49
- --from-office <path> 直吞 .xlsx / .csv / .tsv / .docx 数据表或 Word 报告,自动画像并生成全套文稿
49
+ --from-office <path> 直吞 .xlsx / .csv / .tsv / .docx / .pdf 或本地混合素材目录,自动画像并生成全套文稿(多文件自动生成证据溯源账本)
50
+ --inspect-only 配合 --from-office 使用:仅输出精炼素材档案与 Mode C 权威外源补充检索计划(不直接出稿)
51
+ --instructions <text> 配合 --from-office 使用:自然语言呈现要求(如 "控制8页,跳过目录,product.png放封面")
52
+ --bind-data 配合 --from-office 使用:自动把 Excel 数值工作表绑定进 dataModel 供后续 ppt_data 实时刷新
53
+ --export <list> 可选附加导出(逗号分隔):xlsx,docx,qa-prep,memo,i18n,handout,one-pager,social-carousel,subtitles
54
+ --merge <json|@path> 跨工程拼装器:传入 sources[](deckPath + slides 或 bankIds)自动去重资产与重映射 [E#] 证据
55
+ --save-to-bank <slide> 配合 --edit 将指定页码/ID 收藏至 .dsh-ppt/slide-bank.json 企业金页库
56
+ --list-bank 列出 .dsh-ppt/slide-bank.json 已收藏金页
57
+ --translate <json|@path> 配合 --edit 无损应用翻译包(保持 100% 原版式/图表/图片)
58
+ --bilingual 配合 --translate 输出中英双语对照版
59
+ --feedback <path> 配合 --check 读取 HTML 按 R 导出的 review-feedback.json 审阅批注
60
+ --motion-profile <id> 动效档位:subtle / executive / keynote
50
61
  --sync-pptx <path> 将 Office 修改后的 .pptx 内容回导同步至已有工程(自动写入 .history/ 支持撤销)
51
62
  --target-project <dir> 配合 --sync-pptx 指定目标工程目录(或传 --edit <deck.json>)
52
63
  --preserve-theme 配合 --import-pptx 使用,保留原 .pptx 净化后的品牌配色与 Logo
53
64
  --no-modernize 配合 --import-pptx/--sync-pptx 关闭自动版式升维
65
+ --save-brand-kit <json|@path> 将企业品牌宪章锁持久化至 .dsh-ppt/brand-kit.json(支持配合 --absorb 直接传 true)
66
+ --no-brand-kit 本次建稿忽略工作区已锁定的 .dsh-ppt/brand-kit.json
67
+ --remix <deck.json> 多受众智能压缩改编(默认另存副本,被折叠页要点无损归档至备注)
68
+ --preset <id> 配合 --remix 指定目标受众预设:exec-5min / board-brief / sales-pitch
54
69
  --handout 同时生成 <file>.handout.md 演讲者讲义与逐字稿文件
55
70
  --one-pager 同时生成 <file>.onepager.html 高管一页纸战报(默认不额外写盘,可在检查面板离线导出)
71
+ --social-carousel [4:5|1:1] 同时导出 <file>.carousel.html 社媒竖版/方形长图卡片(小红书/LinkedIn/微信)
72
+ --subtitles [srt|vtt] 同时导出 <file>.srt 或 <file>.vtt 配音时间轴字幕文件
56
73
  --target-minutes <n> 指定演讲目标总时长(分钟),计算逐页配速预算并标记超预算页
57
74
  --smart-layout 显式开启多版式叙事节奏自动升维(配合 --no-smart-layout 可关闭)
58
75
  --brand <json|@path> 品牌主辅颜色、标题/正文字体、封面反白、Logo、页脚、chromeStyle
@@ -129,12 +146,41 @@ export function parseArgv(argv) {
129
146
  else if (key === '--absorb') args.absorb = nextValue()
130
147
  else if (key === '--import-pptx') args.importPptx = nextValue()
131
148
  else if (key === '--from-office') args.fromOffice = nextValue()
149
+ else if (key === '--inspect-only') args.inspectOnly = true
150
+ else if (key === '--instructions') args.instructions = nextValue()
151
+ else if (key === '--bind-data') args.bindData = true
152
+ else if (key === '--export') args.exports = nextValue().split(',').map(s => s.trim()).filter(Boolean)
153
+ else if (key === '--merge') args.merge = readJson(nextValue())
154
+ else if (key === '--save-to-bank') args.saveToBank = nextValue()
155
+ else if (key === '--list-bank') args.listBank = true
156
+ else if (key === '--translate') args.translate = readJson(nextValue())
157
+ else if (key === '--bilingual') args.bilingual = true
158
+ else if (key === '--feedback') args.feedback = nextValue()
159
+ else if (key === '--motion-profile') args.motionProfile = nextValue()
132
160
  else if (key === '--sync-pptx') args.syncPptx = nextValue()
133
161
  else if (key === '--target-project') args.targetProject = nextValue()
134
162
  else if (key === '--preserve-theme') args.preserveTheme = true
135
163
  else if (key === '--no-modernize') args.modernize = false
164
+ else if (key === '--save-brand-kit') {
165
+ const peek = inline !== null ? inline : argv[i + 1]
166
+ if (peek !== undefined && !String(peek).startsWith('--')) args.saveBrandKit = nextValue()
167
+ else args.saveBrandKit = true
168
+ }
169
+ else if (key === '--no-brand-kit') args.useBrandKit = false
170
+ else if (key === '--remix') args.remix = nextValue()
171
+ else if (key === '--preset') args.preset = nextValue()
136
172
  else if (key === '--handout') args.handout = true
137
173
  else if (key === '--one-pager') args.onePager = true
174
+ else if (key === '--social-carousel') {
175
+ const peek = inline !== null ? inline : argv[i + 1]
176
+ if (peek === '4:5' || peek === '1:1') args.socialCarousel = nextValue()
177
+ else args.socialCarousel = '4:5'
178
+ }
179
+ else if (key === '--subtitles') {
180
+ const peek = inline !== null ? inline : argv[i + 1]
181
+ if (peek === 'srt' || peek === 'vtt') args.subtitles = nextValue()
182
+ else args.subtitles = 'srt'
183
+ }
138
184
  else if (key === '--target-minutes') args.targetMinutes = Number(nextValue())
139
185
  else if (key === '--brand') args.brand = readJson(nextValue())
140
186
  else if (key === '--data-model') args.dataModel = readJson(nextValue())
@@ -185,7 +231,9 @@ export async function main(argv = process.argv.slice(2), io = {}) {
185
231
  if (args.listTemplates) { log(JSON.stringify({ templates: listTemplates(args.lang) }, null, 2)); return 0 }
186
232
  if (args.listTastes) { log(JSON.stringify({ tasteRecipes: listAllTasteRecipes(process.cwd()) }, null, 2)); return 0 }
187
233
  if (args.listExemplars) { log(JSON.stringify({ exemplars: listCuratedExemplars(loadWorkspaceExemplars(process.cwd())) }, null, 2)); return 0 }
234
+ if (args.listBank) { log(JSON.stringify(listSlideBank(process.cwd()), null, 2)); return 0 }
188
235
  if (args.plan) {
236
+ const kit = loadWorkspaceBrandKit(process.cwd())
189
237
  const plan = buildResearchPlan({
190
238
  topic: args.plan,
191
239
  persona: args.persona,
@@ -193,15 +241,49 @@ export async function main(argv = process.argv.slice(2), io = {}) {
193
241
  evidence: args.evidence,
194
242
  lang: args.lang,
195
243
  workspaceExemplars: loadWorkspaceExemplars(process.cwd()),
244
+ preferredSources: kit?.preferredSources,
245
+ blockedDomains: kit?.blockedDomains,
196
246
  })
197
247
  log(JSON.stringify(plan, null, 2))
198
248
  return 0
199
249
  }
250
+ if (args.merge) {
251
+ const merged = await mergeDecks({
252
+ sources: Array.isArray(args.merge) ? args.merge : args.merge.sources,
253
+ title: args.title || undefined,
254
+ theme: args.theme,
255
+ lang: args.lang,
256
+ motion: args.motion,
257
+ motionProfile: args.motionProfile,
258
+ outputDir: resolvePath(args.out || '.'),
259
+ fileName: args.file || undefined,
260
+ overwrite: args.overwrite === true,
261
+ exports: args.exports,
262
+ cwd: process.cwd(),
263
+ })
264
+ log(JSON.stringify(merged, null, 2))
265
+ return 0
266
+ }
200
267
  if (args.ingestExemplars) {
201
268
  const report = await ingestExemplarCorpus({ dirPath: args.ingestExemplars, cwd: process.cwd() })
202
269
  log(JSON.stringify(report, null, 2))
203
270
  return 0
204
271
  }
272
+ if (args.saveBrandKit && !args.absorb) {
273
+ const rawKit = typeof args.saveBrandKit === 'string' ? readJson(args.saveBrandKit) : {}
274
+ const saved = saveWorkspaceBrandKit(process.cwd(), rawKit)
275
+ log(JSON.stringify(saved, null, 2))
276
+ return 0
277
+ }
278
+ if (args.remix) {
279
+ const remixed = await remixDeck({
280
+ deckPath: args.remix,
281
+ preset: args.preset || 'exec-5min',
282
+ expectedRevision: args.revision,
283
+ })
284
+ log(JSON.stringify(remixed, null, 2))
285
+ return 0
286
+ }
205
287
  if ([args.edit && !args.syncPptx ? args.edit : null, args.undo, args.check, args.render, args.absorb, args.importPptx, args.syncPptx, args.fromOffice].filter(Boolean).length > 1) {
206
288
  throw new Error('dsh-ppt CLI:--edit / --undo / --check / --render / --absorb / --import-pptx / --sync-pptx / --from-office 只能选择一项')
207
289
  }
@@ -219,6 +301,12 @@ export async function main(argv = process.argv.slice(2), io = {}) {
219
301
  ...(args.chrome ? { chromeStyle: args.chrome } : {}),
220
302
  ...(args.lang ? { lang: args.lang } : {}),
221
303
  ...(args.motion ? { motion: args.motion } : {}),
304
+ ...(args.motionProfile ? { motionProfile: args.motionProfile } : {}),
305
+ ...(args.inspectOnly ? { inspectOnly: true } : {}),
306
+ ...(args.instructions ? { instructions: args.instructions } : {}),
307
+ ...(args.bindData ? { bindDataModel: true } : {}),
308
+ ...(args.evidence !== undefined ? { evidence: args.evidence } : {}),
309
+ ...(args.exports ? { exports: args.exports } : {}),
222
310
  ...(args.targetMinutes !== undefined ? { targetMinutes: args.targetMinutes } : {}),
223
311
  overwrite: args.overwrite === true,
224
312
  handout: args.handout === true,
@@ -252,16 +340,20 @@ export async function main(argv = process.argv.slice(2), io = {}) {
252
340
  return 0
253
341
  }
254
342
  if (args.absorb) {
343
+ const saveBk = args.saveBrandKit === true
344
+ ? true
345
+ : (typeof args.saveBrandKit === 'string' && args.saveBrandKit !== 'true' ? readJson(args.saveBrandKit) : (args.saveBrandKit === 'true' ? true : undefined))
255
346
  const absorbed = await absorbPptx({
256
347
  pptxPath: args.absorb,
257
348
  ...(args.saveTaste ? { saveTasteAs: args.saveTaste } : {}),
258
349
  ...(args.saveExemplar ? { saveExemplarAs: args.saveExemplar } : {}),
350
+ ...(saveBk !== undefined ? { saveBrandKit: saveBk } : {}),
259
351
  })
260
352
  log(JSON.stringify(absorbed, null, 2))
261
353
  return 0
262
354
  }
263
355
  if (args.check) {
264
- const report = await checkDeckAsync({ deckPath: args.check, renderReceipt: args.renderReceipt })
356
+ const report = await checkDeckAsync({ deckPath: args.check, renderReceipt: args.renderReceipt, ...(args.feedback ? { feedbackPath: args.feedback } : {}) })
265
357
  log(JSON.stringify(report, null, 2)); return report.ok && (args.renderReceipt === undefined || report.render?.status === 'rendered') ? 0 : 1
266
358
  }
267
359
  if (args.render) {
@@ -273,6 +365,9 @@ export async function main(argv = process.argv.slice(2), io = {}) {
273
365
  : args.brand
274
366
 
275
367
  if (args.edit || args.undo) {
368
+ const bankSlideRef = args.saveToBank !== undefined
369
+ ? (/^\d+$/.test(String(args.saveToBank)) ? Number(args.saveToBank) : String(args.saveToBank))
370
+ : undefined
276
371
  const result = args.edit
277
372
  ? await editDeck({
278
373
  deckPath: args.edit,
@@ -281,6 +376,10 @@ export async function main(argv = process.argv.slice(2), io = {}) {
281
376
  ...(args.taste ? { taste: args.taste } : {}),
282
377
  referencePptx: args.referencePptx,
283
378
  brand: effectiveBrand,
379
+ ...(args.motionProfile ? { motionProfile: args.motionProfile } : {}),
380
+ ...(bankSlideRef !== undefined ? { saveToBank: { slide: bankSlideRef } } : {}),
381
+ ...(args.translate !== undefined ? { translations: args.translate, bilingualMode: args.bilingual === true } : {}),
382
+ ...(args.exports ? { exports: args.exports } : {}),
284
383
  ...(args.targetMinutes !== undefined ? { targetMinutes: args.targetMinutes } : {}),
285
384
  expectedRevision: args.revision,
286
385
  })
@@ -317,6 +416,8 @@ export async function main(argv = process.argv.slice(2), io = {}) {
317
416
  smartLayout: args.smartLayout,
318
417
  lang: args.lang,
319
418
  motion: args.motion,
419
+ ...(args.motionProfile ? { motionProfile: args.motionProfile } : {}),
420
+ ...(args.exports ? { exports: args.exports } : {}),
320
421
  outputDir: resolvePath(args.out || '.'),
321
422
  fileName: args.file,
322
423
  overwrite: args.overwrite,
@@ -325,8 +426,11 @@ export async function main(argv = process.argv.slice(2), io = {}) {
325
426
  dataModel: args.dataModel,
326
427
  ...(args.evidence !== undefined ? { evidence: args.evidence } : {}),
327
428
  ...(args.evidenceAppendix ? { evidenceAppendix: true } : {}),
429
+ ...(args.useBrandKit === false ? { useBrandKit: false } : {}),
328
430
  ...(args.handout ? { handout: true } : {}),
329
431
  ...(args.onePager ? { onePager: true } : {}),
432
+ ...(args.socialCarousel ? { socialCarousel: args.socialCarousel } : {}),
433
+ ...(args.subtitles ? { subtitles: args.subtitles } : {}),
330
434
  ...(args.targetMinutes !== undefined ? { targetMinutes: args.targetMinutes } : {}),
331
435
  }
332
436
  const result = await buildDeckAsync(options)
@@ -336,6 +440,8 @@ export async function main(argv = process.argv.slice(2), io = {}) {
336
440
  log(' Manifest :' + result.jsonPath)
337
441
  if (result.handoutPath) log(' 讲义 Handout:' + result.handoutPath)
338
442
  if (result.onePagerPath) log(' 高管一页纸:' + result.onePagerPath)
443
+ if (result.carouselPath) log(' 社媒长图卡片:' + result.carouselPath)
444
+ if (result.subtitlesPath) log(' 配音字幕:' + result.subtitlesPath)
339
445
  if (result.deliveryStatus === 'draft') log(' 草稿:还有待填写内容,不可作为成品交付。')
340
446
  log(' 质量检查:' + result.quality.errorCount + ' 个错误 / ' + result.quality.warningCount + ' 个提醒;修订号 ' + result.revision)
341
447
  return 0