@lemonppt/cli 0.1.8 → 0.2.1

package/dist/index.js

@@ -2,17 +2,19 @@
 // Copyright (c) 2026 lemonforme
 // SPDX-License-Identifier: AGPL-3.0-or-later
 import { generateGoal } from '@lemonppt/agent-prompts';
-import { normalizeDeckGoal } from '@lemonppt/core';
-import { exportDeckToPdf, exportDeckToPptx, renderDeck, } from '@lemonppt/renderer';
-import { getTheme } from '@lemonppt/themes';
+import { normalizeDeckGoal, preprocessAgentGoal, validateDeckGoal, validateDeckGoalContent, validateSlideCount } from '@lemonppt/core';
+import { exportDeckToPdf, exportDeckToPptx, 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';
+import { existsSync } from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
 function resolveTheme(themeId) {
-    const id = themeId || 'base';
-    return getTheme(id) ? id : 'base';
+    const id = themeId || 'theme01';
+    return getTheme(id) ? id : 'theme01';
 }
-async function copyThemeAssets(themeId, assetsDir) {
+export async function copyThemeAssets(themeId, assetsDir) {
     const theme = resolveTheme(themeId);
     await mkdir(assetsDir, { recursive: true });
     const cssSource = resolvePackagePath('@lemonppt/themes', 'src', theme, 'styles.css');
@@ -22,17 +24,59 @@ async function copyThemeAssets(themeId, assetsDir) {
     const fontsSource = resolvePackagePath('@lemonppt/renderer', 'assets', 'fonts');
     const fontsDest = path.join(assetsDir, 'fonts');
     await cp(fontsSource, fontsDest, { recursive: true, force: true });
+    // 复制浏览器可执行 bundle（IIFE 格式），支持静态文件模式下结构编辑
+    const clientRenderSource = resolvePackagePath('@lemonppt/renderer', 'dist', 'client', 'client-render.js');
+    const clientRenderDest = path.join(assetsDir, 'client-render.js');
+    await copyFile(clientRenderSource, clientRenderDest);
+    // 复制 ECharts 主题脚本
+    const themeEChartsSource = resolvePackagePath('@lemonppt/renderer', 'dist', 'client', 'theme-echarts.js');
+    const themeEChartsDest = path.join(assetsDir, 'theme-echarts.js');
+    await copyFile(themeEChartsSource, themeEChartsDest);
+    // 复制 jQuery，供编辑器初始化自定义滚动条样式类
+    const jquerySource = resolvePackagePath('jquery', 'dist', 'jquery.min.js');
+    const jqueryDest = path.join(assetsDir, 'jquery.min.js');
+    await copyFile(jquerySource, jqueryDest);
+    // 复制编辑器交互脚本，供单页编辑器动态初始化
+    const editorScriptSource = resolvePackagePath('@lemonppt/renderer', 'dist', 'client', 'editor-script.js');
+    const editorScriptDest = path.join(assetsDir, 'editor-script.js');
+    await copyFile(editorScriptSource, editorScriptDest);
+}
+/**
+ * 把本地媒体文件复制到输出目录的 media/ 下，供 goal.json 引用。
+ */
+export async function stageMediaToFile(options) {
+    const outDir = options.outDir || './output';
+    const originalName = path.basename(options.filePath);
+    const safeName = originalName.replace(/[^a-zA-Z0-9._-]/g, '_');
+    const mediaDir = path.join(outDir, 'media');
+    await mkdir(mediaDir, { recursive: true });
+    const localPath = path.resolve(path.join(mediaDir, safeName));
+    await copyFile(options.filePath, localPath);
+    return {
+        filename: safeName,
+        localPath,
+        relativePath: path.join('media', safeName),
+    };
 }
 function resolvePackagePath(pkg, ...segments) {
-    const mainUrl = import.meta.resolve(pkg);
-    const pkgRoot = path.resolve(path.dirname(fileURLToPath(mainUrl)), '..');
-    return path.join(pkgRoot, ...segments);
+    // 优先通过 package.json 定位包根（第三方 npm 包）
+    try {
+        const pkgJsonUrl = import.meta.resolve(`${pkg}/package.json`);
+        const pkgRoot = path.dirname(fileURLToPath(pkgJsonUrl));
+        return path.join(pkgRoot, ...segments);
+    }
+    catch {
+        // 工作区包可能未导出 package.json，回退到主入口的父目录的父目录
+        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 = 'base', language = 'zh', apiKey, baseUrl, model, outFile, } = options;
+    const { input, pageCount = 8, theme = 'theme01', language = 'zh', apiKey, baseUrl, model, outFile, } = options;
     const result = await generateGoal({
         input,
         pageCount,
@@ -55,22 +99,50 @@ export async function generateGoalToFile(options) {
  */
 export async function readGoalFromFile(filePath) {
     const raw = await readFile(path.resolve(filePath), 'utf-8');
-    const parsed = JSON.parse(raw);
+    const parsed = preprocessAgentGoal(JSON.parse(raw));
     parsed.theme = resolveTheme(parsed.theme);
     return normalizeDeckGoal(parsed);
 }
 /**
  * 渲染 deck 到输出目录。
+ * editable 模式下使用单页编辑器架构：复制 server 的 editor.html/editor.js，
+ * 内嵌 renderEditorData 生成的 EditorData，资源路径使用相对路径。
  */
 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 });
+    if (editable) {
+        const data = renderEditorData(goal, { width: width ?? 1280, height: height ?? 720 });
+        const rendererTemplatesDir = resolvePackagePath('@lemonppt/renderer', 'templates');
+        let editorHtml = await readFile(path.join(rendererTemplatesDir, 'editor.html'), 'utf-8');
+        let editorJs = await readFile(path.join(rendererTemplatesDir, 'editor.js'), 'utf-8');
+        // 静态文件模式下使用相对资源路径
+        editorHtml = editorHtml.replace(/\/deck\/assets\//g, './assets/');
+        editorHtml = editorHtml.replace(/src="\/editor\.js"/g, 'src="./editor.js"');
+        // 内嵌 EditorData，让 editor.js 在静态模式下无需请求 API
+        const embeddedData = `<script>
+window.__lemonPPT_assetsBase = './assets/';
+window.__lemonPPT_editorData = ${JSON.stringify(data)};
+</script>`;
+        editorHtml = editorHtml.replace('</head>', `${embeddedData}\n</head>`);
+        const indexPath = path.join(outputDir, 'editor.html');
+        await writeFile(indexPath, editorHtml, 'utf-8');
+        await writeFile(path.join(outputDir, 'editor.js'), editorJs, 'utf-8');
+        const assets = [
+            './assets/fonts/fonts.css',
+            `./assets/${data.theme}.css`,
+            './assets/jquery.min.js',
+            './assets/editor-script.js',
+            './assets/client-render.js',
+            './assets/theme-echarts.js',
+        ];
+        return { html: editorHtml, indexPath, assetsDir, assets };
+    }
+    const result = renderDeck(goal, { width, height });
+    const indexPath = path.join(outputDir, 'index.html');
     await writeFile(indexPath, result.html, 'utf-8');
     return { html: result.html, indexPath, assetsDir, assets: result.assets };
 }
@@ -90,3 +162,390 @@ export async function exportGoalToPdf(goal, options) {
     await mkdir(path.dirname(outFile), { recursive: true });
     await exportDeckToPdf(goal, { outFile });
 }
+/**
+ * 列出所有可用主题。
+ */
+export function listThemes() {
+    return themes.map((t) => ({ id: t.id, name: t.displayName || t.id }));
+}
+/**
+ * 按主题与角色查询候选版式。
+ */
+export function queryLayouts(options) {
+    const { theme, role, keyword, needsMedia, limit = 8, seed = `lemon-${Date.now()}` } = options;
+    let layouts = listLayoutsByRoleAndTheme(role, theme);
+    if (keyword) {
+        const kw = keyword.toLowerCase();
+        layouts = layouts.filter((m) => [m.id, m.displayName, m.description || '', ...(m.tags || []), m.contentShape || '']
+            .join(' ')
+            .toLowerCase()
+            .includes(kw));
+    }
+    if (needsMedia) {
+        layouts = layouts.filter((m) => m.needsMedia);
+    }
+    // 按 seed 做可复现的伪随机排序
+    let s = 0;
+    const seedStr = `${seed}-${role}-${theme}`;
+    for (let i = 0; i < seedStr.length; i++) {
+        s = (s * 31 + seedStr.charCodeAt(i)) >>> 0;
+    }
+    if (s === 0)
+        s = 123456789;
+    let x = s, y = 362436069, z = 521288629, w = 88675123;
+    const random = () => {
+        const t = x ^ (x << 11);
+        x = y;
+        y = z;
+        z = w;
+        w = (w ^ (w >>> 19) ^ (t ^ (t >>> 8))) >>> 0;
+        return w / 0xffffffff;
+    };
+    const copy = [...layouts];
+    for (let i = copy.length - 1; i > 0; i--) {
+        const j = Math.floor(random() * (i + 1));
+        [copy[i], copy[j]] = [copy[j], copy[i]];
+    }
+    const picked = copy.slice(0, limit);
+    return {
+        theme,
+        role,
+        count: picked.length,
+        layouts: picked.map((m) => ({
+            layout: m.id,
+            displayName: m.displayName,
+            description: m.description || '',
+            needsMedia: m.needsMedia,
+        })),
+    };
+}
+/**
+ * 查看指定版式的字段契约。
+ */
+export function inspectLayout(layoutId) {
+    const registered = getLayout(layoutId);
+    const schema = getLayoutSchema(layoutId);
+    if (!registered || !schema)
+        return null;
+    const meta = registered.meta;
+    function simplifyField(field) {
+        const out = {
+            key: field.key,
+            label: field.label,
+            type: field.type,
+        };
+        if (field.defaultValue !== undefined)
+            out.defaultValue = field.defaultValue;
+        return out;
+    }
+    return {
+        layout: meta.id,
+        displayName: meta.displayName,
+        theme: meta.theme,
+        role: meta.role,
+        description: meta.description || '',
+        needsMedia: meta.needsMedia,
+        mediaSlots: meta.mediaSlots || [],
+        tags: meta.tags || [],
+        contentShape: meta.contentShape || '',
+        fields: schema.fields.map(simplifyField),
+    };
+}
+function createSeededRandom(seed) {
+    let s = 0;
+    for (let i = 0; i < seed.length; i++) {
+        s = (s * 31 + seed.charCodeAt(i)) >>> 0;
+    }
+    if (s === 0)
+        s = 123456789;
+    let x = s;
+    let y = 362436069;
+    let z = 521288629;
+    let w = 88675123;
+    return () => {
+        const t = x ^ (x << 11);
+        x = y;
+        y = z;
+        z = w;
+        w = (w ^ (w >>> 19) ^ (t ^ (t >>> 8))) >>> 0;
+        return w / 0xffffffff;
+    };
+}
+function chooseRoles(pageCount, seed) {
+    const random = createSeededRandom(seed);
+    if (pageCount < 3) {
+        return Array.from({ length: pageCount }, () => 'content');
+    }
+    const roles = ['cover'];
+    if (pageCount >= 4)
+        roles.push('tableOfContents');
+    const contentRoles = ['content', 'metric', 'chart', 'process', 'comparison', 'feature', 'timeline', 'quote', 'image', 'table', 'stats'];
+    const remaining = pageCount - roles.length - 1;
+    for (let i = 0; i < remaining; i++) {
+        const idx = Math.floor(random() * contentRoles.length);
+        roles.push(contentRoles[idx]);
+    }
+    roles.push('closing');
+    return roles;
+}
+/**
+ * 生成只含 role 的 goal.json 骨架。
+ */
+export async function scaffoldGoalToFile(options) {
+    const { title, goal, audience = '内部团队', owner, theme = 'theme01', pages = 8, language = 'zh', seed = `lemon-${Date.now()}`, outFile, } = options;
+    const roles = chooseRoles(pages, seed);
+    const { composeDeckFromRaw: compose } = await import('@lemonppt/composer');
+    const result = compose({
+        title,
+        goal,
+        audience,
+        owner,
+        theme,
+        language,
+        pageCount: pages,
+        randomSeed: seed,
+        slides: roles.map((role) => ({ role: role, props: {} })),
+    });
+    if (outFile) {
+        await mkdir(path.dirname(path.resolve(outFile)), { recursive: true });
+        await writeFile(path.resolve(outFile), JSON.stringify(result, null, 2), 'utf-8');
+    }
+    return result;
+}
+function getDefaultValue(field) {
+    if (field.defaultValue !== undefined)
+        return field.defaultValue;
+    switch (field.type) {
+        case 'text':
+        case 'textarea':
+            return '';
+        case 'number':
+        case 'slider':
+            return field.min ?? 0;
+        case 'boolean':
+            return false;
+        case 'array':
+            return [];
+        case 'select':
+            return field.options?.[0]?.value ?? '';
+        case 'image':
+        case 'color':
+            return '';
+        case 'object':
+            return {};
+        default:
+            return '';
+    }
+}
+function normalizePropsWithSchema(props, fields) {
+    const result = {};
+    const knownKeys = new Set();
+    for (const field of fields || []) {
+        const key = field.key;
+        knownKeys.add(key);
+        const current = props[key];
+        if (field.type === 'array' && field.itemSchema) {
+            if (!Array.isArray(current)) {
+                result[key] = [];
+            }
+            else {
+                result[key] = current.map((item) => item && typeof item === 'object'
+                    ? normalizePropsWithSchema(item, field.itemSchema)
+                    : item);
+            }
+        }
+        else if (current === undefined || current === null) {
+            result[key] = getDefaultValue(field);
+        }
+        else {
+            result[key] = current;
+        }
+    }
+    for (const key of Object.keys(props)) {
+        if (!knownKeys.has(key) && !key.startsWith('_')) {
+            result[key] = props[key];
+        }
+    }
+    return result;
+}
+/**
+ * 规范化 goal.json 的 props。
+ */
+export async function writeSafePropsToFile(options) {
+    const { goalPath, write } = options;
+    const preprocessed = preprocessAgentGoal(JSON.parse(await readFile(path.resolve(goalPath), 'utf-8')));
+    const { composeDeckFromRaw: compose } = await import('@lemonppt/composer');
+    const composed = compose({
+        title: preprocessed.title,
+        goal: preprocessed.goal,
+        audience: preprocessed.audience,
+        owner: preprocessed.owner,
+        theme: preprocessed.theme,
+        language: preprocessed.language,
+        colorScheme: preprocessed.colorScheme,
+        appearance: preprocessed.appearance,
+        pageCount: preprocessed.pageCount,
+        randomSeed: preprocessed.randomSeed,
+        slides: preprocessed.slides.map((s) => ({ role: s.role, layout: s.layout, props: s.props })),
+    });
+    const layoutChanges = [];
+    const unknownFields = [];
+    const safeSlides = composed.slides.map((slide, index) => {
+        const originalLayout = preprocessed.slides[index]?.layout;
+        const registered = getLayout(slide.layout);
+        const schema = registered ? getLayoutSchema(slide.layout) : undefined;
+        if (originalLayout && originalLayout !== slide.layout) {
+            layoutChanges.push({ index: index + 1, from: originalLayout, to: slide.layout });
+        }
+        if (!schema)
+            return { ...slide, props: slide.props };
+        const normalized = normalizePropsWithSchema(slide.props || {}, schema.fields);
+        const unknownKeys = Object.keys(slide.props || {}).filter((k) => !schema.fields.some((f) => f.key === k) && !k.startsWith('_'));
+        if (unknownKeys.length > 0) {
+            unknownFields.push({ index: index + 1, layout: slide.layout, keys: unknownKeys });
+        }
+        return { ...slide, props: normalized };
+    });
+    const safeGoal = { ...composed, slides: safeSlides };
+    const validation = validateDeckGoal(safeGoal);
+    if (write) {
+        await writeFile(path.resolve(goalPath), JSON.stringify(safeGoal, null, 2), 'utf-8');
+    }
+    if (!validation.success) {
+        throw new Error(`goal.json 校验失败: ${JSON.stringify(validation.errors?.format())}`);
+    }
+    return { valid: true, layoutChanges, unknownFields, goal: safeGoal };
+}
+/**
+ * 校验 goal.json 规范。
+ */
+export async function validateGoalSpec(goalPath, strict) {
+    const raw = preprocessAgentGoal(JSON.parse(await readFile(path.resolve(goalPath), 'utf-8')));
+    const result = {
+        valid: false,
+        errors: [],
+        warnings: [],
+    };
+    const validation = validateDeckGoal(raw);
+    if (!validation.success || !validation.data) {
+        result.errors.push({ type: 'schema', detail: validation.errors?.format() });
+        return result;
+    }
+    const goal = validation.data;
+    const countErrors = validateSlideCount({ pageCount: goal.pageCount, slides: goal.slides });
+    if (countErrors.length > 0) {
+        result.errors.push(...countErrors.map((msg) => ({ type: 'count', detail: msg })));
+    }
+    const contentWarnings = validateDeckGoalContent(goal);
+    if (contentWarnings.length > 0) {
+        if (strict) {
+            result.errors.push(...contentWarnings.map((msg) => ({ type: 'content', detail: msg })));
+        }
+        else {
+            result.warnings.push(...contentWarnings);
+        }
+    }
+    const firstSlide = goal.slides[0];
+    const lastSlide = goal.slides[goal.slides.length - 1];
+    if (firstSlide?.role !== 'cover')
+        result.warnings.push('第一页建议使用 cover 角色');
+    if (lastSlide?.role !== 'closing')
+        result.warnings.push('最后一页建议使用 closing 角色');
+    if (result.errors.length === 0) {
+        result.valid = true;
+    }
+    return result;
+}
+/**
+ * 校验渲染后的 HTML deck 结构是否完整。
+ */
+export async function validateDeck(options) {
+    const result = { valid: false, slides: 0, errors: [], warnings: [] };
+    const indexPath = path.resolve(options.deckDir, 'index.html');
+    if (!existsSync(indexPath)) {
+        result.errors.push(`deck index.html not found: ${indexPath}`);
+        return result;
+    }
+    const html = await readFile(indexPath, 'utf-8');
+    if (html.length < 100) {
+        result.errors.push('index.html is too short, render may have failed');
+        return result;
+    }
+    // 估算 slide 数量：通过 lp-slide-wrapper 容器
+    const wrapperMatches = html.match(/class="[^"]*\blp-slide-wrapper\b[^"]*"/g) ?? [];
+    const indexMatches = html.match(/data-slide-index="\d+"/g) ?? [];
+    result.slides = Math.max(wrapperMatches.length, indexMatches.length);
+    if (result.slides === 0) {
+        result.errors.push('no slides found in index.html');
+    }
+    if (options.goalPath) {
+        const goal = JSON.parse(await readFile(path.resolve(options.goalPath), 'utf-8'));
+        const expected = goal.slides.length;
+        if (result.slides !== expected) {
+            result.errors.push(`slide count mismatch: deck=${result.slides}, goal=${expected}`);
+        }
+    }
+    if (!html.includes('</html>')) {
+        result.warnings.push('index.html may be truncated (missing closing </html>)');
+    }
+    if (result.errors.length === 0) {
+        result.valid = true;
+    }
+    return result;
+}
+function collectTextStrings(value) {
+    const results = [];
+    function walk(v) {
+        if (typeof v === 'string') {
+            const trimmed = v.trim();
+            if (trimmed.length >= 4)
+                results.push(trimmed);
+        }
+        else if (Array.isArray(v)) {
+            v.forEach(walk);
+        }
+        else if (v && typeof v === 'object') {
+            Object.values(v).forEach(walk);
+        }
+    }
+    walk(value);
+    return [...new Set(results)];
+}
+/**
+ * 校验 goal.json 中的文案是否都出现在渲染后的 HTML 中。
+ */
+export async function validateGoalCopy(options) {
+    const result = { valid: false, missing: [], checked: 0, errors: [] };
+    const indexPath = path.resolve(options.deckDir, 'index.html');
+    if (!existsSync(indexPath)) {
+        result.errors.push(`deck index.html not found: ${indexPath}`);
+        return result;
+    }
+    const goal = JSON.parse(await readFile(path.resolve(options.goalPath), 'utf-8'));
+    const html = await readFile(indexPath, 'utf-8');
+    const texts = collectTextStrings(goal.slides.map((s) => s.props));
+    result.checked = texts.length;
+    const normalizedHtml = html
+        .replace(/&amp;/g, '&')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'")
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/\s+/g, ' ');
+    for (const text of texts) {
+        const normalizedText = text.replace(/\s+/g, ' ');
+        if (!normalizedHtml.includes(normalizedText)) {
+            result.missing.push(text.slice(0, 80));
+        }
+    }
+    if (result.missing.length > 0) {
+        result.errors.push(`${result.missing.length} / ${result.checked} text snippets missing in rendered HTML`);
+    }
+    else if (result.checked === 0) {
+        result.errors.push('no text found in goal.json to validate');
+    }
+    else {
+        result.valid = true;
+    }
+    return result;
+}

package/dist/install-skill.d.ts

@@ -1,6 +1,8 @@
 export interface InstallSkillOptions {
     /** 指定安装的 Agent，默认全部 */
     agents?: string[];
+    /** 自定义目标目录（直接复制整个 skill 包） */
+    target?: string;
 }
 /**
  * 将 lemonPPT skill 安装到常见 AI Agent 的技能目录。

package/dist/install-skill.js

@@ -1,51 +1,100 @@
 // lemonPPT - AI-powered presentation generation
 // Copyright (c) 2026 lemonforme
 // SPDX-License-Identifier: AGPL-3.0-or-later
-import { copyFile, mkdir, writeFile } from 'node:fs/promises';
+import { copyFile, cp, 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)), '..');
+    // Local monorepo dev: repo root is two levels above the package root
+    const local = path.resolve(pkgRoot, '..', '..', 'SKILL.md');
+    if (existsSync(local) && existsSync(path.resolve(pkgRoot, '..', '..', 'apps', 'server'))) {
+        return local;
+    }
+    // Published package: SKILL.md lives next to the package root (one level above dist/)
     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.');
 }
+function resolveRepoRoot(skillMdPath) {
+    return path.dirname(skillMdPath);
+}
+function resolveSkillBundlePath(skillMdPath) {
+    const repoRoot = resolveRepoRoot(skillMdPath);
+    const bundlePath = path.join(repoRoot, 'skills', 'lemonppt');
+    if (existsSync(bundlePath)) {
+        return bundlePath;
+    }
+    throw new Error('Skill bundle not found at skills/lemonppt. Did you run the build script?');
+}
+function isSourceRepo(repoRoot) {
+    return existsSync(path.join(repoRoot, 'apps', 'server'));
+}
+function resolveCliWrapper(repoRoot) {
+    if (isSourceRepo(repoRoot)) {
+        const cliPath = path.join(repoRoot, 'packages', 'cli', 'dist', 'cli.js');
+        return {
+            type: 'source',
+            cli: cliPath,
+            sh: `#!/bin/bash\nset -e\nexec "${cliPath}" "$@"\n`,
+            ps1: `#Requires -Version 5.1\n& node "${cliPath}" @args\n`,
+        };
+    }
+    return {
+        type: 'published',
+        sh: `#!/bin/bash\nset -e\nexec npx @lemonppt/cli "$@"\n`,
+        ps1: `#Requires -Version 5.1\n& npx @lemonppt/cli @args\n`,
+    };
+}
+function resolveCliMarker(wrapper) {
+    return JSON.stringify(wrapper.type === 'source' && wrapper.cli
+        ? { type: wrapper.type, cli: wrapper.cli }
+        : { type: wrapper.type }, null, 2);
+}
 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 bundlePath = resolveSkillBundlePath(skillMdSource);
+    await cp(bundlePath, skillDir, { recursive: true, force: true });
+    // 兼容 OpenAI/Codex 等同时读取根目录 openai.yaml 的框架
+    const agentYamlSource = path.join(bundlePath, 'agents', 'openai.yaml');
+    if (existsSync(agentYamlSource)) {
+        await copyFile(agentYamlSource, path.join(skillDir, 'openai.yaml'));
+    }
+    const repoRoot = resolveRepoRoot(skillMdSource);
+    const wrapper = resolveCliWrapper(repoRoot);
     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}`);
+    await writeFile(path.join(scriptsDir, 'lemonppt.sh'), wrapper.sh, { mode: 0o755 });
+    await writeFile(path.join(scriptsDir, 'lemonppt.ps1'), wrapper.ps1, { mode: 0o755 });
+    await writeFile(path.join(scriptsDir, '.cli-path.json'), resolveCliMarker(wrapper));
+    console.log(`✓ Installed lemonPPT skill for ${agent} at ${skillDir} (${wrapper.type} mode)`);
 }
 /**
  * 将 lemonPPT skill 安装到常见 AI Agent 的技能目录。
  */
 export async function installSkill(options = {}) {
+    if (options.target) {
+        const skillMdSource = resolveSkillMdPath();
+        const bundlePath = resolveSkillBundlePath(skillMdSource);
+        await mkdir(options.target, { recursive: true });
+        await cp(bundlePath, options.target, { recursive: true, force: true });
+        const repoRoot = resolveRepoRoot(skillMdSource);
+        const wrapper = resolveCliWrapper(repoRoot);
+        const scriptsDir = path.join(options.target, 'scripts');
+        await writeFile(path.join(scriptsDir, 'lemonppt.sh'), wrapper.sh, { mode: 0o755 });
+        await writeFile(path.join(scriptsDir, 'lemonppt.ps1'), wrapper.ps1, { mode: 0o755 });
+        await writeFile(path.join(scriptsDir, '.cli-path.json'), resolveCliMarker(wrapper));
+        console.log(`✓ Copied skill bundle to ${options.target} (${wrapper.type} mode)`);
+        return;
+    }
     const agents = options.agents?.length ? options.agents : DEFAULT_AGENTS;
     for (const agent of agents) {
         await installAgent(agent);