整个构建流程有严格的顺序要求，下面是完整的调用链：

1. generate-archive.ps1           ← 生成 latest-posts + archive + tags + 搜索索引
       │
       ▼
2. build.ps1 (index)              ← 中文首页
3. build.ps1 (blog-*) × N        ← 所有中文博客页面
       │
       ▼
4. build.ps1 (index, -Lang en)    ← 英文首页
5. build.ps1 (blog-*, -Lang en)×N ← 所有英文博客页面
6. generate-archive.ps1 -Lang en  ← 英文归档/标签
       │
       ▼
7. generate-rss.ps1               ← RSS 2.0 订阅源
8. generate-sitemap.ps1           ← sitemap.xml

为什么是这个顺序？因为每一步都依赖前一步的产出：

脚本接受一个可选参数 -IncludeDrafts，传递给下游所有构建步骤：

param([switch]$IncludeDrafts)

每个步骤的结构基本相同：

if (Test-Path $targetScript) {
    Write-Host "描述..." -ForegroundColor Yellow
    & $targetScript -参数
} else {
    Write-Host "警告: 找不到脚本 $targetScript" -ForegroundColor Red
}

这种"先检查，再执行"的模式确保了即使某个脚本文件被意外删除，构建流程也不会崩溃——只是跳过该步骤并给出警告^[1]。

首页使用固定的内容文件，不需要扫描目录：

# 中文首页
& $buildScript -PageName "index" -Title "DragonRS Void"
    -ContentFile "$pagesDir\index\content-index.html"
    -IncludeDrafts:$IncludeDrafts

# 英文首页
& $buildScript -PageName "index" -Title "DragonRS Void"
    -ContentFile "$pagesDir\index\content-index-en.html"
    -Lang en

注意英文首页没有 -IncludeDrafts 参数——因为英文翻译默认都是已发布状态。如果将来需要英文草稿，可以加上。

PageName 为 "index" 时，输出路径是项目根目录（中文）或 dist/en/（英文），而不是 dist/ 子目录^[2]。

中文博客的构建自动扫描目录，排除英文文件：

$blogFiles = Get-ChildItem "$blogDir\content-*.html"
    | Where-Object { $_.Name -notmatch '-en\.html$' }

foreach ($file in $blogFiles) {
    $baseName = $file.BaseName -replace '^content-', ''
    $pageName = "blog-$baseName"
    # 从文件中提取 title 元数据
    $titleMatch = [regex]::Match($raw, '')
    $title = if ($titleMatch.Success) { $titleMatch.Groups[1].Value }
             else { $baseName }
    & $buildScript -PageName $pageName -Title $title
        -ContentFile $file.FullName -IncludeDrafts:$IncludeDrafts
}

关键细节：

英文内容的处理分为两个部分：

Part 1 — 构建英文页面：

$enBlogDir = "$pagesDir\blog\en"
$enFiles = Get-ChildItem "$enBlogDir\content-*.html"
foreach ($file in $enFiles) {
    $baseName = $file.BaseName -replace '^content-', ''
    $pageName = "blog-$baseName"
    & $buildScript -PageName $pageName -Title $title
        -ContentFile $file.FullName -Lang en
}

Part 2 — 生成英文归档/标签：

& $archiveScript -Lang en

英文归档必须在英文页面构建之后运行——因为 generate-archive.ps1 -Lang en 扫描 blog/en/ 目录下的文件，提取元数据来生成归档和标签。如果先运行归档再构建页面，归档内容将不包含最新的文章。

所有页面构建完成后，最后两步是生成 RSS 和 sitemap：

& $rssScript        # generate-rss.ps1  → dist/rss.xml
& $sitemapScript    # generate-sitemap.ps1 → sitemap.xml

这两个文件是元数据文件——它们描述整个网站的结构，供 RSS 阅读器和搜索引擎爬虫使用。它们必须在所有页面构建完成后生成，以确保收录的 URL 列表和内容是最新的^[4]。

RSS 和 sitemap 的生成逻辑各自独立——它们之间没有依赖关系，可以并行执行。但由于 PowerShell 单线程调用，目前是串行的。

rebuild-all.ps1 的名中"all"意味着它构建所有东西。这是一个故意的设计选择——没有"增量构建"、没有"仅构建变更"、没有"缓存"。原因有三：

这种"全量构建"的哲学，和很多现代静态站点生成器（如 Jekyll、Hugo）是一致的——只不过它们用 Go/Ruby 写，而我们用 PowerShell^[5]。

rebuild-all.ps1 的代码量是五个脚本中最少的（约 110 行），但它是唯一"了解全局"的脚本——它知道哪些脚本存在、它们的依赖关系、以及正确的调用顺序。新增一个脚本时（比如将来增加 generate-og-image.ps1），只需要在对应的位置插入调用即可。

最后有一点值得注意：每个步骤执行后都会输出一行带颜色的状态信息（-ForegroundColor Yellow/Green/Red），让你在终端中一眼就能看到构建进度——这是 CLI 工具的"人性化设计"，哪怕它只面向开发者^[6]。