# 个人博客功能文档

> 版本：v0.1.0  
> 阶段：第一版  
> 技术：Next.js  
> 目标：完成一个可写、可读、可部署的个人博客最小版本。

---

## 一、第一版必须完成的功能

### 1. 内容管理

- [ ] 支持使用 Markdown / MDX 编写文章
- [ ] 支持文章元信息：标题、日期、摘要、标签、草稿状态
- [ ] 支持草稿文章不展示
- [ ] 支持文章按日期倒序排列

### 2. 首页

- [ ] 展示站点名称和简介
- [ ] 展示文章列表
- [ ] 文章卡片展示：标题、日期、摘要、标签
- [ ] 点击文章卡片进入文章详情页

### 3. 文章详情页

- [ ] 展示文章标题、日期、标签
- [ ] 渲染 Markdown / MDX 正文
- [ ] 支持代码块高亮
- [ ] 支持基础排版：标题、列表、引用、链接、图片
- [ ] 提供返回首页入口

### 4. 关于页

- [ ] 展示个人简介
- [ ] 展示联系方式或社交链接

### 5. 404 页面

- [ ] 自定义 404 页面
- [ ] 提供返回首页入口

### 6. SEO

- [ ] 每个页面有 title 和 description
- [ ] 文章页有独立 SEO 信息
- [ ] 生成 sitemap.xml
- [ ] 生成 robots.txt

### 7. 基础体验

- [ ] 移动端和桌面端响应式
- [ ] 页面结构语义化
- [ ] 图片支持 alt 文本

### 8. 部署

- [ ] 支持部署到 Vercel
- [ ] 线上可访问
- [ ] 支持自定义域名和 HTTPS
- [ ] `npm run build` 成功

---

## 二、第一版不包含的功能

- 后台管理
- 数据库
- 用户登录
- 评论
- 搜索
- 统计
- 分页
- 标签页 / 归档页 / RSS
- 暗黑模式
- 多语言
- 广告 / 付费 / 会员

---

## 三、第一版完成标准

- [ ] 至少 3 篇非草稿文章
- [ ] 首页、文章页、关于页、404 正常
- [ ] 文章可正常阅读，代码高亮生效
- [ ] 移动端可正常阅读
- [ ] 线上部署可访问
- [ ] 构建无错误