三次调用：存储、召回、回答。
一个 API。recall() 调用在一次往返中返回短期记忆、长期记忆和周边上下文，可直接放入您的提示词。
1
存储
add() 保存事实与对话：用户的话、助手自己的话（speaker "me"），或某个具名者的话。写入时完成索引，不调用 LLM。
2
召回
recall() 在一次调用中返回短期 + 长期 + 上下文 - 一段大小固定、有界的上下文。
3
回答
把这段有界的上下文交给您的 LLM - 任何提供商，用您自己的密钥。
from wontopos import Client mem = Client(api_key="wos-...") mem.add("she prefers tea over coffee", user_id="alice") mem.add("I suggested the jasmine tea", user_id="alice", speaker="me") # its own words # one call: short + long + context ctx = mem.recall("what does alice drink?", user_id="alice")
记忆带有说话者。默认是用户的话，speaker "me" 存储助手自己说的话，而像 "Bob" 这样的名字会记住是用户身边的谁说的，让回忆可以按人来回答。
说话者和存储库一样是显式的。先注册，再以其名字保存。拼写错误绝不会悄悄变成一个新人。每个存储库起步可注册 50 人（会逐步提高），"me" 永远无需注册也不计数。