dsh-ppt 0.1.0

package/lib/skill.js

@@ -0,0 +1,60 @@
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { join } from 'node:path';
+export const SKILL_NAMES = ['dsh-ppt'];
+/** 随包分发的技能目录绝对路径。 */
+export function bundledSkillsDir() {
+    return fileURLToPath(new URL('../skills/', import.meta.url));
+}
+/** 解析 SKILL.md 的 frontmatter（v0.1 只读 name/description 两个单行字段，零依赖）。 */
+function unquoteYamlScalar(value) {
+    const trimmed = value.trim();
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) || (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1).replace(/\\"/g, '"').replace(/\\n/g, '\n').trim();
+    }
+    return trimmed;
+}
+export function parseSkillFile(text) {
+    const normalized = text.replace(/^\uFEFF/, '').replace(/\r\n?/g, '\n');
+    const match = /^---[ \t]*\n([\s\S]*?)\n---[ \t]*\n?/.exec(normalized);
+    if (!match)
+        return { name: '', description: '', content: normalized };
+    const frontmatter = match[1];
+    let name = '';
+    let description = '';
+    for (const rawLine of frontmatter.split('\n')) {
+        const line = rawLine.trim();
+        const keyMatch = /^([A-Za-z][A-Za-z0-9_-]*):[ \t]*(.*)$/.exec(line);
+        if (keyMatch === null)
+            continue;
+        if (keyMatch[1] === 'name')
+            name = unquoteYamlScalar(keyMatch[2]);
+        else if (keyMatch[1] === 'description')
+            description = unquoteYamlScalar(keyMatch[2]);
+    }
+    // legacy regex 解析已由逐行 YAML 扫描替代
+    // legacy description regex 已由逐行 YAML 扫描替代
+    // name 已在逐行扫描中解析
+    // description 已在逐行扫描中解析
+    return { name, description, content: normalized.slice(match[0].length).trimStart() };
+}
+/**
+ * 把技能注册进 DSH 技能注册表。技能文件缺失或 frontmatter 不完整只告警，
+ * 绝不弄崩宿主启动。
+ */
+export function registerPptSkill(ctx) {
+    const skillName = SKILL_NAMES[0];
+    const dir = join(bundledSkillsDir(), skillName);
+    const text = readFileSync(join(dir, 'SKILL.md'), 'utf8');
+    const parsed = parseSkillFile(text);
+    if (parsed.name === '' || parsed.description === '' || parsed.content === '') {
+        throw new Error('技能 ' + skillName + ' 的 frontmatter 不完整（name/description/content 均不能为空）');
+    }
+    return ctx.skills.register({
+        name: parsed.name,
+        description: parsed.description,
+        content: parsed.content,
+        resourceBase: { kind: 'directory', path: dir },
+        source: 'runtime',
+    });
+}

package/lib/types.d.ts

@@ -0,0 +1,65 @@
+/** dsh-ppt 的公共类型。 */
+export type PptThemeId = 'swiss' | 'velvet' | 'data' | 'soft' | 'bold';
+export type PptLanguage = 'zh' | 'en' | 'bilingual';
+export type PptSlideLayout = 'cover' | 'section' | 'bullets' | 'statement' | 'closing';
+export interface PptSlideSpec {
+    layout?: PptSlideLayout;
+    title?: string;
+    subtitle?: string;
+    kicker?: string;
+    text?: string;
+    bullets?: string[];
+}
+export interface PptConfig {
+    /** 默认输出目录；调用 ppt_create 时可用 outputDir 覆盖。默认当前工作目录。 */
+    outputDir?: string;
+    /** 单次生成幻灯片上限，默认 60（3–120）。 */
+    maxSlides?: number;
+}
+export interface PptCreateArgs {
+    title: string;
+    /** Markdown 正文：一句话、一段文字或整篇文档（与 slides 二选一，推荐）。 */
+    content?: string;
+    /** 结构化幻灯片（高级用法，与 content 二选一）。 */
+    slides?: PptSlideSpec[];
+    theme?: string;
+    lang?: string;
+    outputDir?: string;
+    fileName?: string;
+}
+export interface PptThemeInfo {
+    id: string;
+    name: string;
+    mood: string;
+    bestFor: string;
+    dark: boolean;
+    palette: Record<string, string>;
+    fonts: Record<string, string>;
+}
+export interface PptThemesResult {
+    ok: boolean;
+    themes: PptThemeInfo[];
+}
+export interface PptCreateResult {
+    ok: boolean;
+    title: string;
+    theme: string;
+    language: string;
+    slideCount: number;
+    outputDir: string;
+    files: {
+        html: string;
+        pptx: string;
+        json: string;
+    };
+    htmlPath: string;
+    pptxPath: string;
+    jsonPath: string;
+}
+/** deck-core.mjs 暴露给插件的最小面。 */
+export interface DeckEngine {
+    buildDeck(options: Record<string, unknown>): PptCreateResult;
+    listThemes(lang?: string): PptThemeInfo[];
+    resolveTheme(input: unknown): Record<string, unknown>;
+    resolveLanguage(input: unknown): Record<string, unknown>;
+}

package/lib/types.js

@@ -0,0 +1,2 @@
+/** dsh-ppt 的公共类型。 */
+export {};

package/package.json

@@ -0,0 +1,71 @@
+{
+  "name": "dsh-ppt",
+  "version": "0.1.0",
+  "description": "DSH 演示文稿技能 + 工具插件：一句话或一篇 Markdown 文档 → 完整演示文稿（独立 HTML 网页放映 + 可编辑 PPTX 导出），内置 5 套视觉主题，中英双语，SKILL.md 双格式跨 harness。",
+  "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",
+    "prepare": "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": ">=20"
+  },
+  "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"
+}

package/skills/dsh-ppt/SKILL.md

@@ -0,0 +1,103 @@
+---
+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) 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."
+allowed-tools: "Bash, Read, Write, Edit"
+---
+
+# dsh-ppt
+
+一句话或一篇文档 → 完整演示文稿：**独立 HTML 网页放映 + 可编辑 PPTX**。这是从内容到成品的完整 SOP；DSH 内安装插件后调用 `ppt_create` / `ppt_themes` 工具，其他 harness 复制本目录并运行 `scripts/build-deck.mjs`。
+
+## 触发条件
+
+- 用户要求做 PPT、幻灯片、演示文稿、deck、keynote、汇报、提案、路演、培训材料。
+- 用户给了一句话、一段文字或一篇 Markdown 文档，希望变成可放映/可分享的演示。
+- 用户提到导出 PPTX 或网页版幻灯片。
+
+## 核心流水线（每次执行）
+
+1. **Probe 需求**：读入用户的句子/文档。确定听众、目标（说服/汇报/教学/发布）、语气与情绪基调。一句话输入不要反问，直接按发布场景推断并产出完整内容。
+2. **Outline 大纲**：产出 5–12 页大纲。每页只讲一个观点；页型组合固定为：封面 → 问题/背景 → 方案/论点（3–6 页）→ 证据/案例 → 行动号召 → 结束页。每页要点不超过 6 条，每条不超过 20 字（中文）或 12 词（英文）。
+3. **Theme 主题**：调用 `ppt_themes`（DSH）或 `node scripts/build-deck.mjs --list-themes`（跨 harness）选择视觉主题。情绪 → 主题映射见 `references/themes.md`；默认 `data`（技术/AI），高管汇报用 `velvet`，数据报表用 `swiss`，温暖叙事用 `soft`，大声量发布用 `bold`。
+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`
+   - 输出三件套：`*.html`（双击即放映）、`*.pptx`（可编辑）、`*.json`（manifest）。
+5. **Verify 校验**：确认 HTML 页数与大纲一致、标题/要点无截断；PPTX 文件头为 `PK`（zip）。DSH 内用文件工具读取确认；跨 harness 用 `unzip -l deck.pptx | grep presentation.xml` 或 PowerShell `Expand-Archive` 抽查。
+6. **Deliver 交付**：给用户三个绝对路径，并说明：HTML 浏览器直接打开（方向键翻页、F 全屏、G 总览、P 打印/另存 PDF）；PPTX 用 PowerPoint / WPS / Keynote 打开。
+
+## 内容写作规则
+
+- 一句话输入也要「完整」：封面 = 标题 + 那句话；核心观点页 = 原句放大；结束页 = 谢谢/行动号召。若用户要求更丰富，先自行扩写成 6–10 页大纲再构建。
+- 一页一个观点；标题是判断句，不是名词短语。
+- 正文用短句；先结论后理由；数字和对比比形容词更有说服力。
+- 中英双语：`lang` 只决定界面文字（页码/主题标签/结束页），**内容语言由你撰写**。要求双语时，优先每页中文标题 + 英文副标题，或直接生成两份 deck（`--lang zh` 与 `--lang en`）。
+- 更多规则见 `references/copywriting.md`。
+
+## 主题选择
+
+内置 5 套主题（源自 hyperframes 视觉风格库）：
+
+| 主题 ID | 名称 | 情绪 | 适用 |
+| --- | --- | --- | --- |
+| `data` | 数据漂移 | 未来/沉浸 | AI、技术发布、研究（默认） |
+| `swiss` | 瑞士脉冲 | 精准/理性 | 数据、SaaS、开发者工具 |
+| `velvet` | 天鹅绒标准 | 高级/克制 | 高管汇报、品牌、融资路演 |
+| `soft` | 柔和信号 | 温暖/人本 | 品牌故事、培训、个人分享 |
+| `bold` | 极繁大字 | 大声/动能 | 产品发布、活动、大事件 |
+
+完整色板与反模式见 `references/themes.md`。
+
+## 视觉引擎复用（hyperframes）
+
+如果 `hyperframes` 技能已安装，生成前先读它的 `visual-styles.md` / `house-style.md` 作为视觉判断依据；本技能的 5 套主题就是把其中 Swiss Pulse / Velvet Standard / Data Drift / Soft Signal / Maximalist Type 五套风格落成确定性 HTML+PPTX 实现。需要高级动画视频版时，才转用 hyperframes；普通演示不要上视频引擎。
+
+## 结构化 slides（高级用法）
+
+`ppt_create` 的 `slides` 与 CLI `--slides` 接受 JSON 数组：
+
+```json
+[
+  { "layout": "cover", "title": "标题", "subtitle": "副标题", "kicker": "开场" },
+  { "layout": "section", "kicker": "01", "title": "背景" },
+  { "layout": "bullets", "title": "三个论点", "bullets": ["论点一", "论点二", "论点三"] },
+  { "layout": "statement", "title": "核心观点一句话", "subtitle": "支撑说明" },
+  { "layout": "closing", "title": "谢谢", "subtitle": "行动号召" }
+]
+```
+
+`layout` 仅限 `cover | section | bullets | statement | closing`。Markdown 输入不够精确时，用结构化 slides 重写。
+
+## 质量门禁（交付前逐项确认）
+
+- [ ] 页数 3–60，首屏是封面，末屏是结束页。
+- [ ] 每页有明确标题；bullets 页 1–8 条。
+- [ ] HTML 与 PPTX 使用同一主题，配色一致。
+- [ ] 主题色对比度足够（深底浅字或浅底深字）。
+- [ ] 中文内容无错别字；英文标题用 Title Case。
+- [ ] 文件已写到用户工作区，路径为绝对路径。
+
+## 故障排查
+
+| 症状 | 处理 |
+| --- | --- |
+| `ppt_create` 不存在 | 本插件未安装；用 `node <skill-dir>/scripts/build-deck.mjs` 裸 CLI 生成同样三件套 |
+| 未知主题 | `ppt_themes` 或 `--list-themes` 看可用 ID；不要猜 |
+| 内容超过 60 页 | 合并论点，或拆成多个 deck；`maxSlides` 默认 60 |
+| PPTX 打不开 | 确认文件完整（zip 头 `PK`）；Office 首次打开空白版式属正常，编辑视图可用 |
+| 双语界面 | `lang: bilingual` 只双语化界面；内容双语由 agent 在写作阶段完成 |
+
+## 跨 harness 安装
+
+把整个 `dsh-ppt` 技能目录复制到目标 agent 的技能目录即可（只依赖 Node 20+）：
+
+| 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/references/copywriting.md

@@ -0,0 +1,68 @@
+# dsh-ppt 幻灯片写作规则（中英双语）
+
+## 结构模板
+
+任何 deck 都遵循同一叙事骨架：
+
+1. **封面**：标题（判断句或名词短语 + 价值承诺）+ 副标题（一句话定位）。
+2. **背景/问题**：现状 → 痛点 → 为什么现在。
+3. **方案/论点**：每个论点一页，先结论后理由。
+4. **证据/案例**：数字、对比、客户/数据点。
+5. **行动号召**：希望听众下一步做什么。
+6. **结束页**：谢谢 + 联系方式或 CTA 重复。
+
+一句话输入的最小完整结构：封面 → 核心观点页 → 结束页。
+
+## 单页规则
+
+- 一个页面只讲一个观点。
+- 标题是完整的判断句，例如「AI 客服把首响时间压缩到 8 秒」，而不是「关于客服」。
+- bullets 1–8 条，中文每条 ≤ 20 字，英文每条 ≤ 12 词。
+- 优先使用数字、对比、动词；避免「赋能、抓手、闭环」等空词。
+- 最后一页要给出可执行的 CTA，不是只写「谢谢」。
+
+## 双语规则
+
+- 插件 `lang` 参数只控制界面（页码/标签/结束页默认文案）；**内容双语由写作阶段完成**。
+- 双语 deck 推荐两种做法：
+  1. 同一页内：中文标题 + 英文副标题；bullets 中文为主，关键词括号英文。
+  2. 两份 deck：同一大纲分别以 `zh` 与 `en` 生成，主题保持一致。
+- 英文标题用 Title Case；术语首现给中文+英文，如「检索增强生成（RAG）」。
+- 双语时不要逐句直译，按目标语言习惯重写。
+
+## Markdown 输入规范
+
+`ppt_create` 与 `build-deck.mjs` 按以下规则解析 Markdown：
+
+- 第一个 `# 标题` 会成为封面标题；其后的段落/列表成为封面副标题来源。
+- 每个 `## 小节`（或更深标题）生成一页：
+  - 有 `- ` / `* ` / `1.` 列表 → `bullets` 页；
+  - 无列表且无正文 → `section` 过渡页；
+  - 有正文段落 → 正文拆句后作为 bullets。
+- 没有标题的纯文本：第一段第一句为封面副标题，后续段落按 5 句一组拆成要点页。
+- 只有一句话：自动生成「封面 → 核心观点 → 结束页」三页。
+- 需要更精细控制时使用结构化 `slides` JSON，不要和 Markdown 混用。
+
+## 示例
+
+输入：
+
+```markdown
+# 让会议少一半
+
+用异步决策替代同步例会。
+
+## 问题
+- 工程师每周 6 小时在例会上
+- 决策没有记录，反复讨论
+
+## 方案
+- 会前异步文档 + 24h 评论期
+- 只有分歧项才开会
+
+## 效果
+- 周会从 4 次降到 1 次
+- 决策记录 100% 沉淀
+```
+
+产出：封面 → 问题 → 方案 → 效果 → 结束页，共 5 页，主题可选 `swiss`（数据/效率）或 `soft`（团队协作）。

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

@@ -0,0 +1,55 @@
+# dsh-ppt 内置主题参考
+
+主题系统移植自 hyperframes 技能的 `visual-styles.md` 视觉风格库。每套主题在 HTML 与 PPTX 中使用同一色板、同一字体族、同一情绪规则。
+
+## 速查
+
+| ID | 中文名 | English | 明暗 | 底色 | 前景 | 主强调 | 次强调 | 情绪 | 适用 |
+| --- | --- | --- | --- | --- | --- | --- | --- | --- | --- |
+| `data` | 数据漂移 | Data Drift | 暗 | `#070B14` | `#E8F1FF` | `#7C3AED` | `#06B6D4` | 未来/沉浸 | AI、数据、研究、技术发布 |
+| `swiss` | 瑞士脉冲 | Swiss Pulse | 暗 | `#10151B` | `#F5F7FA` | `#2F6BFF` | `#FFB300` | 精准/理性 | SaaS、数据、开发者工具 |
+| `velvet` | 天鹅绒标准 | Velvet Standard | 暗 | `#111316` | `#F4EFE6` | `#C9A84C` | `#3D4A63` | 高级/克制 | 高管汇报、品牌、融资路演 |
+| `soft` | 柔和信号 | Soft Signal | 亮 | `#FFF8EC` | `#3B2F2A` | `#E58A2F` | `#8FAF8C` | 温暖/人本 | 品牌故事、培训、个人分享 |
+| `bold` | 极繁大字 | Maximalist Type | 暗 | `#0D0D0D` | `#FFFFFF` | `#E63946` | `#FFD60A` | 大声/动能 | 产品发布、活动、大事件 |
+
+## 逐主题说明
+
+### data — 数据漂移（默认）
+
+- 深黑底 + 电光紫 + 青色，细体未来感。
+- 适合 AI / ML / 数据 / 前沿技术；大标题少字，用对比数字。
+- 反模式：不要加多余暖色；不要堆长段落。
+
+### swiss — 瑞士脉冲
+
+- 黑白灰 + 一个电蓝（或琥珀），栅格感、大数字。
+- 适合 SaaS / 指标 / 开发者工具；标题短、要点像 spec。
+- 反模式：不要装饰性渐变文字；不要圆角卡片堆叠。
+
+### velvet — 天鹅绒标准
+
+- 黑、米白、香槟金，衬线标题 + 无衬线正文，宽字距，留白多。
+- 适合高管汇报 / 品牌 / 融资；节奏慢，页数少而精。
+- 反模式：不要动画感强烈的颜色；不要超过一个强调色。
+
+### soft — 柔和信号
+
+- 暖奶油底、深棕字、琥珀 + 鼠尾草绿，亮色唯一浅底主题。
+- 适合品牌故事 / 培训 / 个人分享；文字可以更口语。
+- 反模式：不要用纯黑正文；不要高饱和撞色。
+
+### bold — 极繁大字
+
+- 黑底、正红 + 明黄，超粗标题，字就是视觉主体。
+- 适合产品发布 / 活动 / 大事件；短标题、单页单一冲击。
+- 反模式：不要把页面塞满要点；不要让红黄之外再出现第三种强调色。
+
+## 选主题决策树
+
+1. 情绪是未来/科技 → `data`
+2. 情绪是理性/数据/精准 → `swiss`
+3. 情绪是高级/信任/正式 → `velvet`
+4. 情绪是温暖/人本/故事 → `soft`
+5. 情绪是大音量/发布会 → `bold`
+
+无法判断时用 `data`，不要自造主题 ID。

package/skills/dsh-ppt/scripts/build-deck.mjs

@@ -0,0 +1,126 @@
+#! /usr/bin/env node
+/**
+ * build-deck.mjs —— dsh-ppt 的跨 harness 裸 CLI。
+ *
+ * DSH 插件内请优先使用 ppt_create 工具；把 skills/dsh-ppt 目录复制到
+ * Claude Code / Cursor / Gemini CLI / Codex 等 agent 时，用本脚本生成三件套。
+ *
+ * 示例：
+ *   node build-deck.mjs --title "产品发布" --content "deck.md" --theme data --lang zh --out dist/deck
+ *   node build-deck.mjs --title "Pitch" --content "一句话介绍我们的产品。" --theme velvet --lang bilingual
+ *   node build-deck.mjs --list-themes
+ */
+
+import { readFileSync } from 'node:fs'
+import { resolve as resolvePath } from 'node:path'
+import { pathToFileURL } from 'node:url'
+import { buildDeck, listThemes, THEME_IDS, DEFAULT_THEME } from './deck-core.mjs'
+
+const HELP = `dsh-ppt v0.1.0 —— 一句话 / 一篇文档 → HTML 放映 + PPTX 导出
+
+用法：
+  node build-deck.mjs --title <标题> --content <Markdown 或文件路径> [选项]
+
+选项：
+  --title <text>      演示文稿标题（必填）
+  --content <text|@path>  Markdown 正文；或文件路径（自动读取）；或 @- 从 stdin 读
+  --slides <json>     结构化 slides JSON（可选，与 --content 二选一）
+  --theme <id>        视觉主题：${THEME_IDS.join(' / ')}（默认 ${DEFAULT_THEME}）
+  --lang <id>         界面语言：zh / en / bilingual（默认 zh）
+  --out <dir>         输出目录（默认当前目录）
+  --file <name>       文件名前缀（默认取标题）
+  --list-themes       列出内置主题
+  --help              显示本帮助
+
+输出：
+  <file>.html   独立网页放映（无外链，可直接双击打开）
+  <file>.pptx   可编辑 PPTX（16:9）
+  <file>.json   deck manifest
+`
+
+export function parseArgv(argv) {
+  const args = { content: '', slides: null, lang: 'zh', theme: DEFAULT_THEME, out: '.', file: '', title: '' }
+  const positional = []
+  for (let i = 0; i < argv.length; i += 1) {
+    const raw = String(argv[i])
+    const eq = raw.indexOf('=')
+    const key = eq >= 0 ? raw.slice(0, eq) : raw
+    const inline = eq >= 0 ? raw.slice(eq + 1) : null
+    const nextValue = () => {
+      if (inline !== null) return inline
+      if (i + 1 >= argv.length) throw new Error('dsh-ppt CLI：' + key + ' 需要一个值')
+      i += 1
+      return String(argv[i])
+    }
+    if (key === '--help' || key === '-h') args.help = true
+    else if (key === '--list-themes') args.listThemes = true
+    else if (key === '--title') args.title = nextValue()
+    else if (key === '--content') args.content = nextValue()
+    else if (key === '--slides') args.slides = JSON.parse(nextValue())
+    else if (key === '--theme') args.theme = nextValue()
+    else if (key === '--lang') args.lang = nextValue()
+    else if (key === '--out') args.out = nextValue()
+    else if (key === '--file') args.file = nextValue()
+    else positional.push(raw)
+  }
+  args.positional = positional
+  return args
+}
+
+async function readStdin(stream) {
+  let text = ''
+  stream.setEncoding('utf8')
+  for await (const chunk of stream) text += chunk
+  return text
+}
+
+export async function main(argv = process.argv.slice(2), io = {}) {
+  const log = io.log ?? ((message) => console.log(message))
+    const args = parseArgv(argv)
+
+  if (args.help) {
+    log(HELP.trim())
+    return 0
+  }
+  if (args.listThemes) {
+    for (const theme of listThemes('zh')) {
+      log('- ' + theme.id.padEnd(8) + theme.name + '｜' + theme.mood + '｜适合：' + theme.bestFor)
+    }
+    return 0
+  }
+
+  let content = String(args.content ?? '')
+  let slides = args.slides
+  if (content === '@-') {
+    content = await readStdin(io.stdin ?? process.stdin)
+  } else if (content.startsWith('@')) {
+    content = readFileSync(resolvePath(content.slice(1)), 'utf8')
+  } else if (content.trim() === '' && slides === null) {
+    throw new Error('dsh-ppt CLI：--content 不能为空（或用 --slides 传结构化幻灯片）')
+  }
+
+  const options = {
+    title: args.title,
+    content,
+    slides,
+    theme: args.theme,
+    lang: args.lang,
+    outputDir: resolvePath(args.out || '.'),
+    fileName: args.file,
+  }
+  const result = buildDeck(options)
+  log('dsh-ppt 已生成 ' + result.slideCount + ' 页演示文稿：')
+  log('  HTML 放映：' + result.htmlPath)
+  log('  PPTX 导出：' + result.pptxPath)
+  log('  Manifest ：' + result.jsonPath)
+  return 0
+}
+
+if (import.meta.url === pathToFileURL(process.argv[1] ?? '').href) {
+  main().then((code) => {
+    process.exitCode = code ?? 0
+  }).catch((err) => {
+    console.error('[dsh-ppt] ' + (err instanceof Error ? err.message : String(err)))
+    process.exitCode = 1
+  })
+}