const fs = require('fs');
const yaml = require('js-yaml');
const path = require('path');
const { execFileSync } = require('child_process');
const Handlebars = require('handlebars');

// 导入Handlebars助手函数
const { registerAllHelpers } = require('./helpers');

// 注册Handlebars实例和辅助函数
const handlebars = Handlebars.create();
registerAllHelpers(handlebars);

// 加载和注册Handlebars模板的函数
function loadHandlebarsTemplates() {
    const templatesDir = path.join(process.cwd(), 'templates');

    // 检查基本模板目录是否存在
    if (!fs.existsSync(templatesDir)) {
        throw new Error('Templates directory not found. Cannot proceed without templates.');
    }

    // 加载布局模板
    const layoutsDir = path.join(templatesDir, 'layouts');
    if (fs.existsSync(layoutsDir)) {
        fs.readdirSync(layoutsDir).forEach(file => {
            if (file.endsWith('.hbs')) {
                const layoutName = path.basename(file, '.hbs');
                const layoutPath = path.join(layoutsDir, file);
                const layoutContent = fs.readFileSync(layoutPath, 'utf8');
                handlebars.registerPartial(layoutName, layoutContent);
            }
        });
    } else {
        throw new Error('Layouts directory not found. Cannot proceed without layout templates.');
    }

    // 加载组件模板
    const componentsDir = path.join(templatesDir, 'components');
    if (fs.existsSync(componentsDir)) {
        fs.readdirSync(componentsDir).forEach(file => {
            if (file.endsWith('.hbs')) {
                const componentName = path.basename(file, '.hbs');
                const componentPath = path.join(componentsDir, file);
                const componentContent = fs.readFileSync(componentPath, 'utf8');
                handlebars.registerPartial(componentName, componentContent);
            }
        });
    } else {
        throw new Error('Components directory not found. Cannot proceed without component templates.');
    }

    // 识别并检查默认布局模板是否存在
    const defaultLayoutPath = path.join(layoutsDir, 'default.hbs');
    if (!fs.existsSync(defaultLayoutPath)) {
        throw new Error('Default layout template not found. Cannot proceed without default layout.');
    }
}

/**
 * 获取默认布局模板
 * @returns {Object} 包含模板路径和编译的模板函数
 */
function getDefaultLayoutTemplate() {
  const defaultLayoutPath = path.join(process.cwd(), 'templates', 'layouts', 'default.hbs');

  // 检查默认布局模板是否存在
  if (!fs.existsSync(defaultLayoutPath)) {
    throw new Error('Default layout template not found. Cannot proceed without default layout.');
  }

  try {
    // 读取布局内容并编译模板
    const layoutContent = fs.readFileSync(defaultLayoutPath, 'utf8');
    const layoutTemplate = handlebars.compile(layoutContent);

    return {
      path: defaultLayoutPath,
      template: layoutTemplate
    };
  } catch (error) {
    throw new Error(`Error loading default layout template: ${error.message}`);
  }
}

// 渲染Handlebars模板函数
function renderTemplate(templateName, data, useLayout = true) {
    const templatePath = path.join(process.cwd(), 'templates', 'pages', `${templateName}.hbs`);

    // 检查模板是否存在
    if (!fs.existsSync(templatePath)) {
        // 尝试使用通用模板 page.hbs
        const genericTemplatePath = path.join(process.cwd(), 'templates', 'pages', 'page.hbs');

        if (fs.existsSync(genericTemplatePath)) {
            console.log(`模板 ${templateName}.hbs 不存在，使用通用模板 page.hbs 代替`);
            const genericTemplateContent = fs.readFileSync(genericTemplatePath, 'utf8');
            const genericTemplate = handlebars.compile(genericTemplateContent);

    // 添加 pageId 到数据中，以便通用模板使用（优先保留原 pageId，避免回退时语义错位）
    const enhancedData = {
        ...data,
        pageId: data && data.pageId ? data.pageId : templateName
    };

            // 渲染页面内容
            const pageContent = genericTemplate(enhancedData);

            // 如果不使用布局，直接返回页面内容
            if (!useLayout) {
                return pageContent;
            }

            try {
                // 使用辅助函数获取默认布局模板
                const { template: layoutTemplate } = getDefaultLayoutTemplate();

                // 准备布局数据，包含页面内容
                const layoutData = {
                    ...enhancedData,
                    body: pageContent
                };

                // 渲染完整页面
                return layoutTemplate(layoutData);
            } catch (layoutError) {
                throw new Error(`Error rendering layout for ${templateName}: ${layoutError.message}`);
            }
        } else {
            throw new Error(`Template ${templateName}.hbs not found and generic template page.hbs not found. Cannot proceed without template.`);
        }
    }

    try {
        const templateContent = fs.readFileSync(templatePath, 'utf8');
        const template = handlebars.compile(templateContent);

        // 渲染页面内容
        const pageContent = template(data);

        // 如果不使用布局，直接返回页面内容
        if (!useLayout) {
            return pageContent;
        }

        try {
            // 使用辅助函数获取默认布局模板
            const { template: layoutTemplate } = getDefaultLayoutTemplate();

            // 准备布局数据，包含页面内容
            const layoutData = {
                ...data,
                body: pageContent
            };

            // 渲染完整页面
            return layoutTemplate(layoutData);
        } catch (layoutError) {
            throw new Error(`Error rendering layout for ${templateName}: ${layoutError.message}`);
        }
    } catch (error) {
        throw new Error(`Error rendering template ${templateName}: ${error.message}`);
    }
}

// HTML转义函数，防止XSS攻击
function escapeHtml(unsafe) {
    if (unsafe === undefined || unsafe === null) {
        return '';
    }
    return String(unsafe)
        .replace(/&/g, "&")
        .replace(/</g, "&lt;")
        .replace(/>/g, "&gt;")
        .replace(/"/g, "&quot;")
        .replace(/'/g, "&#039;");
}

/**
 * 统一处理配置文件加载错误
 * @param {string} filePath 配置文件路径
 * @param {Error} error 错误对象
 */
function handleConfigLoadError(filePath, error) {
  console.error(`Error loading configuration from ${filePath}:`, error);
}

/**
 * 安全地加载YAML配置文件
 * @param {string} filePath 配置文件路径
 * @returns {Object|null} 配置对象，如果文件不存在或加载失败则返回null
 */
function safeLoadYamlConfig(filePath) {
  if (!fs.existsSync(filePath)) {
    return null;
  }

  try {
    const fileContent = fs.readFileSync(filePath, 'utf8');
    // 使用 loadAll 而不是 load 来支持多文档 YAML 文件
    const docs = yaml.loadAll(fileContent);
    
    // 如果只有一个文档，直接返回
    if (docs.length === 1) {
      return docs[0];
    }
    
    // 如果有多个文档，返回第一个文档（忽略后面的文档）
    if (docs.length > 1) {
      console.warn(`Warning: Multiple documents found in ${filePath}. Using the first document only.`);
      return docs[0];
    }
    
    return null;
  } catch (error) {
    handleConfigLoadError(filePath, error);
    return null;
  }
}

/**
 * 加载模块化配置目录
 * @param {string} dirPath 配置目录路径
 * @returns {Object|null} 配置对象，如果目录不存在或加载失败则返回null
 */
function loadModularConfig(dirPath) {
    if (!fs.existsSync(dirPath)) {
        return null;
    }

    const config = {
        site: {},
        navigation: [],
        fonts: {},
        profile: {},
        social: [],
        categories: []
    };

    // 加载基础配置
    const siteConfigPath = path.join(dirPath, 'site.yml');
    const siteConfig = safeLoadYamlConfig(siteConfigPath);
    if (siteConfig) {
        // 将site.yml中的内容分配到正确的配置字段
        config.site = siteConfig;

        // 提取特殊字段到顶层配置
        if (siteConfig.fonts) config.fonts = siteConfig.fonts;
        if (siteConfig.profile) config.profile = siteConfig.profile;
        if (siteConfig.social) config.social = siteConfig.social;
        
        // 优先使用site.yml中的navigation配置
        if (siteConfig.navigation) {
            config.navigation = siteConfig.navigation;
            console.log('使用 site.yml 中的导航配置');
        }
    }

    // 加载页面配置
    const pagesPath = path.join(dirPath, 'pages');
    if (fs.existsSync(pagesPath)) {
        const files = fs.readdirSync(pagesPath).filter(file =>
            file.endsWith('.yml') || file.endsWith('.yaml'));

        files.forEach(file => {
            const filePath = path.join(pagesPath, file);
            const fileConfig = safeLoadYamlConfig(filePath);

            if (fileConfig) {
                // 提取文件名（不含扩展名）作为配置键
                const configKey = path.basename(file, path.extname(file));

                // 将页面配置添加到主配置对象
                config[configKey] = fileConfig;
            }
        });
    }

    return config;
}

/**
 * 确保配置对象具有必要的默认值
 * @param {Object} config 配置对象
 * @returns {Object} 处理后的配置对象
 */
function ensureConfigDefaults(config) {
  // 创建一个新对象，避免修改原始配置
  const result = { ...config };

  // 确保基本结构存在
  result.site = result.site || {};
  result.navigation = result.navigation || [];

  // 字体默认值（单一字体配置）
  result.fonts = result.fonts && typeof result.fonts === 'object' ? result.fonts : {};
  result.fonts.source = result.fonts.source || 'css';
  result.fonts.family = result.fonts.family || 'LXGW WenKai';
  result.fonts.weight = result.fonts.weight || 'normal';
  result.fonts.cssUrl = result.fonts.cssUrl || 'https://fontsapi.zeoseven.com/292/main/result.css';

  result.profile = result.profile || {};
  result.social = result.social || [];
  // 图标配置默认值
  result.icons = result.icons || {};
  // icons.mode: manual | favicon, 默认 favicon
  result.icons.mode = result.icons.mode || 'favicon';

  // 站点基本信息默认值
  result.site.title = result.site.title || 'MeNav导航';
  result.site.description = result.site.description || '个人网络导航站';
  result.site.author = result.site.author || 'MeNav User';
  result.site.logo_text = result.site.logo_text || '导航站';
  result.site.favicon = result.site.favicon || 'menav.svg';
  result.site.logo = result.site.logo || null;
  result.site.footer = result.site.footer || '';
  result.site.theme = result.site.theme || {
    primary: '#4a89dc',
    background: '#f5f7fa',
    modeToggle: true
  };

  // 用户资料默认值
  result.profile = result.profile || {};
  result.profile.title = result.profile.title || '欢迎使用';
  result.profile.subtitle = result.profile.subtitle || 'MeNav个人导航系统';

  // 处理站点默认值的辅助函数
  function processSiteDefaults(site) {
    site.name = site.name || '未命名站点';
    site.url = site.url || '#';
    site.description = site.description || '';
    site.icon = site.icon || 'fas fa-link';
    site.external = typeof site.external === 'boolean' ? site.external : true;
  }

  // 处理分类默认值的辅助函数
  function processCategoryDefaults(category) {
    category.name = category.name || '未命名分类';
    category.sites = category.sites || [];
    category.sites.forEach(processSiteDefaults);
  }

  // 为所有页面配置中的类别和站点设置默认值
  Object.keys(result).forEach(key => {
    const pageConfig = result[key];
    // 检查是否是页面配置对象
    if (!pageConfig || typeof pageConfig !== 'object') return;

    // 传统结构：categories -> sites
    if (Array.isArray(pageConfig.categories)) {
      pageConfig.categories.forEach(processCategoryDefaults);
    }

    // 扁平结构：sites（用于 friends/articles 等“无层级并列卡片”页面）
    if (Array.isArray(pageConfig.sites)) {
      pageConfig.sites.forEach(processSiteDefaults);
    }
  });

  return result;
}

/**
 * 验证配置是否有效
 * @param {Object} config 配置对象
 * @returns {boolean} 配置是否有效
 */
function validateConfig(config) {
  // 基本结构检查
  if (!config || typeof config !== 'object') {
    console.error('配置无效: 配置必须是一个对象');
    return false;
  }

  // 所有其他验证被移除，因为它们只是检查但没有实际操作
  // 配置默认值和数据修复已经在ensureConfigDefaults函数中处理

  return true;
}

/**
 * 获取导航项的子菜单数据
 * @param {Object} navItem 导航项对象
 * @param {Object} config 配置对象
 * @returns {Array|null} 子菜单数据数组或null
 */
function getSubmenuForNavItem(navItem, config) {
  if (!navItem || !navItem.id || !config) {
    return null;
  }

  // 通用处理：任意页面的子菜单生成（基于 pages/<id>.yml 的 categories）
  if (config[navItem.id] && Array.isArray(config[navItem.id].categories)) return config[navItem.id].categories;

  return null;
}

/**
 * 将 JSON 字符串安全嵌入到 <script> 中，避免出现 `</script>` 结束标签导致脚本块被提前终止。
 * 说明：返回值仍是合法 JSON，JSON.parse 后数据不变。
 * @param {string} jsonString JSON 字符串
 * @returns {string} 安全的 JSON 字符串
 */
function makeJsonSafeForHtmlScript(jsonString) {
  if (typeof jsonString !== 'string') {
    return '';
  }

  return jsonString.replace(/<\/script/gi, '<\\/script');
}

/**
 * 解析页面配置文件路径（优先 user，回退 _default）
 * 注意：仅用于构建期读取文件元信息，不会把路径注入到页面/扩展配置中。
 * @param {string} pageId 页面ID（与 pages/<id>.yml 文件名对应）
 * @returns {string|null} 文件路径或 null
 */
function resolvePageConfigFilePath(pageId) {
  if (!pageId) return null;

  const candidates = [
    path.join(process.cwd(), 'config', 'user', 'pages', `${pageId}.yml`),
    path.join(process.cwd(), 'config', 'user', 'pages', `${pageId}.yaml`),
    path.join(process.cwd(), 'config', '_default', 'pages', `${pageId}.yml`),
    path.join(process.cwd(), 'config', '_default', 'pages', `${pageId}.yaml`),
  ];

  for (const filePath of candidates) {
    try {
      if (fs.existsSync(filePath)) return filePath;
    } catch (e) {
      // 忽略 IO 异常，继续尝试下一个候选
    }
  }

  return null;
}

/**
 * 尝试获取文件最后一次 git 提交时间（ISO 字符串）
 * @param {string} filePath 文件路径
 * @returns {string|null} ISO 字符串（UTC），失败返回 null
 */
function tryGetGitLastCommitIso(filePath) {
  if (!filePath) return null;

  try {
    const relativePath = path.relative(process.cwd(), filePath).replace(/\\/g, '/');
    const output = execFileSync(
      'git',
      ['log', '-1', '--format=%cI', '--', relativePath],
      { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] }
    );
    const raw = String(output || '').trim();
    if (!raw) return null;

    const date = new Date(raw);
    if (Number.isNaN(date.getTime())) return null;

    return date.toISOString();
  } catch (e) {
    return null;
  }
}

/**
 * 获取文件 mtime（ISO 字符串）
 * @param {string} filePath 文件路径
 * @returns {string|null} ISO 字符串（UTC），失败返回 null
 */
function tryGetFileMtimeIso(filePath) {
  if (!filePath) return null;

  try {
    const stats = fs.statSync(filePath);
    const mtime = stats && stats.mtime ? stats.mtime : null;
    if (!(mtime instanceof Date) || Number.isNaN(mtime.getTime())) return null;
    return mtime.toISOString();
  } catch (e) {
    return null;
  }
}

/**
 * 计算页面配置文件“内容更新时间”（优先 git，回退 mtime）
 * @param {string} pageId 页面ID
 * @returns {{updatedAt: string, updatedAtSource: 'git'|'mtime'}|null}
 */
function getPageConfigUpdatedAtMeta(pageId) {
  const filePath = resolvePageConfigFilePath(pageId);
  if (!filePath) return null;

  const gitIso = tryGetGitLastCommitIso(filePath);
  if (gitIso) {
    return { updatedAt: gitIso, updatedAtSource: 'git' };
  }

  const mtimeIso = tryGetFileMtimeIso(filePath);
  if (mtimeIso) {
    return { updatedAt: mtimeIso, updatedAtSource: 'mtime' };
  }

  return null;
}

/**
 * 读取 articles 页面 RSS 缓存（Phase 2）
 * - 缓存默认放在 dev/（仓库默认 gitignore）
 * - 构建端只读缓存：缓存缺失/损坏时回退到 Phase 1（渲染来源站点分类）
 * @param {string} pageId 页面ID（用于支持多个 articles 页面的独立缓存）
 * @param {Object} config 全站配置（用于读取 site.rss.cacheDir）
 * @returns {{items: Array<Object>, meta: Object}|null}
 */
function tryLoadArticlesFeedCache(pageId, config) {
  if (!pageId) return null;

  const cacheDirFromEnv = process.env.RSS_CACHE_DIR ? String(process.env.RSS_CACHE_DIR) : '';
  const cacheDirFromConfig =
    config && config.site && config.site.rss && config.site.rss.cacheDir ? String(config.site.rss.cacheDir) : '';
  const cacheDir = cacheDirFromEnv || cacheDirFromConfig || 'dev';

  const cacheBaseDir = path.isAbsolute(cacheDir) ? cacheDir : path.join(process.cwd(), cacheDir);
  const cachePath = path.join(cacheBaseDir, `${pageId}.feed-cache.json`);
  if (!fs.existsSync(cachePath)) return null;

  try {
    const raw = fs.readFileSync(cachePath, 'utf8');
    const parsed = JSON.parse(raw);
    if (!parsed || typeof parsed !== 'object') return null;

    const articles = Array.isArray(parsed.articles) ? parsed.articles : [];
    const items = articles
      .map(a => {
        const title = a && a.title ? String(a.title) : '';
        const url = a && a.url ? String(a.url) : '';
        if (!title || !url) return null;

        return {
          // 兼容 site-card partial 字段
          name: title,
          url,
          icon: a && a.icon ? String(a.icon) : 'fas fa-pen',
          description: a && a.summary ? String(a.summary) : '',

          // Phase 2 文章元信息（只读展示）
          publishedAt: a && a.publishedAt ? String(a.publishedAt) : '',
          source: a && a.source ? String(a.source) : '',
          // 文章来源站点首页 URL（用于按分类聚合展示；旧缓存可能缺失）
          sourceUrl: a && a.sourceUrl ? String(a.sourceUrl) : '',

          // 文章链接通常应在新标签页打开
          external: true
        };
      })
      .filter(Boolean);

    return {
      items,
      meta: {
        pageId: parsed.pageId || pageId,
        generatedAt: parsed.generatedAt || '',
        total: parsed.stats && Number.isFinite(parsed.stats.totalArticles) ? parsed.stats.totalArticles : items.length
      }
    };
  } catch (e) {
    console.warn(`[WARN] articles 缓存读取失败：${cachePath}（将回退 Phase 1）`);
    return null;
  }
}

function normalizeUrlKey(input) {
  if (!input) return '';
  try {
    const u = new URL(String(input));
    const origin = u.origin;
    let pathname = u.pathname || '/';
    // 统一去掉末尾斜杠（根路径除外），避免 https://a.com 与 https://a.com/ 不匹配
    if (pathname !== '/' && pathname.endsWith('/')) pathname = pathname.slice(0, -1);
    return `${origin}${pathname}`;
  } catch {
    return String(input).trim();
  }
}

function collectSitesRecursively(node, output) {
  if (!node || typeof node !== 'object') return;

  if (Array.isArray(node.subcategories)) node.subcategories.forEach(child => collectSitesRecursively(child, output));
  if (Array.isArray(node.groups)) node.groups.forEach(child => collectSitesRecursively(child, output));
  if (Array.isArray(node.subgroups)) node.subgroups.forEach(child => collectSitesRecursively(child, output));

  if (Array.isArray(node.sites)) {
    node.sites.forEach(site => {
      if (site && typeof site === 'object') output.push(site);
    });
  }
}

/**
 * articles Phase 2：按页面配置的“分类”聚合文章展示
 * - 规则：某篇文章的 sourceUrl/source 归属到其来源站点（pages/articles.yml 中配置的站点）所在的分类
 * - 兼容：旧缓存缺少 sourceUrl 时回退使用 source（站点名称）匹配
 * @param {Array<Object>} categories 页面配置 categories（可包含更深层级）
 * @param {Array<Object>} articlesItems Phase 2 文章条目（来自缓存）
 * @returns {Array<{name: string, icon: string, items: Array<Object>}>}
 */
function buildArticlesCategoriesByPageCategories(categories, articlesItems) {
  const safeItems = Array.isArray(articlesItems) ? articlesItems : [];
  const safeCategories = Array.isArray(categories) ? categories : [];

  // 若页面未配置分类，则回退为单一分类容器
  if (safeCategories.length === 0) {
    return [
      {
        name: '最新文章',
        icon: 'fas fa-rss',
        items: safeItems
      }
    ];
  }

  const categoryIndex = safeCategories.map(category => {
    const sites = [];
    collectSitesRecursively(category, sites);

    const siteUrlKeys = new Set();
    const siteNameKeys = new Set();
    sites.forEach(site => {
      const urlKey = normalizeUrlKey(site && site.url ? String(site.url) : '');
      if (urlKey) siteUrlKeys.add(urlKey);
      const nameKey = site && site.name ? String(site.name).trim().toLowerCase() : '';
      if (nameKey) siteNameKeys.add(nameKey);
    });

    return { category, siteUrlKeys, siteNameKeys };
  });

  const buckets = categoryIndex.map(() => []);
  const uncategorized = [];

  safeItems.forEach(item => {
    const sourceUrlKey = normalizeUrlKey(item && item.sourceUrl ? String(item.sourceUrl) : '');
    const sourceNameKey = item && item.source ? String(item.source).trim().toLowerCase() : '';

    let matchedIndex = -1;
    if (sourceUrlKey) {
      matchedIndex = categoryIndex.findIndex(idx => idx.siteUrlKeys.has(sourceUrlKey));
    }
    if (matchedIndex < 0 && sourceNameKey) {
      matchedIndex = categoryIndex.findIndex(idx => idx.siteNameKeys.has(sourceNameKey));
    }

    if (matchedIndex < 0) {
      uncategorized.push(item);
      return;
    }

    buckets[matchedIndex].push(item);
  });

  const displayCategories = categoryIndex.map((idx, i) => ({
    name: idx.category && idx.category.name ? String(idx.category.name) : '未命名分类',
    icon: idx.category && idx.category.icon ? String(idx.category.icon) : 'fas fa-rss',
    items: buckets[i]
  }));

  if (uncategorized.length > 0) {
    displayCategories.push({
      name: '其他',
      icon: 'fas fa-ellipsis-h',
      items: uncategorized
    });
  }

  return displayCategories;
}

function tryLoadProjectsRepoCache(pageId, config) {
  if (!pageId) return null;

  const cacheDirFromEnv = process.env.PROJECTS_CACHE_DIR ? String(process.env.PROJECTS_CACHE_DIR) : '';
  const cacheDirFromConfig =
    config && config.site && config.site.github && config.site.github.cacheDir ? String(config.site.github.cacheDir) : '';
  const cacheDir = cacheDirFromEnv || cacheDirFromConfig || 'dev';

  const cacheBaseDir = path.isAbsolute(cacheDir) ? cacheDir : path.join(process.cwd(), cacheDir);
  const cachePath = path.join(cacheBaseDir, `${pageId}.repo-cache.json`);
  if (!fs.existsSync(cachePath)) return null;

  try {
    const raw = fs.readFileSync(cachePath, 'utf8');
    const parsed = JSON.parse(raw);
    if (!parsed || typeof parsed !== 'object') return null;

    const repos = Array.isArray(parsed.repos) ? parsed.repos : [];
    const map = new Map();
    repos.forEach(r => {
      const url = r && r.url ? String(r.url) : '';
      if (!url) return;
      map.set(url, {
        language: r && r.language ? String(r.language) : '',
        languageColor: r && r.languageColor ? String(r.languageColor) : '',
        stars: Number.isFinite(r && r.stars) ? r.stars : null,
        forks: Number.isFinite(r && r.forks) ? r.forks : null
      });
    });

    return {
      map,
      meta: {
        pageId: parsed.pageId || pageId,
        generatedAt: parsed.generatedAt || ''
      }
    };
  } catch (e) {
    console.warn(`[WARN] projects 缓存读取失败：${cachePath}（将仅展示标题与描述）`);
    return null;
  }
}

function normalizeGithubRepoUrl(url) {
  if (!url) return '';
  try {
    const u = new URL(String(url));
    if (u.hostname.toLowerCase() !== 'github.com') return '';
    const parts = u.pathname.split('/').filter(Boolean);
    if (parts.length < 2) return '';
    const owner = parts[0];
    const repo = parts[1].replace(/\.git$/i, '');
    if (!owner || !repo) return '';
    return `https://github.com/${owner}/${repo}`;
  } catch {
    return '';
  }
}

function applyRepoMetaToCategories(categories, repoMetaMap) {
  if (!Array.isArray(categories) || !(repoMetaMap instanceof Map)) return;

  const walk = (node) => {
    if (!node || typeof node !== 'object') return;
    if (Array.isArray(node.subcategories)) node.subcategories.forEach(walk);
    if (Array.isArray(node.groups)) node.groups.forEach(walk);
    if (Array.isArray(node.subgroups)) node.subgroups.forEach(walk);

    if (Array.isArray(node.sites)) {
      node.sites.forEach(site => {
        if (!site || typeof site !== 'object' || !site.url) return;
        const canonical = normalizeGithubRepoUrl(site.url);
        if (!canonical) return;
        const meta = repoMetaMap.get(canonical);
        if (!meta) return;

        site.language = meta.language || '';
        site.languageColor = meta.languageColor || '';
        site.stars = meta.stars;
        site.forks = meta.forks;
      });
    }
  };

  categories.forEach(walk);
}

/**
 * 准备渲染数据，添加模板所需的特殊属性
 * @param {Object} config 配置对象
 * @returns {Object} 增强的渲染数据
 */
function prepareRenderData(config) {
  // 创建渲染数据对象，包含原始配置
  const renderData = { ...config };

  // 添加额外渲染数据
  renderData._meta = {
    generated_at: new Date(),
    version: process.env.npm_package_version || '1.0.0',
    generator: 'MeNav'
  };

  // 确保navigation是数组
  if (!Array.isArray(renderData.navigation)) {
    renderData.navigation = [];
    // 移除警告日志，数据处理逻辑保留
  }

  // 添加导航项的活动状态标记和子菜单
  if (Array.isArray(renderData.navigation)) {
    renderData.navigation = renderData.navigation.map((item, index) => {
      const navItem = {
        ...item,
        isActive: index === 0, // 默认第一项为活动项
        id: item.id || `nav-${index}`,
        active: index === 0 // 保持旧模板兼容（由顺序决定，不读取配置的 active 字段）
      };

      // 使用辅助函数获取子菜单
      const submenu = getSubmenuForNavItem(navItem, renderData);
      if (submenu) {
        navItem.submenu = submenu;
      }

      return navItem;
    });
  }

  // 首页（默认页）规则：navigation 顺序第一项即首页
  renderData.homePageId = renderData.navigation && renderData.navigation[0] ? renderData.navigation[0].id : null;

  // 添加序列化的配置数据，用于浏览器扩展（确保包含 homePageId 等处理结果）
  renderData.configJSON = makeJsonSafeForHtmlScript(
    JSON.stringify({
      version: process.env.npm_package_version || '1.0.0',
      timestamp: new Date().toISOString(),
      data: renderData // 使用经过处理的renderData而不是原始config
    })
  );

  // 为Handlebars模板特别准备navigationData数组
  renderData.navigationData = renderData.navigation;

  // 确保social数据格式正确
  if (Array.isArray(renderData.social)) {
    renderData.socialLinks = renderData.social; // 兼容模板中的不同引用名
  }

  return renderData;
}

// 读取配置文件
function loadConfig() {
  // 初始化空配置对象
  let config = {
    site: {},
    navigation: [],
    fonts: {},
    profile: {},
    social: []
  };

  // 检查模块化配置来源是否存在
  const hasUserModularConfig = fs.existsSync('config/user');
  const hasDefaultModularConfig = fs.existsSync('config/_default');

  // 根据优先级顺序选择最高优先级的配置
  if (hasUserModularConfig) {
    // 配置采用“完全替换”策略：一旦存在 config/user/，将不会回退到 config/_default/
    if (!fs.existsSync('config/user/site.yml')) {
      console.error('[ERROR] 检测到 config/user/ 目录，但缺少 config/user/site.yml。');
      console.error('[ERROR] 由于配置采用“完全替换”策略，系统不会从 config/_default/ 补齐缺失配置。');
      console.error('[ERROR] 解决方法：先完整复制 config/_default/ 到 config/user/，再按需修改。');
      process.exit(1);
    }

    if (!fs.existsSync('config/user/pages')) {
      console.warn('[WARN] 检测到 config/user/ 目录，但缺少 config/user/pages/。部分页面内容可能为空。');
      console.warn('[WARN] 建议：复制 config/_default/pages/ 到 config/user/pages/，再按需修改。');
    }

    // 1. 最高优先级: config/user/ 目录
    config = loadModularConfig('config/user');
  } else if (hasDefaultModularConfig) {
    // 2. 次高优先级: config/_default/ 目录
    config = loadModularConfig('config/_default');
  } else {
    console.error('[ERROR] 未找到可用配置：缺少 config/user/ 或 config/_default/。');
    console.error('[ERROR] 本版本已不再支持旧版单文件配置（config.yml / config.yaml）。');
    console.error('[ERROR] 解决方法：使用模块化配置目录（建议从 config/_default/ 复制到 config/user/ 再修改）。');
    process.exit(1);
  }

  // 确保配置有默认值并通过验证
  config = ensureConfigDefaults(config);

  if (!validateConfig(config)) {
    // 移除警告日志，保留函数调用
  }

  // 准备渲染数据
  const renderData = prepareRenderData(config);

  return renderData;
}

// 生成导航菜单
function generateNavigation(navigation, config) {
    return navigation.map(nav => {
        // 根据页面ID获取对应的子菜单项（分类）
        let submenuItems = '';

        // 使用辅助函数获取子菜单数据
        const submenu = getSubmenuForNavItem(nav, config);

        // 如果存在子菜单，生成HTML
        if (submenu && Array.isArray(submenu)) {
            submenuItems = `
                <div class="submenu">
                    ${submenu.map(category => `
                        <a href="#${category.name}" class="submenu-item" data-page="${nav.id}" data-category="${category.name}">
                            <i class="${escapeHtml(category.icon)}"></i>
                            <span>${escapeHtml(category.name)}</span>
                        </a>
                    `).join('')}
                </div>`;
        }

        return `
                <div class="nav-item-wrapper">
                    <a href="#" class="nav-item${nav.active ? ' active' : ''}" data-page="${escapeHtml(nav.id)}">
                        <div class="icon-container">
                            <i class="${escapeHtml(nav.icon)}"></i>
                        </div>
                        <span class="nav-text">${escapeHtml(nav.name)}</span>
                        ${submenuItems ? '<i class="fas fa-chevron-down submenu-toggle"></i>' : ''}
                    </a>
                    ${submenuItems}
                </div>`;
    }).join('\n');
}

// 生成网站卡片HTML
function generateSiteCards(sites) {
    if (!sites || !Array.isArray(sites) || sites.length === 0) {
        return `<p class="empty-sites">暂无网站</p>`;
    }

    return sites.map(site => `
                        <a href="${escapeHtml(site.url)}" class="site-card" title="${escapeHtml(site.name)} - ${escapeHtml(site.description || '')}">
                            <i class="${escapeHtml(site.icon || 'fas fa-link')}"></i>
                            <h3>${escapeHtml(site.name || '未命名站点')}</h3>
                            <p>${escapeHtml(site.description || '')}</p>
                        </a>`).join('\n');
}

// 生成分类板块
function generateCategories(categories) {
    if (!categories || !Array.isArray(categories) || categories.length === 0) {
        return `
                <section class="category">
                    <h2><i class="fas fa-info-circle"></i> 暂无分类</h2>
                    <p>请在配置文件中添加分类</p>
                </section>`;
    }

    return categories.map(category => `
                <section class="category" id="${escapeHtml(category.name)}">
                    <h2><i class="${escapeHtml(category.icon)}"></i> ${escapeHtml(category.name)}</h2>
                    <div class="sites-grid">
                        ${generateSiteCards(category.sites)}
                    </div>
                </section>`).join('\n');
}

// 生成社交链接HTML
function generateSocialLinks(social) {
    if (!social || !Array.isArray(social) || social.length === 0) {
        return '';
    }

    // 尝试使用Handlebars模板
    try {
        const socialLinksPath = path.join(process.cwd(), 'templates', 'components', 'social-links.hbs');
        if (fs.existsSync(socialLinksPath)) {
            const templateContent = fs.readFileSync(socialLinksPath, 'utf8');
            const template = handlebars.compile(templateContent);
            // 确保数据格式正确
            return template(social); // 社交链接模板直接接收数组
        }
    } catch (error) {
        console.error('Error rendering social-links template:', error);
        // 出错时回退到原始生成方法
    }

    // 回退到原始生成方法
    return social.map(link => `
                    <a href="${escapeHtml(link.url)}" class="social-icon" target="_blank" rel="noopener" title="${escapeHtml(link.name || '社交链接')}" aria-label="${escapeHtml(link.name || '社交链接')}" data-type="social-link" data-name="${escapeHtml(link.name || '社交链接')}" data-url="${escapeHtml(link.url)}" data-icon="${escapeHtml(link.icon || 'fas fa-link')}">
                        <i class="${escapeHtml(link.icon || 'fas fa-link')}" aria-hidden="true"></i>
                        <span class="nav-text visually-hidden" data-editable="social-link-name">${escapeHtml(link.name || '社交链接')}</span>
                    </a>`).join('\n');
}

// 生成页面内容（包括首页和其他页面）
function generatePageContent(pageId, data) {
    // 确保数据对象存在
    if (!data) {
        console.error(`Missing data for page: ${pageId}`);
        return `
                <div class="welcome-section">
                    <div class="welcome-section-main">
                        <h2>页面未配置</h2>
                        <p class="subtitle">请配置 ${pageId} 页面</p>
                    </div>
                </div>`;
    }

    // 首页使用profile数据，其他页面使用自身数据
    if (pageId === 'home') {
        const profile = data.profile || {};

        return `
                <div class="welcome-section">
                    <div class="welcome-section-main">
                        <h2>${escapeHtml(profile.title || '欢迎使用')}</h2>
                        <h3>${escapeHtml(profile.subtitle || '个人导航站')}</h3>
                    </div>
                </div>
${generateCategories(data.categories)}`;
    } else {
        // 其他页面使用通用结构
        const title = data.title || `${pageId} 页面`;
        const subtitle = data.subtitle || '';
        const categories = data.categories || [];

        return `
                <div class="welcome-section">
                    <div class="welcome-section-main">
                        <h2>${escapeHtml(title)}</h2>
                        <p class="subtitle">${escapeHtml(subtitle)}</p>
                    </div>
                </div>
                ${generateCategories(categories)}`;
    }
}

// 生成搜索结果页面
function generateSearchResultsPage(config) {
    // 获取所有导航页面ID
    const pageIds = config.navigation.map(nav => nav.id);

    // 生成所有页面的搜索结果区域
    const searchSections = pageIds.map(pageId => {
        // 根据页面ID获取对应的图标和名称
        const navItem = config.navigation.find(nav => nav.id === pageId);
        const icon = navItem ? navItem.icon : 'fas fa-file';
        const name = navItem ? navItem.name : pageId;

        return `
                <section class="category search-section" data-section="${escapeHtml(pageId)}" style="display: none;">
                    <h2><i class="${escapeHtml(icon)}"></i> ${escapeHtml(name)}匹配项</h2>
                    <div class="sites-grid"></div>
                </section>`;
    }).join('\n');

    return `
            <!-- 搜索结果页 -->
            <div class="page" id="search-results">
                <div class="welcome-section">
                    <div class="welcome-section-main">
                        <h2>搜索结果</h2>
                        <p class="subtitle">在所有页面中找到的匹配项</p>
                    </div>
                </div>
${searchSections}
            </div>`;
}

/**
 * 将 CSS 文本安全嵌入到 <style> 中，避免出现 `</style>` 结束标签导致样式块被提前终止。
 * @param {string} cssText CSS 文本
 * @returns {string} 安全的 CSS 文本
 */
function makeCssSafeForHtmlStyleTag(cssText) {
  if (typeof cssText !== 'string') {
    return '';
  }

  return cssText.replace(/<\/style/gi, '<\\/style');
}

function normalizeFontWeight(input) {
  if (input === undefined || input === null) return 'normal';

  if (typeof input === 'number' && Number.isFinite(input)) {
    return String(input);
  }

  const raw = String(input).trim();
  if (!raw) return 'normal';

  if (/^(normal|bold|bolder|lighter)$/i.test(raw)) return raw.toLowerCase();
  if (/^[1-9]00$/.test(raw)) return raw;

  return raw;
}

function normalizeFontFamilyForCss(input) {
  const raw = String(input || '').trim();
  if (!raw) return '';

  const generics = new Set([
    'serif',
    'sans-serif',
    'monospace',
    'cursive',
    'fantasy',
    'system-ui',
    'ui-serif',
    'ui-sans-serif',
    'ui-monospace',
    'ui-rounded',
    'emoji',
    'math',
    'fangsong',
  ]);

  return raw
    .split(',')
    .map(part => part.trim())
    .filter(Boolean)
    .map(part => {
      const unquoted = part.replace(/^['"]|['"]$/g, '').trim();
      if (!unquoted) return '';
      if (generics.has(unquoted)) return unquoted;

      const needsQuotes = /\s/.test(unquoted);
      if (!needsQuotes) return unquoted;

      return `"${unquoted.replace(/"/g, '\\"')}"`;
    })
    .filter(Boolean)
    .join(', ');
}

function normalizeFontSource(input) {
  const raw = String(input || '').trim().toLowerCase();
  if (raw === 'css' || raw === 'google' || raw === 'system') return raw;
  return 'system';
}

function getNormalizedFontsConfig(config) {
  const fonts =
    config && config.fonts && typeof config.fonts === 'object' ? config.fonts : {};

  return {
    source: normalizeFontSource(fonts.source),
    family: normalizeFontFamilyForCss(fonts.family),
    weight: normalizeFontWeight(fonts.weight),
    cssUrl: String(fonts.cssUrl || fonts.href || '').trim(),
  };
}

// 生成字体相关 <link>（包含固定的首页特殊样式字体）
function generateFontLinks(config) {
  const fonts = getNormalizedFontsConfig(config);
  const links = [];

  // 首页特殊样式字体：固定为 Quicksand（不通过配置控制）
  links.push('<link rel="preconnect" href="https://fonts.googleapis.com">');
  links.push('<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>');
  links.push(
    '<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=Quicksand:wght@500&display=swap">'
  );

  // 全站基础字体：按配置加载
  if (fonts.source === 'css' && fonts.cssUrl) {
    links.push(
      `<link rel="stylesheet" href="${escapeHtml(fonts.cssUrl)}">`
    );
  }

  if (fonts.source === 'google' && fonts.family) {
    const familyNoQuotes = fonts.family.replace(/["']/g, '').split(',')[0].trim();
    const weight = /^[1-9]00$/.test(fonts.weight) ? fonts.weight : '400';
    const familyParam = encodeURIComponent(familyNoQuotes).replace(/%20/g, '+');
    links.push(
      `<link rel="stylesheet" href="https://fonts.googleapis.com/css2?family=${familyParam}:wght@${weight}&display=swap">`
    );
  }

  return links.join('\n');
}

// 生成字体 CSS 变量（单一字体配置）
function generateFontCss(config) {
  const fonts = getNormalizedFontsConfig(config);
  const family = fonts.family || 'system-ui, sans-serif';
  const weight = fonts.weight || 'normal';

  const css = `:root {\n  --font-body: ${family};\n  --font-weight-body: ${weight};\n}\n`;
  return makeCssSafeForHtmlStyleTag(css);
}

function normalizeGithubHeatmapColor(input) {
  const raw = String(input || '').trim().replace(/^#/, '');
  const color = raw.toLowerCase();
  if (/^[0-9a-f]{6}$/.test(color)) return color;
  if (/^[0-9a-f]{3}$/.test(color)) return color;
  return '339af0';
}

function getGithubUsernameFromConfig(config) {
  const username = config && config.site && config.site.github && config.site.github.username
    ? String(config.site.github.username).trim()
    : '';
  return username;
}

function buildProjectsMeta(config) {
  const username = getGithubUsernameFromConfig(config);
  if (!username) return null;

  const color = normalizeGithubHeatmapColor(
    config && config.site && config.site.github && config.site.github.heatmapColor
      ? config.site.github.heatmapColor
      : '339af0'
  );

  return {
    heatmap: {
      username,
      profileUrl: `https://github.com/${username}`,
      imageUrl: `https://ghchart.rshah.org/${color}/${username}`
    }
  };
}

/**
 * 渲染单个页面
 * @param {string} pageId 页面ID
 * @param {Object} config 配置数据
 * @returns {string} 渲染后的HTML
 */
function renderPage(pageId, config) {
  // 准备页面数据
  const data = {
    ...(config || {}),
    currentPage: pageId,
    pageId // 同时保留pageId字段，用于通用模板
  };

  // 确保navigation是数组
  if (!Array.isArray(config.navigation)) {
    console.warn('Warning: config.navigation is not an array in renderPage. Using empty array.');
    data.navigation = [];
  } else {
    // 设置当前页面为活动页，其他页面为非活动
    data.navigation = config.navigation.map(nav => {
      const navItem = {
        ...nav,
        isActive: nav.id === pageId,
        active: nav.id === pageId // 兼容原有逻辑
      };

      // 使用辅助函数获取子菜单
      const submenu = getSubmenuForNavItem(navItem, config);
      if (submenu) {
        navItem.submenu = submenu;
      }

      return navItem;
    });
  }

  // 确保socialLinks字段存在
  data.socialLinks = Array.isArray(config.social) ? config.social : [];

  // 确保navigationData可用（针对模板使用）
  data.navigationData = data.navigation;

  // 页面特定的额外数据
  if (config[pageId]) {
    // 使用已经经过ensureConfigDefaults处理的配置数据
    Object.assign(data, config[pageId]);
  }

  // 页面配置缺失时也尽量给出可用的默认值，避免渲染空标题/undefined
  if (data.title === undefined) {
    const navItem = Array.isArray(config.navigation) ? config.navigation.find(nav => nav.id === pageId) : null;
    if (navItem && navItem.name !== undefined) data.title = navItem.name;
  }
  if (data.subtitle === undefined) data.subtitle = '';
  if (!Array.isArray(data.categories)) data.categories = [];

  // 检查页面配置中是否指定了模板（用于派生字段与渲染）
  const explicitTemplate = typeof data.template === 'string' ? data.template.trim() : '';
  let templateName = explicitTemplate || pageId;
  // 未显式指定模板时：若 pages/<pageId>.hbs 不存在，则默认使用通用 page 模板（避免依赖回退日志）
  if (!explicitTemplate) {
    const inferredTemplatePath = path.join(process.cwd(), 'templates', 'pages', `${templateName}.hbs`);
    if (!fs.existsSync(inferredTemplatePath)) {
      templateName = 'page';
    }
  }

  // 页面级卡片风格开关（用于差异化）
  if (templateName === 'projects') {
    data.siteCardStyle = 'repo';
    data.projectsMeta = buildProjectsMeta(config);
    if (Array.isArray(data.categories)) {
      const repoCache = tryLoadProjectsRepoCache(pageId, config);
      if (repoCache && repoCache.map) {
        applyRepoMetaToCategories(data.categories, repoCache.map);
      }
    }
  }

  // friends/articles：允许顶层 sites（历史/兼容），自动转换为一个分类容器以保持页面结构一致
  // 注意：模板名可能被统一为 page（例如 friends/home 取消专属模板后），因此这里同时按 pageId 判断。
  const isFriendsPage = pageId === 'friends' || templateName === 'friends';
  const isArticlesPage = pageId === 'articles' || templateName === 'articles';
  if ((isFriendsPage || isArticlesPage)
    && (!Array.isArray(data.categories) || data.categories.length === 0)
    && Array.isArray(data.sites)
    && data.sites.length > 0) {
    const implicitName = isFriendsPage ? '全部友链' : '全部来源';
    data.categories = [
      {
        name: implicitName,
        icon: 'fas fa-link',
        sites: data.sites
      }
    ];
  }

  // articles 模板页面：Phase 2 若存在 RSS 缓存，则注入 articlesItems（缓存缺失/损坏则回退 Phase 1）
  if (templateName === 'articles') {
    const cache = tryLoadArticlesFeedCache(pageId, config);
    data.articlesItems = cache && Array.isArray(cache.items) ? cache.items : [];
    data.articlesMeta = cache ? cache.meta : null;
    // Phase 2：按页面配置分类聚合展示（用于模板渲染只读文章列表）
    data.articlesCategories = data.articlesItems.length
      ? buildArticlesCategoriesByPageCategories(data.categories, data.articlesItems)
      : [];
  }

  // bookmarks 模板页面：注入配置文件“内容更新时间”（优先 git，回退 mtime）
  if (templateName === 'bookmarks') {
    const updatedAtMeta = getPageConfigUpdatedAtMeta(pageId);
    if (updatedAtMeta) {
      data.pageMeta = { ...updatedAtMeta };
    }
  }

  // 首页标题规则：使用 site.yml 的 profile 覆盖首页（导航第一项）的 title/subtitle 显示
  const homePageId = config.homePageId
    || (Array.isArray(config.navigation) && config.navigation[0] ? config.navigation[0].id : null)
    || 'home';
  // 供模板判断“当前是否首页”
  data.homePageId = homePageId;
  if (pageId === homePageId && config.profile) {
    if (config.profile.title !== undefined) data.title = config.profile.title;
    if (config.profile.subtitle !== undefined) data.subtitle = config.profile.subtitle;
  }

  if (config[pageId] && config[pageId].template) {
    console.log(`页面 ${pageId} 使用指定模板: ${templateName}`);
  }

  // 直接渲染页面内容，不使用layout布局（因为layout会在generateHTML中统一应用）
  return renderTemplate(templateName, data, false);
}

/**
 * 生成所有页面的HTML内容
 * @param {Object} config 配置对象
 * @returns {Object} 包含所有页面HTML的对象
 */
function generateAllPagesHTML(config) {
  // 页面内容集合
  const pages = {};

  // 渲染配置中定义的所有页面
  if (Array.isArray(config.navigation)) {
    config.navigation.forEach(navItem => {
      const pageId = navItem.id;

      // 渲染页面内容
      pages[pageId] = renderPage(pageId, config);
    });
  }

  // 确保搜索结果页存在
  if (!pages['search-results']) {
    pages['search-results'] = renderPage('search-results', config);
  }

  return pages;
}

/**
 * 生成完整的HTML
 * @param {Object} config 配置对象
 * @returns {string} 完整HTML
 */
function generateHTML(config) {
  // 获取所有页面内容
  const pages = generateAllPagesHTML(config);

  // 获取当前年份
  const currentYear = new Date().getFullYear();

  // 准备导航数据，添加submenu字段
  const navigationData = config.navigation.map(nav => {
    const navItem = { ...nav };

    // 使用辅助函数获取子菜单
    const submenu = getSubmenuForNavItem(navItem, config);
    if (submenu) {
      navItem.submenu = submenu;
    }

    return navItem;
  });

  // 准备字体链接与 CSS 变量
  const fontLinks = generateFontLinks(config);
  const fontCss = generateFontCss(config);

  // 准备社交链接
  const socialLinks = generateSocialLinks(config.social);

  // 使用主布局模板
  const layoutData = {
    ...config,
    pages,
    fontLinks,
    fontCss,
    navigationData,
    currentYear,
    socialLinks,
    navigation: generateNavigation(config.navigation, config), // 兼容旧版
    social: Array.isArray(config.social) ? config.social : [], // 兼容旧版

    // 确保配置数据可用于浏览器扩展
    configJSON: config.configJSON // 从prepareRenderData函数中获取的配置数据
  };

  try {
    // 使用辅助函数获取默认布局模板
    const { template: layoutTemplate } = getDefaultLayoutTemplate();

    // 渲染模板
    return layoutTemplate(layoutData);
  } catch (error) {
    console.error('Error rendering main HTML template:', error);
    throw error;
  }
}

// 复制静态文件
function copyStaticFiles(config) {
    // 确保dist目录存在
    if (!fs.existsSync('dist')) {
        fs.mkdirSync('dist', { recursive: true });
    }

    // 复制CSS文件
    try {
        fs.copyFileSync('assets/style.css', 'dist/style.css');
    } catch (e) {
        console.error('Error copying style.css:', e);
    }

    try {
      fs.copyFileSync('assets/pinyin-match.js', 'dist/pinyin-match.js');
    } catch (e) {
      console.error('Error copying pinyin-match.js:', e);
    }
  
    // 复制JavaScript文件
    try {
        fs.copyFileSync('src/script.js', 'dist/script.js');
    } catch (e) {
        console.error('Error copying script.js:', e);
    }

    // 如果配置了favicon，确保文件存在并复制
    if (config.site.favicon) {
        try {
            if (fs.existsSync(`assets/${config.site.favicon}`)) {
                fs.copyFileSync(`assets/${config.site.favicon}`, `dist/${path.basename(config.site.favicon)}`);
            } else if (fs.existsSync(config.site.favicon)) {
                fs.copyFileSync(config.site.favicon, `dist/${path.basename(config.site.favicon)}`);
            } else {
                console.warn(`Warning: Favicon file not found: ${config.site.favicon}`);
            }
        } catch (e) {
            console.error('Error copying favicon:', e);
        }
    }
}

// 主函数
function main() {
    const config = loadConfig();

    try {
        // 确保dist目录存在
        if (!fs.existsSync('dist')) {
            fs.mkdirSync('dist', { recursive: true });
        }

        // 初始化Handlebars模板系统
        loadHandlebarsTemplates();

        // 使用generateHTML函数生成完整的HTML
        const htmlContent = generateHTML(config);

        // 生成HTML
        fs.writeFileSync('dist/index.html', htmlContent);

        // 复制静态文件
        copyStaticFiles(config);
    } catch (e) {
        console.error('Error in main function:', e);
        process.exit(1);
    }
}

if (require.main === module) {
    main();
}

// 导出供测试使用的函数
module.exports = {
  loadConfig,
  generateHTML,
  copyStaticFiles,
  generateNavigation,
  generateCategories,
  loadHandlebarsTemplates,
  renderTemplate,
  generateAllPagesHTML
};