跳转到主要内容
Catalog 找东西;MetaSchema 解释架子怎么摆。

1. 用 Catalog 找具体对象

Catalog 是工作区内具体实体实例面向用户的目录。非系统实体写入成功后,HeavenBase 自动写入 Catalog 行。
当你只知道类型、名称、描述或 tags 等宽泛对象属性时,查询 Catalog。
Catalog.object_id 是 Catalog 行主键。Catalog.target_id 是目标对象的 object_idCatalog.target_entity 是目标实体类型。

2. 水合类型化行

Catalog 用于发现,不能替代类型化实体查询。选定 Catalog 行后,通过 workspace.get(...) 水合目标行。
当 object ID 可能在实体类型间重复时,使用 target_entity + target_id 组合。

3. 用 MetaSchema 看工作区结构

MetaSchema 描述工作区结构:实体、字段、存储放置、后端、capabilities、扩展与其他面向引擎的行。
MetaSchema 了解能查什么;用 Catalog 找到要查询或水合的实际对象。

4. 用 Capabilities 看可选项

hb.capabilities 是逻辑类型、存储策略、后端选择与操作支持的公开索引。它与 Catalog 不是一回事。
当答案应只反映某一工作区已配置的后端实例时,用 ws.capabilities

5. 审计与修复 Catalog 行

Catalog 行由实体行派生。若手动编辑后端文件或从部分失败恢复,在向 Agent 暴露工作区前先检查系统一致性。
dry_run=True 只报告修复计划,不写入或删除 Catalog 行。

进一步探索

相关资源: