@lemonppt/cli 1.0.7 → 1.0.9

package/dist/cli.js

@@ -3,11 +3,13 @@
 // Copyright (c) 2026 lemonforme
 // SPDX-License-Identifier: AGPL-3.0-or-later
 import { createServer as createHttpServer } from 'node:http';
+import { createServer as createHttpsServer } from 'node:https';
 import { spawn } from 'node:child_process';
 import { existsSync } from 'node:fs';
 import { stat, readFile } from 'node:fs/promises';
 import { extname, join, resolve, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
+import { generate as generateSelfSignedCert } from 'selfsigned';
 import { exportGoalToPdf, exportGoalToPptx, generateGoalToFile, inspectLayout, listThemes, queryLayouts, readGoalFromFile, renderGoalToDir, scaffoldGoalToFile, stageMediaToFile, validateDeck, validateGoalCopy, validateGoalSpec, writeSafePropsToFile, } from './index.js';
 import { installSkill } from './install-skill.js';
 function printUsage() {
@@ -15,8 +17,10 @@ function printUsage() {
   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 serve [<dir>] [--port N]   # start API server if built, else static preview
-  lemonppt server [<dir>] [--port N]  # alias for serve
+  lemonppt serve [<dir>] [--port N] [--https] [--cert <path>] [--key <path>]
+                                      # start API server if built, else static preview
+  lemonppt server [<dir>] [--port N] [--https] [--cert <path>] [--key <path>]
+                                      # alias for serve
   lemonppt install-skill [--claude] [--codex] [--cursor] [--all] [--target <dir>]
 
   lemonppt list-themes
@@ -77,7 +81,28 @@ async function startApiServer(dir, port) {
         });
     });
 }
-async function serveDir(dir, port) {
+async function readCertFile(filePath) {
+    if (!filePath)
+        return undefined;
+    const content = await readFile(resolve(filePath), 'utf-8');
+    return content;
+}
+async function resolveHttpsCredentials(options) {
+    if (!options.https && !options.cert && !options.key)
+        return undefined;
+    const certFromFile = await readCertFile(options.cert);
+    const keyFromFile = await readCertFile(options.key);
+    if (certFromFile && keyFromFile) {
+        return { cert: certFromFile, key: keyFromFile };
+    }
+    if (certFromFile || keyFromFile) {
+        throw new Error('使用 HTTPS 时必须同时提供 --cert 和 --key，或都不提供以自动生成自签名证书。');
+    }
+    const attrs = [{ name: 'commonName', value: 'localhost' }];
+    const pems = generateSelfSignedCert(attrs, { days: 365, keySize: 2048 });
+    return { cert: pems.cert, key: pems.private };
+}
+async function serveDir(dir, port, options = {}) {
     const root = resolve(dir);
     const mimeTypes = {
         '.html': 'text/html; charset=utf-8',
@@ -95,8 +120,9 @@ async function serveDir(dir, port) {
         '.otf': 'font/otf',
         '.eot': 'application/vnd.ms-fontobject',
     };
-    const server = createHttpServer(async (req, res) => {
-        const url = new URL(req.url || '/', `http://${req.headers.host}`);
+    const requestHandler = async (req, res) => {
+        const protocol = options.https ? 'https' : 'http';
+        const url = new URL(req.url || '/', `${protocol}://${req.headers.host}`);
         let pathname = decodeURIComponent(url.pathname);
         if (pathname === '/') {
             // 优先 editable 输出（editor.html），回退到非 editable 输出（index.html）
@@ -134,10 +160,15 @@ async function serveDir(dir, port) {
             res.writeHead(404);
             res.end('Not found');
         }
-    });
+    };
+    const credentials = await resolveHttpsCredentials(options);
+    const protocol = credentials ? 'https' : 'http';
+    const server = credentials
+        ? createHttpsServer(credentials, requestHandler)
+        : createHttpServer(requestHandler);
     return new Promise((resolve) => {
         server.listen(port, () => {
-            console.log(`Serving ${root} at http://localhost:${port}`);
+            console.log(`Serving ${root} at ${protocol}://localhost:${port}`);
             resolve();
         });
     });
@@ -211,13 +242,18 @@ async function main() {
             case 'server': {
                 const dir = positional[0] || './output';
                 const port = args.options.port ? Number(args.options.port) : 3456;
+                const serveOptions = {
+                    https: args.options.https === true,
+                    cert: args.options.cert,
+                    key: args.options.key,
+                };
                 if (existsSync(apiServerPath)) {
                     console.log(`Starting API server on port ${port}...`);
                     await startApiServer(dir, port);
                 }
                 else {
                     console.log(`API server not built, falling back to static preview.`);
-                    await serveDir(dir, port);
+                    await serveDir(dir, port, serveOptions);
                     // 保持进程运行
                     await new Promise(() => { });
                 }

package/dist/index.d.ts

@@ -68,10 +68,12 @@ export declare function renderGoalToDir(goal: DeckGoal, options?: RenderCliOptio
 }>;
 /**
  * 导出 goal 为 PPTX。
+ * 若服务端 Chromium 无法启动，会自动生成浏览器兜底驱动页。
  */
 export declare function exportGoalToPptx(goal: DeckGoal, options: ExportCliOptions): Promise<void>;
 /**
  * 导出 goal 为 PDF。
+ * 若服务端 Chromium 无法启动，会自动生成浏览器兜底驱动页。
  */
 export declare function exportGoalToPdf(goal: DeckGoal, options: ExportCliOptions): Promise<void>;
 /**

package/dist/index.js

@@ -2,8 +2,8 @@
 // Copyright (c) 2026 lemonforme
 // SPDX-License-Identifier: AGPL-3.0-or-later
 import { generateGoal } from '@lemonppt/agent-prompts';
-import { normalizeDeckGoal, preprocessAgentGoal, validateDeckGoal, validateDeckGoalContent, validateSlideCount } from '@lemonppt/core';
-import { exportDeckToPdf, exportDeckToPptx, renderDeck, renderEditorData, } from '@lemonppt/renderer';
+import { preprocessAgentGoal, validateDeckGoal, validateDeckGoalContent, validateSlideCount } from '@lemonppt/core';
+import { exportDeckToPdf, exportDeckToPptxScreenshot, normalizeGoal, renderBrowserExportDriver, renderDeck, renderEditorData, } from '@lemonppt/renderer';
 import { getTheme, themes } from '@lemonppt/themes';
 import { getLayout, getLayoutSchema, listLayoutsByRoleAndTheme } from '@lemonppt/templates';
 import { copyFile, cp, mkdir, readFile, writeFile } from 'node:fs/promises';
@@ -14,6 +14,19 @@ function resolveTheme(themeId) {
     const id = themeId || 'theme01';
     return getTheme(id) ? id : 'theme01';
 }
+function isBrowserLaunchError(err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return /launch|browser|chromium|executable|playwright/i.test(message);
+}
+async function copyBrowserExportAssets(assetsDir) {
+    await mkdir(assetsDir, { recursive: true });
+    const vendorSource = resolvePackagePath('@lemonppt/renderer', 'assets', 'vendor');
+    const vendorDest = path.join(assetsDir, 'vendor');
+    await cp(vendorSource, vendorDest, { recursive: true, force: true });
+    const bundleSource = resolvePackagePath('@lemonppt/renderer', 'dist', 'client', 'browser-export.js');
+    const bundleDest = path.join(assetsDir, 'browser-export.js');
+    await copyFile(bundleSource, bundleDest);
+}
 export async function copyThemeAssets(themeId, assetsDir) {
     const theme = resolveTheme(themeId);
     await mkdir(assetsDir, { recursive: true });
@@ -40,6 +53,13 @@ export async function copyThemeAssets(themeId, assetsDir) {
     const editorScriptSource = resolvePackagePath('@lemonppt/renderer', 'dist', 'client', 'editor-script.js');
     const editorScriptDest = path.join(assetsDir, 'editor-script.js');
     await copyFile(editorScriptSource, editorScriptDest);
+    // 复制浏览器端导出兜底脚本及 vendor bundle（沙箱环境无法启动 Chromium 时使用）
+    const browserExportSource = resolvePackagePath('@lemonppt/renderer', 'dist', 'client', 'browser-export.js');
+    const browserExportDest = path.join(assetsDir, 'browser-export.js');
+    await copyFile(browserExportSource, browserExportDest);
+    const vendorDirSource = resolvePackagePath('@lemonppt/renderer', 'assets', 'vendor');
+    const vendorDirDest = path.join(assetsDir, 'vendor');
+    await cp(vendorDirSource, vendorDirDest, { recursive: true, force: true });
 }
 /**
  * 把本地媒体文件复制到输出目录的 media/ 下，供 goal.json 引用。
@@ -101,7 +121,7 @@ export async function readGoalFromFile(filePath) {
     const raw = await readFile(path.resolve(filePath), 'utf-8');
     const parsed = preprocessAgentGoal(JSON.parse(raw));
     parsed.theme = resolveTheme(parsed.theme);
-    return normalizeDeckGoal(parsed);
+    return normalizeGoal(parsed);
 }
 /**
  * 渲染 deck 到输出目录。
@@ -156,21 +176,57 @@ window.__lemonPPT_layoutSchemas = ${JSON.stringify(layoutSchemas)};
     await writeFile(indexPath, result.html, 'utf-8');
     return { html: result.html, indexPath, assetsDir, assets: result.assets };
 }
+async function generateBrowserFallbackDriver(goal, mode, outFile) {
+    const driverDir = path.join(path.dirname(outFile), `.browser-fallback-${mode}`);
+    const assetsDir = path.join(driverDir, 'assets');
+    await mkdir(assetsDir, { recursive: true });
+    await copyThemeAssets(goal.theme, assetsDir);
+    await copyBrowserExportAssets(assetsDir);
+    const driverHtml = renderBrowserExportDriver({
+        mode,
+        goal,
+        callbackUrl: '',
+        assetBaseUrl: './assets',
+    });
+    const driverPath = path.join(driverDir, 'index.html');
+    await writeFile(driverPath, driverHtml, 'utf-8');
+    return driverPath;
+}
 /**
  * 导出 goal 为 PPTX。
+ * 若服务端 Chromium 无法启动，会自动生成浏览器兜底驱动页。
  */
 export async function exportGoalToPptx(goal, options) {
     const outFile = path.resolve(options.outFile);
     await mkdir(path.dirname(outFile), { recursive: true });
-    await exportDeckToPptx(goal, { outFile });
+    try {
+        await exportDeckToPptxScreenshot(goal, { outFile });
+    }
+    catch (err) {
+        if (!isBrowserLaunchError(err)) {
+            throw err;
+        }
+        const driverPath = await generateBrowserFallbackDriver(goal, 'pptx', outFile);
+        throw new Error(`无法启动 Chromium 进行 PPTX 导出。已生成浏览器兜底驱动页：${driverPath}，请用浏览器打开该页面完成导出。`);
+    }
 }
 /**
  * 导出 goal 为 PDF。
+ * 若服务端 Chromium 无法启动，会自动生成浏览器兜底驱动页。
  */
 export async function exportGoalToPdf(goal, options) {
     const outFile = path.resolve(options.outFile);
     await mkdir(path.dirname(outFile), { recursive: true });
-    await exportDeckToPdf(goal, { outFile });
+    try {
+        await exportDeckToPdf(goal, { outFile });
+    }
+    catch (err) {
+        if (!isBrowserLaunchError(err)) {
+            throw err;
+        }
+        const driverPath = await generateBrowserFallbackDriver(goal, 'pdf', outFile);
+        throw new Error(`无法启动 Chromium 进行 PDF 导出。已生成浏览器兜底驱动页：${driverPath}，请用浏览器打开该页面完成导出。`);
+    }
 }
 /**
  * 列出所有可用主题。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lemonppt/cli",
-  "version": "1.0.7",
+  "version": "1.0.9",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -31,10 +31,11 @@
   },
   "homepage": "https://github.com/lemonforme/lemonPPT#readme",
   "dependencies": {
-    "@lemonppt/agent-prompts": "1.0.7",
-    "@lemonppt/themes": "1.0.7",
-    "@lemonppt/renderer": "1.0.7",
-    "@lemonppt/core": "1.0.7"
+    "selfsigned": "^2.4.1",
+    "@lemonppt/agent-prompts": "1.0.9",
+    "@lemonppt/core": "1.0.9",
+    "@lemonppt/renderer": "1.0.9",
+    "@lemonppt/themes": "1.0.9"
   },
   "devDependencies": {
     "@types/node": "^20.0.0",