World Machine

一个用自然语言
维护的世界

告诉 Agent「阿贪 6 月 11 日搬到了河东」,它就能回答他现在住哪儿,也能查到他搬家前住哪儿,还能找回原话。

阿贪 6 月 8 日住河西,6 月 11 日搬到了河东。
旧传单写着西广场,但集市 13 日已搬到东广场,阿贪今天去东广场。
阿贪 14 日收到消息,渡船 12 日已复航。现在回看,13 日就能过河。
阿贪错过了 21:40 的末班车。试排 22:10 的一班车,他就能搭上,实际班表不变。

河畔搬家
回看过去

阿贪搬到了河东,搬家前住在哪儿也查得到。

周末集市
知道现在

旧传单写着西广场,但今天该去东广场。

北湾渡口
补记变化

14 日才收到通知,渡船其实 12 日就已复航。

夜间小站
原话留档

状态随新事实演进,当时的原话始终一字不改。

记下变化,就能查到事情现在怎样。

旧传单写着西广场,新通知说集市搬到了东广场。普通检索只会把两条碎片都丢给模型自己猜;World Machine 同时维护演进中的状态与不可变原话。

想知道什么
只查原文切片时
World Machine
现在在哪儿?
只查原文切片时旧传单和新通知都搜到了,还要让大模型自己猜哪个算数。
World Machine直接拿到当前状态。集市搬迁后,按当前查询就是东广场。
那天在哪儿?
只查原文切片时搜出一堆聊天记录后,还得让模型自己推算哪天换了地方。
World Machine按日期无损回看。传入历史时间点,查搬迁前的日子仍是西广场。
什么时候变的?
只查原文切片时今天才收到的补记消息,常被写入时间覆盖成“今天才发生”。
World Machine按实际发生时间排序。14 日收到复航通知,渡船从 12 日起就有效。
依据怎么说?
只查原文切片时做摘要容易丢细节,留原文又难以支撑准确的状态判断。
World Machine状态与原话一次返回。既看到结构化结论,也能核对当时原话。

看一句话怎么更新阿贪的住址。

切换下面的场景,看 World Machine 如何同步保存原话、更新带生效时间的状态,并支持任意历史时刻回溯。

阿贪搬家了

发生了什么

    现在的住址

    原话即时保存,状态随后自动更新 5 分钟亲手试一试 →

    一条命令,把长期记忆装进你的 Agent。

    通过官方 world CLI 与 world-machine Agent Skill,只需几分钟即可让编码助手和终端拥有跨会话的结构化记忆。

    SKILL

    让 AI 助手自动学会记忆管理

    npx -y skills add bootun/world-cli --skill world-machine -y

    安装配套 Skill 后,Claude Code、Cursor、Trae、Antigravity 等助手会自动掌握何时记录事实、何时召回背景以及如何按日期回溯。

    AUTH

    浏览器一键授权,无需手动管理密钥

    world auth login

    自动打开控制台完成确认,自动签发 CLI 专用凭证并安全保存到本机配置;远程或 SSH 环境支持 --no-browser。

    WRITE

    记下变化,自动附带本地时区与幂等重试

    world remember "我上个月搬到上海,现在在 Acme 当架构师。"

    保留原始自然语言表述即可,world 会自动附带本机 IANA 时区,准确解析「昨天」「上个月」等相对时间,并支持从标准输入管道读入长文本。

    RECALL

    按问题召回,随时用日期回看历史

    world recall "当时的项目状态是什么?" --as-of "2026-01-01"

    终端默认输出清晰易读的实体状态与原话;加 --json 可直接交给 Agent 或脚本解析,加 --as-of 可回到任意历史日期。

    两分钟,让你的 Agent 拥有记忆。

    把下面这句提示词直接发给你的 AI 编程助手即可自动装好;如果你习惯在终端手动执行,也可以切到「终端三步上手」。

    # 直接发送给 Claude Code / Cursor / Trae / Antigravity 等 AI 编程助手:
    帮我安装 World CLI:https://worldmachine.dev/cli-guide.md
    
    # 助手会自动读取安装指引,装好 world CLI 与 world-machine Skill,
    # 并引导你在浏览器里一键完成控制台登录授权。

    接下来读什么

    • 快速开始:从安装授权到第一次写入、召回与按日期回溯
    • CLI 与 Skill 手册:全部命令参数、多配置管理、环境变量与退出码
    • 核心概念:原文记忆与结构化状态、有效时间轴与可信度分级
    • 使用指南:怎么写更准、如何更正旧陈述、Agent 协同与安全边界
    • 底层 REST API:仅在自有后端或自定义框架直接调 HTTP 时查阅

    为什么优先用 CLI 与 Skill

    • 自动附带本机 IANA 时区,相对时间不再落错日期
    • 自动生成幂等键并安全重试瞬时网络波动
    • 浏览器一键授权,密钥安全存于本地配置,不暴露给对话或代码库
    • 配套 Skill 内置使用规范与隐私护栏,让 AI 助手开箱即用