dsh-ppt 0.7.0 → 0.8.1

package/lib/workbench.js

@@ -0,0 +1,270 @@
+/** Operator-only workbench. Paths come from successful tools, never browser input. */
+import { createHash } from 'node:crypto';
+import { appendFileSync, existsSync, lstatSync, mkdirSync, readFileSync, realpathSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { basename, dirname, join, resolve } from 'node:path';
+import { getEngine } from './execution.js';
+import { bilingualQuality, englishWorkbenchMessage } from './workbench-language.js';
+export const PPT_WORKBENCH_ROUTE = '/api/dsh-ppt/workbench';
+export const PPT_DOWNLOAD_ROUTE = '/api/dsh-ppt/download';
+const REQUEST_LIMIT = 12 * 1024 * 1024;
+const FILE_LIMIT = 64 * 1024 * 1024;
+const digest = (value) => createHash('sha256').update(value).digest('hex');
+function ordinaryFile(path) {
+    const stat = lstatSync(path);
+    if (!stat.isFile() || stat.isSymbolicLink() || stat.size > FILE_LIMIT)
+        throw new Error('文件不是普通文件或超过 64 MiB');
+    return readFileSync(path);
+}
+function pathsFor(path) { const base = path.slice(0, -5); return { json: path, html: base + '.html', pptx: base + '.pptx' }; }
+function json(status, value) {
+    return new Response(JSON.stringify(value), { status, headers: { 'content-type': 'application/json; charset=utf-8', 'cache-control': 'no-store' } });
+}
+function fail(status, message) { return json(status, { ok: false, message, messageEn: englishWorkbenchMessage(message) }); }
+function originVerdict(request) {
+    const site = request.headers.get('sec-fetch-site'), origin = request.headers.get('origin');
+    if (site && !['same-origin', 'none'].includes(site))
+        return fail(403, '拒绝跨站操作');
+    if (origin && /^https?:/i.test(origin)) {
+        try {
+            if (new URL(origin).host !== (request.headers.get('host') || new URL(request.url).host))
+                return fail(403, '拒绝跨源操作');
+        }
+        catch {
+            return fail(403, '无效来源');
+        }
+    }
+}
+export class PptWorkbench {
+    catalogPath;
+    loadEngine;
+    renders = new Map();
+    constructor(options = {}) {
+        this.catalogPath = options.catalogPath ?? join(process.env.DSH_HOME || join(homedir(), '.dsh'), 'plugins', 'dsh-ppt', 'projects.jsonl');
+        this.loadEngine = options.loadEngine ?? getEngine;
+    }
+    catalog() {
+        if (!existsSync(this.catalogPath))
+            return [];
+        if (lstatSync(this.catalogPath).size > 8 * 1024 * 1024)
+            throw new Error('项目索引超过 8 MiB，请备份后整理 projects.jsonl');
+        const rows = new Map();
+        for (const line of readFileSync(this.catalogPath, 'utf8').split('\n')) {
+            try {
+                const row = JSON.parse(line);
+                if (typeof row.path === 'string' && row.path.endsWith('.json') && row.id === digest(row.path) && typeof row.title === 'string' && typeof row.updatedAt === 'string') {
+                    rows.delete(row.id);
+                    rows.set(row.id, row);
+                }
+            }
+            catch { /* A crash may leave an incomplete last append; keep older rows. */ }
+        }
+        return [...rows.values()].reverse().slice(0, 100);
+    }
+    /** Recording a completed tool never turns a successful generation into an error. */
+    async remember(result, args, exec) {
+        const file = result?.jsonPath ?? result?.deckPath;
+        if (typeof file !== 'string')
+            return;
+        exec?.signal?.throwIfAborted();
+        const path = realpathSync(resolve(exec?.agent?.session.header.cwd ?? process.cwd(), file));
+        ordinaryFile(path);
+        const engine = await this.loadEngine();
+        const { manifest } = engine.readDeckProject({ deckPath: path });
+        // Versioned generator projects only; arbitrary JSON and externally edited PPTX cannot enter.
+        if (manifest.schemaVersion !== 1 || typeof manifest.deckId !== 'string' || manifest.slides.some((s) => typeof s.id !== 'string'))
+            return;
+        const row = { id: digest(path), path, title: manifest.title, updatedAt: new Date().toISOString() };
+        mkdirSync(dirname(this.catalogPath), { recursive: true });
+        if (existsSync(this.catalogPath) && lstatSync(this.catalogPath).size >= 8 * 1024 * 1024)
+            throw new Error('项目索引已满，请备份后整理 projects.jsonl');
+        appendFileSync(this.catalogPath, JSON.stringify(row) + '\n');
+    }
+    async project(id) {
+        if (typeof id !== 'string' || !/^[0-9a-f]{64}$/.test(id))
+            throw new Error('请选择已有项目');
+        const entry = this.catalog().find(row => row.id === id);
+        if (!entry)
+            throw new Error('项目不在本机索引中，请先在对话中创建或检查演示文稿');
+        if (realpathSync(entry.path) !== entry.path)
+            throw new Error('项目位置已改变，请在对话中重新检查');
+        ordinaryFile(entry.path);
+        const engine = await this.loadEngine();
+        const { manifest } = engine.readDeckProject({ deckPath: entry.path });
+        return { entry, engine, manifest, files: pathsFor(entry.path) };
+    }
+    async view(id) {
+        const { entry, engine, manifest, files } = await this.project(id);
+        const check = bilingualQuality(engine.checkDeck({ deckPath: entry.path }));
+        let html = '';
+        try {
+            html = ordinaryFile(files.html).toString('utf8');
+        }
+        catch { /* A check can register an older JSON-only project. */ }
+        const render = this.renders.get(entry.id);
+        const currentRender = render && render.revision === manifest.revision && digest(ordinaryFile(files.pptx)) === render.sourceSha256 ? render : undefined;
+        return { ok: true, project: { ...entry, deckId: manifest.deckId, revision: manifest.revision, slides: manifest.slides,
+                undoAvailable: manifest.history.length, quality: check, html,
+                assets: Object.fromEntries(Object.entries(manifest.assets ?? {}).map(([key, value]) => [key, { data: value.data, mime: value.mime }])),
+                render: currentRender ? { pageCount: currentRender.pngPaths.length, missingFonts: currentRender.missingFonts ?? [] } : null } };
+    }
+    revision(body, manifest) {
+        if (!Number.isSafeInteger(body.expectedRevision) || body.expectedRevision !== manifest.revision)
+            throw new Error('项目已被修改，请重新打开后再编辑；当前输入保留');
+    }
+    patch(value) {
+        if (!value || typeof value !== 'object' || Array.isArray(value))
+            throw new Error('修改内容无效');
+        const result = {};
+        for (const [key, item] of Object.entries(value)) {
+            if (['title', 'subtitle', 'kicker', 'text', 'notes'].includes(key)) {
+                if (typeof item !== 'string' || item.length > 8000)
+                    throw new Error('文字字段过长或无效');
+            }
+            else if (key === 'bullets') {
+                if (!Array.isArray(item) || item.length > 50 || item.some(v => typeof v !== 'string' || v.length > 2000))
+                    throw new Error('要点内容无效');
+            }
+            else if (key === 'image') {
+                if (!item || typeof item !== 'object' || Array.isArray(item))
+                    throw new Error('请选择 PNG 或 JPEG 图片');
+                const image = item;
+                if (Object.keys(image).some(k => !['src', 'alt', 'fit', 'caption'].includes(k)) || typeof image.src !== 'string' || !/^data:image\/(png|jpeg);base64,[A-Za-z0-9+/=]+$/.test(image.src))
+                    throw new Error('图片必须从面板上传，不能读取其他本地文件');
+                if (['alt', 'caption'].some(k => image[k] !== undefined && (typeof image[k] !== 'string' || image[k].length > 2000)) || (image.fit !== undefined && !['contain', 'cover'].includes(String(image.fit))))
+                    throw new Error('图片说明或适应方式无效');
+            }
+            else
+                throw new Error('面板不支持修改此字段：' + key);
+            result[key] = item;
+        }
+        return result;
+    }
+    async action(body, signal) {
+        signal?.throwIfAborted();
+        if (body.operation === 'list')
+            return { ok: true, projects: this.catalog() };
+        if (body.operation === 'open')
+            return this.view(body.id);
+        const { entry, engine, manifest, files } = await this.project(body.id);
+        signal?.throwIfAborted();
+        if (body.operation === 'download') {
+            if (!['html', 'pptx', 'json'].includes(String(body.kind)))
+                throw new Error('不支持此文件类型');
+            const path = files[body.kind];
+            return { ok: true, name: basename(path), data: ordinaryFile(path).toString('base64') };
+        }
+        if (body.operation === 'page') {
+            const render = this.renders.get(entry.id);
+            if (!render || render.revision !== manifest.revision || digest(ordinaryFile(files.pptx)) !== render.sourceSha256)
+                throw new Error('请先渲染当前版本的 PPTX');
+            if (!Number.isSafeInteger(body.page) || Number(body.page) < 1 || Number(body.page) > render.pngPaths.length)
+                throw new Error('页码无效');
+            const bytes = ordinaryFile(render.pngPaths[Number(body.page) - 1]);
+            if (digest(bytes) !== render.pngHashes[Number(body.page) - 1])
+                throw new Error('渲染图片已变化，请重新渲染当前 PPTX');
+            return { ok: true, data: 'data:image/png;base64,' + bytes.toString('base64') };
+        }
+        this.revision(body, manifest);
+        if (body.operation === 'render') {
+            const result = await engine.renderDeck({ pptxPath: files.pptx, format: 'png', signal });
+            if (result.ok)
+                this.renders.set(entry.id, { revision: manifest.revision, pngPaths: result.pngPaths ?? [], pngHashes: (result.pngPaths ?? []).map(path => digest(ordinaryFile(path))), missingFonts: result.missingFonts, sourceSha256: result.sourceSha256 });
+            const view = await this.view(entry.id);
+            if (result.ok && !view.project.render)
+                throw new Error('项目已被修改，请重新渲染');
+            return { ...result, ...(result.ok ? {} : {
+                    messageEn: englishWorkbenchMessage(result.message || 'PPTX rendering failed.'),
+                    installationHintEn: 'Optional renderer: @deepseek-ai/libreoffice-kit@0.1.5. Install it in this DSH profile and restart DSH.',
+                }), project: view.project };
+        }
+        if (body.operation === 'edit') {
+            if (body.slide !== undefined && (typeof body.slide !== 'string' || !manifest.slides.some((s) => s.id === body.slide)))
+                throw new Error('页面不存在');
+            const args = { deckPath: entry.path, expectedRevision: body.expectedRevision, signal,
+                ...(body.slide === undefined ? {} : { edits: [{ slide: body.slide, patch: this.patch(body.patch) }] }),
+                ...(body.order === undefined ? {} : { order: body.order }) };
+            const result = await engine.editDeck(args);
+            await this.remember(result, args);
+            return { ...await this.view(entry.id), changed: result.changed };
+        }
+        if (body.operation === 'undo') {
+            await engine.undoDeck({ deckPath: entry.path, expectedRevision: body.expectedRevision, signal });
+            return this.view(entry.id);
+        }
+        throw new Error('不支持此操作');
+    }
+    async fetchDownload(request) {
+        if (request.method !== 'GET')
+            return fail(405, '请使用 GET');
+        const denied = originVerdict(request);
+        if (denied)
+            return denied;
+        try {
+            const params = new URL(request.url).searchParams, kind = params.get('kind');
+            if (!['html', 'pptx', 'json'].includes(String(kind)))
+                return fail(400, '不支持此文件类型');
+            const { entry, manifest, files } = await this.project(params.get('id'));
+            if (String(manifest.revision) !== params.get('revision'))
+                return fail(409, '项目已被修改，请重新打开后下载');
+            request.signal.throwIfAborted();
+            const path = files[kind], bytes = ordinaryFile(path);
+            if ((await this.project(entry.id)).manifest.revision !== manifest.revision)
+                return fail(409, '项目已被修改，请重新打开后下载');
+            const type = kind === 'pptx' ? 'application/vnd.openxmlformats-officedocument.presentationml.presentation' : kind === 'html' ? 'text/html; charset=utf-8' : 'application/json; charset=utf-8';
+            return new Response(new Uint8Array(bytes), { headers: {
+                    'content-type': type, 'cache-control': 'no-store', 'x-content-type-options': 'nosniff',
+                    'content-disposition': `attachment; filename="presentation.${kind}"; filename*=UTF-8''${encodeURIComponent(basename(path))}`,
+                } });
+        }
+        catch (error) {
+            return fail(400, error instanceof Error ? error.message : String(error));
+        }
+    }
+    async fetch(request) {
+        if (request.method !== 'POST')
+            return fail(405, '请使用 POST');
+        if (request.headers.get('x-dsh-ppt-action') !== '1' || request.headers.get('content-type')?.split(';')[0].trim().toLowerCase() !== 'application/json')
+            return fail(403, '请从演示文稿面板操作');
+        const denied = originVerdict(request);
+        if (denied)
+            return denied;
+        try {
+            const reader = request.body?.getReader();
+            if (!reader)
+                return fail(400, '缺少请求内容');
+            let size = 0;
+            const chunks = [];
+            try {
+                for (;;) {
+                    const { value, done } = await reader.read();
+                    if (done)
+                        break;
+                    size += value.byteLength;
+                    if (size > REQUEST_LIMIT) {
+                        await reader.cancel();
+                        return fail(413, '图片或请求超过 12 MiB，请压缩后重试');
+                    }
+                    chunks.push(value);
+                }
+            }
+            finally {
+                reader.releaseLock();
+            }
+            const body = JSON.parse(Buffer.concat(chunks).toString('utf8'));
+            if (!body || typeof body !== 'object' || Array.isArray(body))
+                return fail(400, '请求必须是对象');
+            return json(200, await this.action(body, request.signal));
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return fail(/修订号冲突|已被修改|正在被另一次|其他操作修改/.test(message) ? 409 : 400, message);
+        }
+    }
+}
+export function installPptWorkbench(ctx, workbench) {
+    ctx.inject?.(['connection'], (host) => {
+        host.connection?.fetch?.register({ path: PPT_WORKBENCH_ROUTE, methods: ['POST'], requestBody: 'buffered', fetch: (request) => workbench.fetch(request) });
+        host.connection?.fetch?.register({ path: PPT_DOWNLOAD_ROUTE, methods: ['GET'], requestBody: 'buffered', fetch: (request) => workbench.fetchDownload(request) });
+    });
+}

package/package.json

@@ -1,84 +1,91 @@
-{
-  "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
-    }
-  }
-}
+{
+  "name": "dsh-ppt",
+  "version": "0.8.1",
+  "description": "DSH 演示文稿插件：生成 HTML、可编辑 PPTX 和工程文件，支持图表、轻量编辑、撤销与质量检查。",
+  "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",
+    "./client": "./lib/client.js",
+    "./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"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    }
+  },
+  "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.5"
+  },
+  "peerDependenciesMeta": {
+    "@deepseek-ai/libreoffice-kit": {
+      "optional": true
+    }
+  }
+}

package/skills/dsh-ppt/SKILL.md

@@ -1,74 +1,74 @@
----
-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: "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"
----
-
-# dsh-ppt
-
-一句话或一篇文档 → 完整演示文稿：**独立 HTML 网页放映 + 可编辑 PPTX**。本文件只做路由与纪律；具体规则按需读取 `references/`。
-
-## 触发条件
-
-用户要做 PPT / 幻灯片 / 演示文稿 / deck / 汇报 / 提案 / 路演 / 培训材料，或给一句话、一段文字、一篇 Markdown 想变成可放映的演示。
-
-## 执行纪律（每次都要遵守）
-
-- 一页一个观点；标题是判断句，不是名词短语。
-- 内容语言由你撰写；`lang` 只决定界面文字。
-- 先选主题再构建；不确定就用默认 `data`。
-- 交付前逐项过一遍文末「质量门禁」。
-- 目标是可用成品：先组织真实内容，再调用生成器；未填模板必须标注草稿，不编造缺失事实。
-- 渲染报告缺失字体时，替换为环境和接收方机器可用字体，重新生成并逐页检查；未解决需标注字体问题，不能声称已验收。
-
-## 核心流水线
-
-1. **Probe 需求**：读入用户的句子/文档，确定听众、目标、语气。一句话输入不要反问，直接按发布场景推断。
-2. **Outline 大纲**：产出 5–12 页大纲（封面 → 问题/背景 → 方案/论点 3–6 页 → 证据 → 行动号召 → 结束页）。
-   → 写大纲与正文前先读 `references/copywriting.md`。
-3. **Theme 主题**：调 `ppt_themes`（DSH）或 `node scripts/build-deck.mjs --list-themes`（跨 harness）。
-   → 拿不准选哪套时读 `references/themes.md` 的情绪决策树。
-4. **Build 生成**：
-   - DSH 内：调 `ppt_create`，大纲写成 Markdown 传 `content`（推荐），或传结构化 `slides`。
-   - 跨 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 校验与修正**：调 `ppt_check` 检查具体页；在浏览器操作放映、总览和备注，查看图片/图表。若可选官方引擎可用，调 `ppt_render` 读取最终 PPTX 生成逐页 PNG/PDF，逐页看画面。修正用 `ppt_edit`，以 `expectedRevision` 防冲突；需要时 `ppt_undo`。修改后重新渲染，以收据复核当前文件。文件头/结构通过不等同于视觉验收，静态估算、渲染、视觉检查必须分开说明。
-6. **Deliver 交付**：给用户三个绝对路径，说明 HTML 直接放映（← → 翻页 · F 全屏 · G 总览 · S 备注 · P 打印），PPTX 用 PowerPoint / WPS / Keynote 打开（备注在演示者视图可见，bullets 页放映时逐条点击出现）。
-
-## 按需装载索引
-
-| 何时读 | 文件 | 内容 |
-| --- | --- | --- |
-| 写大纲 / 正文前 | `references/copywriting.md` | 叙事骨架、单页规则、双语规则 |
-| 选主题拿不准 | `references/themes.md` | 5 套主题色板 + 情绪决策树 |
-| 用表格/金句/备注/结构化 slides | `references/syntax.md` | Markdown 解析、进阶语法、slides JSON、motion 开关 |
-| 图片/图表/模板/品牌/编辑/渲染 | `references/advanced.md` | 参数、限制、草稿与成品、收据语义 |
-| 交付异常 | `references/troubleshooting.md` | 症状 → 处理对照表 |
-
-## 质量门禁（交付前逐项确认）
-
-- [ ] 页数 3–60，首屏是封面，末屏是结束页。
-- [ ] 每页有明确标题；bullets 页 1–8 条，中文每条 ≤ 20 字、英文 ≤ 12 词。
-- [ ] HTML 与 PPTX 使用同一主题，配色一致。
-- [ ] 主题色对比度足够（深底浅字或浅底深字）。
-- [ ] 中文内容无错别字；英文标题用 Title Case。
-- [ ] 最后一页有可执行的行动号召，不只是「谢谢」。
-- [ ] 文件已写到用户工作区，路径为绝对路径。
-- [ ] 没有未填模板；保留真实数据来源，检查每页画面而非只检查生成成功。
-- [ ] 图片嵌入成功，图表与原始数据一致；渲染收据匹配最终 PPTX，说明尚未验证的部分。
-
-## 跨 harness 安装
-
-把整个 `dsh-ppt` 技能目录复制到目标 agent 的技能目录，使用 Node `^22.19.0 || >=24.0.0`，在该目录运行 `npm install --ignore-scripts`。纯文本可直接运行；图片/图表/品牌导出需要 Office Kit，PNG/PDF 需另外安装可选官方引擎：
-
-| Agent | 技能目录 |
-| --- | --- |
-| DeepSeek Harness | `dsh plugin --profile web add dsh-ppt` |
-| Claude Code | `~/.claude/skills/` |
-| Cursor | `.cursor/skills/` |
-| Gemini CLI | `~/.gemini/skills/` |
-| OpenAI Codex | `~/.codex/skills/` |
-
-一次编写，处处可用。
+---
+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: "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"
+---
+
+# dsh-ppt
+
+一句话或一篇文档 → 完整演示文稿：**独立 HTML 网页放映 + 可编辑 PPTX**。本文件只做路由与纪律；具体规则按需读取 `references/`。
+
+## 触发条件
+
+用户要做 PPT / 幻灯片 / 演示文稿 / deck / 汇报 / 提案 / 路演 / 培训材料，或给一句话、一段文字、一篇 Markdown 想变成可放映的演示。
+
+## 执行纪律（每次都要遵守）
+
+- 一页一个观点；标题是判断句，不是名词短语。
+- 内容语言由你撰写；`lang` 只决定界面文字。
+- 先选主题再构建；不确定就用默认 `data`。
+- 交付前逐项过一遍文末「质量门禁」。
+- 目标是可用成品：先组织真实内容，再调用生成器；未填模板必须标注草稿，不编造缺失事实。
+- 渲染报告缺失字体时，替换为环境和接收方机器可用字体，重新生成并逐页检查；未解决需标注字体问题，不能声称已验收。
+
+## 核心流水线
+
+1. **Probe 需求**：读入用户的句子/文档，确定听众、目标、语气。一句话输入不要反问，直接按发布场景推断。
+2. **Outline 大纲**：产出 5–12 页大纲（封面 → 问题/背景 → 方案/论点 3–6 页 → 证据 → 行动号召 → 结束页）。
+   → 写大纲与正文前先读 `references/copywriting.md`。
+3. **Theme 主题**：调 `ppt_themes`（DSH）或 `node scripts/build-deck.mjs --list-themes`（跨 harness）。
+   → 拿不准选哪套时读 `references/themes.md` 的情绪决策树。
+4. **Build 生成**：
+   - DSH 内：调 `ppt_create`，大纲写成 Markdown 传 `content`（推荐），或传结构化 `slides`。
+   - 跨 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 校验与修正**：调 `ppt_check` 检查具体页；在浏览器操作放映、总览和备注，查看图片/图表。若可选官方引擎可用，调 `ppt_render` 读取最终 PPTX 生成逐页 PNG/PDF，逐页看画面。修正用 `ppt_edit`，以 `expectedRevision` 防冲突；需要时 `ppt_undo`。修改后重新渲染，以收据复核当前文件。文件头/结构通过不等同于视觉验收，静态估算、渲染、视觉检查必须分开说明。
+6. **Deliver 交付**：给用户三个绝对路径，说明 HTML 直接放映（← → 翻页 · F 全屏 · G 总览 · S 备注 · P 打印），PPTX 用 PowerPoint / WPS / Keynote 打开（备注在演示者视图可见，bullets 页放映时逐条点击出现）。DSH 用户也可在「设置 → 演示文稿」修改文字、替换 PNG/JPEG、移动页面、撤销和下载最新文件；已有 JSON 工程先 `ppt_check` 才会出现在项目列表。`ppt_edit.order` 使用每个稳定页面 ID 各一次，与正文修改合并成一次撤销。
+
+## 按需装载索引
+
+| 何时读 | 文件 | 内容 |
+| --- | --- | --- |
+| 写大纲 / 正文前 | `references/copywriting.md` | 叙事骨架、单页规则、双语规则 |
+| 选主题拿不准 | `references/themes.md` | 5 套主题色板 + 情绪决策树 |
+| 用表格/金句/备注/结构化 slides | `references/syntax.md` | Markdown 解析、进阶语法、slides JSON、motion 开关 |
+| 图片/图表/模板/品牌/编辑/渲染 | `references/advanced.md` | 参数、限制、草稿与成品、收据语义 |
+| 交付异常 | `references/troubleshooting.md` | 症状 → 处理对照表 |
+
+## 质量门禁（交付前逐项确认）
+
+- [ ] 页数 3–60，首屏是封面，末屏是结束页。
+- [ ] 每页有明确标题；bullets 页 1–8 条，中文每条 ≤ 20 字、英文 ≤ 12 词。
+- [ ] HTML 与 PPTX 使用同一主题，配色一致。
+- [ ] 主题色对比度足够（深底浅字或浅底深字）。
+- [ ] 中文内容无错别字；英文标题用 Title Case。
+- [ ] 最后一页有可执行的行动号召，不只是「谢谢」。
+- [ ] 文件已写到用户工作区，路径为绝对路径。
+- [ ] 没有未填模板；保留真实数据来源，检查每页画面而非只检查生成成功。
+- [ ] 图片嵌入成功，图表与原始数据一致；渲染收据匹配最终 PPTX，说明尚未验证的部分。
+
+## 跨 harness 安装
+
+把整个 `dsh-ppt` 技能目录复制到目标 agent 的技能目录，使用 Node `^22.19.0 || >=24.0.0`，在该目录运行 `npm install --ignore-scripts`。纯文本可直接运行；图片/图表/品牌导出需要 Office Kit，PNG/PDF 需另外安装可选官方引擎：
+
+| Agent | 技能目录 |
+| --- | --- |
+| DeepSeek Harness | `dsh plugin --profile web add dsh-ppt` |
+| Claude Code | `~/.claude/skills/` |
+| Cursor | `.cursor/skills/` |
+| Gemini CLI | `~/.gemini/skills/` |
+| OpenAI Codex | `~/.codex/skills/` |
+
+一次编写，处处可用。

package/skills/dsh-ppt/package.json

@@ -1,11 +1,11 @@
-{
-  "name": "dsh-ppt-skill",
+{
+  "name": "dsh-ppt-skill",
   "version": "0.7.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" }
-}
+  "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" }
+}