zengen 0.1.35 → 0.2.0

package/dist/process/template.js

@@ -0,0 +1,188 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderTemplates = renderTemplates;
+const fs = __importStar(require("fs/promises"));
+const path = __importStar(require("path"));
+const metadata_1 = require("../metadata");
+const paths_1 = require("../paths");
+const convertMarkdownToHtml_1 = require("../utils/convertMarkdownToHtml");
+const frontmatter_1 = require("../utils/frontmatter");
+const langNames = {
+    'zh-Hans': '简体中文',
+    'en-US': 'English',
+    'ja-JP': '日本語',
+    'ko-KR': '한국어',
+};
+/**
+ * 生成语言切换器 HTML
+ * @param currentLang 当前语言
+ * @param availableLangs 可用语言列表
+ * @returns 语言切换器 HTML 字符串
+ */
+function generateLanguageSwitcher(templateData) {
+    const { options: { langs = [], baseUrl = '/' }, } = metadata_1.MetaData;
+    const items = langs
+        .map(lang => {
+        const langName = langNames[lang] || lang;
+        const isCurrent = lang === templateData.lang;
+        const activeClass = isCurrent ? 'active' : '';
+        return `<li class="lang-item ${activeClass}">
+        <a href="${path.join(baseUrl, lang, templateData.file.hash + '.html')}" class="lang-link">${langName}</a>
+      </li>`;
+    })
+        .join('');
+    return `<div class="language-switcher">
+    <span class="lang-label">Language:</span>
+    <ul class="lang-list">${items}</ul>
+  </div>`;
+}
+/**
+ * 生成导航 HTML
+ * @param navigation 导航树
+ * @param currentPath 当前路径（可选，用于高亮当前页面）
+ * @returns 导航 HTML 字符串
+ */
+async function generateNavigationHtml(data) {
+    const { files, options: { baseUrl = '/' }, } = metadata_1.MetaData;
+    const navigation = await Promise.all(files.map(async (file) => {
+        const content = await fs.readFile(path.join(paths_1.ZEN_SRC_DIR, data.lang, file.hash + '.md'), 'utf-8');
+        const { frontmatter } = (0, frontmatter_1.parseFrontmatter)(content);
+        const title = frontmatter.title || file.metadata?.title || file.path; // 优先使用提取的标题
+        return {
+            title,
+            path: path.join(baseUrl, data.lang, file.hash + '.html'),
+            isActive: data.file.hash === file.hash,
+        };
+    }));
+    navigation.sort((a, b) => a.title.localeCompare(b.title));
+    return `<ul class="nav-list">${navigation
+        .map(item => {
+        const activeClass = item.isActive ? 'active' : '';
+        let html = `<li class="nav-item">`;
+        html += `<a href="${item.path}" class="nav-link ${activeClass}">${item.title}</a>`;
+        html += `</li>`;
+        return html;
+    })
+        .join('')}</ul>`;
+}
+/**
+ * 简单的模板变量替换
+ * @param template 模板字符串
+ * @param data 模板数据
+ * @returns 渲染后的 HTML 字符串
+ */
+async function renderTemplate(template, data) {
+    const { options: { langs = [] }, } = metadata_1.MetaData;
+    const markdownContent = data.content;
+    const { frontmatter, body } = (0, frontmatter_1.parseFrontmatter)(markdownContent);
+    const htmlContent = (0, convertMarkdownToHtml_1.convertMarkdownToHtml)(body);
+    let result = template;
+    // 替换导航
+    const navigationHtml = await generateNavigationHtml(data);
+    result = result.replace(/{{navigation}}/g, navigationHtml);
+    // 替换其他变量 - 使用全局替换
+    result = result.replace(/{{title}}/g, frontmatter.title || 'Untitled');
+    result = result.replace(/{{content}}/g, htmlContent);
+    // 替换元数据变量
+    if (frontmatter) {
+        result = result.replace(/{{summary}}/g, frontmatter.summary || '');
+        result = result.replace(/{{tags}}/g, frontmatter.tags?.join(', ') || '');
+        result = result.replace(/{{inferred_date}}/g, frontmatter.inferred_date || '');
+        result = result.replace(/{{inferred_lang}}/g, frontmatter.inferred_lang || '');
+    }
+    // 替换语言相关变量
+    result = result.replace(/{{lang}}/g, data.lang || '');
+    if (langs && langs.length > 1 && data.lang) {
+        const langSwitcher = generateLanguageSwitcher(data);
+        result = result.replace('{{language_switcher}}', langSwitcher);
+    }
+    return result;
+}
+const renderRedirectTemplate = async (from, to) => {
+    const { options: { baseUrl = '/' }, } = metadata_1.MetaData;
+    const toURL = path.join(baseUrl, to);
+    const html = `<!DOCTYPE html>
+<html lang="en">
+<head>
+    <meta charset="UTF-8">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <meta http-equiv="refresh" content="0; url=${toURL}">
+    <title>Redirecting...</title>
+</head>
+<body>
+    <p>Redirecting to <a href="${toURL}">${toURL}</a></p>
+</body>
+</html>`;
+    const targetPath = path.join(paths_1.ZEN_DIST_DIR, from);
+    await fs.mkdir(path.dirname(targetPath), { recursive: true });
+    await fs.writeFile(targetPath, html, 'utf-8');
+};
+/**
+ * 渲染模板并保存文件
+ */
+async function renderTemplates() {
+    const { files, options: { langs, verbose }, } = metadata_1.MetaData;
+    if (verbose)
+        console.log(`⚡ Processing files...`);
+    const layoutTemplate = await fs.readFile(path.join(__dirname, '../../assets/templates/default/layout.html'), 'utf-8');
+    for (const file of files) {
+        for (const lang of langs || []) {
+            console.info(`📄 Preparing file for language: ${file.path} [${file.hash}] [${lang}]`);
+            const targetPath = path.join(paths_1.ZEN_DIST_DIR, lang, file.hash + '.html');
+            const content = await fs.readFile(path.join(paths_1.ZEN_SRC_DIR, lang, file.hash + '.md'), 'utf-8');
+            try {
+                const html = await renderTemplate(layoutTemplate, {
+                    file,
+                    content,
+                    lang,
+                });
+                await fs.mkdir(path.dirname(targetPath), { recursive: true });
+                await fs.writeFile(targetPath, html, 'utf-8');
+                if (verbose)
+                    console.log(`✅ Rendered: ${targetPath}`);
+            }
+            catch (error) {
+                console.error(`❌ Failed to render ${file.path}:`, error);
+            }
+        }
+    }
+    for (const lang of langs || []) {
+        await renderRedirectTemplate(path.join(lang, 'index.html'), path.join(lang, files[0].hash + '.html'));
+    }
+    await renderRedirectTemplate('index.html', path.join(langs?.[0] || 'en-US', 'index.html'));
+}
+//# sourceMappingURL=template.js.map

package/dist/process/template.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template.js","sourceRoot":"","sources":["../../src/process/template.ts"],"names":[],"mappings":"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"}

package/dist/scan/files.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 计算文件内容的 SHA256 哈希值
+ * @param filePath 文件路径
+ * @returns 文件的哈希值，如果读取失败则返回空字符串
+ */
+export declare function calculateFileHash(filePath: string): Promise<string>;
+//# sourceMappingURL=files.d.ts.map

package/dist/scan/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/scan/files.ts"],"names":[],"mappings":"AAGA;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAQzE"}

package/dist/scan/files.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateFileHash = calculateFileHash;
+const crypto = __importStar(require("crypto"));
+const fs = __importStar(require("fs/promises"));
+/**
+ * 计算文件内容的 SHA256 哈希值
+ * @param filePath 文件路径
+ * @returns 文件的哈希值，如果读取失败则返回空字符串
+ */
+async function calculateFileHash(filePath) {
+    try {
+        const content = await fs.readFile(filePath, 'utf-8');
+        return crypto.createHash('sha256').update(content).digest('hex');
+    }
+    catch (error) {
+        console.warn(`⚠️ Failed to calculate hash for ${filePath}:`, error);
+        return '';
+    }
+}
+//# sourceMappingURL=files.js.map

package/dist/scan/files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.js","sourceRoot":"","sources":["../../src/scan/files.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,8CAQC;AAhBD,+CAAiC;AACjC,gDAAkC;AAElC;;;;GAIG;AACI,KAAK,UAAU,iBAAiB,CAAC,QAAgB;IACtD,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,mCAAmC,QAAQ,GAAG,EAAE,KAAK,CAAC,CAAC;QACpE,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/services/openai.d.ts

@@ -0,0 +1,41 @@
+/**
+ * OpenAI 消息接口
+ */
+export interface OpenAIMessage {
+    role: 'system' | 'user' | 'assistant';
+    content: string;
+}
+/**
+ * OpenAI 响应接口
+ */
+export interface OpenAIResponse {
+    id: string;
+    object: string;
+    created: number;
+    model: string;
+    choices: Array<{
+        index: number;
+        message: {
+            role: string;
+            content: string;
+        };
+        finish_reason: string;
+    }>;
+    usage: {
+        prompt_tokens: number;
+        completion_tokens: number;
+        total_tokens: number;
+    };
+}
+/**
+ * 使用 OpenAI API 补全消息
+ * @param messages 消息数组
+ * @param options 可选配置
+ * @returns Promise<OpenAIResponse> 返回完整的OpenAI响应
+ */
+export declare const completeMessages: (messages: OpenAIMessage[], options?: {
+    response_format?: {
+        type: "json_object" | "text";
+    };
+}) => Promise<OpenAIResponse>;
+//# sourceMappingURL=openai.d.ts.map

package/dist/services/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/services/openai.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE;YACP,IAAI,EAAE,MAAM,CAAC;YACb,OAAO,EAAE,MAAM,CAAC;SACjB,CAAC;QACF,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,KAAK,EAAE;QACL,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,aAAa,EAAE,EACzB,UAAU;IACR,eAAe,CAAC,EAAE;QAAE,IAAI,EAAE,aAAa,GAAG,MAAM,CAAA;KAAE,CAAC;CACpD,KACA,OAAO,CAAC,cAAc,CAiDxB,CAAC"}

package/dist/services/openai.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.completeMessages = void 0;
+/**
+ * 使用 OpenAI API 补全消息
+ * @param messages 消息数组
+ * @param options 可选配置
+ * @returns Promise<OpenAIResponse> 返回完整的OpenAI响应
+ */
+const completeMessages = async (messages, options) => {
+    // 从环境变量读取配置
+    const apiKey = process.env.OPENAI_API_KEY || '';
+    const baseUrl = process.env.OPENAI_BASE_URL || 'https://api.openai.com/v1';
+    const model = process.env.OPENAI_MODEL || 'gpt-3.5-turbo';
+    if (!apiKey) {
+        throw new Error('OPENAI_API_KEY environment variable is not set');
+    }
+    try {
+        const requestBody = {
+            model,
+            messages,
+            temperature: 0, // 总是设置为 0，提取内容不需要随机性
+            // 不设置 max_tokens，让API自动决定
+        };
+        // 添加可选的response_format
+        if (options?.response_format) {
+            requestBody.response_format = options.response_format;
+        }
+        const response = await fetch(`${baseUrl}/chat/completions`, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                Authorization: `Bearer ${apiKey}`,
+            },
+            body: JSON.stringify(requestBody),
+        });
+        if (!response.ok) {
+            const errorText = await response.text();
+            throw new Error(`OpenAI API error (${response.status}): ${errorText}`);
+        }
+        const data = await response.json();
+        // 验证响应
+        if (!data.choices?.[0]?.message?.content?.trim()) {
+            throw new Error('Empty response from OpenAI API');
+        }
+        return data;
+    }
+    catch (error) {
+        console.error('❌ Failed to call OpenAI API:', error);
+        throw error;
+    }
+};
+exports.completeMessages = completeMessages;
+//# sourceMappingURL=openai.js.map

package/dist/services/openai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.js","sourceRoot":"","sources":["../../src/services/openai.ts"],"names":[],"mappings":";;;AA+BA;;;;;GAKG;AACI,MAAM,gBAAgB,GAAG,KAAK,EACnC,QAAyB,EACzB,OAEC,EACwB,EAAE;IAC3B,YAAY;IACZ,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,EAAE,CAAC;IAChD,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,2BAA2B,CAAC;IAC3E,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,eAAe,CAAC;IAE1D,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,IAAI,CAAC;QACH,MAAM,WAAW,GAAQ;YACvB,KAAK;YACL,QAAQ;YACR,WAAW,EAAE,CAAC,EAAE,qBAAqB;YACrC,0BAA0B;SAC3B,CAAC;QAEF,uBAAuB;QACvB,IAAI,OAAO,EAAE,eAAe,EAAE,CAAC;YAC7B,WAAW,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;QACxD,CAAC;QAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,OAAO,mBAAmB,EAAE;YAC1D,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,aAAa,EAAE,UAAU,MAAM,EAAE;aAClC;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACxC,MAAM,IAAI,KAAK,CAAC,qBAAqB,QAAQ,CAAC,MAAM,MAAM,SAAS,EAAE,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,IAAI,GAAmB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAEnD,OAAO;QACP,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;YACjD,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,KAAK,CAAC,CAAC;QACrD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC;AAtDW,QAAA,gBAAgB,oBAsD3B"}

package/dist/types.d.ts

@@ -1,55 +1,35 @@
+/**
+ * 单个文件的元数据缓存项
+ */
+export interface FileMetaData {
+    hash: string;
+    path: string;
+    metadata?: AIMetadata;
+}
+/**
+ * .zen/meta.json 文件结构
+ */
+export interface MetaDataStore {
+    version: string;
+    options: BuildOptions;
+    files: FileMetaData[];
+}
 export interface BuildOptions {
-    srcDir: string;
-    outDir: string;
     template?: string;
-    watch?: boolean;
     verbose?: boolean;
-    serve?: boolean;
-    port?: number;
-    host?: string;
     baseUrl?: string;
+    langs?: string[];
 }
-export interface FileInfo {
-    path: string;
-    relativePath: string;
-    name: string;
-    ext: string;
-    content: string;
-    html?: string;
-    metadata?: {
-        title: string;
-    };
-}
-export interface NavigationItem {
-    title: string;
-    path: string;
-    children?: NavigationItem[];
-}
-export interface TemplateData {
+export interface AIMetadata {
     title: string;
-    content: string;
-    navigation: NavigationItem[];
-    metadata?: {
-        title: string;
-    };
-    currentPath?: string;
-}
-export interface MarkdownProcessor {
-    beforeParse?(content: string, fileInfo: FileInfo): string | Promise<string>;
-    afterParse?(html: string, fileInfo: FileInfo): string | Promise<string>;
-}
-export interface ZenConfig {
-    srcDir?: string;
-    outDir?: string;
-    template?: string;
-    baseUrl?: string;
-    i18n?: {
-        sourceLang: string;
-        targetLangs: string[];
-        apiKey?: string;
+    summary: string;
+    tags: string[];
+    inferred_date?: string;
+    inferred_lang: string;
+    tokens_used?: {
+        prompt: number;
+        completion: number;
+        total: number;
     };
-    processors?: MarkdownProcessor[];
-    includePattern?: string;
-    excludePattern?: string;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;CAC7B;AAED,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,cAAc,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5E,UAAU,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CACzE;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE;QACL,UAAU,EAAE,MAAM,CAAC;QACnB,WAAW,EAAE,MAAM,EAAE,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;IACF,UAAU,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACjC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH"}

package/dist/utils/convertMarkdownToHtml.d.ts

@@ -0,0 +1,7 @@
+/**
+ * 将 Markdown 内容转换为 HTML
+ * @param mdContent Markdown 内容字符串
+ * @returns 转换后的 HTML 字符串
+ */
+export declare const convertMarkdownToHtml: (mdContent: string) => string;
+//# sourceMappingURL=convertMarkdownToHtml.d.ts.map

package/dist/utils/convertMarkdownToHtml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertMarkdownToHtml.d.ts","sourceRoot":"","sources":["../../src/utils/convertMarkdownToHtml.ts"],"names":[],"mappings":"AAwBA;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,GAAI,WAAW,MAAM,KAAG,MAEzD,CAAC"}

package/dist/utils/convertMarkdownToHtml.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.convertMarkdownToHtml = void 0;
+const marked_1 = require("marked");
+const highlight_js_1 = __importDefault(require("highlight.js"));
+// 配置 marked 使用 highlight.js 进行代码高亮
+marked_1.marked.setOptions({
+    highlight: function (code, lang) {
+        if (lang && highlight_js_1.default.getLanguage(lang)) {
+            try {
+                return highlight_js_1.default.highlight(code, { language: lang }).value;
+            }
+            catch (err) {
+                console.warn(`Failed to highlight code with language ${lang}:`, err);
+            }
+        }
+        return highlight_js_1.default.highlightAuto(code).value;
+    },
+    pedantic: false,
+    gfm: true,
+    breaks: false,
+    sanitize: false,
+    smartLists: true,
+    smartypants: false,
+    xhtml: false,
+});
+/**
+ * 将 Markdown 内容转换为 HTML
+ * @param mdContent Markdown 内容字符串
+ * @returns 转换后的 HTML 字符串
+ */
+const convertMarkdownToHtml = (mdContent) => {
+    return marked_1.marked.parse(mdContent);
+};
+exports.convertMarkdownToHtml = convertMarkdownToHtml;
+//# sourceMappingURL=convertMarkdownToHtml.js.map

package/dist/utils/convertMarkdownToHtml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convertMarkdownToHtml.js","sourceRoot":"","sources":["../../src/utils/convertMarkdownToHtml.ts"],"names":[],"mappings":";;;;;;AAAA,mCAAgC;AAChC,gEAAgC;AAEhC,mCAAmC;AACnC,eAAM,CAAC,UAAU,CAAC;IAChB,SAAS,EAAE,UAAU,IAAY,EAAE,IAAY;QAC7C,IAAI,IAAI,IAAI,sBAAI,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,IAAI,CAAC;gBACH,OAAO,sBAAI,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC;YACxD,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,IAAI,CAAC,0CAA0C,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;QACD,OAAO,sBAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;IACxC,CAAC;IACD,QAAQ,EAAE,KAAK;IACf,GAAG,EAAE,IAAI;IACT,MAAM,EAAE,KAAK;IACb,QAAQ,EAAE,KAAK;IACf,UAAU,EAAE,IAAI;IAChB,WAAW,EAAE,KAAK;IAClB,KAAK,EAAE,KAAK;CACN,CAAC,CAAC;AAEV;;;;GAIG;AACI,MAAM,qBAAqB,GAAG,CAAC,SAAiB,EAAU,EAAE;IACjE,OAAO,eAAM,CAAC,KAAK,CAAC,SAAS,CAAW,CAAC;AAC3C,CAAC,CAAC;AAFW,QAAA,qBAAqB,yBAEhC"}

package/dist/utils/frontmatter.d.ts

@@ -0,0 +1,6 @@
+export declare const parseFrontmatter: (content: string) => {
+    frontmatter: any;
+    body: string;
+};
+export declare const updateFrontmatter: (content: string, newFrontmatter: any) => string;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/utils/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,GAAI,SAAS,MAAM,KAAG;IAAE,WAAW,EAAE,GAAG,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CASlF,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,SAAS,MAAM,EAAE,gBAAgB,GAAG,KAAG,MAIxE,CAAC"}

package/dist/utils/frontmatter.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.updateFrontmatter = exports.parseFrontmatter = void 0;
+const yaml_1 = require("yaml");
+const parseFrontmatter = (content) => {
+    const frontmatterRegex = /^---\n([\s\S]*?)\n---/;
+    const match = content.match(frontmatterRegex);
+    if (match) {
+        const frontmatterContent = match[1];
+        const body = content.slice(match[0].length).trim();
+        return { frontmatter: (0, yaml_1.parse)(frontmatterContent.trim()), body };
+    }
+    return { frontmatter: {}, body: content };
+};
+exports.parseFrontmatter = parseFrontmatter;
+const updateFrontmatter = (content, newFrontmatter) => {
+    const { body } = (0, exports.parseFrontmatter)(content);
+    const frontmatterContent = `---\n${(0, yaml_1.stringify)(newFrontmatter)}---\n\n`;
+    return frontmatterContent + body;
+};
+exports.updateFrontmatter = updateFrontmatter;
+//# sourceMappingURL=frontmatter.js.map

package/dist/utils/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../../src/utils/frontmatter.ts"],"names":[],"mappings":";;;AAAA,+BAAwC;AAEjC,MAAM,gBAAgB,GAAG,CAAC,OAAe,EAAsC,EAAE;IACtF,MAAM,gBAAgB,GAAG,uBAAuB,CAAC;IACjD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC;IAC9C,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,kBAAkB,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;QACnD,OAAO,EAAE,WAAW,EAAE,IAAA,YAAK,EAAC,kBAAkB,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IACjE,CAAC;IACD,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;AAC5C,CAAC,CAAC;AATW,QAAA,gBAAgB,oBAS3B;AAEK,MAAM,iBAAiB,GAAG,CAAC,OAAe,EAAE,cAAmB,EAAU,EAAE;IAChF,MAAM,EAAE,IAAI,EAAE,GAAG,IAAA,wBAAgB,EAAC,OAAO,CAAC,CAAC;IAC3C,MAAM,kBAAkB,GAAG,QAAQ,IAAA,gBAAS,EAAC,cAAc,CAAC,SAAS,CAAC;IACtE,OAAO,kBAAkB,GAAG,IAAI,CAAC;AACnC,CAAC,CAAC;AAJW,QAAA,iBAAiB,qBAI5B"}

package/docs/advanced-usage.md

@@ -0,0 +1,39 @@
+# 高级用法
+
+深入介绍 ZEN 的高级功能和配置选项。
+
+## 自定义模板
+
+ZEN 支持自定义 HTML 模板：
+
+```bash
+zengen build --src ./docs --out ./dist --template ./custom-template.html
+```
+
+## 配置选项
+
+可以在 `.zenrc` 文件中配置：
+
+```json
+{
+  "srcDir": "./docs",
+  "outDir": "./dist",
+  "template": "./template.html",
+  "baseUrl": "https://example.com",
+  "i18n": {
+    "sourceLang": "zh-Hans",
+    "targetLangs": ["en-US", "ja-JP"]
+  }
+}
+```
+
+## 插件系统
+
+ZEN 支持插件扩展功能：
+
+```typescript
+interface MarkdownProcessor {
+  beforeParse?(content: string, fileInfo: FileInfo): string | Promise<string>;
+  afterParse?(html: string, fileInfo: FileInfo): string | Promise<string>;
+}
+```

package/docs/deployment/github-pages.md

@@ -52,12 +52,11 @@ echo "docs.example.com" > docs-dist/CNAME
 
 ```bash
 cd demo/src
-zengen build --clean --verbose
+zengen build --verbose
 ```
 
 可用的选项：
 
-- `--clean`：在构建前清理输出目录
 - `--verbose`：显示详细输出
 - `--watch`：监听模式（不适用于 CI/CD）
 - `--template`：指定自定义模板文件

package/docs/getting-started.md

@@ -0,0 +1,26 @@
+# 快速开始指南
+
+本文档介绍如何快速开始使用 ZEN 文档生成器。
+
+## 安装
+
+```bash
+npm install -g zengen
+```
+
+## 基本用法
+
+1. 创建文档目录
+2. 编写 Markdown 文件
+3. 运行构建命令
+
+```bash
+zengen build --src ./docs --out ./dist
+```
+
+## 特性
+
+- 极简配置
+- 内置响应式模板
+- AI 辅助元数据提取
+- 多语言支持