+ 发布产品

memorius Skill 技能

# memorius — 任何 AI 代理都能用的自包含记忆金库（含 3D 书柜） ## 技能简介 **memori

AI Agent
查看 Skill ↗
认领产品

memorius — 任何 AI 代理都能用的自包含记忆金库（含 3D 书柜）

技能简介

memorius 是一款完全本地化、代理无关的 AI 长期记忆系统。它把"代理记忆"做成一个统一的 vault（金库）——支持 Claude Code、Codex CLI、Gemini CLI、OpenClaude、OpenCode、Pi、OpenClaw 以及任何 MCP-compatible 代理同时读写同一份记忆。底层用 SQLite + 向量检索 + 可插拔 embedding + 跨编码 reranker + 知识图谱 + neuroscience 启发的 consolidation 算法，并自带 3D 漫步式书柜浏览器（WASD 走动 + 点击翻书），所有计算都在本机 CPU 完成——零云、零 API key、零锁定。

核心能力

  • Vault → Shelf → Folder → Note 四级层次：每条记忆（Note）必带 vault 与 shelf 标签，可无限嵌套 folder，组织方式贴近人类书架而非平面 list。
  • 向量 + 关键词 + 跨编码 reranker 三层检索：默认向量检索（可换 OpenAI embedding）；结果经 cross-encoder 二次精排；辅以 BM25 风格关键词回退。
  • 会话日记（Session Diary）：把每次代理会话的高价值对话沉淀成可搜索笔记，可检索"上次谁问过这个问题"。
  • 知识图谱（Knowledge Graph）：自动从笔记文本构建实体关系图，浏览器可看关联节点图，搜索时可顺藤摸瓜。
  • 多种前端同时挂载：
    • CLI — memorius init / store / search / status / stats / mine
    • MCP Server — 标准 MCP 协议接入任何 MCP-compatible 代理
    • REST API — http://127.0.0.1:8912，方便外部 Webhook 写入
    • 3D Bookcase — memorius bookcase 起 WASD 漫步的浏览界面（loopback only）
  • Agent Hooks：自动检测当前终端是否跑 Claude Code / Codex / Pi / OpenClaude / OpenCode 等，自动接入对应 hook（SessionStart/Stop 等），零配置注入记忆。
  • memorius mine：从一段对话文本（如 ChatGPT 导出文件）反向抽取值得保存的事实，自动入库。
  • repair 子命令：可校验 vault 完整性，损坏 blob / 孤立节点的修复路径内置。
  • 自我巩固算法：模仿海马体-皮层 consolidation，自动把高频访问的短期记忆"重写"为长期记忆，无须人工干预。
  • --json 全接口 JSON 输出：方便 shell pipeline / 自动化脚本调用。

安装配置

环境前置：Python ≥ 3.10（dev extra 需 pytest / pytest-asyncio）。

# 1. 一行安装（所有功能都已包含，不用选 extra）
pip install memorius

# 2. 验证版本
memorius --version

# 3. 初始化 vault（创建 ~/.memorius/config.yaml + 存储目录）
memorius init

# 4. 起 3D 书柜
memorius bookcase
# 默认 web：http://127.0.0.1:8400/bookcase.html（loopback only）
#         REST API：http://127.0.0.1:8912

# 5. 在 Claude Code / Codex / Gemini CLI 启动时，memorius 自动接入对应 hook（首启会询问）

可选 flag：--port 改 REST 端口、--static-port 改 web 端口、--no-browser 不自动开浏览器。

使用步骤

  1. 存：写一条事实入库。

    memorius store "The sky is blue because Rayleigh scattering scatters shorter wavelengths more" 
  --vault main --shelf science --folder physics

  2. 搜：语义搜，按意召回。

    memorius search "why is the sky blue"

  3. 挖：从一段 ChatGPT 导出的对话文本挖出值得保存的事实，自动入库。

    memorius mine transcript.txt --vault conversations

  4. 看：3D 书柜 WASD 走动浏览，麦克风可语音搜索（Chromium only）。

    memorius bookcase

  5. 状态：memorius status / memorius stats 看 vault / 记忆 / 图谱三项指标。

  6. 接 Agent：直接打开 Claude Code / Codex / Gemini CLI，memorius 自动 hook，无需手动配置 MCP。

  7. REST 调用：curl http://127.0.0.1:8912/vaults 列出所有 vault，POST /vault/main/notes 写入。

适用场景

  • 多 AI 代理共用一套记忆：日常在 Claude Code / Codex / Gemini CLI 之间切换的开发者，记忆统一一处。
  • 本地优先 + 长期记忆：不愿把代码上下文传到第三方云的开发者。
  • 知识管理 / 个人 PKM：把读过的论文、解决的问题、生活笔记统一管理，3D 浏览体验更直观。
  • 团队记忆标准化：自部署 memorius 服务端，团队共享 vault schema，每位成员私有 vault + 公共 vault。
  • 会话分析：从过去所有代理会话中挖掘高价值事实，memorius mine 自动入库。
  • AI 增强长期项目：维护一个跑了好几个月的项目，memorius 帮你记忆之前的坑点、决策。
  • 教学 / 笔记整理：把课程笔记按 Shelf 整理，每条概念带图谱关联。

适用人群

  • 在 多种 AI 编码代理之间切换的全栈 / 后端 / 数据工程师
  • 本地优先 开发者，注重隐私、不愿把数据托给 SaaS
  • 个人知识管理 PKM 重度用户（如 PARA 方法论追随者）
  • AI 工具重度用户，希望记忆跨工具共享、长期可检索
  • 教学 / 研究场景，需要把多次会话累积知识结构化沉淀
  • 对 3D 可视化 / 新交互范式 有兴趣的早期采用者

工作原理

memorius 在设计上坚持三件事：本地优先、代理无关、即装即用。

  • 本地优先：所有数据落 ~/.memorius/，embedding 在本地 CPU 跑（默认自带模型，可换 OpenAI embedding）；3D 书柜 / REST 都仅绑 loopback 接口（127.0.0.1），不向外暴露端口。
  • 代理无关：抽象记忆接口为 MCP 协议，Claude Code / Codex / Gemini CLI / OpenClaude / OpenCode / Pi / OpenClaw 全部通过标准 MCP 接入；启动时检测在跑哪种代理，自动注册对应 hook（SessionStart / Stop 等）。
  • 检索三层：向量召回 → cross-encoder 精排 → 关键词回退。最上层提供 Knowledge Graph 把笔记间实体关系抽出，搜索可"沿图走"。
  • Consolidation 算法：模仿海马体-皮层 unconscious replay，自动把高频访问但只短期相关的记忆重写为长期记忆，无需任何 prompt 触发。
  • 3D Bookcase：纯 Three.js / WebGL 在浏览器端跑，REST server 仅供数据；vault 抽象成"房间"，shelf 抽象成"书架"，book 即 note，walk + look + click 三套交互。
  • 隐私默认：所有 vault / blob 落本机，无 telemetery；可选禁用 OpenAI embedding 切到本地 sentence-transformers。

官方链接

memorius 网站预览

团队信息

AI产品库 官方
由 AI 猎手自动发现

评论与建议

0 条评论