← 返回博客列表
FJ-06-B · 2026-09-01 · 约 1 分钟

示例:用 Astro Content Collections 管理 AI 生成内容


这是一篇示例文章,用于验证博客模块的渲染效果,同时作为 AI 自动生成内容的格式样例。 后续由 CI 发布的文章应保持相同的 frontmatter 结构与排版约定。

Frontmatter 约定

每篇文章的开头必须包含以下字段:

  • title:文章标题(必填)
  • date:发布日期,格式 YYYY-MM-DD(必填)
  • tags:标签数组,用于列表页筛选
  • summary:一句话摘要,用于列表页与 SEO 描述
  • draft:设为 true 时不在站点中展示

正文排版

正文支持标准 Markdown。以下是各元素的渲染样例。

代码块

// scripts/generate-post.mjs 生成的文件落盘位置
const dir = `src/content/${type}`;
const file = `${dir}/${date}-${slug}.md`;

行内代码如 getCollection('blog') 会显示为等宽字体。

引用

内容集合(Content Collections)是 Astro 对 Markdown/MDX 内容的类型安全封装, 适合以文件形式维护、以 Git 为发布管道的博客系统。

表格

字段 类型 说明
title string 文章标题
date date 发布日期
tags string[] 标签

自动发布流程

.github/workflows/auto-publish.yml 定时调用 scripts/generate-post.mjs, 通过 OpenAI 兼容接口生成文章并提交到仓库,push 随即触发部署工作流完成发布。 详见 README 中的说明。