概念索引

面向 schema、service、CLI、Web UI、MCP 和样例包贡献者的概念地图。

推荐阅读顺序

1. 对象图语义层
2. Workspace 与 Domain
3. Model Elements
4. EntitySet
5. DataSet
6. Link 与字段映射
7. Storage 与 GraphStore
8. Entity 与 Relation
9. 查询入口

概念地图

flowchart LR
  Workspace["Workspace"]
  Domain["Domain"]
  EntitySet["EntitySet"]
  DataSet["DataSet"]
  Storage["Storage"]
  DataLink["DataLink"]
  EntitySetLink["EntitySetLink"]
  StorageLink["StorageLink"]
  Entity["Entity records"]
  Relation["Relation records"]
  Query["Query Service"]
  Agent["AgentGateway / MCP"]

  Workspace --> Domain
  Domain --> EntitySet
  Domain --> DataSet
  Domain --> Storage
  EntitySet --> DataLink
  DataLink --> DataSet
  DataSet --> StorageLink
  StorageLink --> Storage
  EntitySet --> EntitySetLink
  Entity --> Query
  Relation --> Query
  EntitySet --> Query
  DataSet --> Query
  Storage --> Query
  Query --> Agent

概念分组

分组	概念	角色
范围	Workspace、domain	隔离模型和运行时数据。
模型定义	EntitySet、DataSet、Storage、Link	在写入运行时数据前定义语义契约。
运行时图	Entity、Relation	提供 Query Service 可读取的对象图实例。
读取入口	.umodel、.entity、.topo	让 REST、CLI、Web UI、SDK、MCP 使用同一套查询路径。
存储抽象	GraphStore provider	让同一服务可运行在内存、文件或 Ladybug-backed provider 上。

源码入口

• Schema 定义：schemas/
• 公共模型类型：pkg/model/types.go
• 公共服务契约：pkg/contract/contracts.go
• 多域 Quickstart 样例包：examples/quickstart-multidomain