update README.md

docs/pages/home.md

@@ -0,0 +1,68 @@
+# 首页
+
+首页是网站的入口，由 Hero 首屏、置顶文章和文章列表三个模块组成。
+
+## 页面结构
+
+首页从上到下依次为：
+
+1. **Hero 首屏** — 全屏展示区（可通过 Hero 设置关闭）
+2. **置顶文章** — 显示置顶的文章，大卡片布局
+3. **文章列表** — 非置顶文章的流式布局
+
+## Hero 首屏
+
+Hero 区域占据整个视口高度，包含：
+
+- **主标题**：默认使用站点标题，可在主题设置中自定义
+- **副标题**：默认使用站点副标题
+- **描述文案**：支持一言 API、自定义文案或关闭
+- **视觉效果**：渐变背景 + 呼吸光球 + 滚动模糊
+
+页面滚动时，Hero 区域会产生模糊效果，内容向上淡出，底部有向下箭头提示滚动。
+
+Hero 设置详见 [Hero 首屏配置](/config/hero)。
+
+## 置顶文章
+
+在 Halo 后台将文章设置为「置顶」后，该文章会出现在首页置顶区域：
+
+- 单篇置顶：全宽大卡片展示
+- 多篇置顶：两列网格布局
+- 显示分类、日期、标题和摘要
+- 支持封面图，悬停时图片微缩放
+
+## 文章列表
+
+非置顶文章以流式卡片布局展示：
+
+- **有封面图**：左侧内容 + 右侧缩略图
+- **无封面图**：纯文字布局
+- **移动端**：统一为上下布局
+
+每张卡片显示以下信息（均可通过主题设置控制显隐）：
+
+- 分类标签
+- 发布日期
+- 文章标题
+- 文章摘要（可配置行数）
+- 标签列表
+- 阅读量
+
+## 文章加载方式
+
+支持两种加载方式，在 [首页配置](/config/home) 中设置：
+
+### 分页
+
+传统翻页导航，页面底部显示「较新」「较旧」按钮和页码信息。
+
+### 无限滚动
+
+滚动到页面底部时自动加载下一页文章，新文章以渐入动画出现。加载过程中显示旋转加载指示器，全部加载完毕后显示提示文案。
+
+## 相关配置
+
+- [首页配置](/config/home) — 置顶/文章模块、卡片显示项、加载方式
+- [Hero 首屏配置](/config/hero) — 标题、描述、视觉效果
+- [样式设置](/config/style) — 配色、圆角、动画