✨ feat(docs): add "Recent Releases" page and update zh nav label for "Data Browser" to "模型库"

- Navigation:
  - Add top-level "Recent Releases" (zh: "最新发布") to mkdocs nav
  - Update zh translation for "Data Browser": "数据浏览器" → "模型库"
- Documentation generation:
  - Implement generateReleasesMarkdown to list all models sorted by release_date (desc)
  - Robust date parsing (YYYY / YYYY-MM / YYYY-MM-DD); unknown dates sorted last
  - Build now writes docs/<locale>/releases.md for each locale
- i18n:
  - Add keys: title.releases, intro.releases, table.released, table.provider
  - zh: set title.data → "模型库" (en remains "Data Browser")
- Types/Lint:
  - Adjust types to satisfy exactOptionalPropertyTypes in releases generator

Affected files:
- mkdocs.yml
- i18n/docs/en.json
- i18n/docs/zh.json
- src/services/docs-generator.ts
- src/build.ts

No breaking changes. Site nav shows zh "模型库" and a new "Recent Releases" page.

Author: t0ng7u

i18n/docs/en.json

@@ -11,6 +11,7 @@
   "legend.temperature": "Temperature",
   "legend.attachment": "Attachment",
   "table.model": "Model",
+  "table.provider": "Provider",
   "table.modelId": "Model ID",
   "table.context": "Context",
   "table.output": "Output",
@@ -22,4 +23,8 @@
   "table.details": "Details",
   "link.api": "📖 API Address",
   "link.doc": "📚 Official Documentation"
+  ,
+  "title.releases": "Recent Releases",
+  "intro.releases": "Models across all providers sorted by Released date (desc).",
+  "table.released": "Released"
 }

i18n/docs/zh.json

@@ -1,5 +1,5 @@
 {
-  "title.data": "数据浏览器",
+  "title.data": "模型库",
   "intro.data": "本页根据 API 数据自动生成，展示所有大模型提供商与模型的综合信息。",
   "stats.title": "统计",
   "stats.providers": "提供商数量",
@@ -11,6 +11,7 @@
   "legend.temperature": "温度",
   "legend.attachment": "附件",
   "table.model": "模型",
+  "table.provider": "提供商",
   "table.modelId": "模型 ID",
   "table.context": "上下文",
   "table.output": "输出",
@@ -22,4 +23,8 @@
   "table.details": "详情",
   "link.api": "📖 API 地址",
   "link.doc": "📚 官方文档"
+  ,
+  "title.releases": "最新发布",
+  "intro.releases": "按发布时间（Released）降序展示全站模型。",
+  "table.released": "发布于"
 }

mkdocs.yml

@@ -75,7 +75,8 @@ plugins:
           site_name: 'LLM 元数据'
           nav_translations:
             Home: 首页
-            Data Browser: 数据浏览器
+            Data Browser: 模型库
+            Recent Releases: 最新发布
             Submit Model: 提交模型
         - locale: ja
           name: 日本語
@@ -169,4 +170,5 @@ markdown_extensions:
 nav:
   - Home: index.md
   - Data Browser: data.md
+  - Recent Releases: releases.md
   - Submit Model: submit.md

src/build.ts

@@ -503,14 +503,24 @@ class Builder {
       console.log('Generating documentation...');
       const locales = this.i18nService.getLocales().map((l: { locale: string }) => l.locale);
       for (const locale of locales) {
-        const md = this.docsGenerator.generateDataMarkdown(
+        const dataMd = this.docsGenerator.generateDataMarkdown(
           allModelsData,
           indexes.providers,
           manifest,
           locale,
         );
-        const outPath = join(this.ROOT, 'docs', locale, 'data.md');
-        if (writeTextIfChanged(outPath, md, { dryRun })) {
+        const dataOut = join(this.ROOT, 'docs', locale, 'data.md');
+        if (writeTextIfChanged(dataOut, dataMd, { dryRun })) {
+          changes++;
+        }
+
+        const releasesMd = this.docsGenerator.generateReleasesMarkdown(
+          this.dataProcessor.localizeNormalizedData(allModelsData, overrides, locale),
+          manifest,
+          locale,
+        );
+        const releasesOut = join(this.ROOT, 'docs', locale, 'releases.md');
+        if (writeTextIfChanged(releasesOut, releasesMd, { dryRun })) {
           changes++;
         }
       }

src/services/docs-generator.ts

@@ -21,6 +21,24 @@ export class DocumentationGenerator {
     this.i18n = new I18nService(rootDir);
   }
 
+  /** 将 YYYY 或 YYYY-MM 或 YYYY-MM-DD 字符串解析为时间戳（不可解析返回 null） */
+  private parseDateToTimestamp(dateStr?: string): number | null {
+    if (!dateStr || typeof dateStr !== 'string') return null;
+    // 规范化为完整日期，优先使用原字符串可被 Date 解析
+    const direct = Date.parse(dateStr);
+    if (!Number.isNaN(direct)) return direct;
+    // 补全到月初/日：支持 "YYYY"、"YYYY-MM"
+    if (/^\d{4}$/.test(dateStr)) {
+      const ts = Date.parse(`${dateStr}-01-01`);
+      return Number.isNaN(ts) ? null : ts;
+    }
+    if (/^\d{4}-\d{2}$/.test(dateStr)) {
+      const ts = Date.parse(`${dateStr}-01`);
+      return Number.isNaN(ts) ? null : ts;
+    }
+    return null;
+  }
+
   /** 计算 NewAPI 比率（文档用） */
   private calculateNewApiRatios(cost?: {
     input?: number;
@@ -173,4 +191,136 @@ ${tr('intro.data')}
 
     return markdown;
   }
+
+  /** 生成“最新发布” Markdown（全站按 release_date 降序） */
+  generateReleasesMarkdown(
+    allModelsData: NormalizedData,
+    manifest: BuildManifest,
+    locale: string = 'en',
+  ): string {
+    const { stats } = manifest;
+    const lastUpdated = new Date(manifest.generatedAt).toLocaleString(
+      this.i18n.getDateLocale(locale),
+      { timeZone: this.i18n.getTimeZone(locale) },
+    );
+
+    const messages = this.i18n.getDocMessages(locale);
+    const tr = (key: string): string => messages[key] || key;
+
+    let markdown = `---
+hide:
+  - navigation
+---
+
+# ${tr('title.releases')}
+
+${tr('intro.releases')}
+
+!!! info "${tr('stats.title')}"
+    - **${tr('stats.providers')}**: ${stats.providers}
+    - **${tr('stats.models')}**: ${stats.models}
+    - **${tr('stats.updated')}**: ${lastUpdated}
+
+`;
+
+    type Row = {
+      providerId: string;
+      providerName: string;
+      modelId: string;
+      modelName: string;
+      releaseRaw?: string | undefined;
+      releaseTs: number | null;
+      context?: number;
+      output?: number;
+      pricing: string;
+      ratios: string;
+      capabilities: string;
+      knowledge?: string | undefined;
+      modalities: string;
+      details: string;
+    };
+
+    const rows: Row[] = [];
+    for (const [providerId, provider] of Object.entries(allModelsData.providers)) {
+      const providerName = provider.name || providerId;
+      for (const [modelId, model] of Object.entries(provider.models || {})) {
+        const releaseRaw = model.release_date || undefined;
+        const releaseTs = this.parseDateToTimestamp(releaseRaw);
+        const row: Row = {
+          providerId,
+          providerName,
+          modelId,
+          modelName: model.name || modelId,
+          releaseRaw,
+          releaseTs,
+          pricing: formatPricing(model.cost),
+          ratios: this.formatNewApiRatios(this.calculateNewApiRatios(model.cost)),
+          capabilities: formatCapabilities(model),
+          knowledge: model.knowledge,
+          modalities: formatModalities(model.modalities),
+          details: formatDetails(model),
+        };
+        if (typeof model.limit?.context === 'number') {
+          row.context = model.limit.context;
+        }
+        if (typeof model.limit?.output === 'number') {
+          row.output = model.limit.output;
+        }
+        rows.push(row);
+      }
+    }
+
+    rows.sort((a, b) => {
+      const at = a.releaseTs ?? -Infinity;
+      const bt = b.releaseTs ?? -Infinity;
+      return bt - at; // 降序（新 → 旧 → 未知）
+    });
+
+    const headers = [
+      tr('table.model'),
+      tr('table.provider'),
+      tr('table.modelId'),
+      tr('table.released'),
+      tr('table.pricing'),
+      tr('table.ratios'),
+      tr('table.capabilities'),
+      tr('table.knowledge'),
+      tr('table.modalities'),
+      tr('table.details'),
+    ];
+    const separators = [
+      '-------',
+      '--------',
+      '--------',
+      '--------',
+      '----------------',
+      '---------------',
+      '--------------',
+      '-----------',
+      '------------',
+      '----------',
+    ];
+
+    markdown += `| ${headers.join(' | ')} |\n`;
+    markdown += `|${separators.join('|')}|\n`;
+
+    for (const r of rows) {
+      const fields = [
+        `**${escapeMarkdownPipes(r.modelName)}**`,
+        escapeMarkdownPipes(r.providerName),
+        escapeMarkdownPipes(r.modelId),
+        escapeMarkdownPipes(r.releaseRaw || '-'),
+        r.pricing,
+        r.ratios,
+        r.capabilities,
+        r.knowledge || '-',
+        r.modalities,
+        r.details,
+      ];
+      markdown += `| ${fields.join(' | ')} |\n`;
+    }
+
+    markdown += '\n';
+    return markdown;
+  }
 }