Core Concepts
理解 World Machine 的世界模型
无论你通过 world CLI、Agent Skill 还是底层接口使用 World Machine,背后操作的都是同一套简洁的世界模型。读完这一页,你会彻底看懂每一次召回结果为什么长这样。
1. 记忆是原话,状态是结论
记进 World Machine 的任何一句话,首先都会被逐字保留为一条不可变的原文记忆(Memories)。原文不会被压缩成摘要,也不会在后续更新中被覆盖——你的 Agent 随时都能回头查证当时的原话。
在原话之上,系统会在后台自动理解陈述中的人、组织、地点与事实属性,持续更新结构化状态(Entities)。这是整个产品最重要的分界线:
| 层级 | 代表什么 | 时效与特性 |
|---|---|---|
| 原文记忆(Memories) | 当时说过的完整原话 | 写入即落盘、立即可查、永不改写 |
| 结构化状态(Entities) | 从原话归纳出的实体属性与时间区间 | 后台异步沉淀,随新事实自动演进 |
如果一句话只是普通寒暄或随手记下的感想、不包含明确的实体事实,它同样会完整保存在原文记忆里供语义检索,而不会强行捏造多余的实体噪音。
2. 实体是「谁」,组件是「关于它的什么」
实体(Entity)指代现实世界里一个独立的对象,比如一个人、一家公司、一个项目或一个地点。当前用户本人通常以 self 标识,其他人物或机构则保留规范名与已知别名。
组件(Component)是挂在实体上的某一方面属性,例如任职(Employment)、居住地(Location)或偏好(Preference)。不同组件彼此独立,各自记录自己的生效时间,互不覆盖:
实体类型和组件类型会随日常陈述自然演化,不局限于死板的固定表结构;如果某个组织只是在对话中被顺带提及、尚无额外属性,它也会作为独立实体建档,待后续补充信息后自然丰满。
3. 有效时间轴与时区
现实中的状态总是在某一天开始生效、在另一天发生变更。World Machine 为每个组件维护有效时间区间(从何时起生效,到何时结束;未结束的即为当前有效状态)。
使用 world recall --as-of "2025-09-15"(或 world entity get --as-of)时,系统会沿这条时间轴直接取出那一刻成立的状态切片:
asOfValidTimeMs 时默认返回当前有效状态;传入历史毫秒时间戳即可无损回看。这也是为什么我们强调保留原句里的相对时间词(如「昨天」「上个月」「上周五」):world remember 会自动附带本机时区,让系统按说话人当地的日历日准确落盘,不会因为跨时区出现偏移。
4. 可信度与认知分级
每条结构化属性都会带上一个可信度分级标记(epistemicStatus),用来区分“这是用户自己口述的”还是“经过核验的客观事实”或“存在矛盾的陈述”:
| 分级标记 | 含义 | Agent 使用建议 |
|---|---|---|
| observed_fact | 经过核验的客观事实 | 可直接作为高可信依据 |
| stated_claim | 单方口述陈述(日常记录的默认等级) | 适合记录自述与偏好,涉及不可逆决策前应向用户确认 |
| inferred_belief | 从其他信息间接推断出的结论 | 作为参考线索,不直接当成硬事实 |
| disputed_claim | 存在冲突待澄清的陈述 | 提示存在分歧,建议结合原话进一步核实 |
| unknown | 未归类或兼容取值 | 程序解析时保留兜底分支 |
stated_claim)。显式区分可信分级,能有效防止 Agent 把未经核实的闲聊当成绝对事实执行。5. 账号空间与隔离边界
World Machine 的所有读写操作都通过登录凭证在云端鉴权边界自动绑定归属空间,不同账号的数据严格隔离:
- 单账号统一空间:同一控制台账号下授权的多个终端(如个人笔记本、工作机、不同 CLI 密钥)共享同一个记忆空间,随时同步。
- 密钥随时可控:在 开发者控制台 可以按设备或用途给密钥命名,不再使用时一键撤销,不影响已有记忆数据。
- 多终端用户隔离:面向多终端用户场景,可通过专属主体凭证为每个独立用户分配完全隔离的记忆空间。
6. 召回排序直觉
world recall 不是简单的“按时间倒序取最近 N 条”,而是综合语义相关性、实体关联度与时间新鲜度进行排序。
因此,一段半年前记下、但与当前提问高度相关的决定,往往会排在昨天一句无关闲聊之前。如果你的提问已经非常明确,适当缩小 --max-entities 和 --max-events 可以让给到模型的上下文更紧凑、噪音更少。