|
Download docs/memory.md from weideyouni/holoaeon: direct link, hf CLI and curl.
- Browser
- Download file 1.28 kB
-
https://huggingface.co/weideyouni/holoaeon/resolve/main/docs/memory.md
- Command line
-
hf download hf://weideyouni/holoaeon/docs/memory.md
-
curl -L -o memory.md https://huggingface.co/weideyouni/holoaeon/resolve/main/docs/memory.md
1.28 kB
记忆(三层存储)
记忆提供线程安全的存取、检索、巩固与衰减。
1. 三层结构
| 层 | 容量 | 角色 |
|---|---|---|
working |
256 | 当前任务上下文,可被巩固提升 |
longterm |
100,000 | 跨任务沉淀,带强度与标签 |
archive |
1,000,000 | 稳定事实与参考,不衰减 |
2. 记忆项(MemoryItem)
每条记忆含:key、value、kind、tags、ts(时间戳)、strength(强度)。
3. 核心操作
put(key, value, kind, tags, strength):写入,超容量时自动淘汰最弱项;get(key):按键精确取值;recall(query, k):按 token 重叠 + 标签命中打分,返回前 k;consolidate(min_strength):足够强的工作记忆提升为长期记忆;decay(rate):工作/长期记忆强度衰减,归档不衰减。
4. 检索打分
score = Jaccard(query_tokens, item_tokens) + 0.1 · strength
5. 持久化
支持 to_dict / load 的 JSON 序列化,便于跨会话恢复。
6. 用法
from holoaeon.memory import Memory
m = Memory()
m.put("k", {"a": 1}, kind="working", tags=["x"])
m.consolidate()
print(m.get("k")) # {'a': 1}
print(m.recall("x"))