不会写代码，也能让 AI 全托管一个博客：从 Fork 到日常维护（保姆级教程）

一、方案总览#

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

首先需要提前注册这几个账号，准备好所需要的AI工具。

工作原理一句话：你把需求说给 AI → AI 修改源码并推送到 GitHub → Vercel 自动拉取、构建、发布 → 几分钟后网站更新。这就是”全托管”：你从不需要碰服务器，也不需要打开代码文件。

二、前置准备#

2.1 需要注册的账号#

账号	用途	注册地址	备注
GitHub	托管博客源码，触发自动部署	github.com/signup	邮箱验证后即可用
Vercel	部署托管	vercel.com	直接用 GitHub 账号关联注册
Cloudflare	（可选）域名 DNS 托管，绑域名和优选 IP 时的操作台	dash.cloudflare.com	域名本来就托管在 Cloudflare 的直接用现成的；不在的可忽略
MongoDB Atlas	（可选进阶）评论系统数据库	cloud.mongodb.com	只有第九步装独立评论时才需要，免费层够用

以下为个人用小号的解释（总结：本教程无任何风险，仅仅大号免费额度不够了），可展开看详细内容

为什么不用大号？主要是想部署在 Vercel 上面，大号连的 Vercel 做的音乐 API 被人白嫖，月额度烧完了，所以为了赶时间就申请了一套小号。这就是主要原因，也挺无奈。

2.2 需要安装的软件#

软件	版本要求	用途	官网地址
Node.js	22.x LTS	博客构建运行环境	nodejs.org
Git	最新版即可	代码版本管理、推送 GitHub	git-scm.com/download/win
pnpm	最新版（Node 装好后一条命令安装）	依赖管理（项目强制要求 pnpm）	pnpm.io
AI 编程工具	最新版	替你执行命令、改文件（本文用 DSH，也可用 Trae、Cursor 等）	按你选的工具官网

1
node -v

1
npm install -g pnpm
2
pnpm -v

三、第一步：Fork 模板仓库#

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

1. 浏览器打开模板仓库（二选一）：my-blog 是 MmzMing/my-blog；Firefly 是 CuteLeaf/Firefly
2. 点击右上角 Fork 按钮
3. 弹出页面保持默认，点 Create fork
4. 等待几秒，页面跳转到 github.com/你的用户名/仓库名 —— 完成

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

注意默认分支不一样：my-blog 是 master，Firefly 是 main。后面部署选生产分支时要选对，第八步会再提醒。下文以 my-blog 为例，Fork 的是 Firefly 的话把仓库名和分支名对应替换即可。

四、第二步：让 AI 把项目克隆到本地#

1. 打开你的 AI 编程工具，新建并打开一个空文件夹（例如 E:\blog）作为工作区
2. 在 AI 对话框里，把下面这句发出去（把用户名换成你自己的）：

1
请帮我把我 GitHub 上的仓库 https://github.com/你的用户名/my-blog 克隆到当前打开的文件夹里，克隆完成后告诉我项目结构。只动这个仓库，不要碰我电脑上其他项目。

AI 会自动执行克隆并把仓库内容放进工作区。如果工具执行命令前弹出确认框，点允许即可。

五、第三步：先立规矩，再动代码（全托管的核心）#

这一步看起来最没用，其实是整个教程里最重要的一步。

AI 最擅长的事，除了干活，还有”顺手帮你优化一下”——你不把边界写死，它就会替你做决定。所以开工第一件事，是在仓库根目录建一份 AGENTS.md，把规矩写下来，AI 每次开工先读它。下面这份可以直接抄，把括号里的换成你的：

1
# 本仓库工作规矩
2
1. 只动本仓库。其他仓库、部署后台、DNS，一律不碰。
3
2. 一批只做一件事，一批一个 commit。想改五个地方，分五批提交。
4
3. 每次改完必须自己跑构建验证，并把验证结果（成功/失败、关键数据）汇报给我。
5
4. 视觉效果（好不好看、像不像）由我验收，你不要自行判定通过。
6
5. 不许猜测。素材、数字、现状以仓库代码和接口实测为准，查不到就说查不到。
7
6. 推送前把本批改动的文件清单列给我，等我确认再推。

然后对 AI 说：

1
请把上面这份规矩保存为仓库根目录的 AGENTS.md（如果根目录已有同名文件，先把两份内容给我看，合并后再保存），然后把它作为第一个 commit 提交并推送。之后所有工作都按这份规矩执行。

我的实验站第一个提交干的就是这件事。后面它真拦住过好几次 AI 想顺手重构”范围外问题”的冲动。

六、第四步：安装依赖与本地预览#

继续在对话框发送：

1
请先检查本机 Node 和 pnpm 版本（项目要求 Node 22、pnpm 最新版），符合要求就在项目根目录执行 pnpm install 安装依赖；如果 pnpm 未安装，先用 npm install -g pnpm 安装。完成后启动开发服务器（pnpm dev），告诉我预览地址。

AI 会自动完成版本检查、安装和启动。依赖大约几百个包，国内网络一般 1～3 分钟。启动成功后浏览器打开 http://localhost:4321 就能看到你的博客，此时改任何配置、文章，页面保存即刷新。

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

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

七、第五步：把模板换成”你自己的站”#

刚 Fork 下来的站挂的全是模板作者的名字、头像、友链。先换掉，才算你的站。把下面这段填好发给 AI：

1
请帮我完成博客的身份切换，要求一批只做一件事、分开提交：
2
1. 站点名改为「XX的小站」，站点域名先填 https://XX.vercel.app（以后绑了自己的域名再改）；
3
2. 作者昵称改为 XX，头像换成我放在工作区的 avatar.png；
4
3. 友链列表整体清空，一条不留；
5
4. 文章页的打赏入口关闭，页脚和隐私页里的联系邮箱改成我的 someone@example.com；
6
5. 先把仓库自带的示例文章列个清单给我，我确认哪些删，你再删。
7
每完成一项，把改了哪些文件列给我看。

AI 会直接定位配置文件修改。注意第 5 条：模板自带的示例文章里可能混着有用的说明页，让 AI 先列清单、你点头再删，比一句话”全删了”稳妥。

八、第六步：部署到 Vercel 上线#

1. 打开 vercel.com，点 Continue with GitHub，用你的账号授权登录
2. 控制台点 Add New… → Project
3. 在 Import Git Repository 列表里找到你的 my-blog 仓库，点 Import（找不到的话，点下面的链接给 Vercel 授权访问该仓库）
4. 配置页确认四处，其余全部默认：

5. 点 Deploy，等 3～5 分钟构建完成
6. 完成后得到一个 你的项目名.vercel.app 的免费域名，点击即可访问

一个保险设置（建议顺手加上）：展开 Environment Variables 添加一条 NODE_VERSION = 22。Astro 7 要求构建环境的 Node 必须 ≥ 22；Vercel 新项目默认一般已经达标，但个别项目默认版本偏低，会直接构建失败。把版本钉死，就不用赌它的默认值。

绑定自己的域名（可选/可直接使用托管到Cloudflare的域名）：项目页 → Settings → Domains → Add，填入你的域名，按提示到域名注册商那里加一条 CNAME 记录指向 Vercel 给出的地址，等证书自动签发（几分钟）即可 HTTPS 访问。绑完别忘了回第七步，让 AI 把配置里的站点域名换成正式域名。域名托管在 Cloudflare 的，就在 Cloudflare 控制台的 DNS 页加这条记录——注意把代理状态设成仅 DNS（灰云）：开着橙云代理时，流量会先绕 Cloudflare 的默认节点，下面的优选 IP 不生效，还可能和 Vercel 的证书校验打架。

部署失败怎么办：不要自己研究日志。把 Vercel 构建日志里的报错整段复制下来发给 AI：

1
我的博客在 Vercel 构建失败，日志报错如下：
2
（粘贴日志）
3
请分析原因，在本地修好并验证构建能通过，然后再推送。

九成问题出在依赖版本或环境变量，AI 能直接定位。

九、第七步（可选进阶）：给评论装一套独立后端#

模板自带评论功能，但后端要自己接。千万不要和别人的站、或者你自己的主站共用一套评论后端——共用同一套，两边的评论会串在一起，谁在实验站发的测试留言都会出现在正式站上（新手可忽略）。独立部署一套 Waline，零成本，十分钟：

1. 建数据库：登录 MongoDB Atlas → 创建免费集群（M0）→ 在 Database Access 里新建一个数据库用户（记下用户名密码）→ Network Access 里放行 0.0.0.0/0（Vercel 没有固定出口 IP，必须全放行，安全靠强密码）→ 新建一个空数据库，例如 waline-idea
2. 部署后端：Fork 一份 walinejs/waline 到你的GitHub账号 → 回 Vercel 新建 Project 导入它 → Root Directory 改成 example（真正的应用在子目录里，不改部署必失败）→ 项目 Settings 里把 Node.js Version 改成 24.x（默认的 26.x 与 Waline 不兼容）
3. 填环境变量（Deploy 前在 Environment Variables 里一次填齐）：

最容易栽的坑：MONGO_HOST 和 MONGO_PORT 必须写成 JSON 数组。只写一个光秃秃的 27017，它会把这串数字拆开当成多个端口去连，部署显示成功、请求全部超时，你还会以为是网络问题。另一条：不要把 mongodb+srv:// 整串连接字符串直接粘进去，Waline 不吃整串，必须拆成上面这组分项变量。

4. 部署成功后得到评论后端地址（如 https://waline-idea.vercel.app，建议同样在 Domains 里绑个自己的子域名，vercel大陆dns基本被污染的无法访问），回博客这边对 AI 说：

1
请把评论配置里的 serverURL 改成 https://我的评论后端域名/ ，登录方式保持允许游客（昵称+邮箱即可评论），改完构建验证并推送。

推送后等几分钟，打开留言板发一条测试评论，能发出来、刷新还在，这套评论就通了。

1
请把 Umami 统计接入这个站，我的 data-website-id 是 XXX。如果模板自带统计/Umami 配置项就填配置项，不要把脚本硬编码进每个页面；本地预览确认统计请求发出后再告诉我。

1
请给我一份部署 Umami 的 docker-compose.yml（官方镜像 + PostgreSQL），并说明每个环境变量要填什么。

十、第八步（可选进阶）：播放器音源——公共源还是自建源（二选一）#

模板自带的播放器要出声，得先给它接一个”源站”（提供歌单和音频地址的接口）。两种接法，二选一：

也可以先 A 后 B：配置是逐张歌单生效的，哪张不满意就把哪张切到自建，不用一次全换。

1
请把播放器默认歌单换成：平台 tencent，歌单 ID 9439238150。主源和备胎保持不动，改完构建验证，告诉我改了哪一行。

1
请为播放器实现一个自建源站，独立项目，部署到 Vercel：
2
1）歌单接口：输入平台（wy/tx/kg）和歌单 ID，返回全量歌曲详情；网易云按 trackIds 每批 100 首并发补详情并保持原顺序；响应加缓存头 s-maxage=86400；
3
2）解析接口：输入平台、歌曲 ID、歌名、歌手，按"主源→平台对口源→备用源"的顺序找可播地址，每个候选先实际请求验活再返回，验不过换下一个；结果在服务端缓存 6 小时；
4
3）两个接口都只允许我博客的域名调用（按 Referer 白名单校验），其他来源返回 403。
5
写完逐项自查并把测试结果给我。

1
请把播放器歌单改造成列表配置：每张歌单包含名称、平台、歌单 ID 和 api 字段，api 为 self 时请求我自建源站的歌单/解析接口，为公共源地址时走 Meting。切歌单时不要打断正在播放的歌曲，点了新歌单里的歌才切换队列。

十一、日常施工：怎么跟 AI 说话#

站搭起来只是开始。托管的日常，是你不断提需求、AI 不断交付。一次靠谱的施工长这样，五步：

1. 你说需求，说清”哪里、什么问题、想要什么效果”，例如：“播放器切歌单太慢，冷加载要十几秒，查一下原因，能改就改。”
2. AI 先查再动：定位到是节点跨国、串行请求、缓存太短三层原因叠加，先把原因报给你。
3. 分批施工：并发改造一批、缓存策略一批、收尾小补丁一批，每批一个 commit，随时能单独回滚。
4. AI 交自查证据：改前改后实测数据、逐项比对结果、构建是否通过——不看证据不算完。
5. 你验收：真机打开试一遍（手机、电脑各一次），体感对了才算结；不对就描述现象发回去，别自己猜原因。

三句常用提示词：

要证据时：

1
改完后把自查结果给我：构建是否通过、改前改后关键数据对照、你逐项核对过什么。没验证过的部分明确标出来，不要笼统说"已完成"。

圈范围时（写文章、做调研尤其要用）：

1
素材只许用（某个时间点）之后、（某个作者）的提交记录，上游原作者的历史不要纳入。数字逐个核对来源，不许推测。

因为 Fork 是全量复制历史，你不圈范围，AI 就会把模板作者的开发史写成你的奋斗史——这事在我站上真实发生过。

任务太长时，拆开喂：

长任务（写几千字长文、改十几个文件）不要一口气交代完。先让它出清单/大纲，你确认后再让它逐节、逐批推进。原因见文末的常见问题速查：链路太长，中转 API 容易中途断流，拆小之后每段都短，谁都掐不断。

十二、后续日常维护#

1
请按这个博客现有的文章格式，在仓库根目录建一个「文章模板.md」：包含完整的 frontmatter（标题、日期、描述、标签、分类、封面、草稿标记，字段和现有文章保持一致）和正文骨架。

1
我新写了一篇（文件在 src/content/posts/ 下），检查一下 frontmatter 和图片引用，没问题就提交推送。

1
请把这张歌单加进播放器：平台 网易云，ID 是 2804070207，名字叫「我喜欢的音乐」。加完构建验证，告诉我改了哪个文件。

十三、常见问题速查#

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

• 零服务器成本：不需要买云主机，Vercel / Atlas 免费额度对个人博客绰绰有余
• 零命令、零代码：装依赖、改配置、写文章、提交推送全部用自然语言完成，命令都在本文可复制
• 自动持续部署：源码在 GitHub，push 即发布，更新几分钟内全网上线
• 国内访问也不慢：把站放 Vercel 不等于国内就打不开——Vercel 官方文档提到其网络有面向国内的优选 IP，实测访问速度大约能达到备案后用国内 CDN 加速效果的 80% 左右（个人感觉）。省了备案和国内主机的钱，速度只让两成，对个人博客完全够用
• 数据完全自持：仓库在你自己账号下，随时可以换部署平台、换 AI 工具、甚至换回自己动手，博客不锁死在任何服务商
• 托管靠流程，不靠运气：权限给最小、规矩写成文件、批次切小、验收归人——这四条比模型本身更决定成败

接下来要做的只有一件事：把本文里所有的占位符换成你的名字和域名，然后对 AI 说出第一句需求。

参考#

• 番茄主理人，《零成本搭建 Firefly（Astro）个人博客，AI 全自动部署教程》 —— 本文体例与流程的主要参考
• CuteLeaf/Firefly —— Firefly 主题仓库
• MmzMing/my-blog —— my-blog 模板仓库，灵感屋的底子
• walinejs/waline 与 Waline 官方文档 —— 第九步独立评论后端的出处
• Astro 官方文档 —— 两套模板共同的框架
• Vercel 文档 —— 部署与自定义域名设置
• enhanced-FaaS-in-China —— 第六步优选 IP 的出处，社区维护的 Vercel 优选域名
• Vercel 官方指南，Accessing Vercel-hosted sites from mainland China —— 官方对国内访问的说明：自定义域名是第一步
• 二叉树树 AcoFork，《现代！易上手！高效！且社区支持的超高校级的MarkDown编辑器！》 —— 第十二步 Obsidian 写博客的配置方法：仓库根目录、图片链接与粘贴改名插件