博客搭建器
帮助用户启动个人博客 —— 从框架选择到上线部署,并包含完整的 SEO。全流程:框架选择 -> 主题 -> 文章模板 -> 部署 -> SEO。
工作流程
第 1 步 —— 了解用户背景
询问(或从上下文推断):
- 技术背景?(非技术人员 / JS 开发者 / Python 开发者 / 等等)
- 从零开始还是已有现有站点?
- 偏好的部署目标:GitHub Pages、Vercel、Cloudflare Pages?
- 内容重点:写作、作品集、教程博客、文档?
第 2 步 —— 推荐框架
| 情况 | 推荐 |
|---|---|
| 非技术人员,只想写作 | Hugo —— 零 JS,速度快,主题库庞大 |
| 已经会写 JS/TS,想要组件控制 | Astro —— 岛屿架构,开发体验极佳 |
| 喜爱主题生态,熟悉 Node | Hexo —— 成熟的插件生态 |
| React 开发者,想要完全控制 | Next.js —— App Router + MDX |
给出推荐及简短理由。确认后再继续。
第 3 步 —— 框架设置
阅读相应的参考文件,引导用户完成安装和入门主题:
| 框架 | 参考文件 |
|---|---|
| Hugo | references/hugo.md |
| Hexo | references/hexo.md |
| Astro | references/astro.md |
| Next.js | references/nextjs.md |
第 4 步 —— 生成文章模板
生成一个可直接使用的文章模板文件,包含完整的 Frontmatter。 assets/post-templates/ 中的资源模板是起点 —— 复制并根据用户选择的主题和偏好进行调整。
第 5 步 —— 部署
阅读 references/deployment.md 了解相应的 CI/CD 工作流。提供完整的 GitHub Actions YAML,可直接提交。
关键提示:
- GitHub Pages:推送到 .github/workflows/deploy.yml;在仓库设置中启用 Pages
- Vercel:在控制台中连接仓库;设置框架预设和输出目录
- Cloudflare Pages:构建命令 = npm run build,输出目录 = dist(Astro/Hexo/Next.js)或 public(Hugo)
第 6 步 —— SEO 配置
每个博客都需要:
- sitemap.xml —— 框架特定;见 references/.md
- robots.txt —— 提供实际文件内容,而不仅仅是描述
- Open Graph 标签 —— og:title、og:description、og:image、og:url 作为实际标记
- 规范化 URL —— 在配置中设置 baseURL / site,以便站点地图和 OG 标签正确工作
始终注意:站点 URL 必须在框架配置中设置,站点地图才能生成正确的绝对 URL。
指导原则
- 提供实际文件内容(代码、YAML、TOML),而不仅仅是描述
- 只包含关键的字段 —— 避免冗余样板
- 指出一两个容易出错的地方(例如,Hugo 的 baseURL、Astro 的 site 字段)
- 优先提供可直接复制粘贴的示例