dsh-ppt 0.34.0 → 0.36.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 +31 -0
- package/README.en.md +14 -17
- package/README.md +14 -17
- package/docs/USAGE.en.md +44 -35
- package/docs/USAGE.md +45 -36
- package/docs/VALIDATION.md +4 -0
- package/docs/assets/intro/screen-en.webp +0 -0
- package/docs/assets/intro/screen-zh.webp +0 -0
- package/docs/assets/intro/workflow-en-dark.svg +1 -1
- package/docs/assets/intro/workflow-en-light.svg +1 -1
- package/docs/assets/intro/workflow-en-mobile-dark.svg +1 -1
- package/docs/assets/intro/workflow-en-mobile-light.svg +1 -1
- package/docs/assets/intro/workflow-zh-dark.svg +1 -1
- package/docs/assets/intro/workflow-zh-light.svg +1 -1
- package/docs/assets/intro/workflow-zh-mobile-dark.svg +1 -1
- package/docs/assets/intro/workflow-zh-mobile-light.svg +1 -1
- package/lib/client.js +333 -45
- package/lib/execution.js +20 -2
- package/lib/tools.js +64 -2
- package/lib/types.d.ts +58 -1
- package/lib/workbench.js +18 -2
- package/package.json +2 -2
- package/skills/dsh-ppt/SKILL.md +34 -32
- package/skills/dsh-ppt/package.json +1 -1
- package/skills/dsh-ppt/references/office-pack.md +124 -0
- package/skills/dsh-ppt/references/research-plan.md +93 -62
- package/skills/dsh-ppt/scripts/build-deck.mjs +60 -2
- package/skills/dsh-ppt/scripts/deck-absorb.mjs +2 -0
- package/skills/dsh-ppt/scripts/deck-advanced.mjs +198 -29
- package/skills/dsh-ppt/scripts/deck-brand-kit.mjs +13 -0
- package/skills/dsh-ppt/scripts/deck-charts-exec.mjs +805 -0
- package/skills/dsh-ppt/scripts/deck-chrome.mjs +10 -1
- package/skills/dsh-ppt/scripts/deck-compose.mjs +386 -0
- package/skills/dsh-ppt/scripts/deck-core.mjs +128 -14
- package/skills/dsh-ppt/scripts/deck-delivery.mjs +141 -3
- package/skills/dsh-ppt/scripts/deck-evidence.mjs +811 -118
- package/skills/dsh-ppt/scripts/deck-export.mjs +652 -0
- package/skills/dsh-ppt/scripts/deck-i18n.mjs +170 -0
- package/skills/dsh-ppt/scripts/deck-layouts.mjs +72 -8
- package/skills/dsh-ppt/scripts/deck-office.mjs +833 -38
package/skills/dsh-ppt/SKILL.md
CHANGED
|
@@ -1,85 +1,87 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: dsh-ppt
|
|
3
|
-
description: "Turn one sentence, a zero-material research topic, a Markdown document, structured slides, Office
|
|
3
|
+
description: "Turn one sentence, a zero-material research topic, a Markdown document, structured slides, mixed Office/photo packs (.xlsx/.csv/.docx/.pdf/.png), or a benchmark .pptx corpus into a world-class presentation deck: standalone HTML web slideshow (with Dual-Screen Presenter Console, Executive One-Pager, Ctrl+K Jump, D Pen, T Timer, A Auto-Tour & R Offline Review Feedback) + 100% native-editable PPTX (with Tri-Mode Routing A/B/C, 8-Domain Authoritative Research Query Engine & SLOP-13/14 Compliance Gates, 20 Curated Gold Exemplars & Zero-LLM Self-Repair Loop, 41 canonical native-editable layouts + 53 aliases including MECE issue-tree, squarified treemap, Stephen Few OKR gauge, Good/Better/Best pricing, World/China dotted maps, 2.5D isometric stack/pillars, Mermaid connectors, native <m:oMath> formulas, 9-language code terminals, device mockups, Magic Quadrant, Radar, Dumbbell, Heatmap, Marimekko, Sankey, Value Chain & SWOT) + project manifest + reverse companion exports (.xlsx/.docx/.qa-prep.md/.memo.md/.i18n.json), Workspace Slide Bank & Multi-Deck Composer, and 100% layout-lossless i18n. Supports 13 tools, 24 themes, 6 Master Chrome Skeletons, 8 Taste Recipes, 20 industry blueprints, 13 publication-grade charts, and 61 native <a:custGeom> vector icons. 中文:支持三模路由(直出 / 零资料 8 域权威深研 / Mode C 本地多源+外源对标)、41 种原生可编辑图谱、企业品牌宪章锁(SLOP-13/14)、逆向导出 Excel/Word/答辩预案/无损翻译包与离线 R 键审阅回流。"
|
|
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
|
---
|
|
7
7
|
|
|
8
8
|
# dsh-ppt
|
|
9
9
|
|
|
10
|
-
|
|
10
|
+
一句话、一篇文档、一组混合 Office/照片素材包或一份参考 `.pptx` → **大师级可交付演示文稿(独立 HTML 网页放映 + 100% 原生可编辑 PPTX + 工程 JSON + 可选配套 `.xlsx`/`.docx`/`.qa-prep.md`/`.memo.md`/`.i18n.json`)**。本文件负责审美总纲、三模路由与交付纪律;具体语法与专项 SOP 按需读取 `references/`。
|
|
11
11
|
|
|
12
12
|
## 触发条件
|
|
13
13
|
|
|
14
|
-
用户要做 PPT / 幻灯片 / 演示文稿 / deck / keynote / 汇报 / 述职 / 提案 / 路演 / 答辩 / 课件 /
|
|
14
|
+
用户要做 PPT / 幻灯片 / 演示文稿 / deck / keynote / 汇报 / 述职 / 提案 / 路演 / 答辩 / 课件 / 培训材料,或希望融合本地 Word/Excel/PDF/照片、结合外部权威资料对标,或吸收参考 `.pptx` 风格来制作新文稿。
|
|
15
15
|
|
|
16
16
|
## 核心审美哲学:品味内建(零品味负担)
|
|
17
17
|
|
|
18
18
|
普通用户无法分辨底层版式栅格、对比度或图表噪音——**你就是首席艺术总监,默认输出必须直接达到麦肯锡咨询 / Apple 发布会 / Nature 学术答辩 / 现代故宫霁蓝政务水准**:
|
|
19
19
|
|
|
20
|
-
1. **零追问场景定调(Zero-Question Auto-Director)**:用户说“帮我做个汇报 PPT”时,**不要反问一堆设计参数**。直接根据内容语义识别六大画像(商业咨询、政务述职、学术答辩、科技路演、教育讲义、人文品牌),传 `theme: 'auto'` 或显式匹配 24
|
|
20
|
+
1. **零追问场景定调(Zero-Question Auto-Director)**:用户说“帮我做个汇报 PPT”时,**不要反问一堆设计参数**。直接根据内容语义识别六大画像(商业咨询、政务述职、学术答辩、科技路演、教育讲义、人文品牌),传 `theme: 'auto'` 或显式匹配 **24 套大师主题(16 浅 8 深**,含 `bcg-emerald`、`economist-brief`、`venture-daylight`、`stripe-craft`、`aurora-stage`、`obsidian-amber`、`keynote-light`、`financial-ft`、`medical-clean`、`luxury-noir`)。**明亮投影优先**:会议室汇报、政企述职、学术答辩、教学课件一律优先选用 16 套浅底主题(通用默认 `consulting` 蔚蓝战略),绝不在常规办公场景盲目套用纯黑赛博风 `data`!并按场景自动匹配 **6 套差异化母版骨架(`chromeStyle`:`consulting-classic` / `keynote-spatial` / `editorial-folio` / `saas-bento` / `academic-minimal` / `gov-ceremonial`)**,彻底告别「一套模板换颜色」。
|
|
21
21
|
2. **结论先行(Action Titles)**:除封面、目录与章节页外,每页标题必须是**完整的结论判断句**(如「异步评审将工程师周均例会耗时压缩 75%」),严禁使用「项目背景」「数据分析」「周末到馆人次」等空洞名词标签。
|
|
22
|
-
3. **版式节奏与反要点墙(Anti-Bullet-Wall)**:优先传**结构化 `slides`**(或使用
|
|
23
|
-
4.
|
|
24
|
-
5. **20 套标杆范本槽位填空 + 标杆弧线重排(`alignOrder: true`)+ 零模型自检修复闭环**:不要从零发明排版!直接传 `exemplar: 'auto'` 智能匹配或从内置 **20 套标杆范本**(8 套核心场景 + 12 套源自 Apache-2.0 / MIT / CC-BY-4.0 开源 GitHub 优质 `.pptx`
|
|
25
|
-
6. **8 套大师品味配方(Taste Recipes
|
|
22
|
+
3. **版式节奏与反要点墙(Anti-Bullet-Wall)**:优先传**结构化 `slides`**(或使用 `:::` 容器指令)充分利用 **41 种原生可编辑版式(36 核心 + 5 媒体,含 53 别名)**。**整套文稿严禁连续超过 2 页使用普通 `bullets` 要点列表**;8 页以上文稿须有节奏地交替视觉密度(拆解战略因果用 **`issue-tree`** MECE 逻辑议题树、预算/营收占比用 **`treemap`** 矩形树图、OKR/实绩达标用 **`gauge`** 水平子弹仪、商业套餐选型用 **`pricing`** 三档报价矩阵、地理分布用 `map`、3D 架构用 `isometric`、指标用 `kpi`、排期用 `gantt`、系统分层用 `architecture`、竞品能力用 `harvey`、市场空间用 `tam`、组织用 `org`、并列支柱用 `cards[pillars/bento]`、痛点整改用 `comparison[issue-action]`、演进闭环用 `process[timeline/steps/flywheel/funnel]`、四象限用 `matrix`/`quadrant`、数据配洞察用 `chart-split`、学术对比用 `table[booktabs]` 三线表)。
|
|
23
|
+
4. **出版级图表与三线表**:支持 **13 类出版级原生图表**,单系列图表自动隐藏冗余图例,使用 `spotlight: true` / `highlight: 'max' | 'last'` 突出焦点色柱、其余灰阶退后,按需叠加 `referenceLine` 基准虚线与 `showGrowthCallout: true` 麦肯锡增长飞线批注,左下角附 `source` 数据来源;学术与严谨数据对比使用无竖线的 `booktabs` 三线表。
|
|
24
|
+
5. **20 套标杆范本槽位填空 + 标杆弧线重排(`alignOrder: true`)+ 零模型自检修复闭环**:不要从零发明排版!直接传 `exemplar: 'auto'` 智能匹配或从内置 **20 套标杆范本**(8 套核心场景 + 12 套源自 Apache-2.0 / MIT / CC-BY-4.0 开源 GitHub 优质 `.pptx` 经实机渲染甄选蒸馏的标杆)中择一,先调 `ppt_templates({ exemplarId })` 获取逐页槽位契约与 **Few-Shot JSON 样板**,再按槽位调用 `ppt_create({ exemplar, alignOrder: true, ... })`;引擎内置 **确定性弱模型补偿器 + 落盘前两轮 `checkManifest`/`SLOP-01..14` 零模型自检修复闭环(`autoUpgrade`,默认开启)**,即使输入为乱序粗糙 `bullets` / 碎块饼图 / 超载指标 / 刺眼配色也能以 0 额外模型开销 100% 无损升维修复。用户手头有优质 `.pptx` 目录时,调 `ppt_absorb({ pptxPath: "<目录路径>" })`(或 CLI `--ingest-exemplars <dir>`)批量沉淀至 `.dsh-ppt/exemplars.json` 与 `.dsh-ppt/taste-recipes.json`。
|
|
25
|
+
6. **8 套大师品味配方(Taste Recipes)、61 枚原生矢量图标与单份母版吸收**:可独立选用 `taste: 'mckinsey-partner' | 'apple-keynote-dark' | 'apple-keynote-light' | 'swiss-editorial' | 'linear-craft' | 'ft-data-journal' | 'nature-academic' | 'oriental-zen'` 驱动 4 套海报封面、4 种卡片材质与 **61 枚原生 `<a:custGeom>` 矢量图标**;单份标杆 `.pptx` 用 `ppt_absorb`(`saveTasteAs` / `saveExemplarAs` / `saveBrandKit`)或 `referencePptx` + `cloneStructure: true` 吸收。
|
|
26
26
|
|
|
27
27
|
## 执行纪律(每次都要遵守)
|
|
28
28
|
|
|
29
29
|
- **默认零额外模型开销直接交付**:不自动触发 AI 预审、模拟答辩或视觉看图修复。用户可在 DSH 设置页主动开启可选 AI 预审/答辩或「视觉检查与修复」(支持最高 24 页全量审查与 12 种无损版式/字号修复);AI 演练不等于事实核验,不编造实验、数据或引用;采纳建议默认另存副本,原件保留。模型失败、截断、停止或未检查页面必须如实说明,不能声称视觉通过。
|
|
30
|
-
- **数字溯源与推演纪律**:需要解释数字来源或现场滑块推演时,提供 `dataModel`
|
|
30
|
+
- **数字溯源与推演纪律**:需要解释数字来源或现场滑块推演时,提供 `dataModel`(或在 `ppt_from_office` 中传 `bindDataModel: true` 自动绑定 Excel 数值表)并在 `slides` 绑定 `{{metricId}}`;先读 `references/data.md`。`source` 必须对应真实材料行或单元格,假设用 `kind: 'input'` 标注,禁止虚构来源。修改数据先 `ppt_data(action: 'preview')`,展示差异并获确认后带凭证 `apply`(默认 `saveAs: true`)。
|
|
31
31
|
- **工程安全与版本锁**:修改已有工程先 `ppt_check` 获取当前 `revision` 与页面 ID。外部手工改过的 HTML/PPTX 或缺少校验记录的旧工程不可被 `ppt_edit` 静默覆盖;若用户在 PowerPoint / WPS 中修改了 `.pptx` 并希望同步回工程,请使用 **`ppt_import`(传 `projectId`)或 CLI `--sync-pptx`**,自动在 `.history/` 留存快照并用 `ppt_undo` 可逆回导;需要全新翻新外部 `.pptx` 时使用 `ppt_import`(CLI `--import-pptx`)。风格提取仍可使用只读 `ppt_absorb` / `referencePptx`。
|
|
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`)控制播放器界面与默认标签;跨语种或中英双语化现有工程时,先导出 `exports: ['i18n']` 翻译槽位再用 `ppt_edit({ translations, bilingualMode, targetLang })` 无损回填,避免重写整份 JSON 破坏图表与配图。
|
|
34
34
|
|
|
35
|
-
##
|
|
35
|
+
## 核心流水线(三模路由:Mode A / Mode B / Mode C)
|
|
36
36
|
|
|
37
|
-
- **Mode A
|
|
38
|
-
- **Mode B
|
|
37
|
+
- **Mode A(有资料直出)**:用户已给出完整文档、大纲、表格、数据或参考 `.pptx` 且无需外源对标时,零追问自动定调并直接生成可交付三件套。
|
|
38
|
+
- **Mode B(零资料 8 域权威深研策划)**:用户**没有资料**、只给主题或明确要求「先去搜资料、核验准确性、先策划 PPT 方案再生成」时,**严禁凭训练记忆编造具体统计数字**!必须先读 `references/research-plan.md`,按四步闭环执行:① 调 `ppt_templates({ topic })`(或 CLI `--plan`)获取 8 大领域专属 `site:` + `filetype:pdf` + `-site:` 3 轮权威检索包与标杆分镜 → ② 用宿主 Agent 联网搜索工具开展 3 轮一手源检索与双源交叉核验,沉淀带 `origin` / `tier` / `claimType` / `date` 的 `evidence[]` 账本 → ③ 向用户展示策划方案并获确认(除非用户明示跳过确认直出)→ ④ 带 `evidence[]` + `evidenceAppendix: true` 调 `ppt_create` 出稿并通过 `SLOP-13` 代码级信源审计。
|
|
39
|
+
- **Mode C(本地混合素材包 × 权威外源对标 + 定制编排)**:用户给了本地 `.docx`/`.xlsx`/`.pdf`/照片,并附带具体编排要求或需要补充行业规模、竞品财报、官方政策等外部权威数据时,先读 `references/office-pack.md`:① 调 `ppt_from_office({ filePath, inspectOnly: true, instructions })` 获取低 Token 的 **Material Dossier(精炼素材档案)** 与 **`enrichmentPlan`**(含本地 `[E1..Ek]` 与顺延外部起始编号 `nextEvidenceId`)→ ② 按需跑 Tier 1/2 权威外源检索补齐外部 `evidence[]`(标注 `origin: 'web-research'`, `tier: 1 | 2`)→ ③ 调 `ppt_create` 或 `ppt_from_office({ evidence, instructions, maxSlides, includeSheets, photoRoles, bindDataModel: true })` 双轨融合成稿。
|
|
39
40
|
|
|
40
|
-
1. **Probe & Auto-Direct
|
|
41
|
+
1. **Probe & Auto-Direct 定调**:读入用户资料(或 Mode B/C 核验后的证据账本与素材档案),静默判定听众与六大画像(见 `references/themes.md`)。若用户给了参考 `.pptx`,调 `ppt_absorb` 查看提取结果或在创建时传 `referencePptx`。Mode A 一句话输入不反问,直接推断并生成完整成品。
|
|
41
42
|
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`)。
|
|
42
|
-
3. **Theme 选主题与骨架**:不确定时在 `ppt_create` 传 `theme: 'auto'`(自动路由至明亮高质感场景主题与匹配骨架),或从 **24 套内置主题**中精确指定(调 `ppt_themes` 查看),并可通过 `brand.chromeStyle` 或单页 `chrome` 覆盖 6
|
|
43
|
+
3. **Theme 选主题与骨架**:不确定时在 `ppt_create` 传 `theme: 'auto'`(自动路由至明亮高质感场景主题与匹配骨架),或从 **24 套内置主题**中精确指定(调 `ppt_themes` 查看),并可通过 `brand.chromeStyle` 或单页 `chrome` 覆盖 **6 套母版骨架**。
|
|
43
44
|
- **重要 CLI 差异**:跨 harness 直接运行 `build-deck.mjs` 时,裸 CLI 缺省 `--theme` 为兼容旧脚本仍回退 `data`,因此 **CLI 调用请务必显式传 `--theme auto` 或具体场景主题 ID(如 `--theme consulting` / `--theme exec-jilan`)**!
|
|
44
|
-
4. **Build 生成**:先读 `references/syntax.md`(用到图表/多图/外源母版/编辑时读 `references/advanced.md`)。
|
|
45
|
-
- **推荐方式(DSH 内)**:调 `ppt_create`,优先传结构化 `slides`(精确控制 **
|
|
46
|
-
- **跨 harness CLI**:`node <skill-dir>/scripts/build-deck.mjs --title "标题" --slides @slides.json --theme auto --lang zh --out dist
|
|
47
|
-
- 动效默认 `motion: 'on'
|
|
48
|
-
5. **Verify
|
|
49
|
-
6. **Deliver 交付**:向用户提供 `.html`、`.pptx`、`.json`(默认严格保持三件套,仅在传 `--handout` / `--one-pager`
|
|
45
|
+
4. **Build 生成**:先读 `references/syntax.md`(用到图表/多图/外源母版/编辑时读 `references/advanced.md`,用到本地多源包/导出/拼装/翻译时读 `references/office-pack.md`)。
|
|
46
|
+
- **推荐方式(DSH 内)**:调 `ppt_create`,优先传结构化 `slides`(精确控制 **41 种原生可编辑版式**,含 `issue-tree / treemap / gauge / pricing / map / isometric / gantt / architecture / harvey / tam / org / quadrant / radar / dumbbell / heatmap / mockup / code / mermaid / kpi / cards / comparison / matrix / process / chart-split / table[booktabs] / callout`),或传带 `:::` 指令的 Markdown `content`;跨工程复用金页用 `mergeSources`(配合 `ppt_edit({ saveToBank })`)。
|
|
47
|
+
- **跨 harness CLI**:`node <skill-dir>/scripts/build-deck.mjs --title "标题" --slides @slides.json --theme auto --lang zh --out dist`(直吞混合素材包用 `--from-office ./pack --inspect-only` 或 `--instructions "..." --bind-data`;配套逆向导出用 `--export xlsx,docx,qa-prep,memo,i18n`;跨工程拼装用 `--merge @sources.json`;无损翻译用 `--edit deck.json --translate @en.json --bilingual`;吸收参考模板用 `--reference-pptx ref.pptx --clone-structure`)。
|
|
48
|
+
- 动效默认 `motion: 'on'`,可用 `motionProfile: 'subtle' | 'executive' | 'keynote'` 与单页 `reveal: 'step'` 控制分步点击显现(HTML + PPTX 原生 `<p:timing>` 同构);严肃政企公文、学术打印或归档传 `motion: 'off'`。
|
|
49
|
+
5. **Verify 校验、看图修正与离线 `R` 键审阅回流**:调 `ppt_check` 检查结构、字数密度、WCAG 对比度与 `SLOP-01..14` 审美/合规告警;若收到审阅人从独立 HTML 按 **`R`** 键导出的 `review-feedback.json`,传 `ppt_check({ deckPath, feedbackPath })`(CLI `--check deck.json --feedback review-feedback.json`)直接定位逐页 `stakeholder-feedback` 批注并用 `ppt_edit` 修订。若安装了 `@deepseek-ai/libreoffice-kit`,调 `ppt_render` 生成逐页 PNG/PDF 并附 `renderReceipt` 复检,逐张用看图工具核查画面(0 缺字、0 溢出、0 遮挡、0 冗余图例)。微调文字、切换主题、收藏金页或无损翻译用 `ppt_edit`(带 `expectedRevision`),需要时 `ppt_undo`。静态估算、渲染成功与视觉验收必须分开如实陈述。
|
|
50
|
+
6. **Deliver 交付**:向用户提供 `.html`、`.pptx`、`.json`(默认严格保持三件套,仅在传 `exports: [...]` 或 `--export` / `--handout` / `--one-pager` 时同步落盘配套 `.xlsx` 数据工作簿、`.docx` Word 文档、`.qa-prep.md` 会前质询预案、`.memo.md` 高管备忘录、`.i18n.json` 翻译槽位包、`.handout.md`、`.onepager.html`、`.carousel.html`、`.srt`)绝对路径;说明 HTML 快捷键(`← →` 翻页/分步步进 · **`P` 双屏提词台** · **`R` 离线审阅批注并导出 JSON 给 AI 修订** · **`Ctrl/Cmd+K` 全局速搜** · **`D` 白板画笔** · **`T` Q&A 倒计时** · **`A` 自动字幕导览** · **`L` 激光笔** · `F` 全屏 · `G` 总览 · `S` 备注);说明 PPTX 100% 原生可编辑特性及 `ppt_import` / `--sync-pptx` 双向导回能力。
|
|
50
51
|
|
|
51
52
|
## 按需装载索引
|
|
52
53
|
|
|
53
54
|
| 何时必读 | 参考文件 | 核心内容 |
|
|
54
55
|
| --- | --- | --- |
|
|
55
|
-
|
|
|
56
|
+
| **本地混合素材包、Mode C 混源深研、逆向导出/拼装/无损翻译/R 键回流** | `references/office-pack.md` | `inspectOnly` 素材档案与 `enrichmentPlan`、需求驱动 Office/照片编排与防裁歪、`exports[]`(`xlsx/docx/qa-prep/memo/i18n`)、Slide Bank + `mergeSources`、无损双语、`reveal: 'step'` 与 `R` 键反馈闭环 |
|
|
57
|
+
| **零资料/混源联网调研、8 域权威检索与 `SLOP-13` 核验** | `references/research-plan.md` | 三模路由(Mode A/B/C)、8 大领域 `site:` + `filetype:pdf` + `-site:` 检索包、`classifySourceAuthority` T1/T2/T3、`SLOP-13` 9 项门禁与 `brand-kit.json` `preferredSources`/`blockedDomains` |
|
|
56
58
|
| 按标杆范本槽位填空或批量投喂 `.pptx` 语料 | `references/exemplars.md` | 20 套标杆范本槽位契约、`ppt_templates(exemplarId)`、批量 `--ingest-exemplars` 与弱模型升维补偿器 |
|
|
57
59
|
| 写大纲、标题与正文前 | `references/copywriting.md` | 六大画像叙事骨架、Action Title 写法、字数预算、反空话与双语规范 |
|
|
58
|
-
| 选主题、配色、骨架或吸收母版 | `references/themes.md` |
|
|
59
|
-
| 写结构化 `slides` 或扩展 Markdown | `references/syntax.md` |
|
|
60
|
-
| 图表、图片、吸收 `.pptx`、编辑与渲染 | `references/advanced.md` | 13 类出版级图表、瀑布图、`ppt_absorb`/`referencePptx`/`cloneStructure`、
|
|
61
|
-
| 数字溯源、公式与现场推演 | `references/data.md` | `dataModel`
|
|
60
|
+
| 选主题、配色、骨架或吸收母版 | `references/themes.md` | 24 套大师主题色板(16 浅 8 深)、6 套母版骨架(Chrome)、语义 Token、六大画像选型树 |
|
|
61
|
+
| 写结构化 `slides` 或扩展 Markdown | `references/syntax.md` | 41 种原生可编辑版式(36 核心 + 5 媒体,含 `issue-tree`/`treemap`/`gauge`/`pricing`)+ 53 别名、`items` 结构、`:::` 容器指令、三线表与 `takeaway` |
|
|
62
|
+
| 图表、图片、吸收 `.pptx`、编辑与渲染 | `references/advanced.md` | 13 类出版级图表、瀑布图、`ppt_absorb`/`referencePptx`/`cloneStructure`、20 套蓝图、Vision QA 与 CLI |
|
|
63
|
+
| 数字溯源、公式与现场推演 | `references/data.md` | `dataModel` 源绑定(含 `bindDataModel: true`)、公式约束、全字段 `{{metricId}}` 联动与预览确认流 |
|
|
62
64
|
| 遇到报错或渲染异常 | `references/troubleshooting.md` | 症状 → 根因与处理速查表 |
|
|
63
65
|
|
|
64
|
-
## 质量与反土味门禁(SLOP-01..
|
|
66
|
+
## 质量与反土味门禁(SLOP-01..14,交付前逐项核对)
|
|
65
67
|
|
|
66
68
|
- [ ] **SLOP-01 结论标题**:内容页与图表页标题均为完整判断句(Action Title),无「项目背景 / 数据图表 / 总结」等纯名词短标题。
|
|
67
69
|
- [ ] **SLOP-02 章节面包屑**:`kicker` 体现章节脉络(如 `01 · 增长引擎`),未连续多页硬编码重复「要点 / Point」。
|
|
68
|
-
- [ ] **SLOP-03 拒绝要点墙**:单页普通 bullets ≤ 5 条;无连续 > 2 页 `bullets` 版式,并列信息已升格为 `kpi / cards / comparison / process / matrix`。
|
|
70
|
+
- [ ] **SLOP-03 拒绝要点墙**:单页普通 bullets ≤ 5 条;无连续 > 2 页 `bullets` 版式,并列信息已升格为 `kpi / cards / comparison / process / matrix / issue-tree / treemap / gauge / pricing`。
|
|
69
71
|
- [ ] **SLOP-04 字号与字数底线**:正文绝不低于 `13.5pt`;单条要点中文 ≤ 24 字(英文 ≤ 14 词),卡片正文中文 ≤ 40 字,引导词使用 `**关键词**:说明` 形成层级。
|
|
70
|
-
- [ ] **SLOP-05 图文对齐与呼吸感**:配图采用圆角细框对齐或 `split-bleed`
|
|
72
|
+
- [ ] **SLOP-05 图文对齐与呼吸感**:配图采用圆角细框对齐或 `split-bleed` 半屏出血,人像/团队照设 `focalPoint: 'top'` 防切头,正文列垂直居中,无「左上角两行字 + 大片死白」。
|
|
71
73
|
- [ ] **SLOP-06 出版级图表与三线表**:单系列图表无冗余图例,网格线 ≤ 5 条细灰线,关键柱已用 `highlight` 聚焦并带直接数值标签;学术表格采用 `booktabs` 无竖线三线表;数据页左下角有真实 `source` 说明(未虚构出处)。
|
|
72
74
|
- [ ] **SLOP-07 投影安全与对比度**:会议/政务/学术/培训优先浅底主题;政务风杜绝刺眼纯红底配黄字;正文与背景对比度 ≥ 4.5:1,HTML 与 PPTX 主题完全一致。
|
|
73
75
|
- [ ] **SLOP-08 版式多样性**:≥ 6 页的文稿至少组合 4 种不同版式原型,封面与封底不误印页码。
|
|
74
76
|
- [ ] **SLOP-09 可执行收尾**:`closing` 页包含明确的下一步行动号召(CTA / 里程碑 / 联络方式),绝不仅写两个字「谢谢」。
|
|
75
77
|
- [ ] **SLOP-10 真实性与跨平台完备**:无未填占位草稿(除非用户明确要求空模板并标注 `draft`),全部产物为工作区绝对路径;若已运行渲染,确认 `missingFonts: []` 且收据匹配最新 PPTX。
|
|
76
78
|
- [ ] **SLOP-11/12 卡片材质节奏与图表聚光灯**:长篇文稿避免连续 ≥ 4 页等宽方框卡片;单系列 ≥ 5 项柱状/条形图须通过 `highlight` / `spotlight` / `referenceLine` 聚焦核心主角。
|
|
77
|
-
- [ ] **SLOP-13
|
|
78
|
-
- [ ] **SLOP-14 企业品牌宪章与合规门禁**:工作区存在 `.dsh-ppt/brand-kit.json` 时默认自动锁定企业主色、字体、页脚、内容页保密水印(`brand.watermark
|
|
79
|
+
- [ ] **SLOP-13 事实出处与代码级权威信源门禁(v0.35 升级 9 项)**:严禁空洞假出处(`vague-placeholder-source`)、悬空 `[E#]` 引用(`dangling-evidence-ref`)、未披露口径的 `unverified`/`conflicting`(`unverified-evidence-claim`)与调研模式无出处量化页(`unsourced-research-numbers`);由 `classifySourceAuthority` 代码级核验 Tier 1/2/3 与工作区 `preferredSources`/`blockedDomains`,同步拦截「名义权威机构 + 自媒体二手转引链接」(`secondary-relay-source`)、把 Tier 3 噪声站/屏蔽域标为 `verified`(`low-authority-source`)、`claimType: 'forecast'` 预测数字未标「预计/预测/E」(`unmarked-forecast-claim`)、外源缺失年份(`missing-external-date`)以及超 3 年过时外部基准(`stale-evidence-date`)。
|
|
80
|
+
- [ ] **SLOP-14 企业品牌宪章与合规门禁**:工作区存在 `.dsh-ppt/brand-kit.json` 时默认自动锁定企业主色、字体、页脚、内容页保密水印(`brand.watermark`)、官方封底与 `preferredSources`/`blockedDomains`;全篇无企业禁用词(`forbidden-brand-term`)与主色漂移(`brand-palette-drift`);需为高管/董事会/客户压缩精简版本时直接用 `ppt_edit({ remixPreset })` / `--remix` 另存无损归档副本。
|
|
79
81
|
|
|
80
82
|
## 跨 harness 安装
|
|
81
83
|
|
|
82
|
-
把整个 `skills/dsh-ppt` 目录复制到目标 Agent 的技能目录,在 Node `^22.19.0 || >=24.0.0` 下执行 `npm install --ignore-scripts`。
|
|
84
|
+
把整个 `skills/dsh-ppt` 目录复制到目标 Agent 的技能目录,在 Node `^22.19.0 || >=24.0.0` 下执行 `npm install --ignore-scripts`。24 套主题与 36 种零依赖核心原生版式/图示(含 41 种完整版式中的核心图谱)纯 Node 内置模块即可运行;图片、13 类图表与外部 `.pptx` 吸收使用已声明的 `@office-kit/pptx@0.21.0`;PNG/PDF 渲染按需安装 `@deepseek-ai/libreoffice-kit`:
|
|
83
85
|
|
|
84
86
|
| Agent | 技能目录 / 安装命令 |
|
|
85
87
|
| --- | --- |
|
|
@@ -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
|
-
#
|
|
1
|
+
# 深度调研、权威信源导航与事实核验协议(Research & Authority Protocol)
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
当用户**没有现成文档/数据**(Mode B),或**有本地文件但要求补充行业规模/竞品财报/官方政策等外部权威对标**(Mode C)时,必须按本协议执行。
|
|
4
4
|
|
|
5
|
-
> **架构红线**:`dsh-ppt`
|
|
5
|
+
> **架构红线**:`dsh-ppt` 引擎保持 100% 离线、零网络外联与零新增依赖;实时联网检索与一手网页阅读由**宿主 Agent 的联网搜索/浏览器工具**完成(学术场景可叠加 `dsh-cite`),校验后的结构化证据通过 `evidence[]` 账本交给 `dsh-ppt` 进行代码级信源定级(`classifySourceAuthority`)、`SLOP-13` 深度审计与双轨溯源渲染。
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
9
|
-
##
|
|
9
|
+
## 一、三模路由判定(Tri-Mode Routing:Mode A / Mode B / Mode C)
|
|
10
10
|
|
|
11
|
-
| 模式 | 触发条件 |
|
|
11
|
+
| 模式 | 触发条件 | 核心动作 |
|
|
12
12
|
| --- | --- | --- |
|
|
13
|
-
| **Mode A:有资料直出** |
|
|
14
|
-
| **Mode B:零资料深研策划** |
|
|
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
|
-
|
|
21
|
+
`ppt_templates({ topic })` / CLI `--plan` 与 `ppt_from_office({ inspectOnly: true })` 内置 `detectResearchDomain` + `buildAuthoritativeQueryPack`,自动将选题路由至 **8 大专业领域**,输出自带 **`site:` 权威白名单 + `filetype:pdf` 官方报告指令 + `-site:` 营销号排除清单** 的 3 轮检索式:
|
|
21
22
|
|
|
22
|
-
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
29
|
-
|
|
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
|
-
|
|
40
|
+
---
|
|
32
41
|
|
|
33
|
-
|
|
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
|
-
|
|
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
|
-
|
|
52
|
+
### Step 2:代码级信源定级(`classifySourceAuthority`)与核验红线
|
|
48
53
|
|
|
49
|
-
|
|
50
|
-
2. **核验后的核心事实账本摘要(`E1..En`)**:列出关键数字、一手出处、年份口径及核验状态(含任何已发现的口径分歧或待补项);
|
|
51
|
-
3. **逐页分镜策划表(Storyboard)**:页码、叙事角色、结论先行标题(Action Title)、拟用版式、绑定证据 `[E#]`(可直接调用 `ppt_templates({ topic, evidence })` 自动生成 `planMarkdown` 并补齐真实标题)。
|
|
54
|
+
每条拟上屏证据整理为结构化 `evidence[]` 条目(完整字段见下例),引擎通过 `classifySourceAuthority` 自动定级:
|
|
52
55
|
|
|
53
|
-
|
|
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
|
|
65
|
+
### Step 3:向用户展示策划方案并确认(Plan Gate)
|
|
56
66
|
|
|
57
|
-
|
|
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
|
-
"
|
|
69
|
-
"
|
|
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://
|
|
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
|
-
"
|
|
78
|
-
"
|
|
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
|
|
104
|
+
"note": "车企官方规划偏乐观(2027),供应链预计平价窗口在 2030E"
|
|
83
105
|
}
|
|
84
106
|
],
|
|
85
107
|
"slides": [
|
|
86
108
|
{
|
|
87
109
|
"layout": "kpi",
|
|
88
110
|
"kicker": "01 · 产业拐点",
|
|
89
|
-
"title": "
|
|
111
|
+
"title": "全球装车迈过 894 GWh,2030E 全固态平价预计落在 0.55–0.72 元/Wh 区间",
|
|
90
112
|
"evidenceIds": ["E1", "E2"],
|
|
91
113
|
"items": [
|
|
92
|
-
{ "tag": "2025
|
|
93
|
-
{ "tag": "
|
|
114
|
+
{ "tag": "2025 全球装车", "value": "894 GWh", "delta": "IEA 一手年报 [E1]" },
|
|
115
|
+
{ "tag": "2030E 预计成本区间", "value": "0.55–0.72 元/Wh", "delta": "多机构口径区间 [E2]" }
|
|
94
116
|
],
|
|
95
|
-
"takeaway": "
|
|
117
|
+
"takeaway": "实绩数据源自 IEA [E1];全固态 2030E 成本为预测口径区间 [E2],需持续跟踪硫化物良率。"
|
|
96
118
|
}
|
|
97
119
|
]
|
|
98
120
|
}
|
|
99
121
|
```
|
|
100
122
|
|
|
101
|
-
|
|
123
|
+
---
|
|
124
|
+
|
|
125
|
+
## 四、`SLOP-13` 事实出处与权威信源静态门禁(9 项确定性审计)
|
|
102
126
|
|
|
103
|
-
|
|
104
|
-
|
|
105
|
-
|
|
106
|
-
|
|
107
|
-
|
|
108
|
-
|
|
109
|
-
|
|
110
|
-
|
|
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
|
-
##
|
|
145
|
+
## 五、裸 CLI 用法速查
|
|
115
146
|
|
|
116
147
|
```bash
|
|
117
|
-
# 1.
|
|
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.
|
|
121
|
-
node skills/dsh-ppt/scripts/build-deck.mjs --
|
|
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
|
```
|