dsh-ppt 0.5.1 → 0.6.0

package/lib/tools.js

@@ -1,4 +1,30 @@
 import { createPptExecutors } from './execution.js';
+/** Harness uses disjoint oneOf branches for unions, never type arrays. */
+function compileNode(node) {
+    if (Array.isArray(node.type)) {
+        const { type, description, properties, additionalProperties, items, required, ...shared } = node;
+        return {
+            ...(description !== undefined ? { description } : {}),
+            oneOf: type.map(kind => compileNode({
+                ...shared, type: kind,
+                ...(kind === 'object' ? {
+                    ...(properties !== undefined ? { properties } : {}),
+                    ...(additionalProperties !== undefined ? { additionalProperties } : {}),
+                    ...(required !== undefined ? { required } : {}),
+                } : {}),
+                ...(kind === 'array' && items !== undefined ? { items } : {}),
+            })),
+        };
+    }
+    const compiled = { ...node };
+    if (node.properties)
+        compiled.properties = Object.fromEntries(Object.entries(node.properties).map(([key, value]) => [key, compileNode(value)]));
+    if (node.items)
+        compiled.items = compileNode(node.items);
+    if (Array.isArray(node.oneOf))
+        compiled.oneOf = node.oneOf.map(value => compileNode(value));
+    return compiled;
+}
 function compileParameters(spec) {
     const properties = {};
     const required = [];
@@ -6,19 +32,19 @@ function compileParameters(spec) {
         if (prop?.required === true)
             required.push(key);
         const node = {};
-        if (typeof prop?.type === 'string')
+        if (typeof prop?.type === 'string' || Array.isArray(prop?.type))
             node.type = prop.type;
         if (typeof prop?.description === 'string')
             node.description = prop.description;
         if (Array.isArray(prop?.enum))
             node.enum = prop.enum;
-        if (prop?.type === 'array' && prop.items !== null && typeof prop.items === 'object') {
-            node.items = {
-                type: prop.items.type === 'object' ? 'object' : 'string',
-                ...(prop.items.type === 'object' ? { additionalProperties: true } : {}),
-            };
-        }
-        properties[key] = node;
+        if (prop?.type === 'array' && prop.items !== null && typeof prop.items === 'object')
+            node.items = prop.items;
+        if (prop.properties)
+            node.properties = prop.properties;
+        if (prop.additionalProperties !== undefined)
+            node.additionalProperties = prop.additionalProperties;
+        properties[key] = compileNode(node);
     }
     return { type: 'object', properties, ...(required.length > 0 ? { required } : {}) };
 }
@@ -82,12 +108,60 @@ function renderThemes(value) {
     return oneText(summary + '\n\n想要并排对比：ppt_themes { preview: true, outputDir: "..." } 会生成 themes-preview.html 和每套主题的 SVG 色板卡。');
 }
 function renderCreate(value) {
-    return oneText('dsh-ppt 已生成 ' + value.slideCount + ' 页演示文稿（主题 ' + value.theme + '，语言 ' + value.language + '）：\n' +
+    return oneText('dsh-ppt 已生成 ' + value.slideCount + ' 页' + (value.deliveryStatus === 'draft' ? '草稿（还有待填写内容，不能作为成品交付）' : '演示文稿') + '（主题 ' + value.theme + '，语言 ' + value.language + '）：\n' +
         'HTML 网页放映：' + value.htmlPath + '\n' +
         'PPTX 导出：' + value.pptxPath + '\n' +
         'Manifest：' + value.jsonPath + '\n' +
-        'HTML 双击即可放映（← → 翻页 / V 演讲者视图 / S 备注 / G 缩略图总览 / F 全屏 / P 打印 / ? 快捷键）；PPTX 可用 PowerPoint / WPS / Keynote 打开。');
+        'HTML 双击即可放映（← → 翻页 / V 演讲者视图 / S 备注 / G 缩略图总览 / F 全屏 / P 打印 / ? 快捷键）；PPTX 可用 PowerPoint / WPS / Keynote 打开。' +
+        (value.revision !== undefined ? '\n修订号：' + value.revision + '；可撤销修改：' + value.undoAvailable + '。用 ppt_edit 修改指定页，ppt_undo 撤销。' : '') +
+        (value.quality ? '\n\n' + qualityText(value.quality) : ''));
+}
+function qualityText(value) {
+    return '质量检查：' + value.errorCount + ' 个错误，' + value.warningCount + ' 个提醒。\n' +
+        value.issues.slice(0, 12).map(issue => '第 ' + issue.slide + ' 页：' + issue.message + '；' + issue.suggestion).join('\n') +
+        (value.issues.length > 12 ? '\n其余提醒请查看结构化结果。' : '') + '\n' + value.note;
 }
+function renderCheck(value) {
+    return oneText(qualityText(value) + '\nPPTX 渲染：' + (value.verification?.pptxRender === 'rendered' ? '已核验当前文件的渲染输出' : '尚未验证') +
+        '；视觉检查：需查看实际画面。' + (value.render?.message ? '\n' + value.render.message : '') +
+        (value.render?.missingFonts?.length ? '\n缺失字体：' + value.render.missingFonts.join('、') + '。请替换为可用字体，重新生成并检查每页；解决前需标注字体问题。' : ''));
+}
+function renderPreview(value) {
+    if (!value.ok)
+        return oneText((value.message || 'PPTX 尚未渲染。') + (value.installationHint ? '\n' + value.installationHint : ''));
+    return oneText('PPTX 已渲染 ' + value.slideCount + ' 页（' + value.backend + '）：\n' +
+        (value.pngPaths?.length ? '逐页 PNG：\n' + value.pngPaths.slice(0, 6).join('\n') + (value.pngPaths.length > 6 ? '\n其余页面见结构化结果。' : '') + '\n' : '') +
+        (value.pdfPath ? 'PDF：' + value.pdfPath + '\n' : '') + '渲染收据：' + value.receiptPath +
+        '\n缺失字体：' + (value.missingFonts?.join('、') || '引擎未报告缺失字体') +
+        (value.missingFonts?.length ? '\n请先替换为环境和目标机器可用字体，重新生成并渲染检查；解决前不能声称已验收。' : '') +
+        '\n请查看实际画面，确认文字、图片和图表后再交付。原可编辑 PPTX 保留。');
+}
+const imageSchema = { type: ['object', 'string', 'null'], properties: {
+        src: { type: 'string', description: 'Local PNG/JPEG path relative to the session cwd, or image data URI. Embedded into all output files.' },
+        alt: { type: 'string' }, fit: { type: 'string', enum: ['contain', 'cover'] }, caption: { type: 'string' },
+    }, additionalProperties: false };
+const chartSchema = { type: ['object', 'null'], properties: {
+        kind: { type: 'string', enum: ['column', 'bar', 'line', 'pie'] },
+        categories: { type: 'array', items: { type: ['string', 'number'] } },
+        series: { type: 'array', items: { type: 'object', properties: { name: { type: 'string' }, values: { type: 'array', items: { type: ['number', 'string'] } } }, required: ['name', 'values'], additionalProperties: false } },
+        rows: { type: 'array', items: { type: 'array', items: { type: ['string', 'number'] } }, description: 'Alternative: header row [category, series names], then category/value rows.' },
+        unit: { type: 'string' }, caption: { type: 'string' },
+    }, additionalProperties: false };
+const brandProperties = {
+    name: { type: 'string' }, primaryColor: { type: 'string' }, backgroundColor: { type: 'string' }, textColor: { type: 'string' },
+    fontFamily: { type: 'string', description: 'One installed font family; choose a font available on the recipient computer.' },
+    logo: { type: ['string', 'null'], description: 'Local PNG/JPEG logo path; null clears logo during edit.' }, footer: { type: 'string' },
+};
+const slideProperties = {
+    layout: { type: 'string', enum: ['cover', 'section', 'bullets', 'statement', 'quote', 'table', 'closing', 'image', 'image-left', 'image-right', 'chart'] },
+    title: { type: 'string' }, subtitle: { type: 'string' }, kicker: { type: 'string' }, text: { type: 'string' }, notes: { type: 'string' },
+    bullets: { type: 'array', items: { type: 'string' } }, rows: { type: 'array', items: { type: 'array', items: { type: ['string', 'number'] } } },
+    image: imageSchema, chart: chartSchema,
+};
+const projectParameters = {
+    deckPath: { type: 'string', required: true, description: 'Path to a dsh-ppt .json project, relative to this session cwd or absolute. Arbitrary external PPTX editing is not supported.' },
+    expectedRevision: { type: 'integer', description: 'Use revision returned by ppt_create/ppt_check to prevent overwriting another edit.' },
+};
 /** Assemble presentation schemas, rendering and the session-aware executors. */
 export function buildPptTools(config) {
     const executors = createPptExecutors(config);
@@ -109,14 +183,16 @@ export function buildPptTools(config) {
         },
         {
             name: 'ppt_create',
-            description: 'Build a complete presentation deck from one sentence or a Markdown document and write three artifacts to outputDir: a standalone HTML web slideshow, an editable 16:9 PPTX, and a deck.json manifest. Five built-in visual themes are available (see ppt_themes). content is Markdown text (recommended); advanced callers may pass structured slides instead. 中文：把一句话或一篇 Markdown 文档生成完整演示文稿，写入 outputDir 三个文件：独立 HTML 网页放映、可编辑 16:9 PPTX、deck.json manifest；内置 5 套视觉主题。',
+            description: 'Generate a standalone HTML slideshow, editable 16:9 PPTX and JSON project from prepared Markdown or structured slides. Organize actual facts and content before calling; this deterministic generator does not invent missing facts or research them. Supports five themes, local images, native editable charts and shared branding. Check and visually review artifacts before delivery; template-only output is an unfilled draft. 中文：先组织事实与内容，再生成可直接放映和继续编辑的三件套；支持图片、原生图表与品牌，交付前检查成品。',
             parameters: compileParameters({
                 title: { type: 'string', required: true, description: 'Deck title (used for the cover and file names).' },
                 content: { type: 'string', description: 'Markdown content: one sentence, a paragraph, or a full document. First # heading becomes the cover title; ## headings become slides; -/* lists become bullets; | ... | tables paginate with repeated headers (8 data rows/page, up to 8 columns and 60 characters/cell); > blockquotes become quote slides; <!-- 备注: ... --> comments become speaker notes. Required unless slides is provided.' },
                 theme: { type: 'string', description: 'Visual theme id: swiss / velvet / data / soft / bold. Default data. See ppt_themes.' },
                 lang: { type: 'string', description: 'UI language of the generated player: zh (default), en, or bilingual. Content language is whatever you write.' },
                 motion: { type: 'string', enum: ['on', 'off'], description: 'Slide transitions plus bullet entrance animations: on (default) or off for a fully static deck.' },
-                slides: { type: 'array', items: { type: 'object', additionalProperties: true }, description: 'Optional structured slides: [{ layout: cover|section|bullets|statement|quote|table|closing, title, subtitle, kicker, bullets: [], rows: [][] (for table), notes: "speaker notes" }]. Tables paginate with repeated headers (8 data rows/page, up to 8 columns and 60 characters/cell). Exceeding the configured maxSlides returns an error before writing. Use this for precise control instead of content.' },
+                slides: { type: 'array', items: { type: 'object', properties: slideProperties, additionalProperties: true }, description: 'Structured slides including image/image-left/image-right and chart. Images: {src, alt, fit: contain|cover, caption}. Charts: {kind: column|bar|line|pie, categories, series:[{name,values}]} or rows with header. Tables paginate at 8 data rows. Keep full content editable; use images only for actual photos/screenshots/logos.' },
+                template: { type: 'string', enum: ['weekly', 'defense', 'project', 'pitch'], description: 'Scenario reference from ppt_templates. Provide finished content/slides following its outline. Template alone creates a clearly marked draft with unfilled slots, never a finished presentation.' },
+                brand: { type: 'object', properties: brandProperties, additionalProperties: false, description: 'Shared brand: #RRGGBB primary/background/text colors, fontFamily, logo and footer. Applied to HTML and PPTX.' },
                 outputDir: { type: 'string', description: 'Directory to write the files into. Default: session working directory (or the plugin outputDir config).' },
                 fileName: { type: 'string', description: 'Base file name for the three artifacts. Default: sanitized deck title.' },
                 overwrite: { type: 'boolean', description: 'Replace an existing same-name HTML/PPTX/JSON trio. Default false: choose a unique numeric suffix instead.' },
@@ -127,5 +203,51 @@ export function buildPptTools(config) {
             },
             execute: executors.create,
         },
+        {
+            name: 'ppt_templates',
+            description: 'List weekly report, thesis defense, project update and pitch scenario outlines and draft structures. Use as internal content planning references; fill actual facts before delivering a finished deck. 中文：查看周报、答辩、项目汇报和路演的结构参考，组织并填写真实内容后再调用 ppt_create 交付成品。',
+            parameters: compileParameters({ lang: { type: 'string', description: 'zh / en / bilingual, default zh.' } }),
+            output: { schema: { type: 'object', additionalProperties: true }, render: (_args, value) => oneText(JSON.stringify(value, null, 2)) },
+            execute: executors.templates,
+        },
+        {
+            name: 'ppt_edit',
+            description: 'Modify selected slides in an existing dsh-ppt JSON project, preserving other pages and stable IDs. Each edit uses a 1-based slide number or ID and a patch of changed fields. Regenerates the HTML/PPTX/JSON trio atomically, embeds new images, stores undo history. Use ppt_check first and expectedRevision. 中文：按页码或 ID 修改指定页，其他页不变，支持撤销；可同步调整品牌。',
+            parameters: compileParameters({ ...projectParameters,
+                edits: { type: 'array', items: { type: 'object', properties: { slide: { type: ['integer', 'string'], description: '1-based page number or stable slide ID' }, patch: { type: 'object', properties: slideProperties, additionalProperties: false } }, required: ['slide', 'patch'], additionalProperties: false } },
+                brand: { type: ['object', 'null'], properties: brandProperties, additionalProperties: false, description: 'Merge shared branding. null clears all branding. Empty footer clears footer; logo:null clears logo.' },
+            }),
+            output: { schema: createResultSchema, render: (_args, value) => renderCreate(value) },
+            execute: executors.edit,
+        },
+        {
+            name: 'ppt_undo',
+            description: 'Undo the most recent edit in a dsh-ppt JSON project, restoring slides, charts, embedded images and branding together. Revision increases so stale edits cannot overwrite the undo. Keeps up to 20 edits. 中文：撤销最近一次修改，恢复正文、图表、图片和品牌设置。',
+            parameters: compileParameters(projectParameters),
+            output: { schema: createResultSchema, render: (_args, value) => renderCreate(value) },
+            execute: executors.undo,
+        },
+        {
+            name: 'ppt_check',
+            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. 中文：交付前检查工程，定位具体页的问题并给出修改建议，不改文件。',
+            parameters: compileParameters({ deckPath: projectParameters.deckPath,
+                renderReceipt: { type: 'string', description: 'Optional receiptPath returned by ppt_render. Rechecks current PPTX hash and every rendered output; never implies a visual pass.' },
+            }),
+            output: { schema: { type: 'object', additionalProperties: true }, render: (_args, value) => renderCheck(value) },
+            execute: executors.check,
+        },
+        {
+            name: 'ppt_render',
+            description: 'Read the final PPTX and render all pages to PNG, PDF, or both using optional official @deepseek-ai/libreoffice-kit@0.1.3. Returns unavailable plus installation guidance when absent; ordinary deck creation remains usable. Retains original editable PPTX and creates a separate unique output folder and integrity receipt. Reports missing fonts. Inspect actual pages before delivery. 中文：把最终 PPTX 渲染为逐页图片和 PDF，报告缺失字体；需安装可选官方引擎，渲染成功仍需检查画面。',
+            parameters: compileParameters({
+                pptxPath: { type: 'string', required: true, description: 'Final .pptx path, absolute or relative to session cwd.' },
+                outputDir: { type: 'string', description: 'Base output folder. Existing folders are preserved; creates a unique sibling when needed. Default <deck>-render.' },
+                format: { type: 'string', enum: ['png', 'pdf', 'both'], description: 'png (default), pdf, or both.' },
+                width: { type: 'integer', description: 'PNG target width 320–3840, default 1440; scales from actual page dimensions.' },
+                timeoutMs: { type: 'integer', description: 'Whole rendering deadline in milliseconds, 1000–300000, default 120000.' },
+            }),
+            output: { schema: { type: 'object', additionalProperties: true }, render: (_args, value) => renderPreview(value) },
+            execute: executors.render,
+        },
     ];
 }

package/lib/types.d.ts

@@ -1,8 +1,99 @@
 /** dsh-ppt 的公共类型。 */
 export type PptThemeId = 'swiss' | 'velvet' | 'data' | 'soft' | 'bold';
 export type PptLanguage = 'zh' | 'en' | 'bilingual';
-export type PptSlideLayout = 'cover' | 'section' | 'bullets' | 'statement' | 'quote' | 'table' | 'closing';
+export type PptSlideLayout = 'cover' | 'section' | 'bullets' | 'statement' | 'quote' | 'table' | 'closing' | 'image' | 'image-left' | 'image-right' | 'chart';
+export type PptTemplateId = 'weekly' | 'defense' | 'project' | 'pitch';
+export interface PptImageSpec {
+    src?: string;
+    assetId?: string;
+    alt?: string;
+    fit?: 'contain' | 'cover';
+    caption?: string;
+}
+export interface PptChartSpec {
+    kind?: 'column' | 'bar' | 'line' | 'pie';
+    categories?: Array<string | number>;
+    series?: Array<{
+        name: string;
+        values: Array<string | number>;
+    }>;
+    rows?: Array<Array<string | number>>;
+    unit?: string;
+    caption?: string;
+}
+export interface PptBrand {
+    name?: string;
+    primaryColor?: string;
+    backgroundColor?: string;
+    textColor?: string;
+    fontFamily?: string;
+    logo?: string | null;
+    footer?: string;
+}
+export interface PptQualityIssue {
+    slide: number;
+    slideId?: string;
+    severity: 'warning' | 'error';
+    code: string;
+    message: string;
+    suggestion: string;
+}
+export interface PptQualityResult {
+    ok: boolean;
+    slideCount: number;
+    errorCount: number;
+    warningCount: number;
+    issues: PptQualityIssue[];
+    note: string;
+}
+export interface PptVerification {
+    static: 'checked';
+    pptxRender: 'not-verified' | 'rendered';
+    visual: 'not-verified';
+}
+export interface PptRenderArgs {
+    pptxPath: string;
+    outputDir?: string;
+    format?: 'png' | 'pdf' | 'both';
+    width?: number;
+    timeoutMs?: number;
+}
+export interface PptRenderResult {
+    ok: boolean;
+    status: 'unavailable' | 'not-verified' | 'rendered';
+    backend?: string;
+    rendererVersion?: string;
+    sourceSha256?: string;
+    outputDir?: string;
+    reason?: string;
+    slideCount?: number;
+    pngPaths?: string[];
+    pdfPath?: string;
+    receiptPath?: string;
+    missingFonts?: string[];
+    message?: string;
+    installationHint?: string;
+    visual?: 'not-verified';
+}
+export interface PptCheckResult extends PptQualityResult {
+    verification: PptVerification;
+    render?: PptRenderResult;
+}
+export interface PptEditArgs {
+    deckPath: string;
+    edits?: Array<{
+        slide: number | string;
+        patch: Partial<Omit<PptSlideSpec, 'id'>>;
+    }>;
+    brand?: PptBrand | null;
+    expectedRevision?: number;
+}
+export interface PptProjectArgs {
+    deckPath: string;
+    expectedRevision?: number;
+}
 export interface PptSlideSpec {
+    id?: string;
     layout?: PptSlideLayout;
     title?: string;
     subtitle?: string;
@@ -13,6 +104,8 @@ export interface PptSlideSpec {
     rows?: Array<Array<string | number>>;
     /** 演讲者备注；写入 HTML 备注面板与 PPTX 原生备注页。 */
     notes?: string;
+    image?: PptImageSpec | string | null;
+    chart?: PptChartSpec | null;
 }
 export interface PptConfig {
     /** 默认输出目录；调用 ppt_create 时可用 outputDir 覆盖。相对路径按会话工作目录解析。 */
@@ -38,6 +131,8 @@ export interface PptCreateArgs {
     fileName?: string;
     /** 是否覆盖同名三件套；默认 false，同名时自动选择唯一后缀。 */
     overwrite?: boolean;
+    template?: PptTemplateId;
+    brand?: PptBrand;
 }
 export interface PptThemeInfo {
     id: string;
@@ -80,9 +175,22 @@ export interface PptCreateResult {
     htmlPath: string;
     pptxPath: string;
     jsonPath: string;
+    deckId?: string;
+    revision?: number;
+    undoAvailable?: number;
+    deliveryStatus?: 'draft' | 'ready-for-review';
+    quality?: PptQualityResult;
+    verification?: PptVerification;
 }
-/** deck-core.mjs 暴露给插件的最小面。 */
+/** Shared generator and optional renderer exposed to the plugin. */
 export interface DeckEngine {
+    buildDeckAsync?(options: Record<string, unknown>): Promise<PptCreateResult>;
+    listTemplates(lang?: string): unknown[];
+    editDeck(options: Record<string, unknown>): Promise<PptCreateResult>;
+    undoDeck(options: Record<string, unknown>): Promise<PptCreateResult>;
+    checkDeck(options: Record<string, unknown>): PptQualityResult;
+    checkDeckAsync?(options: Record<string, unknown>): Promise<PptCheckResult>;
+    renderDeck(options: Record<string, unknown>): Promise<PptRenderResult>;
     buildDeck(options: Record<string, unknown>): PptCreateResult;
     buildThemePreview(options: Record<string, unknown>): PptThemePreviewResult;
     listThemes(lang?: string): PptThemeInfo[];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-ppt",
-  "version": "0.5.1",
-  "description": "DSH 演示文稿插件：Markdown 生成网页放映与可编辑 PPTX，长表格自动分页，内置 5 套主题、备注与转场动画。",
+  "version": "0.6.0",
+  "description": "DSH 演示文稿插件：HTML 与可编辑 PPTX、图文排版、原生图表、按页编辑撤销、质量检查与可选官方 PNG/PDF 渲染。",
   "type": "module",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
@@ -12,6 +12,8 @@
     },
     "./skills/*": "./skills/*",
     "./deck-core": "./skills/dsh-ppt/scripts/deck-core.mjs",
+    "./deck-advanced": "./skills/dsh-ppt/scripts/deck-advanced.mjs",
+    "./deck-render": "./skills/dsh-ppt/scripts/deck-render.mjs",
     "./build-deck": "./skills/dsh-ppt/scripts/build-deck.mjs",
     "./cordis.patch.yml": "./cordis.patch.yml",
     "./package.json": "./package.json"
@@ -19,6 +21,7 @@
   "files": [
     "lib",
     "skills",
+    "docs",
     "cordis.patch.yml",
     "README.md",
     "README.en.md",
@@ -66,5 +69,16 @@
   },
   "homepage": "https://github.com/STARDUSTLC666/dsh-ppt#readme",
   "author": "stardustlc",
-  "packageManager": "pnpm@11.7.0"
+  "packageManager": "pnpm@11.7.0",
+  "dependencies": {
+    "@office-kit/pptx": "0.21.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/libreoffice-kit": "0.1.3"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/libreoffice-kit": {
+      "optional": true
+    }
+  }
 }

package/skills/dsh-ppt/SKILL.md

@@ -1,7 +1,7 @@
 ---
 name: dsh-ppt
 description: "Turn one sentence or a Markdown document into a complete, presentation-ready deck: a standalone HTML web slideshow plus an editable PPTX export, with 5 built-in visual themes (Swiss Pulse / Velvet Standard / Data Drift / Soft Signal / Maximalist Type), slide transitions + bullet entrance animations (motion, on by default), and bilingual Chinese/English support. Use when the user asks for a PPT, slides, deck, keynote, 演示文稿, 幻灯片, 汇报, 提案, 路演, 培训材料, or wants to turn a document into a presentation. 中文：把一句话或一篇文档变成完整演示文稿（HTML 网页放映 + PPTX 导出），内置 5 套视觉主题、页间转场与要点入场动画，中英双语。"
-compatibility: "DSH plugin runs in-process with zero runtime dependencies. The standalone CLI needs Node.js >= 20. Cross-harness: copy this skill directory into any Agent Skills directory."
+compatibility: "Node ^22.19.0 or >=24.0.0. Images/charts use @office-kit/pptx@0.21.0. Optional PNG/PDF renderer: @deepseek-ai/libreoffice-kit@0.1.3. Cross-harness: copy the full directory and run npm install --ignore-scripts there."
 allowed-tools: "Bash, Read, Write, Edit"
 ---
 
@@ -19,6 +19,8 @@ allowed-tools: "Bash, Read, Write, Edit"
 - 内容语言由你撰写；`lang` 只决定界面文字。
 - 先选主题再构建；不确定就用默认 `data`。
 - 交付前逐项过一遍文末「质量门禁」。
+- 目标是可用成品：先组织真实内容，再调用生成器；未填模板必须标注草稿，不编造缺失事实。
+- 渲染报告缺失字体时，替换为环境和接收方机器可用字体，重新生成并逐页检查；未解决需标注字体问题，不能声称已验收。
 
 ## 核心流水线
 
@@ -32,7 +34,7 @@ allowed-tools: "Bash, Read, Write, Edit"
    - 跨 harness：`node <skill-dir>/scripts/build-deck.mjs --title "标题" --content deck.md --theme data --lang zh --out dist`。
    - 动效默认开（页间转场 + 要点逐条入场）；严肃/打印场景传 `motion: 'off'`。
    → 用表格 / 金句 / 备注 / 结构化 slides 前读 `references/syntax.md`。
-5. **Verify 校验**：确认 HTML 页数与大纲一致、标题无截断、PPTX 文件头为 `PK`。
+5. **Verify 校验与修正**：调 `ppt_check` 检查具体页；在浏览器操作放映、总览和备注，查看图片/图表。若可选官方引擎可用，调 `ppt_render` 读取最终 PPTX 生成逐页 PNG/PDF，逐页看画面。修正用 `ppt_edit`，以 `expectedRevision` 防冲突；需要时 `ppt_undo`。修改后重新渲染，以收据复核当前文件。文件头/结构通过不等同于视觉验收，静态估算、渲染、视觉检查必须分开说明。
 6. **Deliver 交付**：给用户三个绝对路径，说明 HTML 直接放映（← → 翻页 · F 全屏 · G 总览 · S 备注 · P 打印），PPTX 用 PowerPoint / WPS / Keynote 打开（备注在演示者视图可见，bullets 页放映时逐条点击出现）。
 
 ## 按需装载索引
@@ -42,6 +44,7 @@ allowed-tools: "Bash, Read, Write, Edit"
 | 写大纲 / 正文前 | `references/copywriting.md` | 叙事骨架、单页规则、双语规则 |
 | 选主题拿不准 | `references/themes.md` | 5 套主题色板 + 情绪决策树 |
 | 用表格/金句/备注/结构化 slides | `references/syntax.md` | Markdown 解析、进阶语法、slides JSON、motion 开关 |
+| 图片/图表/模板/品牌/编辑/渲染 | `references/advanced.md` | 参数、限制、草稿与成品、收据语义 |
 | 交付异常 | `references/troubleshooting.md` | 症状 → 处理对照表 |
 
 ## 质量门禁（交付前逐项确认）
@@ -53,10 +56,12 @@ allowed-tools: "Bash, Read, Write, Edit"
 - [ ] 中文内容无错别字；英文标题用 Title Case。
 - [ ] 最后一页有可执行的行动号召，不只是「谢谢」。
 - [ ] 文件已写到用户工作区，路径为绝对路径。
+- [ ] 没有未填模板；保留真实数据来源，检查每页画面而非只检查生成成功。
+- [ ] 图片嵌入成功，图表与原始数据一致；渲染收据匹配最终 PPTX，说明尚未验证的部分。
 
 ## 跨 harness 安装
 
-把整个 `dsh-ppt` 技能目录复制到目标 agent 的技能目录即可（只依赖 Node 20+）：
+把整个 `dsh-ppt` 技能目录复制到目标 agent 的技能目录，使用 Node `^22.19.0 || >=24.0.0`，在该目录运行 `npm install --ignore-scripts`。纯文本可直接运行；图片/图表/品牌导出需要 Office Kit，PNG/PDF 需另外安装可选官方引擎：
 
 | Agent | 技能目录 |
 | --- | --- |

package/skills/dsh-ppt/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "dsh-ppt-skill",
+  "version": "0.6.0",
+  "private": true,
+  "type": "module",
+  "description": "Standalone dsh-ppt skill dependencies for image/chart export",
+  "dependencies": { "@office-kit/pptx": "0.21.0" },
+  "peerDependencies": { "@deepseek-ai/libreoffice-kit": "0.1.3" },
+  "peerDependenciesMeta": { "@deepseek-ai/libreoffice-kit": { "optional": true } },
+  "engines": { "node": "^22.19.0 || >=24.0.0" }
+}

package/skills/dsh-ppt/references/advanced.md

@@ -0,0 +1,39 @@
+# 图文、图表、工程编辑与渲染
+
+Agent 先准备实际内容，再生成可放映 HTML 与可编辑 PPTX。用户无需填写 JSON。以下是工具接口参考。
+
+## 创建
+
+`ppt_templates` 提供 weekly、defense、project、pitch 四种结构参考。`ppt_create` 的 `template` 单独使用时生成待填草稿，返回 `deliveryStatus:draft`；提供完成的 content/slides 才能开始成品验收。
+
+`slides` 新增 image/image-left/image-right/chart 布局。图片示例：`{layout:"image-left",title:"新版流程更短",image:{src:"assets/flow.png",alt:"新版流程截图",fit:"contain"},bullets:["可直接生成","可修改指定页"]}`。PNG/JPEG 本地路径按会话 cwd 解析，亦支持 data URI；每张5MiB/3200万像素、合计32MiB。图片嵌入工程和输出，移动原文件后仍可使用。contain完整显示，cover居中裁切。外链/SVG需先由明确授权的其他工具准备，不自动下载。
+
+图表示例：`{layout:"chart",title:"完成量逐月增加",chart:{kind:"column",categories:["七月","八月","九月"],series:[{name:"完成量",values:[3,5,9]}],unit:"项"}}`。支持 column/bar/line/pie，也可用带表头 rows。长度必须一致，值必须有限；pie仅一个非负系列、正总和。原生PPTX图表包含编辑数据工作簿，HTML有SVG与读屏数据表。
+
+共享品牌 `brand:{primaryColor:"#2C9F87",fontFamily:"Microsoft YaHei",logo:"logo.png",footer:"产品团队 · 2026"}`。还可设背景/文字色及name。选择接收方可用字体；字体诊断不自动安装字体。
+
+## 修改与撤销
+
+先 `ppt_check {deckPath:"report.json"}` 取得当前revision和页面ID。修改：`ppt_edit {deckPath:"report.json",expectedRevision:0,edits:[{slide:3,patch:{title:"新标题",bullets:["事实一","行动"]}}]}`。slide为1起始页码或ID，其他页保留；重复指定页拒绝。可单独修改brand；brand:null清空品牌，logo:null清空Logo，空footer清空页脚。
+
+编辑会原子更新整套HTML/PPTX/JSON，失败回滚。历史最多20次。`ppt_undo {deckPath:"report.json",expectedRevision:1}` 恢复上次状态，包含图片/图表/品牌；revision继续增长，旧修改不可覆盖撤销。仅编辑本插件JSON工程，不导入任意外部PPTX进行修改。编辑不能新增/删除页；表格扩大到需要分页时会要求另建文稿。
+
+## 检查与渲染
+
+`ppt_check` 定位页面问题，包括密度、估计溢出、7–8列表格14pt、图片缺失/损坏/分辨率、图表标签和对比度。6列以内原生表格17pt。静态估算不能保证字体或视觉布局。
+
+可选安装 `npm install --ignore-scripts @deepseek-ai/libreoffice-kit@0.1.3`。Windows还需相应架构的VC++v14运行库。`ppt_render {pptxPath:"report.pptx",format:"both"}` 读取最终PPTX，输出PNG/PDF/收据，不改源文件。默认png，width默认1440（320–3840），timeoutMs默认120000（1000–300000）；最多120页，输入64MiB、输出128MiB、单张16MP。缺失引擎返回unavailable及安装说明，普通创建仍可用。
+
+查看每页PNG及HTML，必要时在实际PowerPoint/WPS检查编辑、备注和动画。LibreOffice不保证与Office逐像素一致，PNG/PDF不保留动画。成功渲染仍为 `visual:not-verified`，不会自动声称视觉通过。
+
+把返回receiptPath传给 `ppt_check {deckPath:"report.json",renderReceipt:".../render-receipt.json"}`。源文件与所有输出的摘要必须匹配；修改/删除后失效，重新渲染。收据是本地完整性记录，非签名证明。
+
+## CLI
+
+`--slides @slides.json`、`--brand @brand.json`、`--template weekly`。
+
+`--edit report.json --edits @edits.json --revision 0`、`--undo report.json --revision 1`。
+
+`--check report.json`、`--render report.pptx --format both`、`--check report.json --render-receipt receipt.json`。
+
+默认渲染目录在PPTX旁；显式 `--out` 指定基目录，已有目录追加后缀。引擎不可用/静态错误/显式收据失效返回非零退出码。

package/skills/dsh-ppt/references/syntax.md

@@ -37,7 +37,7 @@
 ]
 ```
 
-`layout` 仅限 `cover | section | bullets | statement | quote | table | closing`；每页可选 `notes`（演讲者备注），`table` 页用 `rows`（首行为表头）。结构化表格同样自动分页，备注只放第一页。分页后总页数超过 maxSlides 时会报错，请提高配置上限（最多 120）或拆分文稿。Markdown 输入不够精确时，用结构化 slides 重写。
+`layout` 支持 `cover | section | bullets | statement | quote | table | closing | image | image-left | image-right | chart`；每页可选 `notes`，表格用 `rows`（首行为表头）。结构化表格自动分页，备注只放第一页。分页后超过 maxSlides 会报错，最多120页。图文、图表、品牌及按页编辑见 `advanced.md`。
 
 ## 动效（motion）
 

package/skills/dsh-ppt/references/troubleshooting.md

@@ -11,3 +11,9 @@
 | 双语界面 | `lang: bilingual` 只双语化界面；内容双语由 agent 在写作阶段完成 |
 | 放映没有动画 | `motion` 被设为 `off`；默认 `on` 时 HTML 有转场、PPTX 要点逐条点击出现 |
 | HTML 打印要点缺失 | 打印样式已强制显示全部要点；若仍缺失检查浏览器是否屏蔽了动画样式 |
+| 图片、图表或品牌导出缺少依赖 | 插件重新安装；独立技能目录运行 npm install --ignore-scripts 安装 Office Kit 0.21.0 |
+| ppt_render 返回 unavailable | 在插件项目或技能目录安装可选官方 Kit 0.1.3；Windows检查相应VC++v14运行库 |
+| 收据 not-verified | 源PPTX或输出发生变化、缺失、版本不同；用当前PPTX重新渲染，不沿用旧结论 |
+| 修订号冲突 | 重新用ppt_check读取当前工程，再按新revision编辑 |
+| 模板还有待填写 | 补充实际事实/依据/行动；按草稿说明，不作为成品交付 |
+| 渲染报告缺失字体 | 替换为环境和目标机器可用字体，重新生成并逐页检查；未解决需标注字体问题，不能声称已验收 |