@lemonppt/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lemonforme
+
+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/SKILL.md

@@ -0,0 +1,156 @@
+# lemonPPT
+
+根据一句话主题或需求，自动生成精美 PPT（goal.json/HTML/PPTX/PDF）。
+
+## 能力
+
+- 接受用户输入（主题、目标页数、主题风格、语言）
+- 生成结构化演示文稿规划（goal.json）
+- 渲染为可浏览的 HTML
+- 导出为 PPTX 或 PDF
+
+## 使用流程
+
+用户说"帮我做一份 PPT"时，按以下三步执行：
+
+### 1. 生成 goal.json
+
+```bash
+lemonppt generate "<主题>" --pages <页数> --theme <主题> --language zh --out ./goal.json
+```
+
+- `--pages`：页数，建议 6~20 页
+- `--theme`：主题 ID，可选 `minimal`、`dark-tech`、`warm-business`
+- `--language`：`zh` 或 `en`
+- `--api-key`：可选，OpenAI 兼容 API Key；不传则使用内置 fallback 示例
+
+### 2. 导出 PPTX / PDF
+
+```bash
+lemonppt export ./goal.json --pptx ./deck.pptx --pdf ./deck.pdf
+```
+
+至少传 `--pptx` 或 `--pdf` 之一。
+
+### 3. 交付文件
+
+把生成的 `goal.json`、`deck.pptx`、`deck.pdf` 以及 `output/index.html` 展示给用户。
+
+如果用户只需要文件，交付 PPTX/PDF；如果用户想在线预览，交付 HTML。
+
+## goal.json 格式
+
+```json
+{
+  "title": "演示文稿标题",
+  "goal": "演示目标",
+  "audience": "目标受众",
+  "owner": "汇报人",
+  "theme": "minimal",
+  "language": "zh",
+  "pageCount": 8,
+  "randomSeed": "可选种子",
+  "slides": [
+    {
+      "role": "cover",
+      "layout": "cover_v1",
+      "props": {
+        "title": "标题",
+        "subtitle": "副标题",
+        "date": "2026-07-18"
+      }
+    }
+  ]
+}
+```
+
+### 字段说明
+
+| 字段 | 必填 | 说明 |
+|---|---|---|
+| `title` | 是 | PPT 标题 |
+| `goal` | 是 | 演示目标/背景 |
+| `audience` | 是 | 受众描述 |
+| `owner` | 否 | 汇报人 |
+| `theme` | 是 | 主题 ID |
+| `language` | 否 | `zh` 或 `en`，默认 `zh` |
+| `pageCount` | 是 | 总页数，必须等于 `slides.length` |
+| `randomSeed` | 否 | 随机种子，保证结果可复现 |
+| `slides` | 是 | 幻灯片数组 |
+
+每个 slide：
+
+| 字段 | 必填 | 说明 |
+|---|---|---|
+| `role` | 是 | 页面角色，见下方角色表 |
+| `layout` | 否 | 具体版式 ID；留空时系统按 role 自动选择 |
+| `props` | 是 | 该版式所需数据 |
+
+## 可用主题
+
+| 主题 ID | 风格 |
+|---|---|
+| `minimal` | 极简商务 |
+| `dark-tech` | 深色科技 |
+| `warm-business` | 温暖商务 |
+
+## 页面角色与版式
+
+Agent 选页时只需指定 `role`，系统会根据角色自动挑选合适版式。只有在明确需要某一款版式时才填 `layout`。
+
+| role | 用途 | 可用版式 |
+|---|---|---|
+| `cover` | 封面 | `cover_v1` |
+| `tableOfContents` | 目录 | `table_of_contents_v1` |
+| `metric` | 关键指标 | `metric_v1`, `metric_v2` |
+| `stats` | 2x2 统计网格 | `stats_v1` |
+| `chart` | 图表 | `chart_v1` |
+| `comparison` | 对比 | `comparison_v1`, `comparison_v2` |
+| `pricing` | 价格方案 | `pricing_v1` |
+| `process` | 流程步骤 | `process_v1`, `process_v2` |
+| `timeline` | 时间线 | `timeline_v1` |
+| `roadmap` | 路线图 | `roadmap_v1` |
+| `quote` | 金句引用 | `quote_v1`, `quote_v2` |
+| `testimonial` | 客户评价 | `testimonial_v1` |
+| `content` | 内容页 | `content_v1`, `content_v2`, `content_v3`, `split_v1` |
+| `faq` | 问答 | `faq_v1` |
+| `feature` | 产品特性 | `feature_v1` |
+| `team` | 团队介绍 | `team_v1` |
+| `partners` | 合作伙伴墙 | `partners_v1` |
+| `image` | 全屏图片 | `image_v1` |
+| `gallery` | 图片画廊 | `gallery_v1` |
+| `swot` | SWOT 分析 | `swot_v1` |
+| `pest` | PEST 分析 | `pest_v1` |
+| `closing` | 结尾页 | `closing_v1`, `closing_v2` |
+
+## 常见 props 字段
+
+- `title`：页面主标题
+- `kicker`：小标题/标签
+- `subtitle`：副标题
+- `items`：列表项数组
+- `points`：要点数组
+- `stats`：指标数组，元素含 `label`、`value`、`unit`、`change`
+- `image` / `imageUrl`：图片 URL（远程 URL 在 PPTX 中可能显示占位符）
+- `cta` / `contact` / `email` / `link`：结尾页联系方式
+
+## 常见错误处理
+
+1. **没有 API Key**：`lemonppt generate` 会 fallback 到内置示例内容，仍可生成完整文件。
+2. **页数太少**：建议封面 + 目录 + 3~5 页内容 + 结尾，最少 5 页。
+3. **远程图片在 PPTX 中不显示**：PPTX 导出优先使用本地图片或 base64；远程 URL 会显示占位符。
+4. **生成失败**：检查 JSON 是否合法、`slides.length` 是否等于 `pageCount`。
+
+## 完整示例
+
+```bash
+lemonppt generate "AI 助手产品发布会" --pages 8 --theme dark-tech --language zh --out ./ai-launch.json
+lemonppt render ./ai-launch.json --out ./output
+lemonppt export ./ai-launch.json --pptx ./ai-launch.pptx --pdf ./ai-launch.pdf
+```
+
+## 注意事项
+
+- 不要手动指定每个 slide 的 `layout`，优先只写 `role`。
+- `goal.json` 是核心协议，生成后可以直接交给用户修改再导出。
+- 所有命令在 lemonPPT 项目根目录执行；CLI 入口为 `packages/cli/dist/cli.js` 或安装后的 `lemonppt`。

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+import { exportGoalToPdf, exportGoalToPptx, generateGoalToFile, readGoalFromFile, renderGoalToDir, } from './index.js';
+import { installSkill } from './install-skill.js';
+function printUsage() {
+    console.log(`Usage:
+  lemonppt generate "<input>" [--pages N] [--theme <id>] [--language zh|en] [--out goal.json] [--api-key KEY]
+  lemonppt render <goal.json> [--out ./output] [--editable]
+  lemonppt export <goal.json> --pptx out.pptx [--pdf out.pdf]
+  lemonppt install-skill [--claude] [--codex] [--cursor] [--all]
+`);
+}
+function parseArgs(argv) {
+    const positional = [];
+    const options = {};
+    for (let i = 0; i < argv.length; i++) {
+        const arg = argv[i];
+        if (arg.startsWith('--')) {
+            const key = arg.replace(/^--/, '');
+            const next = argv[i + 1];
+            if (next && !next.startsWith('--')) {
+                options[key] = next;
+                i++;
+            }
+            else {
+                options[key] = true;
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, options };
+}
+async function main() {
+    const argv = process.argv.slice(2);
+    if (argv.length === 0) {
+        printUsage();
+        process.exit(0);
+    }
+    const command = argv[0];
+    const args = parseArgs(argv.slice(1));
+    const positional = args.positional;
+    try {
+        switch (command) {
+            case 'generate': {
+                const input = positional[0];
+                if (!input) {
+                    console.error('Error: generate command requires an input string.');
+                    process.exit(1);
+                }
+                const goal = await generateGoalToFile({
+                    input,
+                    pageCount: args.options.pages ? Number(args.options.pages) : 8,
+                    theme: args.options.theme,
+                    language: args.options.language,
+                    apiKey: args.options['api-key'],
+                    baseUrl: args.options['base-url'],
+                    model: args.options.model,
+                    outFile: args.options.out || './goal.json',
+                });
+                console.log(`Generated goal: ${goal.title} (${goal.slides.length} slides)`);
+                break;
+            }
+            case 'render': {
+                const goalPath = positional[0];
+                if (!goalPath) {
+                    console.error('Error: render command requires a goal.json path.');
+                    process.exit(1);
+                }
+                const goal = await readGoalFromFile(goalPath);
+                const { indexPath } = await renderGoalToDir(goal, {
+                    outDir: args.options.out || './output',
+                    editable: args.options.editable === true,
+                });
+                console.log(`Rendered to ${indexPath}`);
+                break;
+            }
+            case 'export': {
+                const goalPath = positional[0];
+                if (!goalPath) {
+                    console.error('Error: export command requires a goal.json path.');
+                    process.exit(1);
+                }
+                const goal = await readGoalFromFile(goalPath);
+                if (args.options.pptx) {
+                    await exportGoalToPptx(goal, { outFile: args.options.pptx });
+                    console.log(`Exported PPTX to ${args.options.pptx}`);
+                }
+                if (args.options.pdf) {
+                    await exportGoalToPdf(goal, { outFile: args.options.pdf });
+                    console.log(`Exported PDF to ${args.options.pdf}`);
+                }
+                if (!args.options.pptx && !args.options.pdf) {
+                    console.error('Error: export command requires --pptx or --pdf.');
+                    process.exit(1);
+                }
+                break;
+            }
+            case 'install-skill': {
+                const agents = [];
+                if (args.options.claude)
+                    agents.push('claude');
+                if (args.options.codex)
+                    agents.push('codex');
+                if (args.options.cursor)
+                    agents.push('cursor');
+                if (args.options.all || agents.length === 0) {
+                    agents.length = 0;
+                    agents.push('claude', 'codex', 'cursor');
+                }
+                await installSkill({ agents });
+                break;
+            }
+            default: {
+                console.error(`Unknown command: ${command}`);
+                printUsage();
+                process.exit(1);
+            }
+        }
+    }
+    catch (err) {
+        console.error(err);
+        process.exit(1);
+    }
+}
+void main();

package/dist/index.d.ts

@@ -0,0 +1,55 @@
+import type { DeckGoal } from '@lemonppt/core';
+import { type RenderOptions } from '@lemonppt/renderer';
+export interface GenerateCliOptions {
+    /** 用户输入的主题/需求 */
+    input: string;
+    /** 页数，默认 8 */
+    pageCount?: number;
+    /** 主题 ID，默认 minimal */
+    theme?: string;
+    /** 语言，默认 zh */
+    language?: 'zh' | 'en';
+    /** OpenAI 兼容 API Key */
+    apiKey?: string;
+    /** OpenAI 兼容 Base URL */
+    baseUrl?: string;
+    /** 模型名称 */
+    model?: string;
+    /** 输出文件路径，默认 ./goal.json */
+    outFile?: string;
+}
+export interface RenderCliOptions extends RenderOptions {
+    /** 输出目录，默认 ./output */
+    outDir?: string;
+    /** 是否开启浏览器端编辑 */
+    editable?: boolean;
+}
+export interface ExportCliOptions {
+    /** 输出文件路径 */
+    outFile: string;
+}
+/**
+ * 生成 goal.json 并可选写入文件。
+ */
+export declare function generateGoalToFile(options: GenerateCliOptions): Promise<DeckGoal>;
+/**
+ * 从文件读取 goal.json。
+ */
+export declare function readGoalFromFile(filePath: string): Promise<DeckGoal>;
+/**
+ * 渲染 deck 到输出目录。
+ */
+export declare function renderGoalToDir(goal: DeckGoal, options?: RenderCliOptions): Promise<{
+    html: string;
+    indexPath: string;
+    assetsDir: string;
+    assets: string[];
+}>;
+/**
+ * 导出 goal 为 PPTX。
+ */
+export declare function exportGoalToPptx(goal: DeckGoal, options: ExportCliOptions): Promise<void>;
+/**
+ * 导出 goal 为 PDF。
+ */
+export declare function exportGoalToPdf(goal: DeckGoal, options: ExportCliOptions): Promise<void>;

package/dist/index.js

@@ -0,0 +1,84 @@
+import { generateGoal } from '@lemonppt/agent-prompts';
+import { exportDeckToPdf, exportDeckToPptx, renderDeck, } from '@lemonppt/renderer';
+import { getTheme } from '@lemonppt/themes';
+import { copyFile, mkdir, readFile, writeFile } from 'node:fs/promises';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+function resolveTheme(themeId) {
+    const id = themeId || 'minimal';
+    return getTheme(id) ? id : 'minimal';
+}
+async function copyThemeAssets(themeId, assetsDir) {
+    const theme = resolveTheme(themeId);
+    await mkdir(assetsDir, { recursive: true });
+    const cssSource = resolvePackagePath('@lemonppt/themes', 'src', theme, 'styles.css');
+    const cssDest = path.join(assetsDir, `${theme}.css`);
+    await copyFile(cssSource, cssDest);
+}
+function resolvePackagePath(pkg, ...segments) {
+    const mainUrl = import.meta.resolve(pkg);
+    const pkgRoot = path.resolve(path.dirname(fileURLToPath(mainUrl)), '..');
+    return path.join(pkgRoot, ...segments);
+}
+/**
+ * 生成 goal.json 并可选写入文件。
+ */
+export async function generateGoalToFile(options) {
+    const { input, pageCount = 8, theme = 'minimal', language = 'zh', apiKey, baseUrl, model, outFile, } = options;
+    const result = await generateGoal({
+        input,
+        pageCount,
+        theme,
+        language,
+        llm: {
+            apiKey: apiKey || process.env.OPENAI_API_KEY,
+            baseUrl: baseUrl || process.env.OPENAI_BASE_URL,
+            model: model || process.env.OPENAI_MODEL,
+        },
+    });
+    if (outFile) {
+        await mkdir(path.dirname(path.resolve(outFile)), { recursive: true });
+        await writeFile(path.resolve(outFile), JSON.stringify(result.goal, null, 2), 'utf-8');
+    }
+    return result.goal;
+}
+/**
+ * 从文件读取 goal.json。
+ */
+export async function readGoalFromFile(filePath) {
+    const raw = await readFile(path.resolve(filePath), 'utf-8');
+    const parsed = JSON.parse(raw);
+    parsed.theme = resolveTheme(parsed.theme);
+    return parsed;
+}
+/**
+ * 渲染 deck 到输出目录。
+ */
+export async function renderGoalToDir(goal, options = {}) {
+    const { outDir = './output', editable = false, width, height } = options;
+    const outputDir = path.resolve(outDir);
+    const assetsDir = path.join(outputDir, 'assets');
+    const result = renderDeck(goal, { width, height, editable });
+    await copyThemeAssets(goal.theme, assetsDir);
+    const indexName = editable ? 'editor.html' : 'index.html';
+    const indexPath = path.join(outputDir, indexName);
+    await mkdir(outputDir, { recursive: true });
+    await writeFile(indexPath, result.html, 'utf-8');
+    return { html: result.html, indexPath, assetsDir, assets: result.assets };
+}
+/**
+ * 导出 goal 为 PPTX。
+ */
+export async function exportGoalToPptx(goal, options) {
+    const outFile = path.resolve(options.outFile);
+    await mkdir(path.dirname(outFile), { recursive: true });
+    await exportDeckToPptx(goal, { outFile });
+}
+/**
+ * 导出 goal 为 PDF。
+ */
+export async function exportGoalToPdf(goal, options) {
+    const outFile = path.resolve(options.outFile);
+    await mkdir(path.dirname(outFile), { recursive: true });
+    await exportDeckToPdf(goal, { outFile });
+}

package/dist/install-skill.d.ts

@@ -0,0 +1,8 @@
+export interface InstallSkillOptions {
+    /** 指定安装的 Agent，默认全部 */
+    agents?: string[];
+}
+/**
+ * 将 lemonPPT skill 安装到常见 AI Agent 的技能目录。
+ */
+export declare function installSkill(options?: InstallSkillOptions): Promise<void>;

package/dist/install-skill.js

@@ -0,0 +1,52 @@
+import { copyFile, mkdir, writeFile } from 'node:fs/promises';
+import { existsSync } from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const DEFAULT_AGENTS = ['claude', 'codex', 'cursor'];
+function resolveSkillMdPath() {
+    // Published package: SKILL.md lives next to the package root (one level above dist/)
+    const mainUrl = import.meta.resolve('@lemonppt/cli');
+    const pkgRoot = path.resolve(path.dirname(fileURLToPath(mainUrl)), '..');
+    const published = path.join(pkgRoot, 'SKILL.md');
+    if (existsSync(published)) {
+        return published;
+    }
+    // Local monorepo dev: fallback to repo root SKILL.md
+    const local = path.resolve(pkgRoot, '..', '..', 'SKILL.md');
+    if (existsSync(local)) {
+        return local;
+    }
+    throw new Error('SKILL.md not found. It should be bundled with @lemonppt/cli or exist at the repo root.');
+}
+async function installAgent(agent) {
+    const homeDir = os.homedir();
+    const skillDir = path.join(homeDir, `.${agent}/skills/lemonppt`);
+    await mkdir(skillDir, { recursive: true });
+    const skillMdSource = resolveSkillMdPath();
+    await copyFile(skillMdSource, path.join(skillDir, 'SKILL.md'));
+    await copyFile(skillMdSource, path.join(skillDir, 'README.md'));
+    const scriptsDir = path.join(skillDir, 'scripts');
+    await mkdir(scriptsDir, { recursive: true });
+    const wrapperSh = `#!/bin/bash
+set -e
+exec npx @lemonppt/cli "$@"
+`;
+    await writeFile(path.join(scriptsDir, 'lemonppt.sh'), wrapperSh, { mode: 0o755 });
+    const wrapperPs1 = `#Requires -Version 5.1
+& npx @lemonppt/cli @args
+`;
+    await writeFile(path.join(scriptsDir, 'lemonppt.ps1'), wrapperPs1, { mode: 0o755 });
+    console.log(`✓ Installed lemonPPT skill for ${agent} at ${skillDir}`);
+}
+/**
+ * 将 lemonPPT skill 安装到常见 AI Agent 的技能目录。
+ */
+export async function installSkill(options = {}) {
+    const agents = options.agents?.length ? options.agents : DEFAULT_AGENTS;
+    for (const agent of agents) {
+        await installAgent(agent);
+    }
+    console.log('\nInstallation complete.');
+    console.log('Agents can now reference lemonPPT via SKILL.md in their skill directories.');
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@lemonppt/cli",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "lemonppt": "./dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist",
+    "SKILL.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lemonforme/lemonPPT.git",
+    "directory": "packages/cli"
+  },
+  "bugs": {
+    "url": "https://github.com/lemonforme/lemonPPT/issues"
+  },
+  "homepage": "https://github.com/lemonforme/lemonPPT#readme",
+  "dependencies": {
+    "@lemonppt/agent-prompts": "0.1.0",
+    "@lemonppt/core": "0.1.0",
+    "@lemonppt/themes": "0.1.0",
+    "@lemonppt/renderer": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}