logflow-theme — Astro 博客模板

LogFlow Theme 是一个以内容为先的 Astro 博客主题，专为中文写作、个人主页和技术文档设计。它的核心结构清晰：文章放在 `src/content/blog/`，支持 Markdown 和 MDX，Frontmatter 字段精简，标题、描述和日期为必填，其余如标签、头图等均可选，且无头图时不会出现破损图片或空的社交元信息。站点信息集中在 `src/consts.ts`，友链在独立配置文件中，设计令牌（颜色、字体、间距等）集中在 `global.css` 的 CSS 变量中，定制路径明确。

主题的辨识度在于全站像素流体动画背景，由零依赖 WebGL 实现，能跟随明暗主题配色，并支持 reduced-motion 与 WebGL 不可用降级；配合 Astro 的 ClientRouter，换页时动画能跨页持续播放。此外，它内置了构建时生成的静态搜索索引，仅覆盖标题、摘要和标签，不收录正文，首次打开搜索时由浏览器加载，不依赖服务端或第三方服务。RSS、sitemap、canonical、Open Graph 和 Twitter Card 均已包含，还提供可选的 Giscus 评论和 GitHub 活跃度组件。

这个主题适合希望快速搭建个人博客或技术文档站点的开发者，尤其是偏好中文写作和简洁视觉风格的用户。它要求 Node.js 版本不低于 22.12.0，部署到 GitHub Pages 时需将 Pages Source 设置为 GitHub Actions，工作流会自动设置 SITE_URL 和 BASE_PATH。需要注意的是，Giscus 评论需要自行在 GitHub 仓库启用 Discussions 并填写 repoId 和 categoryId，字段不完整时页面会显示配置提示；搜索功能仅覆盖文章元信息，不索引正文，若需要全文搜索需自行扩展。上线前建议核对 `src/consts.ts` 中的 SITE_URL 等生产配置，并运行 `npx astro check` 和 `npm run build` 验证构建。