WordPress 适合后台写文章,但当页面结构高度定制、内容又习惯用 Markdown 管理时,Astro 会更自然。

当前决策

保留 WordPress 作为回退,不删除;新建 Astro 静态站并行开发。

为什么选择静态站

本站的核心内容是工具导航、教程、提示词和工作流,第一阶段不需要登录、评论或复杂查询。Astro 可以把 Markdown 在构建时生成 HTML,发布后以静态页面方式托管,运行面更小。

内容和代码放在同一个 Git 仓库,也方便查看每次修改、创建 PR 和回滚到上一个版本。代价是发布文章需要重新构建和部署,不适合完全依赖网页后台写作的人。

当前内容结构

src/pages/       路由与栏目页
src/components/  可复用页面组件
src/content/     Markdown 文章、工具、提示词和工作流
src/data/        导航和结构化卡片数据
src/styles/      全站样式
public/          图标等静态资源

内容集合负责校验标题、日期、分类和标签。构建时如果字段缺失或类型错误,发布流程会直接失败,避免把不完整页面上传到线上。

发布流程

  1. 本地运行质量检查和 Astro 构建。
  2. 把构建产物同步到临时发布区。
  3. 为当前线上版本创建带时间戳的快照。
  4. 将新构建同步到正式站点目录。
  5. 检查首页、工具页和 404 页面。
  6. 健康检查失败时恢复部署前快照。

保留 WordPress 的原因

迁移早期最重要的是保留退路。WordPress 数据和旧主题暂时不删除,直到静态站的内容写作、搜索收录和发布流程连续稳定运行。技术切换不应和内容迁移、域名调整、服务器重构同时发生。

目前的原则是先让页面结构和内容生产稳定,再考虑搜索、反馈表单或更复杂的自动化,而不是提前搭建暂时用不到的系统。