文章 · 编程

个人博客搭建记录

从买下域名却不知道做什么,到借助 Agent 把需求逐步变成一个可以运行的个人网站。

#Agent#Astro#个人网站
文章目录
  1. 先弄清楚自己真正需要什么
  2. 为什么选择静态网站
  3. Agent 做了什么,我做了什么
  4. 从本地运行到生产构建
  5. 当前状态与下一步

买下 unsiscon.com 之后,我其实并不知道下一步应该做什么。

我知道自己想拥有一个不依赖社交平台的网站,也大概知道它可以先作为个人博客使用。但至于首页应该长什么样、应该放哪些内容、使用什么技术、以后怎样维护,我都没有明确答案。于是,这个网站并不是从挑选模板或写代码开始的,而是从一连串问题开始的。

先弄清楚自己真正需要什么

最开始,我很容易把问题理解成“怎样搭建静态网站”。但真正需要决定的事情远不止技术框架:这个网站面向谁、我愿意公开什么、内容如何分类、没有文章时首页应该怎样呈现,以及几年之后我是否还愿意继续维护它。

Agent 没有立刻给出一套现成方案,而是不断向我提问。我逐渐确定,这里首先是一个个人博客和长期网络驻地,而不是作品集或求职简历;内容会以 AI、编程、产品和工具为主;长内容作为文章,较短的想法作为笔记;书影音和项目可以在真正有内容时再出现,空栏目不需要为了完整而摆上假数据。

视觉方向也是这样一点点确定的。我不想要常见的明亮卡片式博客,更喜欢克制、安静的夜间氛围。最后选定了“夜间书房”的背景、圆形头像、深色界面,以及以主题书架和时间线为核心的首页结构。

这一步给我的最大感受是:在 Agent 能快速生成代码之后,真正困难的部分往往变成了描述需求和做出选择。模糊地说“做得好看一点”很难得到稳定结果;说明希望营造什么感觉、哪些内容暂时不存在、什么信息不应该出现,反而更重要。

为什么选择静态网站

目前这个网站不需要账号系统、评论区或复杂的在线数据。文章由我自己编写,更新频率也不会特别高,因此静态网站是更合适的起点。

最终采用的组合是 Astro、Markdown、pnpm 和 Cloudflare Pages:

选择用途
Astro生成轻量的静态页面,并保留组件化能力
Markdown用普通文本编写文章、笔记和项目记录
pnpm管理项目依赖和本地命令
Cloudflare Pages之后连接代码仓库并部署到自己的域名

这个选择并不是因为我已经熟悉这些工具。相反,大部分结构是 Agent 根据需求搭建的。对我来说,更实际的判断标准是:网站能否保持简单、内容能否长期保存、以后更换样式时是否不需要重写文章,以及部署成本是否足够低。

Astro 的内容集合会检查文章的标题、日期、主题和草稿状态。生产构建只收录真正公开的内容,本地开发环境则可以预览草稿。这样我可以先把想法写下来,确认排版和内容之后再发布,而不必在公开页面上保留示例文章。

Agent 做了什么,我做了什么

这个网站的大部分代码由 Agent 协助完成,包括项目配置、页面结构、内容模型、响应式样式、图片优化、RSS、站点地图和部署说明。背景与头像也在确定视觉方向之后生成,再由 Astro 转换成适合网页加载的尺寸和格式。

如果只看代码量,很容易得出“网站是 Agent 做的”这个结论。这当然没有错,但也没有覆盖整个过程。

我需要决定网站叫什么、以什么身份出现、首页先展示什么、哪些栏目隐藏、内容应当如何区分,以及视觉结果是否符合自己的感觉。每一轮预览之后,我也需要指出哪些地方不对。例如,最初没有真实文章时,首页仍然显示空的主题书架;手机页面内容太少,页脚过早出现在首屏。这些并不是代码无法运行,而是结果与需求不一致。Agent 根据这些判断继续调整,直到桌面和手机页面都更接近想要的状态。

这种协作让我意识到,使用 Agent 并不意味着可以完全跳过理解。它确实能让我在技术基础还不完整时先做出原型,但当出现依赖冲突、构建错误或设计取舍时,我仍然需要知道问题发生在哪一层,并逐渐理解每个文件和命令的作用。现在我还做不到独立写出整套网站,但已经有了一个可以继续拆解和学习的真实项目。

从本地运行到生产构建

目前最常用的命令只有几条:

pnpm install
pnpm dev
pnpm check
pnpm build

pnpm dev 用来在本地写作和预览,包括尚未发布的草稿;pnpm check 检查页面和内容配置;pnpm build 生成最终的静态文件。部署时,Cloudflare Pages 只需要执行构建命令并读取 dist 目录。

写下这篇初稿时,网站还没有正式部署。随后代码被推送到 GitHub,并由 Cloudflare Pages 自动构建,最终绑定到 unsiscon.com。现在记录这些命令,不是为了把文章写成完整教程,而是给未来的自己保留一份最小可复现的入口。如果很久之后忘记这个项目怎样启动,至少可以从这里重新开始。

当前状态与下一步

这次搭建没有让我突然“学会前端”,也不能说明我已经掌握 Astro 或完整的 Web 开发流程。更准确的说法是:我借助 Agent,把一个模糊需求推进成了可以运行、检查和继续维护的项目,并在过程中第一次具体接触了静态生成、内容结构、响应式设计和部署配置。

接下来,这个网站需要真正的内容,而不只是一个完成的外壳。我会继续补充学习记录和项目过程,并尝试把正在做的 AI 伴侣逐步记录下来。相比单次对话是否足够聪明,我目前更关心长期记忆和关系感:一个系统能否记住共同经历,理解关系随时间发生的变化,并维持相对稳定的人格。

更远一些,我希望在研究生阶段逐步接触具身智能和视觉—语言—动作模型。这些现在仍然只是想探索的方向,因此更需要保留真实的起点。几年之后再回来看,也许网站的名字、关注的问题和使用的工具都会改变,但这些变化本身正是建立个人网站的意义之一。