Four-Layer Memory Pipeline
Memory flows from user-visible lists to AI-distilled knowledge graphs across four layers:1
Memory List (user-visible)
You can view, add, edit, delete, enable, or disable each memory entry. This is the layer you interact with directly, with full control.
2
Evidence Snapshots (immutable)
When each memory is created, the system generates an immutable evidence snapshot — the original basis for “why this was remembered.” Even if the memory is later modified, the evidence is always preserved.
3
Core Facts (AI-distilled)
Periodic consolidation processes distill evidence into structured facts — entities (people, concepts, tools, projects) and relationships (preferences, usage, affiliation). Core facts are a read-time projection of currently active facts, not a second copy.
4
Memory Graph (visualization)
Core facts form a time-tagged knowledge graph. Each node is an entity, each edge is a relationship. You can visually browse it in the UI.
Entity Types
Entities in the memory graph fall into 10 types:
Entity names and fact descriptions follow the language of the evidence — Chinese memories produce Chinese facts, English memories produce English facts.
Contradiction Handling: No Deletion, Only Iteration
When new information contradicts existing facts, the system’s approach is not “delete the old one”:- The old fact is given an end timestamp (“Until last week, the user was using JavaScript”)
- The new fact begins from the current moment (“Starting this week, the user switched to TypeScript”)
- History is always preserved — the Expert can recall the complete evolution of decisions
Memory Consolidation (Dream)
Memory distillation is performed through two speeds of “consolidation” processes:Light Consolidation (post-conversation)
Key memories are extracted immediately after each quality conversation. Upon successful extraction, best-effort distillation into the graph follows. Fast, immediate, no information lost.
Deep Consolidation (scheduled)
A periodic scheduler scans unprocessed evidence and distills in batches. Each batch is size-limited to avoid single-call timeouts. Mid-process failures can be resumed — already processed portions are not lost.
Retrieval: Bounded and Efficient
When an Expert needs to recall, it doesn’t search all memories — it follows a precise four-step retrieval:1
Candidate screening
Based on the current conversation content, the most relevant candidate memories are screened (upper limit of 30).
2
Graph expansion
A 1-hop expansion is performed on entities in the candidates within the graph — finding directly related facts.
3
Re-ranking
Results are re-ranked by relevance, recency, and importance.
4
Context injection
The top 20 entries (not exceeding 2,000 tokens) are injected into the current conversation context.
“Bounded” is a key design decision. Injecting all memories wholesale not only wastes tokens but drowns out truly relevant information. 20 carefully selected memories are more useful than 200 generic ones. On retrieval failure, the system automatically degrades to a deterministic “latest 20” strategy.
User Control
Control of the memory system is entirely in your hands. On the Expert’s evolution page, you can manage memories through three tabs:Memory List
View, add, edit, delete, enable/disable each memory entry. This is the layer users directly operate.
Core Memories
View AI-distilled structured facts — entities, relationships, timestamps. Read-only view.
Memory Graph
A visual knowledge network. Nodes are entities, edges are relationships — see the complete picture of the Expert’s understanding of you at a glance.

