World Machine

Core Concepts

理解 World Machine 的世界模型

无论你通过 world CLI、Agent Skill 还是底层接口使用 World Machine,背后操作的都是同一套简洁的世界模型。读完这一页,你会彻底看懂每一次召回结果为什么长这样。

适用读者:所有用户与 Agent 开发者预计阅读:6 分钟
本页目录(6 节)

1. 记忆是原话,状态是结论

记进 World Machine 的任何一句话,首先都会被逐字保留为一条不可变的原文记忆(Memories)。原文不会被压缩成摘要,也不会在后续更新中被覆盖——你的 Agent 随时都能回头查证当时的原话。

在原话之上,系统会在后台自动理解陈述中的人、组织、地点与事实属性,持续更新结构化状态(Entities)。这是整个产品最重要的分界线:

层级代表什么时效与特性
原文记忆(Memories)当时说过的完整原话写入即落盘、立即可查、永不改写
结构化状态(Entities)从原话归纳出的实体属性与时间区间后台异步沉淀,随新事实自动演进

如果一句话只是普通寒暄或随手记下的感想、不包含明确的实体事实,它同样会完整保存在原文记忆里供语义检索,而不会强行捏造多余的实体噪音。

2. 实体是「谁」,组件是「关于它的什么」

实体(Entity)指代现实世界里一个独立的对象,比如一个人、一家公司、一个项目或一个地点。当前用户本人通常以 self 标识,其他人物或机构则保留规范名与已知别名。

组件(Component)是挂在实体上的某一方面属性,例如任职(Employment)、居住地(Location)或偏好(Preference)。不同组件彼此独立,各自记录自己的生效时间,互不覆盖:

一个实体挂载多个独立演进的组件 左侧是 Person 类型的 self 实体,右侧展示挂载在其上的 Employment 与 Location 两个组件,各自带有独立的 payload 与 validFromMs 生效时间。 entityId ce7b7b0c-4dbd-… canonicalName self entityType: Person Employment/emp:69df4761-… { organization: "Acme", title: "架构师" } epistemicStatus: stated_claim validFromMs "1794968245880" Location/loc:home { category: "home", city: "上海" } epistemicStatus: stated_claim validFromMs "1790784000000"
同一实体的不同属性各自独立演进。例如「上个月搬到上海」的居住地从上个月月初开始生效,而任职信息从当前声明时刻起算,互不覆盖。

实体类型和组件类型会随日常陈述自然演化,不局限于死板的固定表结构;如果某个组织只是在对话中被顺带提及、尚无额外属性,它也会作为独立实体建档,待后续补充信息后自然丰满。

3. 有效时间轴与时区

现实中的状态总是在某一天开始生效、在另一天发生变更。World Machine 为每个组件维护有效时间区间(从何时起生效,到何时结束;未结束的即为当前有效状态)。

使用 world recall --as-of "2025-09-15"(或 world entity get --as-of)时,系统会沿这条时间轴直接取出那一刻成立的状态切片:

有效时间轴与 asOfValidTimeMs 快照查询 横轴表示有效时间,Employment 从去年 9 月持续至今,Location 从 10 月 1 日开始生效。在 9 月中旬查询仅命中 Employment,在今天查询两者皆命中。 有效时间 Valid Time → 去年 9 月 10-01 今天 Employment organization = Acme Location city = 上海 asOf = 9 月中 只命中 Employment asOf = 今天 两个组件皆命中
有效时间决定「那一刻成不成立」。省略 asOfValidTimeMs 时默认返回当前有效状态;传入历史毫秒时间戳即可无损回看。

这也是为什么我们强调保留原句里的相对时间词(如「昨天」「上个月」「上周五」):world remember 会自动附带本机时区,让系统按说话人当地的日历日准确落盘,不会因为跨时区出现偏移。

4. 可信度与认知分级

每条结构化属性都会带上一个可信度分级标记(epistemicStatus),用来区分“这是用户自己口述的”还是“经过核验的客观事实”或“存在矛盾的陈述”:

分级标记含义Agent 使用建议
observed_fact经过核验的客观事实可直接作为高可信依据
stated_claim单方口述陈述(日常记录的默认等级)适合记录自述与偏好,涉及不可逆决策前应向用户确认
inferred_belief从其他信息间接推断出的结论作为参考线索,不直接当成硬事实
disputed_claim存在冲突待澄清的陈述提示存在分歧,建议结合原话进一步核实
unknown未归类或兼容取值程序解析时保留兜底分支
保留“谁说过”与“一定如此”的边界。用户随口说了一句计划,只代表他曾这样表述(stated_claim)。显式区分可信分级,能有效防止 Agent 把未经核实的闲聊当成绝对事实执行。

5. 账号空间与隔离边界

World Machine 的所有读写操作都通过登录凭证在云端鉴权边界自动绑定归属空间,不同账号的数据严格隔离:

登录凭证唯一决定账号记忆空间边界 本地 CLI 凭证或控制台密钥决定请求归属的云端记忆空间,写入内容与身份边界完全分离,不同账号空间之间严格隔离互不可见。 登录凭证 / API 密钥 由 world auth login 或控制台签发 记忆内容与上下文 原话文本 · 发生时间 · 本地时区 云端身份边界 按凭证自动绑定归属 不支持跨账号越权访问 隔离的记忆空间 仅对当前主体可见 控制台可随时撤销密钥
内容归内容,身份归凭证。每一条记忆都只写入当前授权账号名下的独立空间,不同主体之间完全隔离。
  • 单账号统一空间:同一控制台账号下授权的多个终端(如个人笔记本、工作机、不同 CLI 密钥)共享同一个记忆空间,随时同步。
  • 密钥随时可控:在 开发者控制台 可以按设备或用途给密钥命名,不再使用时一键撤销,不影响已有记忆数据。
  • 多终端用户隔离:面向多终端用户场景,可通过专属主体凭证为每个独立用户分配完全隔离的记忆空间。

6. 召回排序直觉

world recall 不是简单的“按时间倒序取最近 N 条”,而是综合语义相关性、实体关联度与时间新鲜度进行排序。

因此,一段半年前记下、但与当前提问高度相关的决定,往往会排在昨天一句无关闲聊之前。如果你的提问已经非常明确,适当缩小 --max-entities 和 --max-events 可以让给到模型的上下文更紧凑、噪音更少。