Skip to content

真相

真相是一个世界的规范定义:规则、agent、可读视图。它由创作者治理,可版本化、原子化、可审计。应用和 agent 读真相;只有获授权的创作者工具能改写真相。

真相承载哪些内容

概念用途
WorldRule创作者编写的世界规则
AgentRule绑在某个世界范围里的 agent 真相
WorldRelease任意世界发布动作的正式锚点
CanonicalTruthPackage上游真相摄入的正式对象
Projection 输入该世界支持哪些读视图
治理 / 发布元数据版本、来源、审计

真相由创作者治理。应用和 agent 可以读;只有创作者工具(持适当授权)能改写。一次 runtime 故事执行不会无声改写真相。一个应用持有的叙事归档由应用自己持有,不是 Realm 规范层数据。

WorldRelease

发布是一次原子事务级别的提交。

字段用途
包版本这是该 package 的哪一版
来源谁发布、用什么工具
Checksum可校验哈希
Diff 元数据与上一次发布相比改了什么
Rollback 血缘这次发布接续了哪一次、可以回退到哪一次

回退是一次发布操作,不是临时的改写。一次有问题的发布通过另一次发布去取代;问题发布不会从历史里删除,而是被取代。

CanonicalTruthPackage

Package 区分以下成分:

组成用途
规范真相单元世界规则、agent 规则、scene 规则等
派生 / 继承输入世界真相如何约束 agent 真相
Projection 输入该世界支持哪些读视图
治理 / 发布元数据版本、来源、审计

世界设定文本和 prompt 内容永远不是 package 的规范中心。它们可以是 projection 的输入,但本身不是真相。

InheritanceLink 是从世界真相到 agent 真相的正式派生边。

字段用途
世界真相范围
目标受约束的 agent 真相范围
Materialization该边在 host 层呈现的样子

正因为有它,"这个 agent 是这个世界的居民"才是一种真实的强类型关系,而不是一种约定俗成。从世界真相继承的 agent 把约束保持在可见处。

Worldview、Lorebook、Browse DTO

真相通过 projection 读取。Projection 层不会暴露原始真相,只暴露已准入的 projection 形状。

Projection暴露内容
detail-with-agents公开读侧聚合;可能暴露 activeRuleCountagentRuleSummary
Worldview读侧聚合 projection
Lorebook选取的设定内容

Projection 不会暴露原始的 AgentRule 内容。Projection 层是有意收窄的。

场景:创作者编写世界真相

某创作者要为一个世界写规则、agent 和 scene。

  1. 编写真相单元。世界规则、带 inheritance link 的 agent 规则、scene 规则。
  2. 作为草稿暂存。本地工作集:truthDraftstateDrafthistoryDraft
  3. 打包成 CanonicalTruthPackage。真相单元 + 派生输入 + projection 输入 + 治理元数据。
  4. WorldRelease 原子发布。真相被冻结,带来源和 rollback 血缘。
  5. 世界变成可访问目的地。应用可通过准入的 projection 读真相;按 AgentRule 绑定的 agent 是这个世界的一部分。

原子事务是关键性质。不会出现"发了一半"的世界。

场景:真相不是应用的叙事归档

某应用想为一个世界做长篇叙事归档。

  • 这份叙事归档由应用持有,不是 Realm 规范数据。Realm 真相是世界的规范定义;故事执行的输出按默认不是真相。
  • 应用可以把叙事存在自己的私有状态里、存在一个准入的 Realm 资产里、或作为内容文档存在,但不能作为 Realm 规范真相。
  • 创作者如果希望叙事中的某一部分变成规范真相,必须走准入的真相发布流程(创作者工具 + WorldRelease)来抬升。

这层分离很重要:Realm 真相是平台规范层数据,叙事是应用层数据。如果混在一起,任何应用都能无声改写世界规则。

来源依据

Nimi AI open world platform documentation.