数据模型¶

World Simulation Engine 把叙事状态存储为结构化图数据。这个图不只是持久化层，也是工作记忆：模拟组件依靠它回答谁在场、角色私下相信什么、哪些记忆支持某段关系、哪些生成媒体属于某个回合等问题。

本节是贡献者参考，覆盖主要节点标签、关系、生命周期规则和 API 表面。

模型家族¶

完整实体关系图¶

flowchart LR
    Author["Author"]
    World["World"]
    Simulation["Simulation"]
    Location["Location"]
    Landmark["Landmark"]
    Character["Character"]
    BackgroundCharacter["BackgroundCharacter"]
    Intent["Intent"]
    Item["Item"]
    ItemStack["ItemStack"]
    Equipment["Equipment"]
    Container["Container"]
    Turn["Turn"]
    TurnPresentationBlock["TurnPresentationBlock"]
    Event["Event"]
    MemoryAtom["MemoryAtom"]
    SubjectiveEntityClaim["SubjectiveEntityClaim"]
    SubjectiveClaimChangeAudit["SubjectiveClaimChangeAudit"]
    EntityRelationship["EntityRelationship"]
    RelationshipChangeAudit["RelationshipChangeAudit"]
    EmotionState["EmotionState"]
    EmotionChangeAudit["EmotionChangeAudit"]
    Media["Media"]
    PromptMediaFile["PromptMediaFile"]
    WorkflowMediaFile["WorkflowMediaFile"]
    ConnectionConfig["ConnectionConfig"]
    ChatModelConfig["Chat model config"]
    EmbedModelConfig["Embedding model config"]
    ImageModelConfig["Image model config"]
    TtsModelConfig["TTS model config"]
    SttModelConfig["STT model config"]
    ImageGenerationConfig["ImageGenerationConfig"]
    TtsGenerationConfig["TtsGenerationConfig"]
    CharacterTtsConfig["CharacterTtsConfig"]
    GraphStateSnapshot["GraphStateSnapshot"]
    TurnVersion["TurnVersion"]
    WorldStateCheckpoint["WorldStateCheckpoint"]
    GenerationJob["GenerationJob"]
    SimulationAuditEvent["SimulationAuditEvent"]
    Trigger["Trigger"]
    TriggerActivation["TriggerActivation"]
    EntityVariableSet["EntityVariableSet"]
    VariableChangeAudit["VariableChangeAudit"]

    Author -->|CREATED| World
    World -->|NEW_VERSION_OF| World
    Simulation -->|BASED_ON| World
    World -->|CONTAINS| Location
    World -->|CONTAINS| Character
    World -->|CONTAINS| BackgroundCharacter
    World -->|CONTAINS| Item
    World -->|CONTAINS| Equipment
    World -->|CONTAINS| Container
    Simulation -->|CONTAINS| Location
    Simulation -->|CONTAINS| Character
    Simulation -->|CONTAINS| BackgroundCharacter
    Simulation -->|CONTAINS| Item
    Simulation -->|CONTAINS| ItemStack
    Simulation -->|CONTAINS| Equipment
    Simulation -->|CONTAINS| Container
    Simulation -->|CONTAINS| Turn
    Simulation -->|CONTAINS| EntityRelationship
    Simulation -->|CONTAINS| SubjectiveEntityClaim
    World -->|CONTAINS| SubjectiveEntityClaim
    Simulation -->|CONTAINS| EmotionState
    Simulation -->|HAS_GENERATION_JOB| GenerationJob
    Simulation -->|HAS_GRAPH_STATE_SNAPSHOT| GraphStateSnapshot
    Simulation -->|HAS_TURN_VERSION| TurnVersion
    Simulation -->|HAS_STATE_CHECKPOINT| WorldStateCheckpoint
    Simulation -->|HAS_AUDIT_EVENT| SimulationAuditEvent
    World -->|CONTAINS| Trigger
    Simulation -->|CONTAINS| Trigger
    Simulation -->|CONTAINS| TriggerActivation
    Trigger -->|FIRED| TriggerActivation
    World -->|CONTAINS| EntityVariableSet
    Simulation -->|CONTAINS| EntityVariableSet
    Character -->|HAS_VARIABLES| EntityVariableSet
    Turn -->|TRIGGERED| VariableChangeAudit
    VariableChangeAudit -->|CHANGED| EntityVariableSet

    Location -->|CONTAINS| Location
    Location -->|CONTAINS| Landmark
    Character -->|PRESENT_IN| Location
    BackgroundCharacter -->|PRESENT_IN| Location
    Character -->|ANCHORED_TO| Landmark
    BackgroundCharacter -->|ANCHORED_TO| Landmark

    Character -->|HOLDS| Intent
    Character -->|HOLDS| ItemStack
    Character -->|HOLDS| Equipment
    Character -->|EQUIPS| Equipment
    Character -->|HOLDS| Container
    Character -->|OWNS| ItemStack
    Character -->|OWNS| Equipment
    Character -->|OWNS| Container
    Container -->|HOLDS| ItemStack
    Container -->|HOLDS| Equipment
    Container -->|HOLDS| Container
    ItemStack -->|OF_TYPE| Item
    Equipment -->|PRESENT_IN| Location
    ItemStack -->|PRESENT_IN| Location
    Container -->|PRESENT_IN| Location
    Item -->|UNLOCKS| Container

    Turn -->|NEXT| Turn
    Turn -->|PART_OF| Event
    Event -->|INVOLVES| Character
    Event -->|CREATES| Intent
    Event -->|CONTRIBUTES_TO| Intent
    Turn -->|PROPOSED_STATE_CHANGE| Character
    Turn -->|PROPOSED_STATE_CHANGE| Location
    Turn -->|PROPOSED_STATE_CHANGE| ItemStack
    Turn -->|HAS_PRESENTATION| TurnPresentationBlock
    TurnPresentationBlock -->|HAS_VOICE| Media
    Turn -->|GENERATES_IMAGE| Media
    TurnPresentationBlock -->|GENERATES_IMAGE| Media

    Event -->|SUPPORTS| MemoryAtom
    Character -->|REMEMBERS| MemoryAtom
    Character -->|HOLDS_MODEL| SubjectiveEntityClaim
    SubjectiveEntityClaim -->|ABOUT| Character
    SubjectiveEntityClaim -->|ABOUT| Location
    SubjectiveEntityClaim -->|ABOUT| Item
    MemoryAtom -->|CLAIM_EVIDENCE| SubjectiveEntityClaim
    Turn -->|TRIGGERED| SubjectiveClaimChangeAudit
    SubjectiveClaimChangeAudit -->|CHANGED| SubjectiveEntityClaim

    Character -->|HAS_EMOTION_STATE| EmotionState
    MemoryAtom -->|EVIDENCE_FOR| EntityRelationship
    Character -->|RELATIONSHIP_SOURCE| EntityRelationship
    EntityRelationship -->|RELATIONSHIP_TARGET| Character
    MemoryAtom -->|EVIDENCE_FOR| RelationshipChangeAudit
    Turn -->|TRIGGERED| RelationshipChangeAudit
    RelationshipChangeAudit -->|CHANGED| EntityRelationship
    Event -->|CAUSED_EMOTION_CHANGE| EmotionChangeAudit
    MemoryAtom -->|EVIDENCE_FOR| EmotionChangeAudit
    Turn -->|TRIGGERED| EmotionChangeAudit
    EmotionChangeAudit -->|CHANGED| EmotionState

    World -->|HAS_MEDIA| Media
    Simulation -->|HAS_MEDIA| Media
    Character -->|HAS_MEDIA| Media
    Location -->|HAS_MEDIA| Media
    Item -->|HAS_MEDIA| Media
    ItemStack -->|HAS_MEDIA| Media
    Equipment -->|HAS_MEDIA| Media
    Container -->|HAS_MEDIA| Media
    World -->|HAS_COVER| Media
    Character -->|HAS_COVER| Media
    Location -->|HAS_COVER| Media
    Media -->|specializes as| PromptMediaFile
    Media -->|specializes as| WorkflowMediaFile

    World -->|USES| ChatModelConfig
    Simulation -->|USES| ChatModelConfig
    World -->|USES| EmbedModelConfig
    Simulation -->|USES| EmbedModelConfig
    World -->|USES| ImageModelConfig
    Simulation -->|USES| ImageModelConfig
    World -->|USES| TtsModelConfig
    Simulation -->|USES| TtsModelConfig
    ChatModelConfig -->|USES| ConnectionConfig
    EmbedModelConfig -->|USES| ConnectionConfig
    ImageModelConfig -->|USES| ConnectionConfig
    TtsModelConfig -->|USES| ConnectionConfig
    SttModelConfig -->|USES| ConnectionConfig
    Simulation -->|HAS_IMAGE_GENERATION_CONFIG| ImageGenerationConfig
    Simulation -->|HAS_TTS_GENERATION_CONFIG| TtsGenerationConfig
    Character -->|HAS_CONFIG| CharacterTtsConfig
    CharacterTtsConfig -->|USE_CONFIG| TtsModelConfig
    World -->|USE_PROMPT| PromptMediaFile
    Simulation -->|USE_PROMPT| PromptMediaFile
    World -->|USE_WORKFLOW| WorkflowMediaFile
    Simulation -->|USE_WORKFLOW| WorkflowMediaFile

跨领域规则¶

• World 是可复用的作者模板。Simulation 是基于某个 world 的可变运行状态。
• 大多数作者态和运行时实体通过 CONTAINS 连接到 World 或 Simulation。
• Simulation 可以通过 BASED_ON 读取继承的 world 数据，但运行时变更会提交到 simulation 图中。
• 正常状态下物理位置是互斥的：对象要么在地点中，要么被其他实体持有/装备，要么在容器中。
• Turn 使用 PROPOSED_STATE_CHANGE 记录提案；只有 state committer 写入拟议变更后，图才成为已提交事实。
• 私有上下文体现在角色字段、主观断言、关系 visibility、记忆和情绪状态中。呈现 API 应只暴露合适的渲染视图。
• 追踪变量是通用机制：任何实体（不只是 Character）都可以通过 HAS_VARIABLES 拥有一个 EntityVariableSet，其中保存自己的有类型/有边界的 VariableDefinition（对应 SillyTavern MVU variable schema）。变更审计方式与关系、情绪相同，通过 VariableChangeAudit 记录。
• TurnVersion 和 WorldStateCheckpoint 不是永久历史记录：它们的作用是让 turn 的重新生成和回退更安全，一旦故事真正 向前推进就会被清理（见事件、回合与动作）。