Skip to content

Entity module

跨模块浏览当前 subject world 内全部 entities 行,并管理软删回收站。

  • 路径:/entity
  • 导航:模块 id entityhabitat_nav_entity
  • 范围:跟随 Shell User / Agentsubject_kind → 对应 private world)
Tab数据排序
全部deleted_at IS NULLupdated_at DESC
回收站deleted_at IS NOT NULLdeleted_at DESC

行字段:id、title、primary_component、components、时间戳。存活行可 deleteEntity(软删);回收站可 restore。满 30 天由睡眠 cleanup purge 物理删除。

Method作用
entity.list存活实体分页
entity.trash.list回收站分页
entity.delete软删;无 force 且存在引用时返回 references
entity.restore从回收站恢复
entity.deleteComponent删除单个 component

删除语义总表见 entity-model.md「Deletion semantics」。