{"skill":{"slug":"memory-indexer","displayName":"memory-indexer","summary":"短期记忆关键词索引工具 - 自动提取关键词、建立索引、搜索记忆，支持关联发现、时间线视图、重要记忆标记、三级级联搜索、会话备份与精简等功能。版本 2.0.0","description":"---\nname: memory-indexer\ndescription: 短期记忆关键词索引工具 - 自动提取关键词、建立索引、搜索记忆，支持关联发现、时间线视图、重要记忆标记、三级级联搜索、会话备份与精简等功能。版本 2.0.0\nhomepage: https://github.com/smallmj/memory-indexer\nmetadata:\n  {\n    \"openclaw\":\n      {\n        \"emoji\": \"🧠\",\n        \"requires\": { \"bins\": [\"python3\"], \"python_packages\": [\"jieba\"] },\n        \"install\":\n          [\n            {\n              \"id\": \"pip\",\n              \"kind\": \"pip\",\n              \"packages\": [\"jieba\"],\n              \"label\": \"Install jieba for Chinese word segmentation\",\n            },\n          ],\n      },\n  }\n---\n\n# Memory Indexer 🧠\n\n> 短期记忆关键词索引工具，为 AI Agent 提供长期记忆能力\n\n**版本**: v2.0.0\n\n## 简介\n\nMemory Indexer 帮助 AI Agent 持久化记忆：\n\n- 自动提取记忆中的关键词\n- 建立关键词 → 记忆文件的快速索引\n- 支持多关键词精确搜索（AND/OR 模式）\n- 自动发现关联记忆\n- 按时间线展示记忆\n- 标记和查看重要记忆\n- 增量同步外部记忆目录\n- 会话备份与精简（避免 session memory 无限膨胀）\n\n## 功能特性\n\n1. 自动关键词提取：使用 jieba 中文分词\n2. 多模式搜索：OR（任一匹配）/ AND（全部匹配）\n3. 关联发现：自动发现经常一起出现的记忆\n4. 时间线视图：按时间顺序展示记忆\n5. 主动提醒：根据当前关键词提示相关旧记忆\n6. 重要记忆标记：手动标记优先保留\n7. 增量同步：只索引新增或修改的文件\n8. 失效清理：自动清理已删除记忆的索引\n9. **三级级联搜索**：关键词 → 向量语义 → 原文，自动降级\n10. **向量语义搜索**：基于 HuggingFace bge-base-zh-v1.5 模型\n11. **会话备份与精简**：备份用户消息到索引，精简 session 文件到 ~10KB\n12. **Memory 文件精简**：备份 memory/*.md 到索引，精简大文件到 ~10KB\n13. **新对话自动搜索**：Hook 机制，新会话开始时自动检索相关记忆\n14. **压缩风险检测**：检测 memory 目录大小，评估压缩风险\n15. **使用统计**：查看 memory 文件数量、大小、关键词统计\n16. **快照备份**：压缩前自动/手动创建快照，支持恢复\n\n## 安装\n\n### 方式一：运行安装脚本（推荐）\n\n```bash\ngit clone https://github.com/smallmj/memory-indexer.git\ncd memory-indexer\nchmod +x install.sh\n./install.sh\n```\n\n### 方式二：手动安装\n\n```bash\ngit clone https://github.com/smallmj/memory-indexer.git\ncd memory-indexer\npip install -r requirements.txt\nln -sf \"$(pwd)\" ~/.openclaw/workspace/skills/memory-indexer\npython3 memory-indexer.py status\n```\n\n## 快速开始\n\n```bash\n# 添加记忆\npython memory-indexer.py add \"今天学习了 Python\"\n\n# 搜索（OR 模式）\npython memory-indexer.py search \"Python\"\n\n# 搜索（AND 模式）\npython memory-indexer.py search \"Python 编程\" --and\n\n# 列出所有记忆\npython memory-indexer.py list\n\n# 记忆摘要\npython memory-indexer.py summary\n```\n\n### 向量语义搜索（需要安装依赖）\n\n```bash\n# 安装向量模型依赖\npip install sentence-transformers\n\n# 测试向量生成\npython embedding.py test\n\n# 查看向量索引状态\npython embedding.py status\n\n# 批量生成历史记忆的向量\npython embedding.py reindex\n\n# 三级级联搜索（默认）\npython memory-indexer.py search \"今天天气\"\n```\n\n### Hook: 新对话自动搜索记忆\n\n从 v2.0.0 开始，提供 OpenClaw Hook `memory-indexer-on-new`，在新对话开始时自动搜索相关记忆。\n\n```bash\n# 复制 Hook 目录到 OpenClaw\ncp -r hooks/memory-indexer-on-new ~/.openclaw/hooks/\n\n# 重启 Gateway 使其生效\nopenclaw gateway restart\n```\n\n## 命令参考\n\n| 命令 | 功能 | 示例 |\n|------|------|------|\n| `add` | 添加记忆 | `add \"今天学习了 Python\"` |\n| `search` | 搜索记忆 | `search \"Python\"` |\n| `search --and` | AND 搜索 | `search \"Python AI\" --and` |\n| `list` | 列出所有记忆 | `list` |\n| `sync` | 同步外部目录 | `sync` |\n| `cleanup` | 清理失效索引 | `cleanup` |\n| `related` | 关联发现 | `related` |\n| `timeline` | 时间线视图 | `timeline` |\n| `recall` | 主动提醒 | `recall \"Python\"` |\n| `summary` | 记忆摘要 | `summary` |\n| `star` | 标记重要 | `star 20260312.md` |\n| `stars` | 查看重要记忆 | `stars` |\n| `status` | 查看状态 | `status` |\n\n## 配置\n\n数据目录：`~/.memory-indexer/`\n\n```\n~/.memory-indexer/\n├── index.json          # 关键词索引\n├── sync-state.json    # 同步状态\n└── stars.json         # 重要记忆标记\n```\n\n## 依赖\n\n- Python 3.8+\n- jieba (中文分词)\n\n## License\n\nMIT\n","tags":{"latest":"2.0.1","indexer":"1.0.12","long-term-memory":"1.0.9","memory":"1.0.12"},"stats":{"comments":0,"downloads":739,"installsAllTime":3,"installsCurrent":3,"stars":1,"versions":7},"createdAt":1773397525601,"updatedAt":1778491880948},"latestVersion":{"version":"2.0.1","createdAt":1773596753474,"changelog":"更新至 v2.0.1：新增三级级联搜索、向量语义搜索、会话备份与精简、Hook 支持等","license":"MIT-0"},"metadata":{"setup":[],"os":null,"systems":null},"owner":{"handle":"smallmj","userId":"s17dtrmex5wpqkctmbrfmcymah83h1nn","displayName":"smallmj","image":"https://avatars.githubusercontent.com/u/23742160?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089900727}}