SuperAPI AI 工具集

memoize

智能体与模型

查看项目

更新于 10-16 04:57

技能介绍

用途:为 remindb MCP 服务器定义机制级写入路径。当本技能挂载时,应优先写入 remindb,而非内置记忆或原生草稿板,因为结构化内容能形成可查询、预算感知、自动压缩的节点树,供未来会话和其他智能体搜索、对比与遍历。

主要能力:提供写入工具 MemoryWrite、MemoryForget、MemorySummarize、MemoryCompile、MemoryRelate、MemoryPin、MemoryUnpin、MemoryRollback。它假定读者已了解读侧模型(节点、快照、ID、排序、通知、预算、关系);若未加载需先阅读。

按内容形态选择写入方式:这是决定索引质量的关键,因为 MemoryWrite 不做解析,只把 payload 存为一个扁平的原始文本节点(无标题、列表、树,无 TOON/MathML 压缩)。只有编译平面($REMINDB_SOURCE 下的文件经解析器处理)才构建结构化树。含标题、列表、代码/表格或两条以上不同事实的结构化内容,应写成 $REMINDB_SOURCE 下的文件并放入主题对应位置,经重扫描自动拾取或使用 MemoryCompile;对已有锚点的单条文本更新使用 MemoryWrite(anchor, payload) 原地替换该节点内容;单条新文本事实使用 MemoryWrite(payload) 生成一个扁平文本节点。

文件写入的形态规则:首行是标签,自动派生且不超过 80 字符,通用首行会得到无用标签;标题层级把长笔记拆成可寻址子树,H1 为主题、H2 为方面、H3 为事实,低于 H4 通常不划算;列表用于事实集,每行 - key: value 便于单独排序;代码块保留原样并保留语言标签;表格用于矩阵,整体为一个叶子但单元格可搜索;不使用水平分隔线,解析器会丢弃,改用标题;不要把无关事实合并成一段,应拆成列表项或共享 H2 下的 H3。

使用方式:需要保存结构化/多段记忆时,在 $REMINDB_SOURCE 下编写 .md 文件并经重扫描或 MemoryCompile 编译;更新单个节点文本时先 MemoryFetch 再编辑,再用 MemoryWrite(anchor, payload);保存单条新事实时先 MemorySearch 再 MemoryWrite(payload);根据冷节点警告压缩时用 MemoryFetch 后 MemorySummarize;源文件改动后用 MemoryCompile(path) 重新同步;连接两个已有笔记用 MemoryRelate;删除错误或过期节点用 MemoryForget;撤销近期错误写入用 MemoryRollback;保护不变量不被衰减用 MemoryPin。除 MemoryRelate、MemoryPin、MemoryUnpin 为无快照的边带操作外,其他写入都会生成快照。

限制与常见陷阱:MemoryWrite 不解析,结构化 payload 会变成一个扁平节点;对文件来源的节点使用 MemoryWrite 会导致数据库与磁盘不同步,直到该文件重新编译,之后的扫描还可能覆盖该编辑;空内容覆盖不等于删除,会留在默认温度、污染搜索,应使用 MemoryForget;cascade 与 reparent 模式不同,前者丢弃子树,后者保留子节点;不能通过重写标题来改变父级;绝不要将密钥写入 payload 或文件,只记录其位置(如 vault 路径或 1Password 条目标识)。