说明书
CodePulse Blog:把个人博客做成可持续维护的内容系统
一个以 Markdown 为核心、同时提供可视化后台与可部署运维方案的个人博客系统。
项目概述
CodePulse Blog 是一个面向个人长期使用的技术博客与作品展示系统。它并不只解决“发布一篇文章”的问题,而是把个人信息、项目进展、文章沉淀、工具清单与简历展示组织为一套能够持续维护的内容系统。
站点前台提供首页、开发中、项目库、文章页、工具页和简历页;后台则提供站点配置、项目与文章的统一维护能力。内容最终以 Markdown 文件保存,既能通过后台编辑,也能在本地按文件管理,使内容资产不依赖单一数据库或在线平台。
设计目标
个人博客的维护周期往往以年为单位,因此本项目优先关注以下问题:
- 内容要便于迁移、备份和版本化,而不是被锁定在页面或数据库中。
- 后台操作要足够轻量,能完成日常发布、修改、导入、导出与检查。
- 部署更新不能覆盖线上长期积累的文章、项目和图片。
- 管理入口需要具备基本的身份校验、会话控制和写入保护。
- 前台不只是文章列表,也要能展示项目从进行中到完成的生命周期。
核心实现
项目以 Astro 和 TypeScript 构建站点,使用 Node 适配器以服务端模式运行。页面层负责阅读与展示,后台通过同源 API 完成登录、内容保存和图片上传;内容层把设置、项目和文章分别存放在 content 目录下,并通过 Front Matter 承载标题、日期、状态、标签、项目归属等结构化信息。
为了兼顾旧数据与新工作流,系统保留了 JSON 读取兜底和迁移脚本,同时以 Markdown 作为当前主要维护格式。后台提供 Markdown 编辑与预览、批量导入导出、内容审计、文章筛选排序和分页等能力,减少内容数量增加后的管理成本。
当前阶段
项目已经完成从基础站点到可维护内容后台的主要链路,并进一步补足了持久化部署、会话安全、上传校验及反向代理适配。当前内容系统仍处于持续完善阶段,后续工作重点是补充真实文章与项目资料,并在正式部署环境中持续验证备份与恢复流程。
CodePulse Blog 的价值不在于堆叠功能,而在于让“写下来的内容”拥有清晰、可控且可延续的归宿。