dsh-ppt 0.34.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.
- package/CHANGELOG.md +23 -0
- package/README.en.md +8 -11
- package/README.md +8 -11
- package/docs/USAGE.en.md +43 -35
- package/docs/USAGE.md +44 -36
- package/docs/VALIDATION.md +4 -0
- package/lib/client.js +1 -1
- 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/lib/tools.js
CHANGED
|
@@ -39,10 +39,12 @@ function compileParameters(spec) {
|
|
|
39
39
|
node.description = prop.description;
|
|
40
40
|
if (Array.isArray(prop?.enum))
|
|
41
41
|
node.enum = prop.enum;
|
|
42
|
-
if (prop?.type === 'array' && prop.items !== null && typeof prop.items === 'object')
|
|
42
|
+
if ((prop?.type === 'array' || (Array.isArray(prop?.type) && prop.type.includes('array'))) && prop.items !== null && typeof prop.items === 'object')
|
|
43
43
|
node.items = prop.items;
|
|
44
44
|
if (prop.properties)
|
|
45
45
|
node.properties = prop.properties;
|
|
46
|
+
if (Array.isArray(prop?.required))
|
|
47
|
+
node.required = [...prop.required];
|
|
46
48
|
if (prop.additionalProperties !== undefined)
|
|
47
49
|
node.additionalProperties = prop.additionalProperties;
|
|
48
50
|
properties[key] = compileNode(node);
|
|
@@ -140,6 +142,9 @@ function renderAbsorb(value) {
|
|
|
140
142
|
return oneText(parts.join('\n'));
|
|
141
143
|
}
|
|
142
144
|
function renderCreate(value) {
|
|
145
|
+
if (value.inspectOnly === true && typeof value.dossierMarkdown === 'string') {
|
|
146
|
+
return oneText(value.dossierMarkdown);
|
|
147
|
+
}
|
|
143
148
|
const up = value.upgradeReport;
|
|
144
149
|
const sr = (up?.selfRepair && typeof up.selfRepair === 'object') ? up.selfRepair : undefined;
|
|
145
150
|
const srNote = sr && Number(sr.fixedCount || 0) > 0
|
|
@@ -157,7 +162,12 @@ function renderCreate(value) {
|
|
|
157
162
|
'可直接修改的 PPTX:' + value.pptxPath + '\n' +
|
|
158
163
|
'可继续编辑的项目:' + value.jsonPath + '\n' +
|
|
159
164
|
(value.handoutPath ? '演讲讲义:' + value.handoutPath + '\n' : '') +
|
|
160
|
-
'
|
|
165
|
+
(value.xlsxPath ? '配套 Excel 数据簿:' + value.xlsxPath + '\n' : '') +
|
|
166
|
+
(value.docxPath ? '配套 Word 文档:' + value.docxPath + '\n' : '') +
|
|
167
|
+
(value.memoPath ? '高管阅读备忘录:' + value.memoPath + '\n' : '') +
|
|
168
|
+
(value.qaPrepPath ? '会前高管质询预案:' + value.qaPrepPath + '\n' : '') +
|
|
169
|
+
(value.i18nPath ? '无损翻译槽位包:' + value.i18nPath + '\n' : '') +
|
|
170
|
+
'HTML 双击即可放映;可点击上一页/下一页、输入页码,按 R 离线审阅批注,以及“检查与导出”定位问题或下载 PPTX。PPTX 可用 PowerPoint / WPS / Keynote 直接编辑。' +
|
|
161
171
|
upgradeLine +
|
|
162
172
|
evidenceLine +
|
|
163
173
|
(value.revision !== undefined ? '\n修订号:' + value.revision + ';可撤销修改:' + value.undoAvailable + '。用 ppt_edit 修改指定页,ppt_undo 撤销。' : '') +
|
|
@@ -335,11 +345,15 @@ const slideItemSchema = {
|
|
|
335
345
|
size: { type: 'number', description: 'Relative bubble size weight for quadrant/bubble-matrix items.' },
|
|
336
346
|
before: { type: 'number', description: 'Baseline/before numeric value for dumbbell/slope comparison items.' },
|
|
337
347
|
after: { type: 'number', description: 'Target/after numeric value for dumbbell/slope comparison items.' },
|
|
348
|
+
actual: { type: 'number', description: 'Actual numeric progress value for gauge/bullet-chart items.' },
|
|
349
|
+
target: { type: 'number', description: 'Target threshold numeric value for gauge/bullet-chart items.' },
|
|
350
|
+
max: { type: 'number', description: 'Maximum scale ceiling for gauge/bullet-chart items.' },
|
|
338
351
|
status: { type: 'string', enum: ['positive', 'negative', 'warning', 'neutral', 'accent'] },
|
|
339
352
|
tone: { type: 'string', enum: ['positive', 'negative', 'warning', 'neutral', 'accent'] },
|
|
340
353
|
},
|
|
341
354
|
additionalProperties: false,
|
|
342
355
|
};
|
|
356
|
+
const exportKinds = ['xlsx', 'docx', 'qa-prep', 'memo', 'social-carousel', 'subtitles', 'handout', 'one-pager', 'i18n'];
|
|
343
357
|
const slideLayouts = [
|
|
344
358
|
'cover', 'agenda', 'section', 'bullets', 'statement', 'quote',
|
|
345
359
|
'kpi', 'cards', 'comparison', 'matrix', 'process', 'callout',
|
|
@@ -348,6 +362,7 @@ const slideLayouts = [
|
|
|
348
362
|
'mockup', 'code', 'quadrant', 'radar', 'dumbbell', 'heatmap',
|
|
349
363
|
'device', 'browser', 'mobile', 'snippet', 'bubble-matrix', 'magic-quadrant', 'spider', 'slope', 'heat-matrix',
|
|
350
364
|
'map', 'world-map', 'china-map', 'geo-map', 'isometric', 'iso-stack', 'iso-layers', '3d-stack', 'iso-pillars',
|
|
365
|
+
'issue-tree', 'mece', 'logic-tree', 'treemap', 'rect-map', 'budget-map', 'gauge', 'bullet-chart', 'okr-gauge', 'pricing', 'tiers', 'packages',
|
|
351
366
|
'table', 'closing', 'image', 'image-left', 'image-right',
|
|
352
367
|
'chart', 'chart-split', 'gallery', 'waterfall', 'flywheel',
|
|
353
368
|
'bento', 'pillars', 'exec-summary', 'timeline', 'steps', 'layers', 'funnel', 'chevron', 'value-chain',
|
|
@@ -369,6 +384,7 @@ const slideProperties = {
|
|
|
369
384
|
chrome: { type: 'string', enum: ALLOWED_CHROME_STYLES, description: 'Optional per-slide master chrome skeleton override.' },
|
|
370
385
|
cardMaterial: { type: 'string', enum: ['solid', 'frameless', 'glass', 'editorial-rule'], description: 'Optional per-slide card surface materiality.' },
|
|
371
386
|
iconMode: { type: 'string', enum: ['off', 'explicit', 'auto'], description: 'Optional per-slide native vector icon badge mode.' },
|
|
387
|
+
reveal: { type: 'string', enum: ['step', 'all'], description: 'Progressive step-by-step click reveal choreography ("step") on kpi/cards/comparison/process/isometric/matrix/issue-tree/pricing/gauge slides.' },
|
|
372
388
|
title: { type: 'string' }, subtitle: { type: 'string' }, kicker: { type: 'string' },
|
|
373
389
|
takeaway: { type: 'string', description: 'Bottom key-takeaway synthesis banner.' },
|
|
374
390
|
source: { type: 'string', description: 'Bottom-left data/citation source line.' },
|
|
@@ -439,6 +455,9 @@ const evidenceEntrySchema = {
|
|
|
439
455
|
scope: { type: 'string', description: 'Geographic/segment scope or statistical definition (e.g. "Global", "中国大陆", "乘用车口径").' },
|
|
440
456
|
url: { type: 'string', description: 'Optional verified http:// or https:// source URL (stored in speaker notes & handout).' },
|
|
441
457
|
confidence: { type: 'string', enum: ['verified', 'estimated', 'conflicting', 'unverified'], description: 'Fact-check verification status (default "verified").' },
|
|
458
|
+
origin: { type: 'string', enum: ['local-file', 'web-research'], description: 'Provenance origin separating user local materials ("local-file") from external authoritative research ("web-research").' },
|
|
459
|
+
tier: { type: 'integer', description: 'Authoritative source credibility tier: 1 (Official/Gov/Filing/Peer-Reviewed), 2 (Analyst/Research Institute), 3 (Media/UGC).' },
|
|
460
|
+
claimType: { type: 'string', enum: ['actual', 'forecast', 'policy', 'benchmark'], description: 'Distinguishes realized actuals from forward projections ("forecast") or policy/benchmark figures.' },
|
|
442
461
|
note: { type: 'string', description: 'Optional methodology caveat or cross-check discrepancy note.' },
|
|
443
462
|
},
|
|
444
463
|
required: ['claim', 'source'],
|
|
@@ -479,6 +498,8 @@ export function buildPptTools(config) {
|
|
|
479
498
|
brandKitName: { type: 'string', description: 'Optional corporate brand kit display name when saveBrandKit is true.' },
|
|
480
499
|
watermark: { type: 'string', description: 'Optional subtle content-slide classification watermark locked into the brand kit (e.g. "CONFIDENTIAL · 内部资料").' },
|
|
481
500
|
forbiddenTerms: { type: 'array', items: { type: 'string' }, description: 'Optional corporate compliance forbidden terms scanned automatically by SLOP-14.' },
|
|
501
|
+
preferredSources: { type: 'array', items: { type: 'string' }, description: 'Optional corporate/industry trusted authoritative domains or publisher names promoted to Tier 1 in research query packs and SLOP-13.' },
|
|
502
|
+
blockedDomains: { type: 'array', items: { type: 'string' }, description: 'Optional domains blacklisted as low-authority noise sources in research queries and SLOP-13.' },
|
|
482
503
|
}),
|
|
483
504
|
output: {
|
|
484
505
|
schema: { type: 'object', additionalProperties: true },
|
|
@@ -503,6 +524,21 @@ export function buildPptTools(config) {
|
|
|
503
524
|
smartLayout: { type: 'boolean', description: 'Enable or disable automatic multi-archetype Markdown layout promotion on >=4-section decks. Default true in async tool mode.' },
|
|
504
525
|
lang: { type: 'string', description: 'UI language of the generated player: zh (default), en, or bilingual. Content language is whatever you write.' },
|
|
505
526
|
motion: { type: 'string', enum: ['on', 'off'], description: 'Slide transitions plus bullet entrance animations: on (default) or off for a fully static deck.' },
|
|
527
|
+
motionProfile: { type: 'string', enum: ['subtle', 'executive', 'keynote'], description: 'Optional native PPTX transition profile: subtle (fast fade), executive (med fade), or keynote (push).' },
|
|
528
|
+
exports: { type: 'array', items: { type: 'string', enum: exportKinds }, description: 'Optional extra companion deliverables written alongside the 3-file core trio: xlsx (reverse Excel workbook), docx (Word report), qa-prep (executive Q&A defense sheet), memo (narrative memo), i18n (lossless translation bundle), handout, one-pager, social-carousel, subtitles.' },
|
|
529
|
+
mergeSources: {
|
|
530
|
+
type: 'array',
|
|
531
|
+
items: {
|
|
532
|
+
type: 'object',
|
|
533
|
+
properties: {
|
|
534
|
+
deckPath: { type: 'string', description: 'Path to an existing dsh-ppt .json project to cherry-pick slides from.' },
|
|
535
|
+
slides: { type: 'array', items: { oneOf: [{ type: 'integer' }, { type: 'string' }] }, description: 'Optional 1-based slide numbers or slide IDs to pick from deckPath.' },
|
|
536
|
+
bankIds: { type: 'array', items: { type: 'string' }, description: 'Optional slide bank entry IDs from .dsh-ppt/slide-bank.json.' },
|
|
537
|
+
},
|
|
538
|
+
additionalProperties: false,
|
|
539
|
+
},
|
|
540
|
+
description: 'Compose a unified new deck from 2+ existing .json projects and/or workspace slide-bank entries with SHA-256 asset dedup and collision-free [E#] evidence remapping.',
|
|
541
|
+
},
|
|
506
542
|
slides: { type: 'array', items: { type: 'object', properties: slideProperties, additionalProperties: true }, description: 'Structured slides across 30+ native layouts & pro diagrams (cover, agenda, section, bullets, kpi, cards, comparison, matrix, process, callout, gantt, architecture, harvey, tam, org, marimekko, sankey, swot, value-chain, mockup, code, quadrant, radar, dumbbell, heatmap, mermaid, statement, quote, table, chart, chart-split, waterfall, image, image-left, image-right, closing) with items[], columns[], takeaway, source, chrome, tableStyle (consulting|booktabs|minimal|banded|harvey), local images, and 13 chart kinds.' },
|
|
507
543
|
template: { type: 'string', enum: templateIds, description: 'Industry blueprint from ppt_templates (20 blueprints). Provide finished content/slides following its outline; template alone creates an unfilled draft.' },
|
|
508
544
|
brand: { type: 'object', properties: brandProperties, additionalProperties: false, description: 'Shared brand: #RRGGBB primary/background/text colors, fontFamily, logo, footer, and chromeStyle (' + ALLOWED_CHROME_STYLES.join('|') + '). Applied to HTML and PPTX.' },
|
|
@@ -565,6 +601,23 @@ export function buildPptTools(config) {
|
|
|
565
601
|
brand: { type: ['object', 'null'], properties: brandProperties, additionalProperties: false, description: 'Merge shared branding. null clears all branding. Empty footer clears footer; logo:null clears logo.' },
|
|
566
602
|
targetMinutes: { type: ['number', 'null'], description: 'Optional target speaking duration in minutes for pace budgeting (null clears).' },
|
|
567
603
|
remixPreset: { type: 'string', enum: ['exec-5min', 'board-brief', 'sales-pitch'], description: 'Multi-audience compression remix preset (exec-5min: 6 slides / board-brief: 8 slides / sales-pitch: 7 slides). Preserves omitted takeaways in speaker notes and defaults saveAs to true.' },
|
|
604
|
+
motionProfile: { type: ['string', 'null'], description: 'Optional native PPTX transition profile (subtle | executive | keynote, or null to clear).' },
|
|
605
|
+
exports: { type: 'array', items: { type: 'string', enum: exportKinds }, description: 'Optional extra companion exports to write: xlsx, docx, qa-prep, memo, i18n, handout, one-pager, social-carousel, subtitles.' },
|
|
606
|
+
saveToBank: {
|
|
607
|
+
type: 'object',
|
|
608
|
+
properties: {
|
|
609
|
+
slide: { oneOf: [{ type: 'integer' }, { type: 'string' }], description: '1-based slide number or slide ID to save into .dsh-ppt/slide-bank.json.' },
|
|
610
|
+
bankId: { type: 'string' },
|
|
611
|
+
name: { type: 'string' },
|
|
612
|
+
tags: { type: 'array', items: { type: 'string' } },
|
|
613
|
+
},
|
|
614
|
+
required: ['slide'],
|
|
615
|
+
additionalProperties: false,
|
|
616
|
+
description: 'Bookmark a golden slide (with its embedded assets & evidence) into workspace .dsh-ppt/slide-bank.json for cross-deck reuse.',
|
|
617
|
+
},
|
|
618
|
+
translations: { type: ['object', 'array'], items: { type: 'object', additionalProperties: true }, additionalProperties: true, description: 'Lossless translation bundle (from exports:["i18n"] or per-slide array) applied in-place while preserving 100% of layouts, charts, images, and evidence.' },
|
|
619
|
+
bilingualMode: { type: 'boolean', description: 'When applying translations, keep original + translated copy side-by-side in bilingual mode instead of replacing.' },
|
|
620
|
+
targetLang: { type: 'string', enum: ['zh', 'en', 'bilingual'], description: 'Optional target UI language when applying translations.' },
|
|
568
621
|
}),
|
|
569
622
|
output: { schema: createResultSchema, render: (_args, value) => renderCreate(value) },
|
|
570
623
|
execute: executors.edit,
|
|
@@ -594,6 +647,7 @@ export function buildPptTools(config) {
|
|
|
594
647
|
description: 'Inspect a dsh-ppt JSON project without rewriting artifacts. Report revision, slide IDs, page-specific errors and warnings for dense text, estimated overflow, small table fonts, missing/low-resolution images, chart labels, contrast and unfilled template slots. Static estimates require final visual review in browser and PowerPoint/WPS. 中文:交付前检查工程,定位具体页的问题并给出修改建议,不改文件。',
|
|
595
648
|
parameters: compileParameters({ deckPath: projectParameters.deckPath,
|
|
596
649
|
renderReceipt: { type: 'string', description: 'Optional receiptPath returned by ppt_render. Rechecks current PPTX hash and every rendered output; never implies a visual pass.' },
|
|
650
|
+
feedbackPath: { type: 'string', description: 'Optional path to review-feedback.json exported offline from the HTML player (R key); surfaces every stakeholder comment as actionable slide-level issues.' },
|
|
597
651
|
}),
|
|
598
652
|
output: { schema: { type: 'object', additionalProperties: true }, render: (_args, value) => renderCheck(value) },
|
|
599
653
|
execute: executors.check,
|
|
@@ -636,6 +690,14 @@ export function buildPptTools(config) {
|
|
|
636
690
|
parameters: compileParameters({
|
|
637
691
|
filePath: { type: 'string', required: true, description: 'Local .xlsx, .csv, .tsv, .docx, .pdf file path OR a local directory containing mixed source files (relative to session cwd or absolute).' },
|
|
638
692
|
filePaths: { type: 'array', items: { type: 'string' }, description: 'Optional additional local file paths (.xlsx/.csv/.tsv/.docx/.pdf/.png/.jpg/.webp) to fuse together with filePath into one deck with automatic [E1..En] source provenance.' },
|
|
693
|
+
inspectOnly: { type: 'boolean', description: 'Return a compact, token-efficient Material Dossier (Excel sheet profiles/charts, Word/PDF sections, photo pixel dimensions/orientation/focal-point tips, local [E1..Ek] ledger, AND Mode C Authoritative External Enrichment queries) without writing files yet — ideal when following custom user presentation instructions or enriching with web research.' },
|
|
694
|
+
instructions: { type: 'string', description: 'Natural-language presentation requirements (e.g. "控制 8 页,跳过目录,product.png 放封面,重点讲毛利变化") applied deterministically during direct build.' },
|
|
695
|
+
maxSlides: { type: 'integer', description: 'Optional maximum slide budget for direct build.' },
|
|
696
|
+
includeSheets: { type: 'array', items: { type: 'string' }, description: 'Optional list of Excel worksheet names (or substrings) to include.' },
|
|
697
|
+
photoRoles: { type: 'object', additionalProperties: true, description: 'Optional explicit filename-to-role map overriding smart photo choreography (e.g. {"hero.png":"cover","app.png":"mockup-mobile","site1.jpg":"gallery"}).' },
|
|
698
|
+
bindDataModel: { type: 'boolean', description: 'Automatically bind Excel/CSV numeric tables & KPI cards into live dataModel {{metricId}} placeholders so future ppt_data updates refresh the deck live.' },
|
|
699
|
+
evidence: { type: 'array', items: evidenceEntrySchema, description: 'Optional external authoritative web-research evidence[] (origin:"web-research", tier:1|2) merged collision-free after local file evidence [E1..Ek] (Mode C Hybrid).' },
|
|
700
|
+
exports: { type: 'array', items: { type: 'string', enum: exportKinds }, description: 'Optional extra companion exports: xlsx, docx, qa-prep, memo, i18n, handout, one-pager, social-carousel, subtitles.' },
|
|
639
701
|
outputDir: { type: 'string', description: 'Directory to write the generated files into. Default: session working directory (or the plugin outputDir config).' },
|
|
640
702
|
fileName: { type: 'string', description: 'Base file name for the three artifacts. Default: derived from source file or title.' },
|
|
641
703
|
theme: { type: 'string', description: 'Target built-in theme id (or "auto", default "auto").' },
|
package/lib/types.d.ts
CHANGED
|
@@ -35,7 +35,7 @@ export interface PptTasteRecipe {
|
|
|
35
35
|
}
|
|
36
36
|
export type PptPersonaId = 'auto' | 'consulting' | 'tech-pitch' | 'academic' | 'gov-exec' | 'education' | 'editorial';
|
|
37
37
|
export type PptLanguage = 'zh' | 'en' | 'bilingual';
|
|
38
|
-
export type PptSlideLayout = 'cover' | 'agenda' | 'section' | 'bullets' | 'statement' | 'quote' | 'kpi' | 'cards' | 'comparison' | 'matrix' | 'process' | 'callout' | 'gantt' | 'architecture' | 'harvey' | 'tam' | 'org' | 'marimekko' | 'sankey' | 'swot' | 'table' | 'closing' | 'image' | 'image-left' | 'image-right' | 'chart' | 'chart-split' | 'gallery' | 'waterfall' | 'flywheel' | 'bento' | 'pillars' | 'exec-summary' | 'timeline' | 'steps' | 'layers' | 'funnel' | 'chevron' | 'value-chain' | 'issue-action' | 'before-after' | 'matrix-2x2' | 'kpi-grid' | 'scorecard' | 'formula-callout' | 'takeaways' | 'gallery-grid' | 'ablation-compare' | 'roadmap' | 'swimlane' | 'team' | 'mermaid' | 'flowchart' | 'sequence' | 'map' | 'world-map' | 'china-map' | 'geo-map' | 'isometric' | 'iso-stack' | 'iso-layers' | '3d-stack' | 'iso-pillars';
|
|
38
|
+
export type PptSlideLayout = 'cover' | 'agenda' | 'section' | 'bullets' | 'statement' | 'quote' | 'kpi' | 'cards' | 'comparison' | 'matrix' | 'process' | 'callout' | 'gantt' | 'architecture' | 'harvey' | 'tam' | 'org' | 'marimekko' | 'sankey' | 'swot' | 'table' | 'closing' | 'image' | 'image-left' | 'image-right' | 'chart' | 'chart-split' | 'gallery' | 'waterfall' | 'flywheel' | 'bento' | 'pillars' | 'exec-summary' | 'timeline' | 'steps' | 'layers' | 'funnel' | 'chevron' | 'value-chain' | 'issue-action' | 'before-after' | 'matrix-2x2' | 'kpi-grid' | 'scorecard' | 'formula-callout' | 'takeaways' | 'gallery-grid' | 'ablation-compare' | 'roadmap' | 'swimlane' | 'team' | 'mermaid' | 'flowchart' | 'sequence' | 'map' | 'world-map' | 'china-map' | 'geo-map' | 'isometric' | 'iso-stack' | 'iso-layers' | '3d-stack' | 'iso-pillars' | 'issue-tree' | 'mece' | 'logic-tree' | 'treemap' | 'rect-map' | 'budget-map' | 'gauge' | 'bullet-chart' | 'okr-gauge' | 'pricing' | 'tiers' | 'packages';
|
|
39
39
|
export type PptTemplateId = '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';
|
|
40
40
|
export type PptTableStyle = 'consulting' | 'booktabs' | 'minimal' | 'banded' | 'harvey';
|
|
41
41
|
export interface PptImageSpec {
|
|
@@ -69,6 +69,9 @@ export interface PptSlideItem {
|
|
|
69
69
|
role?: string;
|
|
70
70
|
conversion?: string;
|
|
71
71
|
icon?: string;
|
|
72
|
+
actual?: number;
|
|
73
|
+
target?: number;
|
|
74
|
+
max?: number;
|
|
72
75
|
status?: 'positive' | 'negative' | 'warning' | 'neutral' | 'accent';
|
|
73
76
|
tone?: 'positive' | 'negative' | 'warning' | 'neutral' | 'accent';
|
|
74
77
|
}
|
|
@@ -169,6 +172,13 @@ export interface PptCheckResult extends PptQualityResult {
|
|
|
169
172
|
verification: PptVerification;
|
|
170
173
|
render?: PptRenderResult;
|
|
171
174
|
}
|
|
175
|
+
export type PptExportKind = 'xlsx' | 'docx' | 'qa-prep' | 'memo' | 'social-carousel' | 'subtitles' | 'handout' | 'one-pager' | 'i18n';
|
|
176
|
+
export type PptMotionProfile = 'subtle' | 'executive' | 'keynote';
|
|
177
|
+
export interface PptMergeSource {
|
|
178
|
+
deckPath?: string;
|
|
179
|
+
slides?: Array<number | string>;
|
|
180
|
+
bankIds?: string[];
|
|
181
|
+
}
|
|
172
182
|
export interface PptEditArgs {
|
|
173
183
|
deckPath: string;
|
|
174
184
|
edits?: Array<{
|
|
@@ -185,6 +195,17 @@ export interface PptEditArgs {
|
|
|
185
195
|
brand?: PptBrand | null;
|
|
186
196
|
targetMinutes?: number | null;
|
|
187
197
|
remixPreset?: 'exec-5min' | 'board-brief' | 'sales-pitch';
|
|
198
|
+
motionProfile?: PptMotionProfile | null;
|
|
199
|
+
exports?: PptExportKind[];
|
|
200
|
+
saveToBank?: {
|
|
201
|
+
slide: number | string;
|
|
202
|
+
bankId?: string;
|
|
203
|
+
name?: string;
|
|
204
|
+
tags?: string[];
|
|
205
|
+
};
|
|
206
|
+
translations?: Record<string, unknown> | Array<Record<string, unknown>>;
|
|
207
|
+
bilingualMode?: boolean | 'replace' | 'bilingual';
|
|
208
|
+
targetLang?: PptLanguage;
|
|
188
209
|
expectedRevision?: number;
|
|
189
210
|
saveAs?: boolean;
|
|
190
211
|
}
|
|
@@ -237,6 +258,9 @@ export interface PptEvidenceEntry {
|
|
|
237
258
|
scope?: string;
|
|
238
259
|
url?: string;
|
|
239
260
|
confidence?: 'verified' | 'estimated' | 'conflicting' | 'unverified';
|
|
261
|
+
origin?: 'local-file' | 'web-research';
|
|
262
|
+
tier?: 1 | 2 | 3;
|
|
263
|
+
claimType?: 'actual' | 'forecast' | 'policy' | 'benchmark';
|
|
240
264
|
note?: string;
|
|
241
265
|
}
|
|
242
266
|
export interface PptSlideSpec {
|
|
@@ -246,6 +270,7 @@ export interface PptSlideSpec {
|
|
|
246
270
|
chrome?: PptChromeStyle | string;
|
|
247
271
|
cardMaterial?: PptCardMaterial;
|
|
248
272
|
iconMode?: PptIconMode;
|
|
273
|
+
reveal?: 'step' | 'all';
|
|
249
274
|
title?: string;
|
|
250
275
|
subtitle?: string;
|
|
251
276
|
kicker?: string;
|
|
@@ -315,6 +340,9 @@ export interface PptCreateArgs {
|
|
|
315
340
|
lang?: string;
|
|
316
341
|
/** 页间转场与要点入场动画:on(默认)/ off。 */
|
|
317
342
|
motion?: 'on' | 'off';
|
|
343
|
+
motionProfile?: PptMotionProfile;
|
|
344
|
+
exports?: PptExportKind[];
|
|
345
|
+
mergeSources?: PptMergeSource[];
|
|
318
346
|
outputDir?: string;
|
|
319
347
|
fileName?: string;
|
|
320
348
|
/** 是否覆盖同名三件套;默认 false,同名时自动选择唯一后缀。 */
|
|
@@ -377,6 +405,8 @@ export interface PptAbsorbArgs {
|
|
|
377
405
|
brandKitName?: string;
|
|
378
406
|
watermark?: string;
|
|
379
407
|
forbiddenTerms?: string[];
|
|
408
|
+
preferredSources?: string[];
|
|
409
|
+
blockedDomains?: string[];
|
|
380
410
|
signal?: AbortSignal;
|
|
381
411
|
}
|
|
382
412
|
export interface PptExemplarSummary {
|
|
@@ -459,6 +489,14 @@ export interface PptImportArgs {
|
|
|
459
489
|
export interface PptFromOfficeArgs {
|
|
460
490
|
filePath: string;
|
|
461
491
|
filePaths?: string[];
|
|
492
|
+
inspectOnly?: boolean;
|
|
493
|
+
instructions?: string;
|
|
494
|
+
maxSlides?: number;
|
|
495
|
+
includeSheets?: string[];
|
|
496
|
+
photoRoles?: Record<string, string>;
|
|
497
|
+
bindDataModel?: boolean;
|
|
498
|
+
evidence?: PptEvidenceEntry[];
|
|
499
|
+
exports?: PptExportKind[];
|
|
462
500
|
outputDir?: string;
|
|
463
501
|
fileName?: string;
|
|
464
502
|
theme?: string;
|
|
@@ -523,6 +561,17 @@ export interface PptCreateResult {
|
|
|
523
561
|
pptxPath: string;
|
|
524
562
|
jsonPath: string;
|
|
525
563
|
handoutPath?: string;
|
|
564
|
+
onePagerPath?: string;
|
|
565
|
+
carouselPath?: string;
|
|
566
|
+
subtitlesPath?: string;
|
|
567
|
+
xlsxPath?: string;
|
|
568
|
+
docxPath?: string;
|
|
569
|
+
memoPath?: string;
|
|
570
|
+
qaPrepPath?: string;
|
|
571
|
+
i18nPath?: string;
|
|
572
|
+
inspectOnly?: boolean;
|
|
573
|
+
dossierMarkdown?: string;
|
|
574
|
+
enrichmentPlan?: Record<string, unknown>;
|
|
526
575
|
deckId?: string;
|
|
527
576
|
revision?: number;
|
|
528
577
|
undoAvailable?: number;
|
|
@@ -563,6 +612,14 @@ export interface DeckEngine {
|
|
|
563
612
|
renderSocialCarouselHtml?(manifest: any, options?: Record<string, unknown>): string;
|
|
564
613
|
renderSubtitlesSrt?(manifest: any, lang?: string): string;
|
|
565
614
|
renderSubtitlesVtt?(manifest: any, lang?: string): string;
|
|
615
|
+
renderDeckWorkbookXlsx?(manifest: any): Buffer;
|
|
616
|
+
renderDeckReportDocx?(manifest: any, lang?: string): Buffer;
|
|
617
|
+
renderDeckMemoMarkdown?(manifest: any, lang?: string): string;
|
|
618
|
+
renderQaPrepMarkdown?(manifest: any, lang?: string): string;
|
|
619
|
+
extractTranslationBundle?(manifest: any): Record<string, unknown>;
|
|
620
|
+
applyTranslationBundle?(manifest: any, translations: unknown, options?: Record<string, unknown>): Record<string, unknown>;
|
|
621
|
+
listSlideBank?(cwd?: string, tag?: string): Record<string, unknown>;
|
|
622
|
+
mergeDecks?(options?: Record<string, unknown>): Promise<PptCreateResult>;
|
|
566
623
|
remixDeck?(options: Record<string, unknown>): Promise<PptCreateResult>;
|
|
567
624
|
loadWorkspaceBrandKit?(cwd?: string): Record<string, unknown> | null;
|
|
568
625
|
saveWorkspaceBrandKit?(cwd: string, rawKit: Record<string, unknown>): {
|
package/lib/workbench.js
CHANGED
|
@@ -22,6 +22,7 @@ const ALLOWED_LAYOUTS = new Set([
|
|
|
22
22
|
'marimekko', 'sankey', 'swot',
|
|
23
23
|
'mockup', 'code', 'quadrant', 'radar', 'dumbbell', 'heatmap',
|
|
24
24
|
'map', 'isometric',
|
|
25
|
+
'issue-tree', 'treemap', 'gauge', 'pricing',
|
|
25
26
|
'table', 'closing', 'image', 'image-left', 'image-right', 'chart', 'chart-split',
|
|
26
27
|
'waterfall', 'gallery', 'flywheel', 'chevron', 'value-chain',
|
|
27
28
|
'mermaid', 'flowchart', 'sequence',
|
|
@@ -35,7 +36,7 @@ const ALLOWED_ICON_MODES = new Set(['off', 'explicit', 'auto']);
|
|
|
35
36
|
const ALLOWED_COVER_PATTERNS = new Set(['dots', 'grid', 'rings', 'waves', 'isometric-mesh', 'editorial-arcs']);
|
|
36
37
|
const ALLOWED_FOCAL_POINTS = new Set(['center', 'top', 'bottom', 'left', 'right']);
|
|
37
38
|
const ALLOWED_REMIX_PRESETS = new Set(['exec-5min', 'board-brief', 'sales-pitch']);
|
|
38
|
-
const ITEM_KEYS = new Set(['tag', 'badge', 'title', 'text', 'body', 'value', 'unit', 'delta', 'start', 'span', 'milestone', 'role', 'conversion', 'icon', 'avatar', 'x', 'y', 'size', 'before', 'after', 'status', 'tone', 'bullets']);
|
|
39
|
+
const ITEM_KEYS = new Set(['tag', 'badge', 'title', 'text', 'body', 'value', 'unit', 'delta', 'start', 'span', 'milestone', 'role', 'conversion', 'icon', 'avatar', 'x', 'y', 'size', 'before', 'after', 'actual', 'target', 'max', 'status', 'tone', 'bullets']);
|
|
39
40
|
const BRAND_KEYS = new Set(['name', 'primaryColor', 'secondaryColor', 'backgroundColor', 'textColor', 'fontFamily', 'headingFont', 'coverMode', 'coverBg', 'logo', 'footer', 'watermark', 'chromeStyle', 'cardMaterial', 'iconMode', 'taste']);
|
|
40
41
|
const VISUAL_KEYS = new Set(['titleSize', 'bodySize', 'chartLabelSize', 'density', 'tableStyle', 'chrome']);
|
|
41
42
|
/** Sharing keeps the offline deck, but omits the control for a project not in the ZIP. */
|
|
@@ -1530,8 +1531,23 @@ export class PptWorkbench {
|
|
|
1530
1531
|
};
|
|
1531
1532
|
}
|
|
1532
1533
|
if (body.operation === 'download') {
|
|
1533
|
-
if (!['html', 'pptx', 'json', 'handout', 'onepager', 'social-carousel', 'subtitles', 'remotion'].includes(String(body.kind)))
|
|
1534
|
+
if (!['html', 'pptx', 'json', 'handout', 'onepager', 'social-carousel', 'subtitles', 'remotion', 'xlsx', 'docx', 'qa-prep'].includes(String(body.kind)))
|
|
1534
1535
|
throw new Error('不支持此文件类型');
|
|
1536
|
+
if (body.kind === 'xlsx') {
|
|
1537
|
+
if (typeof engine.renderDeckWorkbookXlsx !== 'function')
|
|
1538
|
+
throw new Error('当前引擎版本暂不支持 Excel 工作簿导出');
|
|
1539
|
+
return { ok: true, name: basename(entry.path, '.json') + '.xlsx', data: engine.renderDeckWorkbookXlsx(manifest).toString('base64') };
|
|
1540
|
+
}
|
|
1541
|
+
if (body.kind === 'docx') {
|
|
1542
|
+
if (typeof engine.renderDeckReportDocx !== 'function')
|
|
1543
|
+
throw new Error('当前引擎版本暂不支持 Word 文档导出');
|
|
1544
|
+
return { ok: true, name: basename(entry.path, '.json') + '.docx', data: engine.renderDeckReportDocx(manifest, manifest.language).toString('base64') };
|
|
1545
|
+
}
|
|
1546
|
+
if (body.kind === 'qa-prep') {
|
|
1547
|
+
if (typeof engine.renderQaPrepMarkdown !== 'function')
|
|
1548
|
+
throw new Error('当前引擎版本暂不支持会前质询预案导出');
|
|
1549
|
+
return { ok: true, name: basename(entry.path, '.json') + '.qa-prep.md', data: Buffer.from(engine.renderQaPrepMarkdown(manifest, manifest.language), 'utf8').toString('base64') };
|
|
1550
|
+
}
|
|
1535
1551
|
if (body.kind === 'handout') {
|
|
1536
1552
|
const handoutPath = files.json.slice(0, -5) + '.handout.md';
|
|
1537
1553
|
if (existsSync(handoutPath))
|
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.35.0",
|
|
4
|
+
"description": "DeepSeek Harness 大师级演示文稿引擎与工作台:支持三模路由(有资料直出 / 零资料 8 域权威深研 / Mode C 本地多源融合+外源对标)、企业品牌宪章锁(SLOP-13/14)、41 种原生可编辑图谱(MECE 议题树/Treemap/OKR 子弹仪/三档报价/点阵地图/2.5D 等轴测/Mermaid/公式/代码)、24 主题 / 20 标杆范本、逆向导出 Excel/Word/备忘录/答辩预案/无损翻译包、企业金页库拼装与离线 R 键审阅回流。欢迎 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,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
|
| --- | --- |
|