当前站点架构更新分析与下一步任务

最近一次更新主要是补齐英文源内容、整理待办任务，并修正部分语言处理问题。

这篇文章直接分析当前仓库状态：哪些已经更新，哪些还需要继续修复。

一、当前更新概况

• 已补齐英文源内容

新增或补全了

src/content/blog/en/202603.html、src/content/blog/en/202605.html、

src/content/blog/en/generate-rss.html、src/content/page/en/downloads.html

和 src/content/page/en/example.html。

• 已修正英文审计描述

现有 src/content/blog/en/framework-review.html

中，问题描述已更准确地指出“英文标签页使用中文侧边栏标签”的实际现象。

• 已整理当前待办

TODO.md

已记录这次更新，并新增了与英文构建、语言分支验证、页面模板抽取相关的后续任务。

二、当前架构仍存在的主要缺陷

• 语言分支还不够稳固

虽然补齐了英文页面源文件，但构建脚本本身还没有完成语言分支重构。

generate-archive.ps1 仍可能默认加载中文侧边栏，rebuild-all.ps1 的英文build顺序也需要验证。

• 页面骨架重复未解决

当前 HTML 页面构建仍在 build.ps1、generate-archive.ps1、editor.py

等多个地方单独拼装。 这意味着后续布局修改仍然需要重复维护。

• 配置尚未统一

站点名、路径、语言、端口、最大留言数等配置仍散落在不同脚本中。

没有统一配置文件会增加部署和扩展的难度。

• CGI 公共逻辑仍未抽离

editor.py、guestbook.py 等脚本仍然分别实现表单解析、IP 提取、重建触发等功能。 建议尽快创建 cgi-bin/_common.py 进行共享。

三、验证与修复优先级

• 优先验证英文页面生成

先执行完整构建，确认 src/content/blog/en/ 和 src/content/page/en/ 的内容是否被正确注入到 dist/en/ 输出中。

• 优先修复语言侧边栏选择

最关键的是让 generate-archive.ps1 和 build.ps1 根据 $Lang 一致加载 sidebar-left-en.html / sidebar-right-en.html。

• 优先修正英文 latest-posts 顺序

rebuild-all.ps1 应将英文 generate-archive.ps1 -Lang en 提前到英文页面构建之前，避免首次构建显示空侧边栏。

• 优先抽取共享页面模板

建议创建 src/components/page-shell.html，让页面骨架不再被各脚本分散实现。

四、下一步任务清单

• 确认新补的英文页面是否已正确集成到 -Lang en 构建流程。
• 修复 generate-archive.ps1 的英文侧边栏加载逻辑。
• 修正 rebuild-all.ps1 中英文 latest-posts 的生成顺序。
• 创建 cgi-bin/_common.py，抽离 CGI 共享逻辑。
• 引入统一配置文件，减少各处硬编码。

这次更新已经完成了内容补齐和任务梳理，下一阶段应把重点放在“让构建链变得稳定”和“让语言分支一致”。