今天做了什么

今天请助手帮我梳理了博客项目里的 Markdown 文件，也问了怎样写第一篇真实记录。现在把这次梳理本身记下来，作为日记的开始。

项目里一共有 11 个 Markdown 文件。根目录的《个人博客.md》是一份 63 天的搭建计划，其余文件分别用于网站入口、示例文章和写作模板。

这份计划分成四步：先用 VitePress 搭起能写、能看的静态博客，再开发 FastAPI 后端和 Vue3 前端，最后完成部署、备份和内容迁移。自研系统完成后，再决定是否把日常写作切换过去。

今天还结合源码确认，项目已经有自定义首页、栏目页、文章列表和本地编辑器。不过，目前的三篇文章仍然是示例，不能当作自己的学习记录。计划中列出的任务，也不能直接算作已经完成。

卡在哪里

这次主要想弄清楚两个问题：目录里的这些 Markdown 文件分别做什么，以及第一篇日记应该从哪里开始写。

例如，首页文件只有几行配置，没有通常意义上的正文；日记、项目和读书感悟又放在不同目录里。如果只看文件名，还不容易理解它们怎样组成网站。

写作上也需要一个具体的起点。今天能记录的事情，就是梳理项目、了解文件结构，以及确认写作方法。

怎么解决的

把文件按用途分开后，结构清楚了很多：

• docs/index.md 是首页入口，页面内容由 Vue 组件生成。
• docs/posts/ 放日记，日记文件按年月分目录。
• docs/projects/ 放项目记录，docs/reading/ 放读书感悟。
• 每个栏目里的 index.md 是栏目列表页。
• docs/.vitepress/templates/ 保存新建文章时使用的正文模板。

文章开头由 --- 包围的部分叫 frontmatter，用来填写标题、日期、标签和摘要；后面才是正文。文章属于哪个栏目，由它所在的目录决定，列表则按日期倒序排列。

也弄清楚了现有编辑器的使用步骤：在项目目录执行下面的命令，打开终端给出的本地网址，点击侧栏的“写文章”，选择“日记”，填写标题和正文，再预览、发布。

npm run docs:dev

这里的“发布”会把文章保存为本地 Markdown 文件。线上网站的更新还需要推送和部署。本地编辑器只在开发环境中提供，不能把它理解成已经上线的写作后台。

今天确认的是这些文件和代码的作用。私有仓库、域名绑定、Cloudflare 部署以及访问保护是否完成，还需要另外核验。

今天留下的一点想法

以后写日记，可以从一件具体的事开始：做了什么、哪里不清楚、这次怎样弄明白，以及还留下什么问题。暂时没有解决的部分，也可以如实记下来。

项目已经有了日记、项目、读书感悟三个栏目。将来做后端和导入导出时，要记得保留栏目以及书名、作者、项目状态等信息，避免迁移时只剩下文章正文。

明天计划

走一遍本地编辑流程：启动博客，找到这篇日记，打开编辑器，补充一句新的记录并保存，再刷新确认修改还在。以完成这一次“打开—编辑—保存—查看”为目标。