用途：让智能体在当前调用结束后仍能记住信息，例如客户偏好、联系人已知信息、已查询过的订单，避免下次重复获取。它不同于知识库（知识库存放预先编写的文档），也不同于自动保留的最近若干条对话历史。
主要能力：一是按语义检索的事实记忆，写入时对文本做嵌入，用 memory.add / memory.search 按含义召回；二是按 key 精确读写的集合（collections），JSON 进 JSON 出，支持 set/get/delete/list/query。所有读写都发生在唯一作用域内且相互隔离，作用域分 project（默认，上限 10000 条事实）、contact（2000 条）、conversation（1000 条）。
使用方式：在函数或工具中通过 ctx.memory 访问，需 @zavudev/functions 0.3.0 或更高版本。ctx.memory 为 project 作用域；ctx.memory.contact 与 ctx.memory.conversation 为可选属性，缺失时需处理，否则可能抛出 MemoryScopeError；也可用 forContact(id)、forConversation(id) 指定。集合查询需索引，索引只能在创建时声明，例如 npx zavudev memory collections create orders --index status。CLI 命令均支持 --scope project / contact:<id> / conversation:<id>。REST API 中，写入与搜索的 scope 放在请求体，其余接口放在查询参数。
适用场景：客服或机器人记住单个联系人的偏好、跨线程累积长期知识、缓存已查过的订单等结构化数据。
限制：事实文本上限 8 KB，元数据 2 KB；搜索结果最多 20 条、默认 5 条；集合文档序列化后 200 KB、32 层；每个集合索引固定 2 个；批量操作 25 条；TTL 为 60 秒至 2 年。key 仅允许 A-Z a-z 0-9 . _ : @ -，1–255 字符，E.164 电话号码需去掉加号或加前缀。metadata 不参与搜索。本地 createLocalContext() 使用进程内桩，搜索按子串匹配而非语义，query 不校验索引，检索质量需用测试模式密钥对真实 API 验证。计费按单元计量，写入为读取的 5 倍，另计存储；免费额度含 250000 单元、0.5 GB、10 个集合和 5000 条 project 事实。读取与删除不因配额被拒，仅写入受限。