czon 0.8.4 → 0.8.6

package/dist/ai/extractMetadataFromMarkdown.js

@@ -21,7 +21,7 @@ async function extractMetadataFromMarkdown(filePath, content) {
         'summary: 文档中型摘要（用一段话总结文章，包含关键论点和结论，控制在 300 字以内），用于 邮件推送内容，newsletter 介绍',
         'inferred_date: 文档中隐含的创建日期（如果有的话，格式：YYYY-MM-DD，没有就留空字符串）',
         'inferred_lang: 文档使用的语言代码（例如：zh-Hans 表示简体中文，en-US 表示美式英语）',
-        'key_points: 文章的关键要点列表（5-10 个要点，简洁明了）',
+        'key_points: 文章的关键要点列表（最重要的 3-5 个要点，简洁明了）',
         'audience: 目标读者描述（简短描述，50 字以内）',
         'short_summary: 文档的超短摘要（用 2-3 句话概括文章主要内容，突出核心观点），用于文章列表页摘要，RSS feed 描述',
         ...(hasExistingSlug

package/dist/build/pipeline.js

@@ -40,6 +40,8 @@ const metadata_1 = require("../metadata");
 const paths_1 = require("../paths");
 const category_1 = require("../process/category");
 const translateCategories_1 = require("../process/translateCategories");
+const translateMetadata_1 = require("../process/translateMetadata");
+const translateNavLinks_1 = require("../process/translateNavLinks");
 const enhanceMarkdownSource_1 = require("../process/enhanceMarkdownSource");
 const extractMetadataByAI_1 = require("../process/extractMetadataByAI");
 const processTranslations_1 = require("../process/processTranslations");
@@ -102,10 +104,14 @@ async function buildPipeline(options) {
     }
     // 运行 AI 元数据提取
     await (0, extractMetadataByAI_1.extractMetadataByAI)();
+    // 翻译 AI 提取的 metadata JSON
+    await (0, translateMetadata_1.processTranslateMetadata)();
     // 提取分类信息
     await (0, category_1.processExtractCategory)();
     // 翻译分类
     await (0, translateCategories_1.processTranslateCategories)();
+    // 翻译 navLinks
+    await (0, translateNavLinks_1.processTranslateNavLinks)();
     // 存储母语文件，并进行内容增强预处理
     await (0, enhanceMarkdownSource_1.storeNativeFiles)();
     // 处理翻译

package/dist/process/enhanceMarkdownSource.js

@@ -8,10 +8,10 @@ const promises_1 = require("fs/promises");
 const path_1 = __importDefault(require("path"));
 const metadata_1 = require("../metadata");
 const paths_1 = require("../paths");
-const frontmatter_1 = require("../utils/frontmatter");
 const writeFile_1 = require("../utils/writeFile");
 /**
  * 存储母语文件到 .czon/src
+ * 直接复制原始文件，metadata 从 meta.json 获取
  */
 async function storeNativeFiles() {
     const { files } = metadata_1.MetaData;
@@ -25,16 +25,7 @@ async function storeNativeFiles() {
                 throw new Error(`Missing inferred language`);
             const filePath = path_1.default.join(paths_1.CZON_SRC_DIR, file.metadata.inferred_lang, file.path);
             const originalContent = await (0, promises_1.readFile)(path_1.default.join(paths_1.INPUT_DIR, file.path), 'utf-8');
-            // 增强 YAML Frontmatter
-            const enhancedContent = (0, frontmatter_1.updateFrontmatter)(originalContent, {
-                title: file.metadata.title,
-                summary: file.metadata.summary,
-                tags: file.metadata.tags,
-                date: file.metadata.inferred_date,
-            });
-            // 进行内链接替换, 将相对链接替换为基于 czon://hash 的链接
-            // const replacedContent = replaceInnerLinks(file, enhancedContent);
-            await (0, writeFile_1.writeFile)(filePath, enhancedContent);
+            await (0, writeFile_1.writeFile)(filePath, originalContent);
         }
         catch (error) {
             console.warn(`⚠️ Failed to store native file ${file.path}:`, error);

package/dist/process/template.js

@@ -102,12 +102,11 @@ const spiderStaticSiteGenerator = async () => {
             continue;
         for (const lang of metadata_1.MetaData.options.langs || []) {
             const markdown = await fs.readFile(path.join(paths_1.CZON_SRC_DIR, lang, file.path), 'utf-8');
-            const { frontmatter, body } = (0, frontmatter_1.parseFrontmatter)(markdown);
+            const body = (0, frontmatter_1.stripFrontmatter)(markdown);
             const article = {
                 lang,
                 file,
                 body: '',
-                frontmatter,
                 headings: [],
             };
             (0, convertMarkdownToHtml_1.convertMarkdownToHtml)(article, file.path, lang, body);

package/dist/process/translateMetadata.js

@@ -0,0 +1,172 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processTranslateMetadata = processTranslateMetadata;
+const metadata_1 = require("../metadata");
+const openai_1 = require("../services/openai");
+const languages_1 = require("../languages");
+const sha256_1 = require("../utils/sha256");
+/**
+ * 计算 metadata 中需要翻译字段的哈希值
+ * 用于增量检测
+ */
+function computeTranslatableFieldsHash(metadata) {
+    const translatableFields = {
+        title: metadata.title,
+        description: metadata.description,
+        summary: metadata.summary,
+        short_summary: metadata.short_summary,
+        key_points: metadata.key_points,
+        audience: metadata.audience,
+        tags: metadata.tags,
+    };
+    return (0, sha256_1.sha256)(JSON.stringify(translatableFields));
+}
+/**
+ * 检查单个文件的单个语言是否需要翻译
+ */
+function needsTranslationForLang(file, lang) {
+    if (!file.metadata)
+        return false;
+    // 没有该语言的翻译 -> 需要翻译
+    if (!file.metadataTranslations?.[lang])
+        return true;
+    // hash 变化 -> 源 metadata 已更新，需要重新翻译
+    const currentHash = computeTranslatableFieldsHash(file.metadata);
+    return file.metadataTranslationHash !== currentHash;
+}
+/**
+ * 翻译单个文件的 metadata 到单个目标语言
+ */
+async function translateFileMetadataToLang(file, targetLang) {
+    const { metadata } = file;
+    if (!metadata)
+        return;
+    // 提取需要翻译的字段
+    const sourceMetadata = {
+        title: metadata.title,
+        description: metadata.description,
+        summary: metadata.summary,
+        short_summary: metadata.short_summary,
+        key_points: metadata.key_points,
+        audience: metadata.audience,
+        tags: metadata.tags,
+    };
+    const sourceLangName = languages_1.LANGUAGE_NAMES[metadata.inferred_lang] || metadata.inferred_lang;
+    const targetLangName = languages_1.LANGUAGE_NAMES[targetLang] || targetLang;
+    const response = await (0, openai_1.completeMessages)([
+        {
+            role: 'system',
+            content: [
+                '你是专业的多语言翻译助手，擅长准确翻译技术文档的元数据。',
+                '',
+                '任务：将给定的 metadata JSON 翻译成目标语言。',
+                '',
+                '要求：',
+                '1. 保持 JSON 结构完全不变，只翻译文本内容',
+                '2. title 翻译要简洁明了，不超过 30 个字',
+                '3. description 和 summary 翻译要准确传达原意',
+                '4. tags 翻译要符合目标语言的常用术语',
+                '5. key_points 数组中的每个要点都需要翻译',
+                '6. 技术术语保持准确，必要时可保留原文',
+                '',
+                '直接返回翻译后的 JSON 对象，格式如下：',
+                '{',
+                '  "title": "...",',
+                '  "description": "...",',
+                '  "summary": "...",',
+                '  "short_summary": "...",',
+                '  "key_points": ["...", "..."],',
+                '  "audience": "...",',
+                '  "tags": ["...", "..."]',
+                '}',
+            ].join('\n'),
+        },
+        {
+            role: 'user',
+            content: [
+                `源语言: ${metadata.inferred_lang} (${sourceLangName})`,
+                `目标语言: ${targetLang} (${targetLangName})`,
+                '',
+                '待翻译的 metadata:',
+                JSON.stringify(sourceMetadata, null, 2),
+            ].join('\n'),
+        },
+    ], {
+        response_format: { type: 'json_object' },
+        task_id: `translate-metadata:${file.path}:${targetLang}`,
+    });
+    const translated = JSON.parse(response.choices[0].message.content);
+    // 初始化存储结构
+    if (!file.metadataTranslations) {
+        file.metadataTranslations = {};
+    }
+    // 验证并存储翻译结果
+    if (translated && translated.title) {
+        file.metadataTranslations[targetLang] = {
+            title: translated.title?.trim() || '',
+            description: translated.description?.trim() || '',
+            summary: translated.summary?.trim() || '',
+            short_summary: translated.short_summary?.trim() || '',
+            key_points: Array.isArray(translated.key_points)
+                ? translated.key_points.map((p) => p?.trim()).filter(Boolean)
+                : [],
+            audience: translated.audience?.trim() || '',
+            tags: Array.isArray(translated.tags)
+                ? translated.tags.map((t) => t?.trim()).filter(Boolean)
+                : [],
+        };
+    }
+}
+/**
+ * 处理所有文件的 metadata 翻译
+ * 采用逐文件逐语言的翻译策略，避免输出 JSON 过长被截断
+ */
+async function processTranslateMetadata() {
+    const langs = metadata_1.MetaData.options.langs || [];
+    if (langs.length === 0) {
+        console.info('ℹ️ No target languages configured, skipping metadata translation.');
+        return;
+    }
+    // 收集所有需要翻译的任务 (file, lang) 组合
+    const tasks = [];
+    for (const file of metadata_1.MetaData.files) {
+        if (!file.path.endsWith('.md') || !file.metadata)
+            continue;
+        for (const lang of langs) {
+            if (needsTranslationForLang(file, lang)) {
+                tasks.push({ file, lang });
+            }
+        }
+    }
+    if (tasks.length === 0) {
+        console.info('ℹ️ All metadata already translated, skipping.');
+        return;
+    }
+    const fileCount = new Set(tasks.map(t => t.file.path)).size;
+    console.info(`🌐 Translating metadata: ${tasks.length} tasks (${fileCount} files × up to ${langs.length} languages)...`);
+    // 并行执行所有翻译任务
+    const results = await Promise.allSettled(tasks.map(async ({ file, lang }) => {
+        await translateFileMetadataToLang(file, lang);
+        console.info(`✅ Translated metadata: ${file.path} -> ${lang}`);
+    }));
+    // 统计结果
+    const succeeded = results.filter(r => r.status === 'fulfilled').length;
+    const failed = results.filter(r => r.status === 'rejected').length;
+    if (failed > 0) {
+        console.warn(`⚠️ ${failed} translation tasks failed:`);
+        results.forEach((r, i) => {
+            if (r.status === 'rejected') {
+                console.error(`  ❌ ${tasks[i].file.path} -> ${tasks[i].lang}:`, r.reason?.message || r.reason);
+            }
+        });
+    }
+    // 更新所有成功翻译文件的 hash
+    const translatedFiles = new Set(tasks.filter((_, i) => results[i].status === 'fulfilled').map(t => t.file));
+    for (const file of translatedFiles) {
+        if (file.metadata) {
+            file.metadataTranslationHash = computeTranslatableFieldsHash(file.metadata);
+        }
+    }
+    console.info(`✅ Metadata translation completed: ${succeeded}/${tasks.length} succeeded`);
+}
+//# sourceMappingURL=translateMetadata.js.map

package/dist/process/translateNavLinks.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.processTranslateNavLinks = void 0;
+const metadata_1 = require("../metadata");
+const openai_1 = require("../services/openai");
+const processTranslateNavLinks = async () => {
+    const langs = metadata_1.MetaData.options.langs || [];
+    const navLinks = metadata_1.MetaData.options.site?.navLinks || [];
+    if (langs.length === 0 || navLinks.length === 0) {
+        console.info('ℹ️ No languages or navLinks configured, skipping navLink translation.');
+        return;
+    }
+    if (!metadata_1.MetaData.navLinkTranslations) {
+        metadata_1.MetaData.navLinkTranslations = {};
+    }
+    const allTitles = navLinks.map(link => link.title);
+    const titlesNeedingTranslation = allTitles.filter(title => {
+        const translations = metadata_1.MetaData.navLinkTranslations[title];
+        return !translations || langs.some(lang => !translations[lang]);
+    });
+    if (titlesNeedingTranslation.length === 0) {
+        console.info('ℹ️ All navLink titles already have translations, skipping.');
+        return;
+    }
+    console.info(`🌐 Translating ${titlesNeedingTranslation.length} navLink titles...`);
+    const response = await (0, openai_1.completeMessages)([
+        {
+            role: 'system',
+            content: [
+                '你是一个专业的翻译助手。',
+                '请将给定的导航链接标题翻译成指定的目标语言。',
+                '翻译应该自然、准确，符合目标语言的表达习惯。',
+                '导航链接标题通常是简短的词语，翻译时保持简洁。',
+                '',
+                '请以 JSON 格式返回，格式如下：',
+                '{',
+                '  "translations": {',
+                '    "原标题": { "zh-Hans": "中文翻译", "en-US": "English" }',
+                '  }',
+                '}',
+            ].join('\n'),
+        },
+        {
+            role: 'user',
+            content: [
+                `需要翻译的导航链接标题: ${JSON.stringify(titlesNeedingTranslation)}`,
+                `目标语言: ${JSON.stringify(langs)}`,
+            ].join('\n'),
+        },
+    ], { response_format: { type: 'json_object' }, task_id: 'translate-nav-links' });
+    const json = response.choices[0].message.content;
+    const parsed = JSON.parse(json);
+    if (parsed.translations) {
+        for (const [title, translations] of Object.entries(parsed.translations)) {
+            if (!metadata_1.MetaData.navLinkTranslations[title]) {
+                metadata_1.MetaData.navLinkTranslations[title] = {};
+            }
+            for (const [lang, translation] of Object.entries(translations)) {
+                metadata_1.MetaData.navLinkTranslations[title][lang] = translation;
+            }
+        }
+    }
+    const stillMissingTranslation = allTitles.filter(title => {
+        const translations = metadata_1.MetaData.navLinkTranslations[title];
+        return !translations || langs.some(lang => !translations[lang]);
+    });
+    if (stillMissingTranslation.length > 0) {
+        const details = stillMissingTranslation.map(title => {
+            const missing = langs.filter(lang => !metadata_1.MetaData.navLinkTranslations[title]?.[lang]);
+            return `  - "${title}": 缺少 ${missing.join(', ')}`;
+        });
+        console.error(`❌ 以下 navLink 标题缺少翻译:\n${details.join('\n')}`);
+        console.error('这是一个可重试的错误，请重新运行命令。');
+        process.exit(1);
+    }
+    console.info('✅ NavLink translations completed.');
+};
+exports.processTranslateNavLinks = processTranslateNavLinks;
+//# sourceMappingURL=translateNavLinks.js.map

package/dist/ssg/ContentPage.js

@@ -15,12 +15,13 @@ const Navigator_1 = require("./components/Navigator");
 const PageLayout_1 = require("./layouts/PageLayout");
 const resourceMap_1 = require("./resourceMap");
 const style_1 = require("./style");
+const getLocalizedMetadata_1 = require("./utils/getLocalizedMetadata");
 const ContentPage = props => {
-    const frontmatter = props.content.frontmatter || {};
-    const title = frontmatter.title;
-    const summary = frontmatter.summary;
-    const date = frontmatter.date || '--';
-    const tags = frontmatter.tags || [];
+    const metadata = (0, getLocalizedMetadata_1.getLocalizedMetadata)(props.file, props.lang);
+    const title = metadata?.title || '(no title)';
+    const summary = metadata?.summary || '';
+    const date = props.file.metadata?.inferred_date || '--';
+    const tags = metadata?.tags || [];
     const category = props.file.category;
     const relatedContents = props.ctx.site.files.filter(f => f.category === category && f.path !== props.file.path);
     // 查找指向当前文章的其他文章
@@ -34,7 +35,10 @@ const ContentPage = props => {
             react_1.default.createElement("meta", { name: "viewport", content: "width=device-width, initial-scale=1.0" }),
             react_1.default.createElement("title", null, title),
             react_1.default.createElement("link", { rel: "icon", href: faviconUrl, type: "image/x-icon" }),
-            react_1.default.createElement("meta", { name: "description", content: `tags: ${tags.join(', ')}` }),
+            // 使用 short_summary 作为 description，有利于 SEO 和社交分享预览
+            metadata?.short_summary && (react_1.default.createElement("meta", { name: "description", content: metadata?.short_summary.slice(0, 150) })),
+            // Keywords meta tag for SEO (using tags, if available)
+            tags.length > 0 && react_1.default.createElement("meta", { name: "keywords", content: tags.join(', ') }),
             react_1.default.createElement(Analytics_1.Analytics, { ctx: props.ctx }),
             react_1.default.createElement("script", { src: (0, resourceMap_1.getResourceUrlFrom)(props.ctx.path, 'tailwindcss.js') }),
             react_1.default.createElement("style", null, style_1.style),
@@ -69,16 +73,16 @@ const ContentPage = props => {
                         relatedContents.length > 0 && (react_1.default.createElement(react_1.default.Fragment, null,
                             react_1.default.createElement("h2", null, "See Also"),
                             react_1.default.createElement("ul", null, relatedContents.map(f => {
-                                const theContent = props.ctx.contents.find(c => c.lang === props.lang && c.file === f);
+                                const theMetadata = (0, getLocalizedMetadata_1.getLocalizedMetadata)(f, props.lang);
                                 return (react_1.default.createElement("li", { key: f.path },
-                                    react_1.default.createElement("a", { href: `${f.metadata?.slug}.html` }, theContent?.frontmatter.title)));
+                                    react_1.default.createElement("a", { href: `${f.metadata?.slug}.html` }, theMetadata?.title || '(no title)')));
                             })))),
                         referencedFiles.length > 0 && (react_1.default.createElement(react_1.default.Fragment, null,
                             react_1.default.createElement("h2", null, "Referenced By"),
                             react_1.default.createElement("ul", null, referencedFiles.map(f => {
-                                const theContent = props.ctx.contents.find(c => c.lang === props.lang && c.file === f);
+                                const theMetadata = (0, getLocalizedMetadata_1.getLocalizedMetadata)(f, props.lang);
                                 return (react_1.default.createElement("li", { key: f.path },
-                                    react_1.default.createElement("a", { href: `${f.metadata?.slug}.html` }, theContent?.frontmatter.title)));
+                                    react_1.default.createElement("a", { href: `${f.metadata?.slug}.html` }, theMetadata?.title || '(no title)')));
                             }))))),
                     react_1.default.createElement("footer", { className: "footer" },
                         react_1.default.createElement(LanguageSwitcher_1.LanguageSwitcher, { ctx: props.ctx, lang: props.lang, file: props.file }),

package/dist/ssg/components/CZONHeader.js

@@ -14,10 +14,10 @@ const CZONHeader = props => {
     const home = props.ctx.site.options.site?.home ?? 'index.html';
     return (react_1.default.createElement("header", { className: "czon-header py-4 border-b flex justify-between items-center px-6" },
         react_1.default.createElement("div", { className: "flex items-center gap-4" },
-            hasNavLinks && react_1.default.createElement(NavLinks_1.NavLinksMobile, { navLinks: navLinks }),
+            hasNavLinks && (react_1.default.createElement(NavLinks_1.NavLinksMobile, { navLinks: navLinks, site: props.ctx.site, lang: props.lang })),
             react_1.default.createElement("h1", { className: "text-2xl font-bold" },
                 react_1.default.createElement("a", { href: home }, props.ctx.site.options.site?.title ?? 'CZON')),
-            hasNavLinks && react_1.default.createElement(NavLinks_1.NavLinksDesktop, { navLinks: navLinks })),
+            hasNavLinks && (react_1.default.createElement(NavLinks_1.NavLinksDesktop, { navLinks: navLinks, site: props.ctx.site, lang: props.lang }))),
         react_1.default.createElement("div", { className: "flex items-center gap-4" },
             react_1.default.createElement(DarkModeSwitch_1.DarkModeSwitch, null),
             props.lang && react_1.default.createElement(LanguageSwitch_1.LanguageSwitch, { ctx: props.ctx, lang: props.lang, file: props.file }))));

package/dist/ssg/components/ContentMeta.js

@@ -6,21 +6,29 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ContentMeta = void 0;
 const react_1 = __importDefault(require("react"));
 const getCategoryDisplayName_1 = require("../utils/getCategoryDisplayName");
+const getLocalizedMetadata_1 = require("../utils/getLocalizedMetadata");
 const TagList_1 = require("./TagList");
 const ContentMeta = props => {
-    const content = props.ctx.contents.find(c => c.file === props.file && c.lang === props.lang);
-    const frontmatter = content?.frontmatter || {};
-    const title = frontmatter.title;
-    const summary = frontmatter.summary;
-    const date = frontmatter.date || '--';
-    const tags = frontmatter.tags || [];
+    const metadata = (0, getLocalizedMetadata_1.getLocalizedMetadata)(props.file, props.lang);
+    const title = metadata?.title || '(no title)';
+    const summary = metadata?.summary || '';
+    const audience = metadata?.audience || '';
+    const keyPoints = metadata?.key_points || [];
+    const date = props.file.metadata?.inferred_date || '--';
+    const tags = metadata?.tags || [];
     const category = props.file.category;
     return (react_1.default.createElement("header", { className: "content-header mb-4 pb-2 border-b" },
         react_1.default.createElement("h2", { className: "text-2xl font-bold mb-2" },
             react_1.default.createElement("a", { href: `${props.file.metadata?.slug}.html` }, title)),
-        react_1.default.createElement("p", { className: "font-semibold" }, (0, getCategoryDisplayName_1.getCategoryDisplayName)(props.ctx.site, category, props.lang)),
+        react_1.default.createElement("p", { className: "font-semibold mb-2" }, (0, getCategoryDisplayName_1.getCategoryDisplayName)(props.ctx.site, category, props.lang)),
+        audience && react_1.default.createElement("div", null,
+            "\uD83D\uDC64 ",
+            audience),
         react_1.default.createElement("blockquote", null, summary),
-        react_1.default.createElement("div", null,
+        keyPoints.length > 0 && (react_1.default.createElement("ul", { className: "key-points list-inside my-2" }, keyPoints.slice(0, 5).map((point, index) => (react_1.default.createElement("li", { key: index },
+            "\u2728 ",
+            point))))),
+        date && date !== '--' && react_1.default.createElement("div", null,
             "\uD83D\uDCC5 ",
             date),
         react_1.default.createElement("div", { className: "tags" },

package/dist/ssg/components/NavLinks.js

@@ -5,6 +5,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NavLinksDesktop = exports.NavLinksMobile = void 0;
 const react_1 = __importDefault(require("react"));
+const getNavLinkDisplayTitle_1 = require("../utils/getNavLinkDisplayTitle");
 const mobileStyle = `
 /* Mobile hamburger menu styles */
 .nav-links-mobile {
@@ -233,7 +234,7 @@ const desktopStyle = `
  * 移动端汉堡菜单导航组件
  * 仅在移动端显示（< 768px）
  */
-const NavLinksMobile = ({ navLinks }) => {
+const NavLinksMobile = ({ navLinks, site, lang }) => {
     if (!navLinks || navLinks.length === 0) {
         return null;
     }
@@ -246,7 +247,7 @@ const NavLinksMobile = ({ navLinks }) => {
                 react_1.default.createElement("span", null),
                 react_1.default.createElement("span", null))),
         react_1.default.createElement("div", { className: "nav-links-dropdown", role: "menu", "aria-label": "Navigation links" },
-            react_1.default.createElement("div", { className: "nav-links-dropdown-list" }, navLinks.map((link, index) => (react_1.default.createElement("a", { key: index, href: link.href, className: "nav-link-mobile-item", role: "menuitem" }, link.title)))))));
+            react_1.default.createElement("div", { className: "nav-links-dropdown-list" }, navLinks.map((link, index) => (react_1.default.createElement("a", { key: index, href: link.href, className: "nav-link-mobile-item", role: "menuitem" }, (0, getNavLinkDisplayTitle_1.getNavLinkDisplayTitle)(site, link.title, lang || ''))))))));
 };
 exports.NavLinksMobile = NavLinksMobile;
 /**
@@ -259,7 +260,7 @@ const MAX_VISIBLE_LINKS = 5;
  * 桌面端导航组件
  * 仅在桌面端显示（>= 768px），最大宽度 40vw
  */
-const NavLinksDesktop = ({ navLinks }) => {
+const NavLinksDesktop = ({ navLinks, site, lang }) => {
     if (!navLinks || navLinks.length === 0) {
         return null;
     }
@@ -268,7 +269,7 @@ const NavLinksDesktop = ({ navLinks }) => {
     const hasOverflow = overflowLinks.length > 0;
     return (react_1.default.createElement("nav", { className: "nav-links-desktop", "aria-label": "Main navigation" },
         react_1.default.createElement("style", null, desktopStyle),
-        react_1.default.createElement("div", { className: "nav-links-desktop-list" }, visibleLinks.map((link, index) => (react_1.default.createElement("a", { key: index, href: link.href, className: "nav-link-item" }, link.title)))),
+        react_1.default.createElement("div", { className: "nav-links-desktop-list" }, visibleLinks.map((link, index) => (react_1.default.createElement("a", { key: index, href: link.href, className: "nav-link-item" }, (0, getNavLinkDisplayTitle_1.getNavLinkDisplayTitle)(site, link.title, lang || ''))))),
         hasOverflow && (react_1.default.createElement("div", { className: "nav-links-more-container" },
             react_1.default.createElement("input", { id: "nav-links-more-toggle", type: "checkbox", className: "hidden", "aria-hidden": "true" }),
             react_1.default.createElement("label", { htmlFor: "nav-links-more-toggle", className: "nav-links-more-trigger", "aria-label": "More navigation links", "aria-haspopup": "true", "aria-expanded": "false" },
@@ -276,7 +277,7 @@ const NavLinksDesktop = ({ navLinks }) => {
                 react_1.default.createElement("svg", { className: "nav-links-more-icon", fill: "none", stroke: "currentColor", viewBox: "0 0 24 24", "aria-hidden": "true" },
                     react_1.default.createElement("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M19 9l-7 7-7-7" }))),
             react_1.default.createElement("div", { className: "nav-links-more-dropdown", role: "menu", "aria-label": "Additional navigation links" },
-                react_1.default.createElement("div", { className: "nav-links-more-list" }, overflowLinks.map((link, index) => (react_1.default.createElement("a", { key: index, href: link.href, className: "nav-link-more-item", role: "menuitem" }, link.title)))))))));
+                react_1.default.createElement("div", { className: "nav-links-more-list" }, overflowLinks.map((link, index) => (react_1.default.createElement("a", { key: index, href: link.href, className: "nav-link-more-item", role: "menuitem" }, (0, getNavLinkDisplayTitle_1.getNavLinkDisplayTitle)(site, link.title, lang || ''))))))))));
 };
 exports.NavLinksDesktop = NavLinksDesktop;
 //# sourceMappingURL=NavLinks.js.map

package/dist/ssg/components/Navigator.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Navigator = void 0;
 const react_1 = __importDefault(require("react"));
 const getCategoryDisplayName_1 = require("../utils/getCategoryDisplayName");
+const getLocalizedMetadata_1 = require("../utils/getLocalizedMetadata");
 const sortBy_1 = require("../../utils/sortBy");
 const Navigator = props => {
     const categories = [...new Set(props.ctx.site.files.map(f => f.category))];
@@ -24,8 +25,8 @@ const Navigator = props => {
             filesInCategory.map(file => {
                 const link = file.metadata.slug + '.html';
                 const isActive = props.file === file;
-                const theContent = props.ctx.contents.find(c => c.lang === props.lang && c.file === file);
-                const theTitle = theContent?.frontmatter?.title || file.metadata.title || '(no title)';
+                const theMetadata = (0, getLocalizedMetadata_1.getLocalizedMetadata)(file, props.lang);
+                const theTitle = theMetadata?.title || '(no title)';
                 return (react_1.default.createElement("li", { className: "nav-item", key: file.path },
                     react_1.default.createElement("a", { href: link, className: `nav-link ${isActive ? 'active' : ''}` },
                         theTitle,

package/dist/ssg/utils/getLocalizedMetadata.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getLocalizedMetadata = getLocalizedMetadata;
+/**
+ * 获取文件在指定语言下的 metadata
+ * - 如果是原语言，返回 file.metadata
+ * - 如果是翻译语言，返回 file.metadataTranslations[lang]
+ */
+function getLocalizedMetadata(file, lang) {
+    const metadata = file.metadata;
+    if (!metadata)
+        return undefined;
+    // 如果是原语言，直接返回原始 metadata
+    if (lang === metadata.inferred_lang) {
+        return metadata;
+    }
+    // 否则返回翻译版本
+    return file.metadataTranslations?.[lang];
+}
+//# sourceMappingURL=getLocalizedMetadata.js.map

package/dist/ssg/utils/getNavLinkDisplayTitle.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNavLinkDisplayTitle = getNavLinkDisplayTitle;
+function getNavLinkDisplayTitle(site, title, lang) {
+    return site.navLinkTranslations?.[title]?.[lang] || title;
+}
+//# sourceMappingURL=getNavLinkDisplayTitle.js.map

package/dist/utils/frontmatter.js

@@ -1,9 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.updateFrontmatter = exports.parseFrontmatter = void 0;
+exports.stripFrontmatter = exports.parseFrontmatter = void 0;
 const yaml_1 = require("yaml");
+const frontmatterRegex = /^---\n([\s\S]*?)\n---/;
 const parseFrontmatter = (content) => {
-    const frontmatterRegex = /^---\n([\s\S]*?)\n---/;
     const match = content.match(frontmatterRegex);
     if (match) {
         const frontmatterContent = match[1];
@@ -13,10 +13,15 @@ const parseFrontmatter = (content) => {
     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, { defaultStringType: 'QUOTE_DOUBLE' })}---\n\n`;
-    return frontmatterContent + body;
+/**
+ * 移除 Markdown 内容中的 YAML FrontMatter，只返回正文
+ */
+const stripFrontmatter = (content) => {
+    const match = content.match(frontmatterRegex);
+    if (match) {
+        return content.slice(match[0].length).trim();
+    }
+    return content;
 };
-exports.updateFrontmatter = updateFrontmatter;
+exports.stripFrontmatter = stripFrontmatter;
 //# sourceMappingURL=frontmatter.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "czon",
-  "version": "0.8.4",
+  "version": "0.8.6",
   "description": "CZON - AI enhanced Markdown content engine",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",