从零搭建 Firefly 博客：一次愉快的技术选型实践

第一步：Fork 主题#

去 CuteLeaf/Firefly 点了一下 Fork，自己的仓库里就有了。然后在本地 clone 下来：

1
git clone https://github.com/你的账号/Firefly.git
2
cd Firefly
3
pnpm install
4
pnpm dev

pnpm dev 之后浏览器打开 localhost:4321，看到博客已经在本地跑起来了。

第二步：部署到 EdgeOne Pages#

EdgeOne 的部署流程很简单：

1. 在 EdgeOne 控制台选择「Pages」→「新建项目」
2. 关联 GitHub 仓库
3. 配置构建参数：
   • 构建命令：pnpm install && pnpm build
   • 输出目录：dist
   • Node 版本：≥ 22
4. 点击部署

之后每次 git push，EdgeOne 会自动检测变化、重新构建、部署上线。整个过程不需要手动操作，写过即发布。

第三步：配置自动化维护#

为了让维护更高效，我生成了一个 GitHub Personal Access Token（仅限这个仓库的读写权限），这样日常操作就变成了一条龙：

1
写文章 → git add → git commit → git push → 自动部署

我还配置了上游仓库，方便后续同步主题更新：

1
git remote add upstream https://github.com/CuteLeaf/Firefly.git
2
git fetch upstream
3
git merge upstream/master
4
git push

写文章#

文章存放在 src/content/posts/ 目录下，Markdown 格式。每篇文章开头有一段 front-matter：

1
---
2
title: 文章标题
3
published: 2026-07-14
4
description: 文章的简短描述
5
tags: [标签1, 标签2]
6
category: 分类名称
7
draft: false
8
---

写完后推送到 GitHub，EdgeOne 自动构建，等一两分钟就能看到新文章上线了。

关于标签和分类#

刚接触 Firefly 时，我一度搞混了标签和分类的区别。后来翻了源码才弄明白：

• 分类（category）：每篇文章只能有一个，是文章的”大类”。比如我的博客目前分了「文章示例」和「博客指南」两类。
• 标签（tags）：每篇文章可以有多个，是文章的”关键词”。比如一篇文章可以同时打上 [备考, 申论, 经验分享] 等多个标签。

两者都不需要提前定义，写文章时直接写就行，Firefly 会自动收集并展示在侧边栏。

主要配置#

Firefly 的配置文件都在 src/config/ 目录下，清晰明了。我最常用的几个：

同步上游更新#

CuteLeaf 更新非常勤快（目前已经 1175+ commits），偶尔会同步一下上游的新功能：

1
git fetch upstream
2
git merge upstream/master
3
# 解决可能的冲突
4
git push

建议只修改 src/config/ 和 src/content/ 下的文件，不要动主题核心代码，这样更新时冲突会少很多。