SuperAPI AI 工具集

memory-context

智能体与模型

查看项目

更新于 10-15 20:30

技能介绍

用途:memory-context 是统一技能,用于检索情节式上下文并保留关键会话状态,适合情节检索、语义搜索,或在上下文窗口填满时进行上下文压缩。

主要能力:提供 CLI 操作进行情节查询,包括列出最近情节、按描述搜索、获取情节详情,并支持 JSON 输出便于解析。检索方式包括语义搜索(在嵌入可用时使用,以获得最佳相关性)和关键词搜索(基于 SQL 的快速确定性回退)。支持按领域、任务类型、时间范围(如最近 30 天)和成功结果等策略过滤。上下文压缩方面,强调始终保留测试名称与输出、构建状态、修改文件、待办事项状态、本会话设置的环境变量和决策原因;明确不应压缩精确文件路径、错误消息原文、测试名称和数值结果。

使用方式:需先构建 CLI,命令为 cargo build -p do-memory-cli --release(默认仅 redb,或使用 --features turso 连接远程)。本地开发设置环境变量 export LOCAL_DATABASE_URL="file:./data/memory.db"。Turso 开发服务器可运行 turso dev --db-file ./data/memory.db --port 8080,并设置 export TURSO_URL="http://127.0.0.1:8080" 与 export TURSO_TOKEN=""。情节查询示例:cargo run -p do-memory-cli -- episode list --limit 10;cargo run -p do-memory-cli -- episode search "git worktree" --limit 5;cargo run -p do-memory-cli -- episode get <episode-id>;cargo run -p do-memory-cli -- episode search "error" --format json --limit 5。

适用场景与限制:适用于需要从历史情节中检索上下文、进行语义或关键词搜索、以及在上下文窗口不足时压缩并保留关键状态的开发或代理工作流。资料未提供具体性能指标、收费信息或平台支持范围;低召回、检索慢或相关性差时可参考故障排除建议,如检查嵌入、扩展标签、增加限制、检查缓存、验证索引、减少结果集、使用语义搜索、改进查询或按领域过滤。参考文档包括 agent_docs/LESSONS.md 和 do-memory-cli/CLI_USER_GUIDE.md。