datocms-content-modeling

DatoCMS 内容建模

设计可复用、便于编辑的 DatoCMS 架构。提供建议无需 CLI、MCP、登录或设置。使用提供的需求/架构；仅在需要时，通过可用且经授权的途径检查实时架构。在此确定结构；下方介绍实现途径。

核心原则

1. 内容是数据，而不是页面。 按含义构建结构，而非按呈现方式。
2. 单一事实来源。 避免重复内容。
3. 不要重新创建内置内容。 记录元数据（created_at、published_at 等）、资源元数据（alt、title、custom_data、focal_point）和排序（position）都已存在——绝不要在记录或区块上添加同类字段。请参阅 references/separation-of-concerns.md 和 references/model-configuration.md § 行为 — 排序。
4. 面向未来。 为未知渠道和重新设计预留空间。
5. 以编辑者为中心。 优先满足编辑者，而非开发者。除非显而易见，否则始终为字段、字段集和模型添加提示——架构就是编辑界面。请参阅 references/separation-of-concerns.md § 提示。

路由

确定建模方案后：

• 实现 — datocms-cli（迁移，默认）或 datocms-cma（用户选择不使用迁移/希望立即修改架构）。
• 查询/呈现 — datocms-cda 用于 GraphQL 读取和 Structured Text 查询片段；datocms-frontend-integrations 用于框架呈现。
• 验证器和级联策略机制 — datocms-cma/references/schema.md（链接/结构化文本验证器、on_reference_delete_strategy 等）。
• 构建、编辑或验证 DAST — datocms-structured-text：文档模型、编辑；导入/导出源内容 → 转换。CMA 会持久化最终负载。

缺少同级参考资料时，此处的建模建议仍然适用；有关实现机制，请从 datocms/agent-skills 安装该技能，或更新完整套件。

参考资料

必须遵守——切勿凭记忆建议模型、区块或字段。在提出任何结构化问题或架构建议之前，先加载所有与当前决策相关的参考资料。

决策 → 文件：

• references/separation-of-concerns.md — 按含义而非外观进行命名和塑形；重新设计测试；record-meta、file/gallery-meta 和 position 重复的反模式。
• references/models-vs-blocks.md — 模型与区块的区别；结构规则（不允许孤立项、不允许引用链接字段、语言环境继承）；每条记录的限制（300 KB / 500 个区块 / 5 层）；语言环境乘数。
• references/block-fields-and-structured-text.md — single_block 与 rich_text（Modular Content）及 structured_text 的区别；内联、区块、itemLink 和 inlineItem 矩阵；原生节点建模方式；原生节点（blockquote、code、list、heading、thematicBreak、link）——切勿将其重新创建为区块；图片／图库／视频区块形状（不含同级 caption）。
• references/content-reuse.md — 链接字段、项目级 Blocks Library、内置 seo、无框单区块、字段集分组、区块库规范。
• references/taxonomy-classification.md — 扁平标签、树形模型、通过多个链接实现多面分类、级联策略。
• references/ui-organization.md — Content 选项卡的 menu_item（编辑者）、Schema 选项卡的 schema_menu_item（开发者）、通过 item_type_filter 保存的视图、表情符号惯例、信息架构启发式。
• references/model-configuration.md — singleton、草稿模式、all_locales_required、可排序／树形／排序、inverse_relationships_enabled、presentation_title_field、presentation_image_field、collection_appearance、CDA SEO 回退；先创建再连线的机制。
• references/field-configuration.md — 验证器（enum、format、length、unique、slug_title_field、required_alt_title、required_seo_fields、transformable_image、尺寸、结构化文本大小）；appearance 编辑器（string_select+enum、markdown/wysiwyg/textarea、带框与无框的 single_block、link_select 与 link_embed、structured_text 节点／marks／heading_levels、SEO 预览、slug url_prefix、颜色预设）。