dsh-ppt 0.5.1 → 0.7.0

package/lib/execution.js

@@ -2,7 +2,7 @@ import { resolve } from 'node:path';
 let enginePromise = null;
 function getEngine() {
     if (enginePromise === null) {
-        const engineUrl = new URL('../skills/dsh-ppt/scripts/deck-core.mjs', import.meta.url);
+        const engineUrl = new URL('../skills/dsh-ppt/scripts/deck-advanced.mjs', import.meta.url);
         enginePromise = import(engineUrl.href).then((module) => module)
             .catch((error) => {
             enginePromise = null;
@@ -26,7 +26,7 @@ export function createPptExecutors(config, loadEngine = getEngine) {
             const themes = engine.listThemes(lang);
             if (args.preview === true) {
                 const cwd = exec?.agent?.session.header.cwd ?? process.cwd();
-                const requested = typeof args.outputDir === 'string' && args.outputDir.trim() !== '' ? args.outputDir.trim() : '.';
+                const requested = typeof args.outputDir === 'string' && args.outputDir.trim() !== '' ? args.outputDir.trim() : config.outputDir || '.';
                 const preview = engine.buildThemePreview({
                     outputDir: resolve(cwd, requested),
                     lang,
@@ -43,14 +43,14 @@ export function createPptExecutors(config, loadEngine = getEngine) {
                 throw new Error('dsh-ppt：title 不能为空');
             const hasContent = typeof args.content === 'string' && args.content.trim() !== '';
             const hasSlides = Array.isArray(args.slides) && args.slides.length > 0;
-            if (!hasContent && !hasSlides)
-                throw new Error('dsh-ppt：content 不能为空（或用 slides 传结构化幻灯片）');
+            if (!hasContent && !hasSlides && !args.template)
+                throw new Error('dsh-ppt：content 不能为空（或用 slides / template 传结构化幻灯片）');
             const engine = await loadEngine();
-            // Loading can yield to cancellation. Rendering/writing then runs synchronously.
+            // Check cancellation after loading and before artifact commit inside the async engine.
             exec?.signal?.throwIfAborted();
             const cwd = exec?.agent?.session.header.cwd ?? process.cwd();
             const outputDir = typeof args.outputDir === 'string' && args.outputDir.trim() !== '' ? args.outputDir.trim() : config.outputDir;
-            return engine.buildDeck({
+            return (engine.buildDeckAsync ?? engine.buildDeck)({
                 title: args.title.trim(),
                 content: typeof args.content === 'string' ? args.content : '',
                 slides: hasSlides ? args.slides : undefined,
@@ -61,7 +61,42 @@ export function createPptExecutors(config, loadEngine = getEngine) {
                 fileName: typeof args.fileName === 'string' && args.fileName.trim() !== '' ? args.fileName.trim() : undefined,
                 overwrite: args.overwrite === true,
                 maxSlides: config.maxSlides,
+                template: args.template,
+                brand: args.brand,
+                cwd,
+                signal: exec?.signal,
             });
         },
+        async templates(rawArgs, exec) {
+            exec?.signal?.throwIfAborted();
+            const args = asRecord(rawArgs);
+            const engine = await loadEngine();
+            exec?.signal?.throwIfAborted();
+            return { ok: true, templates: engine.listTemplates(typeof args.lang === 'string' ? args.lang : config.defaultLang || 'zh') };
+        },
+        async edit(rawArgs, exec) {
+            exec?.signal?.throwIfAborted();
+            const engine = await loadEngine();
+            exec?.signal?.throwIfAborted();
+            return engine.editDeck({ ...asRecord(rawArgs), cwd: exec?.agent?.session.header.cwd ?? process.cwd(), signal: exec?.signal });
+        },
+        async undo(rawArgs, exec) {
+            exec?.signal?.throwIfAborted();
+            const engine = await loadEngine();
+            exec?.signal?.throwIfAborted();
+            return engine.undoDeck({ ...asRecord(rawArgs), cwd: exec?.agent?.session.header.cwd ?? process.cwd(), signal: exec?.signal });
+        },
+        async check(rawArgs, exec) {
+            exec?.signal?.throwIfAborted();
+            const engine = await loadEngine();
+            exec?.signal?.throwIfAborted();
+            return (engine.checkDeckAsync ?? engine.checkDeck)({ ...asRecord(rawArgs), cwd: exec?.agent?.session.header.cwd ?? process.cwd(), signal: exec?.signal });
+        },
+        async render(rawArgs, exec) {
+            exec?.signal?.throwIfAborted();
+            const engine = await loadEngine();
+            exec?.signal?.throwIfAborted();
+            return engine.renderDeck({ ...asRecord(rawArgs), cwd: exec?.agent?.session.header.cwd ?? process.cwd(), signal: exec?.signal });
+        },
     };
 }

package/lib/index.d.ts

@@ -20,4 +20,4 @@ export interface PptPluginContext {
 export declare function apply(ctx: PptPluginContext, config?: Config): void;
 export { resolvePptConfig, PPT_OUTPUT_DIR_ENV, DEFAULT_MAX_SLIDES, clampInt } from './config.js';
 export { bundledSkillsDir, parseSkillFile, registerPptSkill, SKILL_NAMES } from './skill.js';
-export type { PptConfig, PptCreateArgs, PptCreateResult, PptLanguage, PptSlideLayout, PptSlideSpec, PptThemeId, PptThemeInfo, PptThemesResult, } from './types.js';
+export type { PptConfig, PptCreateArgs, PptCreateResult, PptLanguage, PptSlideLayout, PptSlideSpec, PptThemeId, PptThemeInfo, PptThemesResult, PptTemplateId, PptImageSpec, PptChartSpec, PptBrand, PptQualityIssue, PptQualityResult, PptVerification, PptRenderArgs, PptRenderResult, PptCheckResult, PptEditArgs, PptProjectArgs, } from './types.js';

package/lib/index.js

@@ -3,15 +3,15 @@
  *
  * 一句话或一篇 Markdown 文档 → 完整演示文稿三件套：
  *   deck.html  独立网页放映（无外链）
- *   deck.pptx  可编辑 PPTX（16:9，零依赖 OOXML 生成）
- *   deck.json  结构化 manifest
+ *   deck.pptx  可编辑 PPTX（16:9，原生文字、图片、表格与图表）
+ *   deck.json  支持按页编辑与撤销的工程
  *
  * 插件同时注册：
  *   1. 技能 dsh-ppt（跨 harness 的完整 SOP，SKILL.md 随包分发）
- *   2. 工具 ppt_create / ppt_themes（确定性生成与主题查询）
+ *   2. 创建、主题、结构参考、编辑、撤销、检查与可选渲染工具
  *
- * 生成引擎是 skills/dsh-ppt/scripts/deck-core.mjs，由工具运行时动态加载；
- * 裸 SKILL.md 复制到其他 agent 时可直接运行同目录 build-deck.mjs。
+ * 生成引擎按需加载；图片与图表采用 @office-kit/pptx。
+ * 官方 LibreOffice Kit 可选安装，用于读取最终 PPTX 生成 PNG / PDF。
  *
  * @module dsh-ppt
  */

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' +
-        'HTML 网页放映：' + value.htmlPath + '\n' +
-        'PPTX 导出：' + value.pptxPath + '\n' +
-        'Manifest：' + value.jsonPath + '\n' +
-        'HTML 双击即可放映（← → 翻页 / V 演讲者视图 / S 备注 / G 缩略图总览 / F 全屏 / P 打印 / ? 快捷键）；PPTX 可用 PowerPoint / WPS / Keynote 打开。');
+    return oneText('dsh-ppt 已生成 ' + value.slideCount + ' 页' + (value.deliveryStatus === 'draft' ? '草稿（还有待填写内容，不能作为成品交付）' : '演示文稿') + '（主题 ' + value.theme + '，语言 ' + value.language + '）：\n' +
+        '打开演示文稿：' + value.htmlPath + '\n' +
+        '可直接修改的 PPTX：' + value.pptxPath + '\n' +
+        '可继续编辑的项目：' + value.jsonPath + '\n' +
+        'HTML 双击即可放映；可点击上一页/下一页、输入页码，以及“检查与导出”定位问题或下载 PPTX。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,70 +1,84 @@
-{
-  "name": "dsh-ppt",
-  "version": "0.5.1",
-  "description": "DSH 演示文稿插件：Markdown 生成网页放映与可编辑 PPTX，长表格自动分页，内置 5 套主题、备注与转场动画。",
-  "type": "module",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./lib/index.d.ts",
-      "default": "./lib/index.js"
-    },
-    "./skills/*": "./skills/*",
-    "./deck-core": "./skills/dsh-ppt/scripts/deck-core.mjs",
-    "./build-deck": "./skills/dsh-ppt/scripts/build-deck.mjs",
-    "./cordis.patch.yml": "./cordis.patch.yml",
-    "./package.json": "./package.json"
-  },
-  "files": [
-    "lib",
-    "skills",
-    "cordis.patch.yml",
-    "README.md",
-    "README.en.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "pnpm run build && node --test \"test/*.test.mjs\"",
-    "test:core": "node --test \"test/*.test.mjs\"",
-    "smoke:cli": "node skills/dsh-ppt/scripts/build-deck.mjs --title \"DSH PPT Smoke\" --content @smoke/sample-deck.md --theme data --lang zh --out .smoke-deck"
-  },
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    }
-  },
-  "keywords": [
-    "dsh",
-    "deepseek-harness",
-    "dsh-plugin",
-    "plugin",
-    "skills",
-    "ppt",
-    "pptx",
-    "presentation",
-    "slides",
-    "html"
-  ],
-  "license": "MIT",
-  "engines": {
-    "node": "^22.19.0 || >=24.0.0"
-  },
-  "devDependencies": {
-    "@types/node": "^24.0.0",
-    "typescript": "^5.6.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/STARDUSTLC666/dsh-ppt.git"
-  },
-  "bugs": {
-    "url": "https://github.com/STARDUSTLC666/dsh-ppt/issues"
-  },
-  "homepage": "https://github.com/STARDUSTLC666/dsh-ppt#readme",
-  "author": "stardustlc",
-  "packageManager": "pnpm@11.7.0"
-}
+{
+  "name": "dsh-ppt",
+  "version": "0.7.0",
+  "description": "DSH 演示文稿插件：HTML 与可编辑 PPTX、图文排版、原生图表、按页编辑撤销、质量检查与可选官方 PNG/PDF 渲染。",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./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"
+  },
+  "files": [
+    "lib",
+    "skills",
+    "docs",
+    "cordis.patch.yml",
+    "README.md",
+    "README.en.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "pnpm run build && node --test \"test/*.test.mjs\"",
+    "test:core": "node --test \"test/*.test.mjs\"",
+    "smoke:cli": "node skills/dsh-ppt/scripts/build-deck.mjs --title \"DSH PPT Smoke\" --content @smoke/sample-deck.md --theme data --lang zh --out .smoke-deck"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "keywords": [
+    "dsh",
+    "deepseek-harness",
+    "dsh-plugin",
+    "plugin",
+    "skills",
+    "ppt",
+    "pptx",
+    "presentation",
+    "slides",
+    "html"
+  ],
+  "license": "MIT",
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.0",
+    "typescript": "^5.6.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/STARDUSTLC666/dsh-ppt.git"
+  },
+  "bugs": {
+    "url": "https://github.com/STARDUSTLC666/dsh-ppt/issues"
+  },
+  "homepage": "https://github.com/STARDUSTLC666/dsh-ppt#readme",
+  "author": "stardustlc",
+  "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
+    }
+  }
+}