dsh-ppt 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+# Changelog
+
+## 0.1.0
+
+- 首发：`dsh-ppt` 技能 + 工具插件。
+- `ppt_create`：Markdown / 结构化 slides → HTML 网页放映 + PPTX 导出 + manifest。
+- `ppt_themes`：5 套内置视觉主题（Swiss Pulse / Velvet Standard / Data Drift / Soft Signal / Maximalist Type）。
+- 中英双语界面（zh / en / bilingual）。
+- 裸 SKILL.md + `build-deck.mjs` CLI，跨 Claude Code / Cursor / Gemini CLI / Codex / DSH。
+- 零运行时依赖：OOXML 与 zip 由 `node:zlib` 手写生成。

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 stardustlc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,139 @@
+# dsh-ppt
+
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
+
+> **One sentence or one document → a complete presentation**: HTML web slideshow + PPTX export, 5 visual themes, bilingual Chinese/English.
+
+DeepSeek Harness (DSH) presentation skill + tool plugin: turns a sentence, a paragraph, or a Markdown document into a ready-to-present **HTML slideshow** and an editable **PPTX**. Pure Node, **zero runtime dependencies**, one codebase for Windows / macOS / Linux.
+
+## Capabilities
+
+| Capability | Description |
+| --- | --- |
+| `ppt_create` tool | Markdown / structured slides → `*.html` + `*.pptx` + `*.json` |
+| `ppt_themes` tool | Lists the 5 built-in themes and their best use cases |
+| `dsh-ppt` skill | A complete six-step SOP registered into DSH |
+| Standalone SKILL.md | Copy `skills/dsh-ppt/` into Claude Code / Cursor / Gemini CLI / Codex for cross-harness use |
+| Visual engine | Reuses the hyperframes visual style library; HTML and PPTX share the same theme source |
+
+Example:
+
+> Turn this sentence into a deck: "AI support cuts first response time to 8 seconds", with a dark tech theme.
+>
+> Turn `docs/quarterly-review.md` into a bilingual presentation and export PPTX.
+
+## Installation
+
+```bash
+dsh plugin --profile web add dsh-ppt
+```
+
+After restart, the `ppt_create` / `ppt_themes` tools and the `dsh-ppt` skill are available. The plugin ships with an empty config and **won't crash startup**.
+
+## Quick start
+
+### Inside DSH (recommended)
+
+```
+1. ppt_themes                        # inspect the 5 themes
+2. ppt_create {
+     title: "Fewer Meetings",
+     content: "# Problem\n- Too many meetings\n\n# Solution\n- Async decisions",
+     theme: "data",
+     lang: "en"
+   }
+3. Open the returned HTML path in a browser; edit the PPTX in PowerPoint / WPS / Keynote
+```
+
+### Any harness (standalone SKILL.md)
+
+Copy `skills/dsh-ppt/` to any Agent Skills directory, then:
+
+```bash
+node <skill-dir>/scripts/build-deck.mjs \
+  --title "Product Launch" \
+  --content deck.md \
+  --theme data \
+  --lang en \
+  --out dist/deck
+```
+
+Artifacts:
+
+| File | Purpose |
+| --- | --- |
+| `*.html` | Standalone web slideshow: arrow keys/wheel/touch navigation, F fullscreen, G overview, P print/save as PDF |
+| `*.pptx` | Editable 16:9 presentation (hand-written OOXML, zip via `node:zlib`, no third-party deps) |
+| `*.json` | Structured manifest (version, theme, language, slides) |
+
+## Built-in themes
+
+| ID | Name | Mood | Best for |
+| --- | --- | --- | --- |
+| `data` | Data Drift (default) | Futuristic / immersive | AI, tech launches, research |
+| `swiss` | Swiss Pulse | Precise / rational | Data, SaaS, developer tools |
+| `velvet` | Velvet Standard | Premium / restrained | Executive decks, brand, investor pitches |
+| `soft` | Soft Signal | Warm / human | Brand stories, training, personal talks |
+| `bold` | Maximalist Type | Loud / kinetic | Product launches, events, big moments |
+
+Themes are derived from [dsh-hyperframes](https://github.com/STARDUSTLC666/dsh-hyperframes) `visual-styles.md`. Full palettes: `skills/dsh-ppt/references/themes.md`.
+
+## Markdown input rules
+
+- The first `# heading` becomes the cover title; its first paragraph becomes the cover subtitle.
+- Each `## section` becomes one slide: lists produce `bullets` slides; empty sections produce `section` dividers.
+- Plain text without headings: the first paragraph is the cover, then every 5 sentences become one slide.
+- A single sentence automatically produces a complete 3-slide structure: cover → core idea → closing.
+- For precise control, use structured `slides` (`cover | section | bullets | statement | closing`).
+
+## Configuration
+
+No required configuration. Optional:
+
+```yaml
+- id: dsh-ppt
+  config:
+    outputDir: E:\decks   # optional; defaults to the session working directory
+    maxSlides: 40         # optional; default 60 (3–120)
+```
+
+The `DSH_PPT_OUTPUT_DIR` env var can also set the default output directory; the `ppt_create` `outputDir` argument has the highest priority.
+
+## Bilingual support
+
+- `lang` argument: `zh` (default) / `en` / `bilingual` controls the player UI, page numbers, and closing defaults.
+- Content language is up to the author: for a bilingual deck, prefer "Chinese title + English subtitle" or generate two decks from the same outline.
+- Plugin docs, skill content, and error messages are bilingual.
+
+## Engineering quality
+
+- Pure Node, zero runtime dependencies: HTML template, OOXML, and zip are hand-written using only `node:fs` / `node:path` / `node:zlib`.
+- The skill and tools share one engine (`skills/dsh-ppt/scripts/deck-core.mjs`), so DSH and bare-skill output are identical.
+- Unit tests cover registration contracts, JSON Schema, theme resolution, Markdown parsing, artifact generation, PPTX part integrity, and the CLI.
+- No `eval` / `child_process` / secrets; artifacts are only written to the user-specified local directory.
+
+## Development
+
+```sh
+pnpm install
+pnpm run build      # tsc → lib/
+pnpm test           # build + node --test (registration/config/engine/CLI)
+pnpm run smoke:cli  # bare CLI smoke test, generates .smoke-deck
+```
+
+## Known limitations
+
+- The PPTX uses a blank layout plus text boxes: text is editable in PowerPoint / WPS, but no smart master placeholders yet.
+- A one-sentence input produces a minimal 3-slide structure; for richer decks, expand the content into a Markdown outline first.
+- `bilingual` only localizes the player UI; it does not translate content.
+- Charts, images, speaker notes, and PPT animations are planned for v0.2+.
+
+## License
+
+MIT. Community plugin, not affiliated with DeepSeek; `@deepseek-ai/*` is an officially reserved namespace.
+
+## Related projects
+
+- [dsh-hyperframes](https://github.com/STARDUSTLC666/dsh-hyperframes) — HTML video skills (source of this plugin's visual styles)
+- [dsh-remotion](https://github.com/STARDUSTLC666/dsh-remotion) — React programmatic video skills
+- [dsh-email](https://github.com/STARDUSTLC666/dsh-email) — Email toolset

package/README.md

@@ -0,0 +1,143 @@
+[English](README.en.md)
+
+# dsh-ppt
+
+> **一句话 / 一篇文档 → 完整演示文稿**：HTML 网页放映 + PPTX 导出，5 套视觉主题，中英双语。
+
+![npm version](https://img.shields.io/npm/v/dsh-ppt?label=npm&color=blue) ![npm downloads](https://img.shields.io/npm/dm/dsh-ppt) ![license](https://img.shields.io/npm/l/dsh-ppt) ![stars](https://img.shields.io/github/stars/STARDUSTLC666/dsh-ppt?style=social)
+
+[![Awesome DSH Plugin](https://awesome-dsh-plugin.com/badge.svg)](https://awesome-dsh-plugin.com)
+
+DSH（DeepSeek Harness）演示文稿技能 + 工具插件：把一句话、一段文字或一篇 Markdown 文档变成可直接放映的 **HTML 网页** 与可编辑的 **PPTX**。纯 Node 实现，**零运行时依赖**，Windows / macOS / Linux 同一份代码。
+
+## 能力一览
+
+| 能力 | 说明 |
+| --- | --- |
+| `ppt_create` 工具 | Markdown / 结构化 slides → `*.html` + `*.pptx` + `*.json` 三件套 |
+| `ppt_themes` 工具 | 列出 5 套内置主题与适用场景 |
+| `dsh-ppt` 技能 | 完整 SOP 注册进 DSH：从一句话到成品 deck 的六步流水线 |
+| 裸 SKILL.md | 把 `skills/dsh-ppt/` 复制到 Claude Code / Cursor / Gemini CLI / Codex 即可跨 harness 使用 |
+| 视觉引擎 | 复用 hyperframes 视觉风格库，5 套主题 HTML 与 PPTX 同源同色 |
+
+示例对话：
+
+> 把这句话做成 PPT：「AI 客服把首次响应时间压缩到 8 秒」，主题用科技感深色。
+>
+> 把 `docs/季度汇报.md` 做成双语演示文稿，导出 PPTX。
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-ppt
+```
+
+重启后即可使用 `ppt_create` / `ppt_themes` 工具，并自动加载 `dsh-ppt` 技能。插件自带空配置，**不会弄崩启动**。
+
+## 快速开始
+
+### DSH 内（推荐）
+
+```
+1. ppt_themes                        # 看 5 套主题
+2. ppt_create {
+     title: "把会议减半",
+     content: "# 问题\n- 周会太多\n\n# 方案\n- 异步决策",
+     theme: "data",
+     lang: "zh"
+   }
+3. 打开返回的 HTML 路径（浏览器放映），PPTX 用 PowerPoint / WPS / Keynote 编辑
+```
+
+### 任意 harness（裸 SKILL.md）
+
+把 `skills/dsh-ppt/` 复制到任意 Agent Skills 目录，然后：
+
+```bash
+node <skill-dir>/scripts/build-deck.mjs \
+  --title "产品发布" \
+  --content deck.md \
+  --theme data \
+  --lang zh \
+  --out dist/deck
+```
+
+输出三件套：
+
+| 文件 | 用途 |
+| --- | --- |
+| `*.html` | 独立网页放映：方向键/滚轮/触屏翻页，F 全屏，G 总览，P 打印或另存 PDF |
+| `*.pptx` | 16:9 可编辑演示文稿（OOXML 由插件手写，zip 用 node:zlib，无第三方依赖） |
+| `*.json` | 结构化 manifest（版本、主题、语言、每页内容） |
+
+## 内置主题
+
+| ID | 名称 | 情绪 | 适用 |
+| --- | --- | --- | --- |
+| `data` | 数据漂移（默认） | 未来 / 沉浸 | AI、技术发布、研究 |
+| `swiss` | 瑞士脉冲 | 精准 / 理性 | 数据、SaaS、开发者工具 |
+| `velvet` | 天鹅绒标准 | 高级 / 克制 | 高管汇报、品牌、融资路演 |
+| `soft` | 柔和信号 | 温暖 / 人本 | 品牌故事、培训、个人分享 |
+| `bold` | 极繁大字 | 大声 / 动能 | 产品发布、活动、大事件 |
+
+主题灵感来自 [hyperframes](https://github.com/STARDUSTLC666/dsh-hyperframes) 的 `visual-styles.md`，完整色板见 `skills/dsh-ppt/references/themes.md`。
+
+## Markdown 输入规则
+
+- 第一个 `# 标题` → 封面标题；其下第一段 → 封面副标题。
+- 每个 `## 小节` → 一页：有列表生成 `bullets` 页，无内容生成 `section` 过渡页。
+- 没有标题的纯文本 → 第一段作封面，后续每 5 句一页。
+- 只有一句话 → 自动生成「封面 → 核心观点 → 结束页」三页完整结构。
+- 需要精确控制时用结构化 `slides`（`cover | section | bullets | statement | closing`）。
+
+## 配置
+
+插件无必填配置。可选：
+
+```yaml
+- id: dsh-ppt
+  config:
+    outputDir: E:\decks   # 可选；默认会话工作目录
+    maxSlides: 40         # 可选；默认 60（3–120）
+```
+
+也可用环境变量 `DSH_PPT_OUTPUT_DIR` 指定默认输出目录；`ppt_create` 的 `outputDir` 参数优先级最高。
+
+## 中英双语
+
+- `lang` 参数：`zh`（默认）/ `en` / `bilingual`，控制播放器界面、页码与结束页默认文案。
+- 内容语言由你撰写：双语 deck 推荐「中文标题 + 英文副标题」，或同一大纲分别生成中英两份。
+- 插件自身文档、技能正文、错误提示均中英双语。
+
+## 工程质量
+
+- 纯 Node，零运行时依赖：HTML 模板、OOXML、zip 全部手写，只用 `node:fs` / `node:path` / `node:zlib`。
+- 技能与工具共用一个引擎（`skills/dsh-ppt/scripts/deck-core.mjs`），不会出现「DSH 一个效果、裸技能另一个效果」。
+- 单元测试覆盖注册契约、JSON Schema、主题解析、Markdown 解析、三件套落盘、PPTX 部件完整性、CLI。
+- 无 `eval` / `child_process` / 密钥；产物只写用户指定的本地目录。
+
+## 开发
+
+```sh
+pnpm install
+pnpm run build      # tsc → lib/
+pnpm test           # 构建 + node --test（注册/配置/引擎/CLI）
+pnpm run smoke:cli  # 裸 CLI 冒烟，生成 .smoke-deck
+```
+
+## 已知限制
+
+- PPTX 采用空白版式 + 文本框实现：PowerPoint / WPS 中可正常编辑文字，但暂不生成智能母版占位符。
+- 一句话输入自动生成三页最小结构；更丰富的内容需要先扩写成 Markdown 大纲再调用 `ppt_create`。
+- `bilingual` 只双语化播放器界面，不自动翻译内容。
+- 暂不支持图表、图片、演讲者备注与 PPT 动画；这些在 v0.2+ 规划。
+
+## 协议
+
+MIT。社区插件，与 DeepSeek 官方无关；`@deepseek-ai/*` 为官方保留命名空间。
+
+## 相关项目
+
+- [dsh-hyperframes](https://github.com/STARDUSTLC666/dsh-hyperframes) — HTML 视频创作技能（本插件视觉风格来源）
+- [dsh-remotion](https://github.com/STARDUSTLC666/dsh-remotion) — React 编程式视频技能
+- [dsh-email](https://github.com/STARDUSTLC666/dsh-email) — 邮件六件套

package/cordis.patch.yml

@@ -0,0 +1,17 @@
+# dsh-ppt：演示文稿技能 + 工具插件（DeepSeek Harness 插件）。
+#
+# 安装即同时注册：
+#   1. 技能 dsh-ppt（把一句话/一篇文档变成完整演示文稿的完整 SOP）
+#   2. 工具 ppt_create / ppt_themes（确定性生成 HTML 网页放映 + PPTX 导出）
+#
+# 插件自带空配置，绝不弄崩启动；无需任何账号或密钥。可选配置：
+#
+#   - id: dsh-ppt
+#     config:
+#       outputDir: E:\decks        # 可选：默认写入会话工作目录
+#       maxSlides: 40              # 可选：单次生成幻灯片上限，默认 60
+#
+- insert:
+    - id: dsh-ppt
+      name: dsh-ppt
+      config: {}

package/lib/config.d.ts

@@ -0,0 +1,10 @@
+import type { PptConfig } from './types.js';
+export declare const PPT_OUTPUT_DIR_ENV = "DSH_PPT_OUTPUT_DIR";
+export declare const DEFAULT_MAX_SLIDES = 60;
+export interface ResolvedPptConfig {
+    outputDir: string;
+    maxSlides: number;
+}
+/** 解析并校验插件行配置。本插件无必填项，空配置永远可用。 */
+export declare function resolvePptConfig(config: PptConfig | undefined | null): ResolvedPptConfig;
+export declare function clampInt(value: unknown, fallback: number, min: number, max: number): number;

package/lib/config.js

@@ -0,0 +1,18 @@
+export const PPT_OUTPUT_DIR_ENV = 'DSH_PPT_OUTPUT_DIR';
+export const DEFAULT_MAX_SLIDES = 60;
+/** 解析并校验插件行配置。本插件无必填项，空配置永远可用。 */
+export function resolvePptConfig(config) {
+    const raw = config ?? {};
+    const outputDir = (typeof raw.outputDir === 'string' ? raw.outputDir : '').trim()
+        || (process.env[PPT_OUTPUT_DIR_ENV] ?? '').trim();
+    return {
+        outputDir,
+        maxSlides: clampInt(raw.maxSlides, DEFAULT_MAX_SLIDES, 3, 120),
+    };
+}
+export function clampInt(value, fallback, min, max) {
+    const n = typeof value === 'number' ? Math.trunc(value) : fallback;
+    if (!Number.isFinite(n))
+        return fallback;
+    return Math.min(max, Math.max(min, n));
+}

package/lib/index.d.ts

@@ -0,0 +1,33 @@
+import { type SkillsService } from './skill.js';
+import type { PptConfig } from './types.js';
+/** cordis 服务注入：apply 里要使用 ctx.tools 与 ctx.skills。 */
+export declare const inject: string[];
+export declare const name = "dsh-ppt";
+export type Config = PptConfig;
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    output: {
+        schema: Record<string, unknown>;
+        render: (args: unknown, value: unknown) => Array<{
+            type: 'text';
+            text: string;
+        }>;
+    };
+    execute: (rawArgs: unknown) => Promise<unknown>;
+}
+export interface PptPluginContext {
+    tools: {
+        register(definition: ToolDefinition): () => void;
+    };
+    skills: SkillsService;
+    logger?: {
+        warn?(message: string): void;
+    };
+    on?(event: string, listener: () => void): () => void;
+}
+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, PptSlideSpec, PptThemeInfo, PptThemesResult } from './types.js';

package/lib/index.js

@@ -0,0 +1,200 @@
+/**
+ * dsh-ppt —— 演示文稿技能 + 工具插件（v0.1.0）。
+ *
+ * 一句话或一篇 Markdown 文档 → 完整演示文稿三件套：
+ *   deck.html  独立网页放映（无外链）
+ *   deck.pptx  可编辑 PPTX（16:9，零依赖 OOXML 生成）
+ *   deck.json  结构化 manifest
+ *
+ * 插件同时注册：
+ *   1. 技能 dsh-ppt（跨 harness 的完整 SOP，SKILL.md 随包分发）
+ *   2. 工具 ppt_create / ppt_themes（确定性生成与主题查询）
+ *
+ * 生成引擎是 skills/dsh-ppt/scripts/deck-core.mjs，由工具运行时动态加载；
+ * 裸 SKILL.md 复制到其他 agent 时可直接运行同目录 build-deck.mjs。
+ *
+ * @module dsh-ppt
+ */
+import { resolvePptConfig } from './config.js';
+import { registerPptSkill } from './skill.js';
+/** cordis 服务注入：apply 里要使用 ctx.tools 与 ctx.skills。 */
+export const inject = ['tools', 'skills'];
+export const name = 'dsh-ppt';
+/**
+ * 把作者 DSL 映射编译成原生 JSON Schema 对象，作为 defineTool 的
+ * definition.parameters 原样下发。原生 wire 请求会逐字携带该值。
+ */
+function compileParameters(spec) {
+    const properties = {};
+    const required = [];
+    for (const [key, prop] of Object.entries(spec)) {
+        if (prop?.required === true)
+            required.push(key);
+        const node = {};
+        if (typeof prop?.type === 'string')
+            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;
+    }
+    return { type: 'object', properties, ...(required.length > 0 ? { required } : {}) };
+}
+const themeInfoSchema = {
+    type: 'object',
+    properties: {
+        id: { type: 'string' },
+        name: { type: 'string' },
+        mood: { type: 'string' },
+        bestFor: { type: 'string' },
+        dark: { type: 'boolean' },
+        palette: { type: 'object', additionalProperties: true },
+        fonts: { type: 'object', additionalProperties: true },
+    },
+    additionalProperties: true,
+};
+const themesResultSchema = {
+    type: 'object',
+    properties: {
+        ok: { type: 'boolean' },
+        themes: { type: 'array', items: themeInfoSchema },
+    },
+    additionalProperties: true,
+};
+const createResultSchema = {
+    type: 'object',
+    properties: {
+        ok: { type: 'boolean' },
+        title: { type: 'string' },
+        theme: { type: 'string' },
+        language: { type: 'string' },
+        slideCount: { type: 'integer' },
+        outputDir: { type: 'string' },
+        files: {
+            type: 'object',
+            properties: {
+                html: { type: 'string' },
+                pptx: { type: 'string' },
+                json: { type: 'string' },
+            },
+            additionalProperties: true,
+        },
+        htmlPath: { type: 'string' },
+        pptxPath: { type: 'string' },
+        jsonPath: { type: 'string' },
+    },
+    additionalProperties: true,
+};
+function oneText(text) {
+    return [{ type: 'text', text }];
+}
+function renderThemes(value) {
+    if (value.themes.length === 0)
+        return oneText('dsh-ppt 没有可用主题。');
+    const lines = value.themes.map((theme) => '- ' + theme.id + '：' + theme.name + '（' + theme.mood + '）｜适合：' + theme.bestFor + '｜' + (theme.dark ? '深色' : '浅色'));
+    return oneText('dsh-ppt 内置主题：\n\n' + lines.join('\n') + '\n\nppt_create 的 theme 参数填其中的 id（默认 data）。');
+}
+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 双击即可放映（方向键翻页 / F 全屏 / G 总览 / P 打印）；PPTX 可用 PowerPoint / WPS / Keynote 打开。');
+}
+let enginePromise = null;
+function getEngine() {
+    if (enginePromise === null) {
+        const engineUrl = new URL('../skills/dsh-ppt/scripts/deck-core.mjs', import.meta.url);
+        enginePromise = import(engineUrl.href).then((module) => module)
+            .catch((error) => {
+            enginePromise = null;
+            throw error;
+        });
+    }
+    return enginePromise;
+}
+function isRecord(value) {
+    return value !== null && typeof value === 'object';
+}
+export function apply(ctx, config = {}) {
+    const resolved = resolvePptConfig(config);
+    const warn = (message) => { ctx.logger?.warn?.(message); };
+    const disposers = [];
+    // 技能注册：单个技能文件缺失只告警，不弄崩宿主启动。
+    try {
+        disposers.push(registerPptSkill(ctx));
+    }
+    catch (error) {
+        warn('[dsh-ppt] 技能加载失败：' + (error instanceof Error ? error.message : String(error)));
+    }
+    disposers.push(ctx.tools.register({
+        name: 'ppt_themes',
+        description: 'List the built-in visual themes of dsh-ppt (id, name, mood, best-for, light/dark palette) before building a deck. Use a theme id as the theme argument of ppt_create. 中文：列出 dsh-ppt 内置视觉主题（id、名称、情绪、适用场景、明暗色板），用于选择 ppt_create 的 theme 参数。',
+        parameters: compileParameters({
+            lang: { type: 'string', description: 'Theme description language: zh (default), en, or bilingual.' },
+        }),
+        output: {
+            schema: themesResultSchema,
+            render: (_args, value) => renderThemes(value),
+        },
+        async execute(rawArgs) {
+            const args = isRecord(rawArgs) ? rawArgs : {};
+            const lang = typeof args.lang === 'string' && args.lang.trim() !== '' ? args.lang.trim() : 'zh';
+            const engine = await getEngine();
+            const themes = engine.listThemes(lang);
+            return { ok: true, themes };
+        },
+    }));
+    disposers.push(ctx.tools.register({
+        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 套视觉主题。',
+        parameters: compileParameters({
+            title: { type: 'string', required: true, description: 'Deck title (used for the cover and file names).' },
+            content: { type: 'string', required: true, description: 'Markdown content: one sentence, a paragraph, or a full document. First # heading becomes the cover title; ## headings become slides; -/* lists become bullets. 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.' },
+            slides: { type: 'array', items: { type: 'object', additionalProperties: true }, description: 'Optional structured slides: [{ layout: cover|section|bullets|statement|closing, title, subtitle, kicker, bullets: [] }]. Use this for precise control instead of content.' },
+            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.' },
+        }),
+        output: {
+            schema: createResultSchema,
+            render: (_args, value) => renderCreate(value),
+        },
+        async execute(rawArgs) {
+            const args = (isRecord(rawArgs) ? rawArgs : {});
+            if (typeof args.title !== 'string' || args.title.trim() === '')
+                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 传结构化幻灯片）');
+            const engine = await getEngine();
+            return engine.buildDeck({
+                title: args.title.trim(),
+                content: typeof args.content === 'string' ? args.content : '',
+                slides: hasSlides ? args.slides : undefined,
+                theme: typeof args.theme === 'string' && args.theme.trim() !== '' ? args.theme.trim() : undefined,
+                lang: typeof args.lang === 'string' && args.lang.trim() !== '' ? args.lang.trim() : undefined,
+                outputDir: typeof args.outputDir === 'string' && args.outputDir.trim() !== '' ? args.outputDir.trim() : (resolved.outputDir || undefined),
+                fileName: typeof args.fileName === 'string' && args.fileName.trim() !== '' ? args.fileName.trim() : undefined,
+                maxSlides: resolved.maxSlides,
+            });
+        },
+    }));
+    if (typeof ctx.on === 'function') {
+        ctx.on('dispose', () => {
+            for (const dispose of disposers)
+                dispose();
+        });
+    }
+}
+export { resolvePptConfig, PPT_OUTPUT_DIR_ENV, DEFAULT_MAX_SLIDES, clampInt } from './config.js';
+export { bundledSkillsDir, parseSkillFile, registerPptSkill, SKILL_NAMES } from './skill.js';

package/lib/skill.d.ts

@@ -0,0 +1,29 @@
+/** cordis 服务注入：apply 里要使用 ctx.skills。 */
+export interface SkillRegistration {
+    name: string;
+    description: string;
+    content: string;
+    resourceBase: {
+        kind: 'directory';
+        path: string;
+    };
+    source?: string;
+}
+export interface SkillsService {
+    register(definition: SkillRegistration): () => void;
+}
+export declare const SKILL_NAMES: readonly ["dsh-ppt"];
+/** 随包分发的技能目录绝对路径。 */
+export declare function bundledSkillsDir(): string;
+export declare function parseSkillFile(text: string): {
+    name: string;
+    description: string;
+    content: string;
+};
+/**
+ * 把技能注册进 DSH 技能注册表。技能文件缺失或 frontmatter 不完整只告警，
+ * 绝不弄崩宿主启动。
+ */
+export declare function registerPptSkill(ctx: {
+    skills: SkillsService;
+}): () => void;