Notion 数据库属性值的完整使用说明和规范，包含最新的 Card Size 属性说明与准确的同步文件路径。
📖 本文是 diw_craft 的内容管理参考手册，记录 Notion 数据库中每个属性的含义和合法值。
| 属性 | 类型 | 来源 | 用途 |
|---|---|---|---|
| Title | Title | 用户填写 | 文章标题 |
| Slug | Rich Text | 用户填写 | URL 路径，留空时使用 Page ID |
| Description | Rich Text | 用户填写 | 摘要，显示在卡片和 SEO |
| Category | Select | 用户选择 | 所属分类页（决定出现在哪个页面） |
| Status | Select | 用户选择 | 同步与访问控制 |
| Style | Select | 用户选择 | 卡片封面图展示方式 |
| Card Size | Select | 用户选择 | 卡片在 Bento 网格中的宽度 |
| Tags | Multi-select | 用户选择 | 标签，用于搜索索引 |
| Cover Image | Files & Media | 用户上传 | 封面图（同步时自动压缩） |
| Sort Order | Number | 用户填写 | 手动置顶权重，留空按时间排序 |
| Last Edited | System | Notion 自动 | 最后编辑时间 → 文章日期 + 增量同步判断 |
决定文章出现在哪个分类页面，每篇只能选一个。
| 值 | 对应页面 |
|---|---|
| project | /projects |
| writing | /writing |
| photo | /photos |
| experiment | /play |
控制内容是否同步到网站以及访问权限。
| 值 | 是否同步 | 说明 |
|---|---|---|
| draft | 否 | 草稿，仅在 Notion 可见 |
| in-review | 否 | 审阅中，仅在 Notion 可见 |
| published | 是 | 公开发布，所有人可访问 |
| protected | 是 | 需要密码才能访问 |
| archived | 否 | 已归档，仅在 Notion 可见 |
🔑 只有 published 和 protected 会被拉取到本地并构建到网站。
控制文章卡片在 Feed 页的封面图展示方式。
| 值 | 外观 | 封面图 |
|---|---|---|
| text-only | 纯文字卡片 | 不需要 |
| image-text | 图文卡片（封面 + 标题 + 摘要） | 必须 |
| image-only | 纯图片卡片 | 必须 |
⚠️ 选 image-text 或 image-only 时，Cover Image 必须上传，否则构建报错。
控制卡片在首页 Bento 网格中的宽度。
| 值 | 宽度 | 适合场景 |
|---|---|---|
| 1x1（默认） | 标准宽度 | 大多数文章 |
| 2x1 | 两倍宽度 | 需要突出展示的内容、图片横幅比例较宽的封面 |
💡 留空时默认为 1x1。2x1 适合想要视觉置顶或封面图比例偏宽的条目。
URL 路径，格式必须是 ASCII kebab-case（全小写 + 连字符）。
| 正确 | 错误 |
|---|---|
| yami-design-system | Yami Design System |
| ai-markdown-for-designers | AI_Markdown_designers |
| coffee-shop | coffeeShop |
⚠️ 留空时使用 Notion Page ID 作为 URL，不美观。建议每篇手动填写。
多选标签，统一使用小写 kebab-case。支持自由添加，用于搜索索引。
常用值：writing、ai、workflow、design-system、e-commerce、photo、experiment
手动控制 Feed 排序权重。数字越小越靠前。
| 场景 | 建议值 |
|---|---|
| 置顶展示 | 1、2、3… |
| 正常时间倒序 | 留空（默认） |
Notion 系统自动维护。同步脚本用它作为：
⚠️ 修改任何属性都会触发 Last Edited 更新，文章日期会随之变化。
npm run sync — 增量同步（只更新 Last Edited 有变化的页面）npm run sync -- --force — 强制全量重新同步
| 产物 | 路径 |
| --- | --- |
| 元数据 | content/metadata.json |
| 正文 Markdown | content/items/{slug}/body.md |
| 封面模糊占位图 | content/items/{slug}/blur.json |
| 封面 + 内联图片 | public/content-images/{slug}/ |
| 搜索索引 | public/search-index.json |