Catalog 找东西;MetaSchema 解释架子怎么摆。
1. 用 Catalog 找具体对象
Catalog 是工作区内具体实体实例面向用户的目录。非系统实体写入成功后,HeavenBase 自动写入 Catalog 行。
Catalog.object_id 是 Catalog 行主键。Catalog.target_id 是目标对象的 object_id,Catalog.target_entity 是目标实体类型。
2. 水合类型化行
Catalog 用于发现,不能替代类型化实体查询。选定 Catalog 行后,通过workspace.get(...) 水合目标行。
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 行。

