From 5728ae16b38eebd6511385debfa14ab880f91c15 Mon Sep 17 00:00:00 2001
From: sanbuphy <physicoada@gmail.com>
Date: Tue, 3 Mar 2026 18:05:08 +0800
Subject: [PATCH] feat(sitemap): improve sitemap generation with git last
 modified dates

Add git last modified date tracking for sitemap URLs to provide more accurate lastmod timestamps
Only write sitemap file when content actually changes to avoid unnecessary updates
---
 scripts/generate-sitemap.mjs | 68 +++++++++++++++++++++++++++++++-----
 1 file changed, 59 insertions(+), 9 deletions(-)

diff --git a/scripts/generate-sitemap.mjs b/scripts/generate-sitemap.mjs
index 1bd2800..abbd630 100644
--- a/scripts/generate-sitemap.mjs
+++ b/scripts/generate-sitemap.mjs
@@ -7,6 +7,7 @@
 import fs from 'fs'
 import path from 'path'
 import { fileURLToPath } from 'url'
+import { execSync } from 'child_process'
 
 const __filename = fileURLToPath(import.meta.url)
 const __dirname = path.dirname(__filename)
@@ -72,10 +73,38 @@ function mdPathToUrl(mdPath, locale) {
   return `${siteUrl}/${locale}/${urlPath}${urlPath ? '/' : ''}`
 }
 
-// 生成 sitemap XML
-function generateSitemap(urls) {
-  const now = new Date().toISOString()
+function getGitLastModified(filePath) {
+  try {
+    const result = execSync(`git log -1 --format="%aI" -- "${filePath}"`, {
+      cwd: path.resolve(__dirname, '..'),
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe']
+    }).trim()
+    if (result) {
+      return result
+    }
+  } catch {
+    // 文件可能是新文件或不在 git 中
+  }
+  const stats = fs.statSync(filePath)
+  return stats.mtime.toISOString()
+}
 
+function getLatestModTime(files) {
+  let latest = '1970-01-01T00:00:00.000Z'
+  for (const file of files) {
+    const fullPath = path.join(docsDir, file.locale, file.relativePath)
+    if (fs.existsSync(fullPath)) {
+      const modTime = getGitLastModified(fullPath)
+      if (modTime > latest) {
+        latest = modTime
+      }
+    }
+  }
+  return latest
+}
+
+function generateSitemap(urls) {
   let xml = '<?xml version="1.0" encoding="UTF-8"?>\n'
   xml += '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"\n'
   xml += '         xmlns:xhtml="http://www.w3.org/1999/xhtml">\n'
@@ -83,11 +112,10 @@ function generateSitemap(urls) {
   for (const urlInfo of urls) {
     xml += '  <url>\n'
     xml += `    <loc>${escapeXml(urlInfo.loc)}</loc>\n`
-    xml += `    <lastmod>${now}</lastmod>\n`
+    xml += `    <lastmod>${urlInfo.lastmod}</lastmod>\n`
     xml += `    <changefreq>weekly</changefreq>\n`
     xml += `    <priority>${urlInfo.priority.toFixed(1)}</priority>\n`
 
-    // 添加 hreflang alternates
     for (const alternate of urlInfo.alternates) {
       xml += `    <xhtml:link rel="alternate" hreflang="${alternate.hreflang}" href="${escapeXml(alternate.href)}"/>\n`
     }
@@ -136,7 +164,8 @@ function main() {
     const urlInfo = {
       loc: '',
       priority: getPriority(baseFile),
-      alternates: []
+      alternates: [],
+      sourceFiles: []
     }
 
     // 为每个语言版本生成 alternate
@@ -151,6 +180,7 @@ function main() {
           hreflang: getHreflangCode(locale),
           href: url
         })
+        urlInfo.sourceFiles.push({ locale, relativePath: baseFile })
 
         // 设置主要语言版本为 zh-cn
         if (locale === 'zh-cn') {
@@ -165,31 +195,51 @@ function main() {
       if (!urlInfo.loc) {
         urlInfo.loc = urlInfo.alternates[0].href
       }
+      urlInfo.lastmod = getLatestModTime(urlInfo.sourceFiles)
       allUrls.push(urlInfo)
     }
   }
 
   // 添加首页
   const homeAlternates = []
+  const homeSourceFiles = []
   for (const locale of locales) {
     homeAlternates.push({
       hreflang: getHreflangCode(locale),
       href: `${siteUrl}/${locale}/`
     })
+    const indexPath = path.join(docsDir, locale, 'index.md')
+    if (fs.existsSync(indexPath)) {
+      homeSourceFiles.push({ locale, relativePath: 'index.md' })
+    }
   }
   allUrls.unshift({
     loc: `${siteUrl}/zh-cn/`,
     priority: 1.0,
-    alternates: homeAlternates
+    alternates: homeAlternates,
+    sourceFiles: homeSourceFiles,
+    lastmod: getLatestModTime(homeSourceFiles)
   })
 
   console.log(`🌐 Generating sitemap with ${allUrls.length} URLs...`)
 
   const sitemapXml = generateSitemap(allUrls)
   const outputPath = path.join(publicDir, 'sitemap.xml')
-  fs.writeFileSync(outputPath, sitemapXml, 'utf-8')
 
-  console.log(`✅ Sitemap generated at ${outputPath}`)
+  let shouldWrite = true
+  if (fs.existsSync(outputPath)) {
+    const existingXml = fs.readFileSync(outputPath, 'utf-8')
+    if (existingXml === sitemapXml) {
+      shouldWrite = false
+      console.log(`⏭️  Sitemap unchanged, skipping write`)
+    }
+  }
+
+  if (shouldWrite) {
+    fs.writeFileSync(outputPath, sitemapXml, 'utf-8')
+    console.log(`✅ Sitemap generated at ${outputPath}`)
+  }
+
   console.log(`📊 Statistics:`)
   console.log(`   - Total URLs: ${allUrls.length}`)
   console.log(`   - Locales: ${locales.length}`)