零点未来 · 技术科普

本体论设计的四项核心原则与典型反例

基于 Palantir Foundry 官方设计指南与行业实践经验,构建"像真实世界一样直观"的企业知识图谱。
四项原则按优先级排序,七个典型反例正反对照呈现。

领域驱动设计 + 不要重复构建相似实体 + 对扩展开放 + 组合优于继承
核心原则 · 最高优先级
01

领域驱动设计

Domain-Driven Design — 本体论建模真实世界,而非源数据

本体论的对象应代表语义上有意义的真实世界概念(如"患者""工单""船舶"),而非数据库表、API 响应或电子表格标签页。 链接应代表真实关系(如"该患者到访了该设施"),而非外键或 JOIN 关系的产物。

建模三步法:领域 → 模型 → 数据
1. 理解业务领域 识别真实世界实体与关系 Understand the Domain 2. 设计本体论模型 定义对象 · 属性 · 链接 · 接口 Design the Ontology 3. 映射源数据与逻辑 管道 · 聚合 · 清洗 · 写入 Map Source Data & Logic 不要从源数据结构出发反推模型设计,先理解领域
❌ 典型反例 ·不作筛选直接映射(Kitchen Sink)

错误做法

拿到一个数据集或 CSV,不做任何领域分析,直接将每一列映射为一个属性,把技术元数据(_crm_extracted_at、_crm_sequence)混入业务模型。源数据长什么样,本体论就长什么样。

❌ 避免 — 从数据出发,1:1 映射 // 一个 CSV 行 → 一个对象类型,所有列直接映射
OrderData {
  order_id, customer_name, customer_email,
  product_sku, quantity,
  _crm_extracted_at, _crm_sequence, // 技术列也混入
}
✅ 最佳实践

正确做法

先理解领域,再设计模型,最后映射数据源。一条 CSV 可能隐藏了多个实体(订单、客户、产品),需要拆分为独立对象类型并用语义链接关联。技术元数据留在后台数据集,不进入本体论。

✅ 推荐 — 领域分析 → 模型设计 → 数据映射 // 从同一个 CSV 中识别出三个实体
Order { order_id, quantity } → 链接到 Customer、Product
Customer { name, email }
Product { sku }
// 技术列只存在于后台管道中,不出现在本体论
❌ 典型反例:从数据出发✅ 正确模式:从领域出发
看到数据集 → 直接建模理解领域 → 设计模型 → 映射数据
属性从源字段 1:1 映射,无筛选属性经过精心筛选,只保留有业务含义的字段
命名使用源系统缩写(dtLastInspMod)命名使用业务语言(lastInspectionDate)
一个 CSV 行直接变成一个对象类型一条数据可能拆分出多个实体(订单→客户+产品+订单)
技术元数据(_crm_extracted_at)混入业务模型技术元数据留在后台数据集,不出现在本体论中

🎯 判断标准:一个用户或 AI 代理应该能够无需查阅文档,仅凭直觉就能在本体论中导航——因为它的结构匹配他们对领域的认知方式。

核心原则 · 第二优先级
02

不要重复构建相似实体

Don't Repeat Yourself — 同一实体只建一次,三次出现则重构

重复的对象类型、冗余的属性和复制粘贴的工作流是维护噩梦和上下文管理问题——对人类和 AI 代理都是如此。 目标是每个概念有唯一的规范化表示,每个操作有唯一的规范化工作流。

一次是巧合,两次是模式,三次必须重构
Sales Customer { name, email, phone, dealSize } Support Customer { name, email, phone, ticketHistory } Billing Customer { name, email, phone, paymentMethod } 三次法则触发重构 → 方案 A:单一规范化类型 Customer { name, email, phone, lifecycleStage } 或 方案 B:接口共享 interface CustomerBase { name, email, phone } 接口:定义一组共享属性,多个对象类型去实现它 — 后面结构模式章节会详细展开 多个类型 implements 同一个 interface → 共享的部分定义一次,特殊部分各自扩展
❌ 典型反例 ·部门孤岛(Department Silos)

错误做法

三个部门各自独立创建客户对象类型:Sales Customer、Support Customer、Billing Customer——每个都有 name/email/phone,加上各自的特殊字段。三套 Action、三套维护负担,同一客户信息还不一致。

❌ 避免 — 三个孤立团队各自建模 Sales_Customer { name, email, phone, dealSize }
Support_Customer { name, email, phone, ticketHistory }
Billing_Customer { name, email, phone, paymentMethod }
// 同一客户在三个类型中都有记录,信息不一致
✅ 最佳实践

正确做法

创建单一规范化 Customer 类型(方案 A),或使用 Interface 定义共享形状(方案 B)。一次出现是巧合,两次形成模式,三次必须重构。

✅ 推荐 — 规范化 + 接口共享 // 方案 A:单一规范类型(推荐大多数情况)
Customer { name, email, phone, lifecycleStage }

// 方案 B:接口共享(类型形状确有本质差异时)
interface CustomerBase { name, email, phone }
SalesLead implements CustomerBase { + dealSize }
SupportContact implements CustomerBase { + ticketHistory }
核心原则 · 第三优先级
03

对扩展开放,对修改关闭

Open for Extension, Closed for Modification — 保护核心模型,让构建者扩展它们

一旦一个对象类型、接口或工作流经过验证并投入生产,其核心结构就应保持稳定。 其他团队应该能在不修改核心模型的前提下,通过扩展来添加新能力。

❌ 典型反例 ·上帝对象

错误做法

新需求来了就往核心类型上塞属性。Equipment 类型本来只有基本字段,后来加入了认证信息、维护记录、财务折旧……最终膨胀为 150+ 属性、大部分为 null 的"万能对象"。

❌ 避免 — 不断往核心类型加字段 Equipment {
  serialNumber, model, location, // 核心
  certificationAuthority, certExpiry, certStatus, // 认证团队加的
  depreciationMethod, bookValue, fiscalYear, // 财务团队加的
  lastMaintenanceDate, mtbf, sparePartsList, // 维护团队加的
  // ... 150+ 属性,大多为 null
}
✅ 最佳实践

正确做法

核心类型保持精简,通过链接扩展类型和接口实现来添加新能力。核心类型不受影响,新能力按需扩展。

✅ 推荐 — 链接扩展 + 接口 // 核心类型保持稳定
Equipment { serialNumber, model, location }

// 认证能力:链接到扩展类型
Equipment → EquipmentCertification { authority, expiry, status }

// 可巡检能力:实现接口
Equipment implements Inspectable { lastInspectionDate, inspectionStatus }
Equipment 🔒 核心模型 · 锁定不变 🔒 EquipmentCertification 链接扩展类型 Inspectable 接口 接口实现 MaintenanceRecord 链接扩展类型 ⬆ 核心类型不变,新能力通过链接 + 接口扩展 ⬆
核心原则 · 第四优先级
04

组合优于深层继承

Composition over Deep Hierarchies — 多接口实现,保持可插拔

Foundry 本体论支持通过接口实现多重继承——一个实体可以从多个聚焦的抽象中组合行为, 而不需要陷入单一继承链的泥潭。

❌ 深层继承链(错误) Asset PhysicalAsset Building SchedulableBuilding ✕ ✅ 接口组合(正确) Building { address, sqft } SchedulableResource { calendar, bookingPolicy } implements Arena { arenaName, seatingCapacity }

💡 关键洞察:构建在 SchedulableResource 接口上的工作流,不做任何修改就能用于 Arena、会议室和车辆——深层继承链永远做不到这一点。

结构设计指南

四大结构模式:构建高效本体论的"语法"

除了四项核心原则,Palantir 还提供了四个关键的结构设计模式,它们是本体论的"语法规则"。

📐 规范化与派生属性

"每个事实只存一次。用派生属性提供便利访问。"

❌ Manager.directReportCount = 5(手动维护整数)
✅ Manager.directReportCount = 派生属性(自动计数)
❌ Employee.managerName = "Alice"(复制值)
✅ Employee → manager(链接,自动获取 name)

⚠️ 超过 ~10k 对象/查询时,考虑有意识地反规范化。

📦 结构体

"将语义相关的字段组合为

ISAAC / MEMBERSHIP继续阅读

把这篇文章,
读到最后。

开通月度会员,继续阅读本篇剩余内容。

  • 解锁会员文章的完整内容与图示
  • 更高档位可下载 skill、加入 AI 咨询营
月度会员

¥30/ 月

查看会员权益

按月开通 · 到期手动续费

已有会员?登录后继续阅读 →
文章阅读全文Skill 与咨询营微信支付
ISAAC / MEMBERSHIP

阅读更深入,
交流也更近一步。

¥30/ 月

开通月度会员 ↗

所有文章均可试看约 40%。单次开通一个月,到期手动续费。