# Roleplay 会话变量

为每个故事保存结构化变量，例如角色状态、关系、物品、地点和任务进度。变量与对话历史一起保存，可在后续回复、重新打开对话或创建分支时继续使用。

Writer 只接收变量命名空间的名称、说明和当前值。revision、更新协议、Schema、语义规则与诊断不会占用写作 Prompt；这些操作资料会单独交给父 Agent，用于生成并校验最终的变量更新。

变量可以限制类型、范围和必填项，并支持设置、数值增减、数组追加和删除。界面会展示最近一次回复造成的变化；删除或重新生成相关回复时，变量也会恢复到对应的故事状态。

剧情更新采用严格的语义字段：设置和数组追加使用 `value`，数值增减使用 `by`，删除不携带值。字段写错时提交会保持原子失败，并返回可直接纠正到具体变更项的提示，不会只应用其中一部分变量。