SuperAPI AI 工具集

memory

通用与其它

查看项目

更新于 10-15 22:17

技能介绍

用途:为会话提供跨会话持久记忆。每轮自动把当前 bank 的规则与相关记忆注入上下文,回合结束后在后台抽取新记忆,长期指令会逐步沉淀为 bank 自动管理的 learned rule。用户说“记住某事”时无需保存调用,但显式 memory::save 可立即持久化。

主要能力:规则是整篇注入系统提示的 markdown 文档(memory::rule::*,存于 bank 的 rules/ 目录);记忆是可召回的记录,按当前问题排序(memory::save/list/recall)。持久身份级指引放规则,时点信息放记忆。函数包括 save、get/list/update/delete/pin、recall、preview、tags、bank::create/list/delete、rule::list/set、supersede、doctor、reload。

使用方式:用户要求记住或纠正时用 memory::save { "text": "...", "entities": [...], "pinned": true },重复保存为强化而非重复;询问记得什么用 memory::recall { "query": "..." };修正或遗忘先 recall/list 找到,再 update 或 delete,并用 pin 保护;统一风格用 memory::rule::set { "bank": "...", "name": "style", "content": "..." }。不同场景用不同 bank,会话通过 session metadata memory_bank(session::set-meta)或控制台选择器指定,memory::bank::create 新建。记忆疑似缺失时运行 memory::doctor {} 做保存→召回往返测试。

触发与限制:memory::item-changed 在记忆创建/更新/取代/删除时触发,memory::bank-changed 在 bank 创建/回收及规则变更时触发,仅在需要观察他人变更时绑定,投递为 fire-and-forget、至少一次、无序。它不是会话记录存储(由 session-manager 负责),也不是逐轮上下文压缩(由 context-manager 负责)。删除为墓碑,bank 删除移入 .trash/,include_superseded: true 可查看历史;抽取只增不改不删,去重合并由 memory-consolidate 负责;注入受 max_rule_chars 与 recall_budget_tokens 限制,超预算规则会可见截断。