SuperAPI AI 工具集

memmachine

智能体与模型

查看项目

更新于 10-29 05:36

技能介绍

MemMachine 指代一个面向智能体的长期记忆服务器,本技能用于操作该具体服务及其集成,而非通用记忆框架。

用途

该技能服务于指定名称的长期记忆服务及其客户端与协议集成。文档要求先阅读固定证据,再对安装或能力作出判断。

主要能力

技能覆盖四种使用形态的识别:客户端 SDK、本地服务器、HTTP/MCP 传输、托管平台。要求检查实际部署配置与组织/项目范围,并明确 SDK 需要运行中的服务器,仅安装并不等于记忆服务可用。操作范围包括从固定 MCP 源码读取实际操作定义,并将 add/write 与 delete 视为变更操作;在任何记忆变更前先确定项目、组织与会话目标。

使用方式

先对照 references/source.json 确认仓库与提交。若为代码检出,在仓库根目录运行:python3 .agent-skills/memmachine/scripts/preflight.py --repo /absolute/nonsymlink/checkout --json,其中 --repo 必须为显式绝对非符号链接目录;若为已安装技能目录清单,则在该技能目录运行:python3 scripts/preflight.py --json。该独立标准库辅助脚本要求 POSIX 环境下的 Python 3.10+(macOS/Linux;Windows 需使用 WSL2,原生 Windows 会失败关闭),不发起子进程或网络调用,不写入,不读取密钥。它比对选定固定文件的 SHA-256,并仅检查 PATH 中命令名是否存在(不检查版本),从不比对 Git HEAD 或整体修订,也不验证运行时。退出码 0 表示输入有效且选定文件检查通过(命令存在仅为信息性);1 表示选定文件缺失或不匹配;2 表示输入错误。未提供 --repo 时,仅报告未经验证的清单。

审批与限制

安装/下载、多服务启动、服务对外暴露、MCP 注册、外部或托管连接与提供方调用、记忆写入/删除、模式迁移、持久配置变更,均须先获得明确批准,并核实涉及的数据与目标范围。报告时需区分仅检查与实际启动/连接,说明是否涉及远程服务或提供方,以及记忆或数据库数据是否变更,不得仅凭源码检查宣称成功。示例包括:在不启动的情况下检查 stdio 与 HTTP MCP 入口;向托管项目添加记忆前就数据、端点、目标范围与写入获取批准;删除项目全部记忆前确认项目身份与破坏性授权。最佳实践要求保持 SDK、服务器、传输与托管服务相互区分,将工具名与上游文档视为线索并核对固定代码与配置,尽量减少记忆暴露,不打印 API 令牌或私有记忆载荷。该辅助脚本只校验选定源码字节,不验证运行时连通性、数据正确性、授权或安全态势。