JohnXu22786/memory-vault

README excerpt

Memory Vault 面向编码代理的 跨会话持久记忆插件 ：把对话中沉淀的经验、决策、偏好与踩坑记录保存到本地，并在未来的会话中按需召回。 - 存储 ：SQLite 本地数据库（唯一数据源），记录、标签、倒排词表全部落盘 - 检索 ：关键词（BM25）与语义向量（USearch，可用时）双通道融合排序，支持时间衰减 - 整理 ：写入时自动去重（正文精确去重 + 语义近似去重，合并/跳过两种策略）； tidy 一键把相似记录折叠为摘要，防止记忆膨胀 - 界面 ：内置 Web 查看界面（纯标准库实现），浏览、检索、新增、删除、整理 - 兼容 ：通用 markdown 记忆格式导入导出，支持 frontmatter 与按二级标题拆分 - 零依赖可运行 ：默认本地哈希嵌入器离线可用、确定性跨会话一致；可选接入 sentence-transformers 或任意 OpenAI 兼容嵌入 API；向量检索自动降级（USearch → numpy → 纯 Python） 快速开始 无需安装依赖，Python ≥ 3.9 即可： 数据默认存放在 /.memory-vault/ （ vault.sqlite3 与可选 config.json ）。也可通过 --vault 或环境变量 VAULT DIR 指定其他位置。 接入 dsh（插件化 harness） 插件根目录包含 manifest.json ，harness 按以下约定加载： 接口 启动方式 用途 MCP 工具 （推荐） python -m memory vault mcp （stdio 传输） 向代理暴露 vault put / vault ask 等 8 个工具，会话内直接存取记忆 CLI python -m memory vault 脚本化、定时整理、批处理导入导出 Web python -m memory vault serve 人工浏览与维护界面 技能 读取 SKILL.md 指导代理何时写入、如何检索的说明文本 典型 harness 配置示意（MCP 风格）： harness 启动该进程后，先发 initialize 握手，再通过 tools/list 发现工具、 tools/call 调用。协议为 stdio 上的 newline-delimited JSON-RPC 2.0（MCP 标准传输），无第三方依赖。 MCP 工具一览 工具 说明 vault put 存入记录（自动去重；返回 action: new/merged/skipped ） vault ask 混合检索，返回 id/title/score/kw/sem/updated at vault take 按 id 取完整内容 vault list 最近记录列表 vault drop 按 id 删除 vault tidy 压缩整理（相似记录…

Category