​
目录结构

content/reading/
  design-as-art/
    index.mdx
  page-cover.json
page-cover.json 用于阅读列表页封面配置，文章正文在各自 index.mdx。

​
Frontmatter 字段

lib/reading/frontmatter.ts 校验字段： 
---
title: "Design as Art"
excerpt: "To understand what it means to be a designer today."
status: "draft" # draft | published | archived
author: "Bruno Munari"
publishedAt: "2026-02-01"
tags: "design, art"
cover: "/img/test.png"
readingMinutes: 5
featured: false
---

​
标签规则

  • tags 使用逗号分隔
  • 同步时会执行：trim + lower + 去重
  • 标签最终作为 Tag 与 BookPostTag 关系保存

​
封面图规则

支持：
  • /img/...
  • /uploads/...
  • ./assets/...（会自动映射）
  • 外部链接 https://...

​
发布流程

  1. 编辑 content/reading/<slug>/index.mdx
  2. 把 status 设置为 published
  3. 执行 npm run content:sync
  4. 在 /reading 和 /reading/<slug> 验证展示

​
数据读取优先级

Reading 模块优先读取数据库；若数据库不可用，会回退读取 content/reading。
如果你在本地只改了 MDX 但没有同步，数据库环境下页面可能不会立即显示变更。