Three Worldly Heart · Memory System

三世心

过去心不可得，现在心不可得，未来心不可得

一套基于「三世心不可得」哲学构建的 AI 记忆系统。
通过 prepare / capture 主循环、overview / resume 渐进披露、
以及 OpenClaw Host Hook / MCP / REST API 三条表面，让 AI 在多通路中保持连续性与治理能力。

SCROLL
Core Visualization

三层嵌套 · 流动不息

三世心不是三层割裂的存储，而是同一意识在不同「时间性」上的投影。 每一层都在旋转、呼吸、相互渗透。

未来心 · Future
现在心 · Present
过去心 · Past
觉知之眼
Witness · 观察者
过去心
Past Mind · Historical Layer
已发生的对话、决策、事实——沉淀为持久对象。 通过 ledger、对象层与可选 semantic assist 被重新召回。 每一次 capture / turn.finish 都在为它增添新的沉积层。
Event Ledger Governed Objects (SQLite) Audit Chain Semantic Assist (optional)
现在心
Present Mind · Active Layer
正在发生的这一轮对话。prepare 预加载上下文， capture / turn.finish 将结果原子化写回。三世心最「薄」但最「亮」 的一层——所有意义的生成都发生在现在心。
/v1/prepare /v1/capture · turn.finish turn_index Working Memory
未来心
Future Mind · Intentional Layer
待完成的承诺、悬而未决的意图、pending_intents。 open_future 追踪尚未兑现的线索， 使 AI 能够主动回访未竟之事。
open_future pending_intents future_commitments decision_topic
Lifecycle

Prepare → Finish / Capture
同一条主循环的不同投影

REST 里它叫 prepare / capture，MCP 里它叫 turn.prepare / turn.finish。 名字可以不同，但读写边界、scope 契约与记忆主干始终只有一套。

POST
/v1/prepare · turn.prepare
生成前注入 bounded memory context
→
⟳
AI 生成回复
当前消息与记忆块在现在心交汇
→
POST
/v1/capture · turn.finish
沉淀 turn，刷新 future 与 working state
写入边界
capture / turn.finish
assistant_reply + pending turn + governed updates + postprocess
⟳
读取边界
prepare / turn.prepare
session_id + user_message + participants + bounded recall + packet
/v1/search
对象优先的 bounded recall
/v1/event-search
跨 channel 事件证据切片
/v1/overview
渐进式记忆披露
/v1/expand
按 handle 下钻对象细节
/v1/resume-packet
上下文恢复包
/v1/handoff
跨宿主迁移契约与续接包
/v1/session
lane 快照与 session summary
/v1/procedure-draft
从会话事件提炼技能草稿
/v1/admin
inspect / correct / invalidate / resolve / forget
/v1/turn-proxy
宿主无法拆钩子时的一次性兜底
Integration Surfaces

三条一等公民表面
不是所有宿主都走同一种入口

TWH 的统一之处，不是逼所有产品共用一条协议，而是让 Host Hook、MCP 与 API / SDK 共享同一条 runtime spine。宿主可以不同，记忆主干不应该分裂。

OpenClaw Host Hook Surface
外挂式记忆覆盖
适合飞书、微信、OpenClaw 这类有 inbound hook 的消息宿主。 通过 openclaw-twh 插件注入 prepare / capture，实现 shadow packet 与 continuity overlay。
Host Hooks → openclaw-twh → Shadow Packet → Runtime Spine
openclaw-twh Feishu / Weixin Shadow Packet memory_slot
MCP Surface
Workbench 的自然入口
适合 Codex、Claude Code、Trae、Cherry Studio 这一类可调工具的 agent workbench。 通过 twh-mcp 暴露小而稳定的 tool / resource / prompt contract，而不是第二套 runtime。
MCP Server → Runtime Packet / Session Bridge → Runtime Spine
turn.prepare turn.finish session.search memory.overview / expand
API / SDK Surface
服务端与自有产品直连
适合自研 AI 应用、网关、编排服务和 Python 直连宿主。 REST API (:8765) 与 Python SDK 只是产品壳，仍复用同一套 prepare / capture / search / admin / session / events 契约。
HTTP API (:8765) / Python SDK → TwhMemoryFacade → SessionMemoryService
/v1/prepare /v1/capture /v1/admin /operator
Data Model

Scope & Filters
记忆的路由层

Scope 定义「谁的记忆」，Filters 定义「哪部分记忆」。 TWH 的读、写、删、改都共享这套语言，并坚持 deterministic filter 先行，semantic assist 后置。

Scope — 主体与通道
subject_id required
记忆的持久主体标识。跨 channel 召回记忆的锚点。
origin: caller_or_host · surfaces: prepare, capture, search...
session_id lane
会话/线程 continuity 键。在 turn 生命周期里是必要路由键，但它不天然等于召回过滤条件。
origin: caller_or_host · lane continuity only
channel optional
当前 lane 的传输通道：mcp / api / feishu / weixin / codex。
origin: host_derived
actor optional
当前 turn 或事件的行为者。自动从 host envelope 派生。
origin: host_derived
workspace_id optional
工作区边界，当宿主暴露 tenant 或 workspace 时使用。
origin: caller_or_host
project_id optional
项目/应用边界，当宿主暴露 project / app lane 时使用。
origin: host_derived
agent_id optional
当前 lane 的 assistant / agent 身份标识。
origin: host_derived
decision_topic optional
治理话题 lane，用于决策导向的记忆路由。跨接入面的重要锚点。
origin: caller_or_host · surfaces: prepare, capture, search, admin...
Filters — 先筛后排
temporal_layers optional
选择记忆来自哪一层：past / present / future。三世心的时间观首先体现在过滤上，而不是摘要文案上。
supports multi-layer recall
channel / workspace / topic optional
跨面 recall 优先用 subject_id + channel / workspace_id / decision_topic 收窄，而不是盲目缩到单一 session。
deterministic scope first
object_types / status optional
区分 facts、profiles、decisions、future commitments 与 events，并显式暴露 effective / resolved / invalidated 等治理状态。
bounded governed recall
occurred_after / before optional
对事件层做时间切片。跨面调查先走时间窗口，再决定是否进入语义辅助或 overview / expand。
ISO 8601 timestamp
limit / candidate_limit optional
控制 recall 预算和候选规模，避免把记忆系统退化成 transcript dumping。
semantic assist stays bounded
Flow

事件先入账，再长出记忆
跨通路的 runtime 时间线

每一次跨 channel 的操作，先在 append-only ledger 中留下一笔， 再通过 governed objects、projection 与 assist layer 被重新组织。

T − ∞
过去证据层
所有已完成的 turn、治理动作与事件切片都先进入 ledger 与 audit chain。过去心先是证据，再被提炼为当前有效对象。
T = 0
prepare(user_message)
新消息到达。prepare / turn.prepare 携带 session_id + user_message，触发 scope 解析、participant resolution、deterministic recall 与可选 semantic assist。结果被压成有界「记忆块」。
T = prepare + Δ
AI 生成 → 用户可见回复
AI 基于「记忆上下文 + 当前消息」生成回复。这是现在心最活跃的瞬间，也是未来心开始被塑形的地方。
T = Δ + capture
capture / turn.finish
回复已发送。capture 将本轮 turn 写入 ledger，刷新 working state，并把 facts / profiles / future commitments 等 governed updates 固定下来。
T = +background
异步 extract / consolidation
后台 worker 对新事件做提炼、working memory 刷新、冲突清理与投影重建。它只能产出 proposal 或派生更新，不绕过治理直接篡改真相源。
T = next host / next turn
overview / resume / next prepare
当上下文压缩、宿主切换或下次对话到来时，TWH 先给 resume-packet / overview，再按需 expand 或 event-search，让过去心、现在心、未来心在新窗口里低成本续接。
Continuity & Governance

渐进披露 · 有界续接
不是把 transcript 整段塞回模型

长线程压缩、宿主切换、跨面接手时，TWH 先给极小的连续性投影，再按 handle 展开。 治理写面与操作台也始终站在同一条主干之上，而不是另起一套后台。

L0 · Resume Packet
如果现在继续干活，最少要知道什么
极小预算的数据包，携带当前主线、focus、open_future、freshness 与关键 scope。适合 host switch、窗口压缩与冷启动续接。
/v1/resume-packet 200 - 500 tokens
L1 · Overview
告诉模型“有哪些主题可展开”
返回紧凑的 topic map、handle、freshness 和 source counts。不是全量回忆，而是让后续 recall 变成按 handle 下钻。
/v1/overview handle map
L2 · Expand Detail
对象优先，而不是 transcript 优先
对某个 handle 给出 facts、profiles、decisions、future objects 与紧凑证据引用，让模型看到“当前有效状态”而不是整段聊天回放。
/v1/expand object-first detail
L3 · Raw Evidence
只有在显式需要时，才下钻到事件切片
事件证据、source refs、message ids 和时间切片始终可查，但默认不注入。它是核查路径，不是日常 prompt 填充路径。
/v1/event-search /v1/events
Governance
纠正、失效、解决、重开
TWH 不只“记住”，还要能纳管。facts、profiles、decisions、future commitments 都可以通过同一条 admin control plane 被 inspect、correct、invalidate、resolve、reopen、retarget、forget 或 purge。
/v1/admin correct invalidate resolve reopen retarget
Operator Shell
观测面、仪表盘与事件流
轻量 operator console 直接挂在同一 runtime 上，通过 /operator、/v1/operator/* 与 /v1/events/stream 提供总览、explorer、活动 tail 与接入面健康检查。
/operator /v1/operator/overview SSE live tail
Boundary
真相源、投影层、辅助层严格分开
ledger 与 governed objects 才是 canonical state；overview、resume、dashboard 是可重建投影；向量、FTS、rerank 只是 recall assist。TWH 追求的是有限上下文加分层记忆，而不是“无限上下文”的幻觉。
truth source projection assist only
Interactive

Runtime Packet 模拟器
体验三世心如何对外显形

点击不同场景，观察主循环、续接、显式事件检索与治理写面如何投影成统一 contract。 这里展示的是贴近当前 TWH 表面的结构化结果，而不是随意拼出的概念 JSON。

POST /v1/prepare
场景
Architecture

系统架构
从接入层到存储层

API Server (:8765) 只是 TWH 的一个产品壳，不是唯一入口。 真正统一的是 SessionMemoryService / TwhMemoryFacade 这条 runtime spine，Host Hook、MCP、REST 与 SDK 都只是它的不同投影。

PUBLIC SURFACES 公共表面 openclaw-twh / twh-mcp / REST API (:8765) / Python SDK / operator
openclaw-twh Plugin
twh-mcp Server
REST API (:8765)
Python SDK
/operator console
/v1/events/stream (SSE)
↕
CORE FACADE 核心门面 prepare / capture / search / session-search / admin / session / events
/v1/prepare
/v1/capture
/v1/turn-proxy
/v1/search
/v1/event-search
/v1/resume-packet
/v1/session-search
/v1/handoff
/v1/overview
/v1/expand
/v1/admin
/v1/session
/v1/events
/v1/procedure-draft
/v1/events/stream (SSE)
↕
RUNTIME SPINE 运行主干 SessionMemoryService / TwhMemoryFacade / SQLite / Projection / Assist
Event Ledger (append-only)
Governed Objects (SQLite)
Audit Chain
Projection Layer
Semantic Assist (optional)
Background Extract / Consolidation
Scope Resolution
Participant Resolution
Session Registry
Truth Source
Ledger 与审计链
每次 turn、治理动作、事件切片先写入 append-only ledger。它解释“发生过什么”，而不是只保存最终摘要。
Governed State
当前有效对象
facts、profiles、decisions、future commitments、pending intents 才是 TWH 当前有效状态的表达，而不是一份 transcript 复制品。
Projection Layer
Overview、Resume、Session Summary
overview、expand、resume-packet、dashboard 都是可重建投影，用来节省上下文和提升人机可见性，但它们不是第二真相源。
Assist Layer
FTS、事件检索、向量辅助
检索增强负责“更容易找到”，不负责“定义什么是真的”。它应该帮助 recall，而不是把 TWH 退化成纯向量记忆系统。
💬
feishu
飞书消息
💚
weixin
微信消息
⌨
codex
Codex 终端
🔗
mcp
MCP 协议