一、方案总览#

整套方案只有四个角色，全部免费：

工作原理一句话：你把源码推送到 GitHub → 平台自动拉取、构建、发布 → 以后每次发文推代码，网站几分钟后自动更新。这就是”持续部署”，你从不需要碰服务器。

二、前置准备#

1
node -v

1
npm install -g pnpm
2
pnpm -v

三、第一步：Fork 官方仓库#

“Fork”就是把别人的项目完整复制一份到你自己的 GitHub 账号下，你拥有这份副本的全部修改权，将来部署平台也是从你的副本拉代码。

1. 浏览器打开 Firefly 官方仓库：https://github.com/CuteLeaf/Firefly
2. 点击右上角 Fork 按钮
3. 弹出页面保持默认（仓库名 Firefly、勾选 Copy the main branch only），点 Create fork
4. 等待几秒，页面跳转到 https://github.com/你的用户名/Firefly —— 完成

全程 1 分钟。不要用 Download ZIP 下载，Fork 才能和自动部署联动。

四、第二步：用 Trae 克隆项目到本地#

1. 安装并打开 Trae，用任意方式登录
2. 菜单 文件 → 打开文件夹，新建并选择一个空文件夹（例如 E:\blog）
3. 在右侧 AI 对话框中，把下面这句发出去（把用户名换成你自己的）：

1
请帮我把我 GitHub 上的仓库 https://github.com/你的用户名/Firefly 克隆到当前打开的文件夹里，克隆完成后告诉我项目结构。

AI 会自动执行 git clone 并把仓库内容放进你的工作区。如果你没有开全自动模式（SOLO / Builder），Trae 执行命令前会弹出确认框，点允许即可。

五、第三步：安装依赖#

项目克隆下来后，继续在 Trae 对话框发送：

1
请先检查本机 Node 和 pnpm 版本（项目要求 Node ≥ 22.23.0、pnpm ≥ 11.22.0），符合要求就在项目根目录执行 pnpm install 安装依赖；如果 pnpm 未安装，先用 npm install -g pnpm 安装。完成后告诉我结果。

AI 会自动完成版本检查和安装。依赖大约几百个包，国内网络一般 1～3 分钟。

这个项目用 preinstall 脚本强制 pnpm，用 npm/yarn 安装会直接报错——让 AI 用 pnpm 就不会遇到。

六、第四步：修改博客配置#

Firefly 的所有个性化配置集中在 src/config/ 目录，改文件即可，不需要碰组件代码。下面两张表帮你快速定位。

1
请帮我完成博客基础配置：
2
1. src/config/siteConfig.ts：网站标题改为「XX 的博客」，副标题改为「记录技术与生活」；
3
2. src/config/profileConfig.ts：作者名改为 XX，GitHub 链接改为 https://github.com/你的用户名，加上我的邮箱 someone@example.com；
4
3. 改完把改动的字段列出来给我确认。

七、第五步：本地预览#

在 Trae 对话框发送：

1
请启动博客开发服务器，并告诉我预览地址。

AI 执行 pnpm dev 后，浏览器打开 http://localhost:4321 就能看到你的博客。此时你改任何配置、文章，页面会热更新，保存即生效。

首次启动需要构建缓存，页面出来前可能有十几秒白屏，属正常现象。

八、第六步：新建第一篇文章#

Firefly 的文章都是 Markdown 文件，放在 src/content/posts/ 目录。继续对 Trae 说：

1
请用 pnpm new-post 创建一篇新文章，文件名 hello-world，然后把标题改成「我的第一篇博客」，写一段 200 字左右的开场白介绍这个博客。

AI 会生成骨架并替你填充内容。生成的文章顶部有一段 frontmatter（配置头），含义如下，以后写文自己填：

1
---
2
title: 我的第一篇博客        # 文章标题（必填）
3
published: 2026-09-15       # 发布日期（必填）
4
description: 文章摘要       # 列表页显示的摘要
5
image: ./cover.webp         # 封面图（相对路径引用同目录图片，可省略）
6
tags: [随笔]                # 标签
7
category: 随笔              # 分类
8
pinned: false               # 是否置顶
9
draft: false                # true = 草稿，不会发布
10
---

正文就是标准 Markdown，写完保存即可。

九、第七步：推送到 GitHub#

本地满意后，把改动推上去（这一步同时是部署的触发器）。在 Trae 对话框发送：

1
请帮我把当前所有改动提交到 Git 并推送到 GitHub，提交信息写「初始化博客配置并发布第一篇文章」。

想手动执行的话，等效命令是：

1
git add .
2
git commit -m "初始化博客配置并发布第一篇文章"
3
git push origin main

推送完成后，打开你的 GitHub 仓库页面，能看到刚才的改动记录。

十、第八步：部署上线（二选一）#

1
我的博客在部署平台构建失败，日志报错如下：
2
（粘贴日志）
3
请分析原因并帮我修复。

十一、后续日常维护#

1
① 对 Trae 说：用 pnpm new-post 创建文章 <文件名>，标题、内容如下：……
2
② 本地 http://localhost:4321 预览效果
3
③ 满意后对 Trae 说：提交并推送到 GitHub
4
④ 平台检测到 push，自动构建，约 3 分钟后线上生效

1
我刚刚在 GitHub 上同步了上游更新，请执行 git pull 拉取到本地，然后检查有没有和我的本地改动冲突。

十二、总结：这套方案好在哪#

• 零服务器成本：不需要买云主机，Vercel / Cloudflare 免费额度对个人博客绰绰有余
• 零记忆负担：装依赖、改配置、建文章、提交推送全部用自然语言让 Trae 完成，命令都在本文可复制
• 自动持续部署：源码在 GitHub，push 即发布，文章更新几分钟内全网上线
• 数据完全自持：仓库在你自己账号下，随时可以换部署平台、换域名，博客不锁死在任何服务商
• 功能开箱即用：暗色模式、全文搜索、评论、相册、友链、RSS、代码高亮，主题全部内置

接下来要做的只有一件事：把本文里所有的「XX」换成你的名字，然后开始写第一篇文章。