# 内容管理 (/docs/use/content)

Mix Space 支持三种主要的内容类型：**文章**（Post）、**日记**（Note）和**页面**（Page）。每种类型有不同的用途和字段。

## 内容类型对比

| 类型 | 用途 | URL 格式 | 特殊字段 |
|------|------|----------|----------|
| **文章** | 长篇博客文章 | `/{分类 slug}/{文章 slug}` | 分类、标签、置顶、相关文章、版权声明 |
| **日记** | 短篇手记、随想 | `/notes/{nid}` 或 `/notes/{年}/{月}/{日}/{slug}` | 心情、天气、密码保护、专题、位置 |
| **页面** | 独立页面（关于、友链等） | `/{页面 slug}` | 副标题、排序 |

所有内容类型共有的字段：

| 字段 | 说明 |
|------|------|
| **标题** | 内容标题 |
| **正文** | 支持 Markdown 和 Lexical 富文本两种格式 |
| **摘要** | 文章概要，留空可由 AI 自动生成 |
| **发布状态** | 已发布 / 草稿 |
| **创建时间 / 修改时间** | 自动记录 |
| **评论开关** | 是否允许评论 |
| **自定义元数据** | JSON 格式的扩展字段 |

## 文章管理

登录后台，进入「文章」页面。

### 创建文章

1. 点击右上角「新建」
2. 在编辑器中撰写内容
3. 在右侧面板中设置：

| 设置项 | 说明 |
|--------|------|
| **分类** | 必选，将文章归入一个分类 |
| **Slug** | URL 路径片段，建议英文小写加连字符（如 `my-first-post`） |
| **标签** | 自由标签，输入后回车添加 |
| **摘要** | 文章摘要，留空可由 AI 生成 |
| **版权声明** | 是否在文末显示版权信息 |
| **置顶** | 置顶该文章 |
| **发布状态** | 设为草稿或直接发布 |

### 文章列表

文章列表支持以下操作：

- **按分类筛选**：选择分类快速过滤
- **按年份筛选**：查看特定年份的文章
- **搜索**：按标题搜索
- **批量管理**：发布、撤回、删除

<Callout type="info">
文章的 URL 格式为 `/{分类 slug}/{文章 slug}`，例如 `/coding/my-first-post`。分类 slug 和文章 slug 共同决定了文章的唯一地址。
</Callout>

### 置顶

文章可以置顶，置顶的文章会排在列表最前面。多篇文章同时置顶时，按**置顶时间倒序**排列（最近置顶的排在前面）。

### 相关文章

在文章编辑面板中可以设置「相关文章」，为读者推荐关联内容。

## 日记管理

登录后台，进入「日记」页面。

### 日记特有字段

| 字段 | 说明 |
|------|------|
| **心情** | 记录写日记时的心情（如「开心」「思考」） |
| **天气** | 记录天气情况 |
| **专题** | 将日记归入一个专题 |
| **密码保护** | 为单篇日记设置访问密码 |
| **位置** | 记录写作地点（仅后台可见） |
| **书签** | 标记为收藏日记 |

### 日记 URL

日记支持两种 URL 格式：

- **NID 格式**：`/notes/{nid}`（自动递增的数字 ID）
- **日期 + Slug 格式**：`/notes/2024/01/15/my-thoughts`（需要手动设置 slug）

<Callout type="info">
日记的 slug 不是必须的。如果你想使用 SEO 友好的 URL（日期 + slug 格式），需要在编辑时手动填写 slug。未设置 slug 的日记只能通过 NID 访问。AI Slug 回填功能可以为缺少 slug 的日记批量生成。
</Callout>

### 专题

日记可以归入「专题」。专题是一组相关日记的集合，类似于一个迷你系列。

在后台「专题」页面中可以管理专题：

- 创建专题（名称、Slug、介绍、图标）
- 编辑和删除专题
- 在日记编辑时选择归属专题

### 密码保护

为日记设置密码后，访客需要输入密码才能查看内容。后台管理视图中可以直接查看，不受密码限制。

## 页面管理

登录后台，进入「页面」页面。

页面是独立的内容单元，通常用于「关于」「友链」「项目」等不归属于分类的固定页面。

### 页面字段

| 字段 | 说明 |
|------|------|
| **标题** | 页面标题 |
| **副标题** | 页面副标题 |
| **Slug** | URL 路径（如 `about` → `/about`） |
| **排序** | 数字越小排序越靠前，默认 `1` |
| **正文** | 页面内容 |

## 分类管理

在后台「分类」页面中管理文章分类。

每个分类包含：

| 字段 | 说明 |
|------|------|
| **名称** | 分类名称 |
| **Slug** | URL 路径片段 |
| **类型** | 分类（Category）或标签（Tag） |

<Callout type="warn">
删除分类不会删除该分类下的文章，但文章将失去分类归属。建议在删除前先迁移文章到其他分类。
</Callout>

## 内容格式

Mix Space 支持两种内容编辑格式：

| 格式 | 说明 |
|------|------|
| **Markdown** | 标准 Markdown 语法，适合习惯纯文本写作的用户 |
| **Lexical 富文本** | 可视化富文本编辑器，支持拖拽排版、嵌入等高级功能 |

你可以在后台设置中配置默认使用哪种格式，也可以在编辑时切换。

## 草稿功能

编辑器会自动保存草稿，防止意外丢失内容。草稿功能包括：

- **自动保存**：编辑过程中定时保存
- **草稿恢复**：打开文章编辑时，如果有未提交的草稿会提示恢复
- **草稿列表**：在编辑器中查看所有草稿

## 定时发布

文章和日记都支持定时发布：在编辑面板中设置 `publicAt` 字段为未来的某个时间，内容将在指定时间自动发布。

在此之前，内容保持草稿状态，前台不可见。