给 Firefly 主题加上 AI 总结功能

1. scripts/generate-ai-summary.js（新增）#

AI 总结生成的核心脚本，主要功能：

• 扫描 src/content/posts/ 下的所有 .md / .mdx 文件
• 检查每个文件的 Front-matter 是否已有 ai 字段
• 对缺少总结的文章，提取正文纯文本并调用 AI API 生成总结
• 将生成的总结写入原文件的 Front-matter 的 ai 字段
• 支持 --force（强制重新生成）和 --dry-run（预览模式）参数

2. src/components/features/AiSummary.astro（新增）#

AI 总结的 UI 展示组件，特点：

• 展示在文章封面图之后、正文之前
• 带有 AI 图标和”AI 总结”标题
• 使用主题色的左边框和背景色，视觉区分明确
• 支持深色/浅色主题自适应
• 仅当 Front-matter 中有 ai 字段时才渲染

3. src/content.config.ts（修改）#

在 posts 集合的 Schema 中添加了 ai 字段：

1
ai: z.string().optional().default(""),

4. src/pages/posts/[...slug].astro（修改）#

在文章详情页中引入 AiSummary 组件并添加条件渲染：

1
import AiSummary from "@/components/features/AiSummary.astro";
2

3
// 在文章内容区域添加
4
{
5
  entry.data.ai && (
6
    <AiSummary summary={entry.data.ai} />
7
  )
8
}

5. package.json（修改）#

添加了以下脚本：

1
{
2
  "scripts": {
3
    "ai-summary": "node scripts/generate-ai-summary.js",
4
    "build": "node scripts/generate-ai-summary.js && node scripts/generate-icons.js && ..."
5
  }
6
}

构建命令会在执行其他步骤之前先运行 AI 总结脚本。

6. .env.example（新增）#

提供了环境变量的配置模板和说明文档。

方式一：本地开发使用 .env 文件#

在项目根目录创建 .env 文件：

1
OPENAI_API_KEY=your-api-key-here
2
OPENAI_BASE_URL=https://api.openai.com/v1

方式二：CI/CD 部署使用环境变量（推荐）#

在 GitHub Actions、Cloudflare Pages、Vercel 等部署平台中设置环境变量：

优先级：系统环境变量 > .env 文件。在 CI/CD 平台设置的环境变量会自动覆盖 .env 中的同名变量。

手动运行#

1
pnpm ai-summary

构建时自动运行#

1
pnpm build

构建命令已包含 AI 总结脚本，会自动在构建前生成缺失的总结。