Gou Min · 项目

个人站重建

这个项目是对旧个人站的一次减法重建。它不再把后台、数据库和大量交互组件当作主角,而是围绕“好好写东西”来组织。

问题与目标

旧方案可以展示内容,却缺少稳定的内容模型、发布检查和可恢复的写作流程。页面更新依赖手工确认,草稿、预览和正式内容之间也没有清晰边界。

这次重建的目标不是增加更多页面,而是建立一条能够长期使用的闭环:访客能快速理解我是谁、做过什么;我自己则能低风险地写作、预览、发布和回溯历史。

当前方案

  • Astro 生成静态页面,Vercel 负责托管。
  • Navfolio 提供首页、博客、项目、随记、书影音和搜索骨架。
  • Markdown / MDX 作为内容源,与代码一起版本管理。
  • 站点以简体中文为默认语言,文案、导航、搜索和日期显示都优先服务中文阅读。

核心取舍

  • 公开页面保持静态。 后台只参与写作,不成为访客访问网站时的运行时依赖。
  • 文件是内容的最终来源。 没有额外数据库,所有变更都能通过 Git 查看和恢复。
  • 发布被拆成三个状态。 草稿允许不完整,待发布接受严格检查,只有已发布内容进入公开路由。
  • 预览使用真实页面组件。 不重新实现一套近似样式,减少“后台看起来正常、上线后不同”的偏差。

如何验证

发布门禁会检查内容字段、分类关系、图片与替代文本、重复网址和临时占位文字;构建验证会遍历生成页面和站内链接。后台的隔离 CRUD 测试还会真正创建、读取、更新和删除每种内容,同时验证图片、关系和路径保护。

项目边界

旧站会作为归档保留,新站在独立目录中开发和预览。只有当新版内容、构建和路由都验证通过后,才会切换 goumin.work 的部署。

回看

这次重建最重要的结果不是换了框架,而是让写作和发布变得可解释:每一步都有明确状态、下一步和失败反馈。后续功能是否加入,也会优先看它能否降低维护负担,而不是单纯增加后台选项。