Skip to content

v1.0.0 — 万忆中枢 WanYi Memory Core

Choose a tag to compare

View all tags
@17861102832 17861102832 released this 22 Aug 00:31
· 17 commits to main since this release
v1.0.0
71527f8

万忆中枢 WanYi Memory Core v1.0.0

永不遗忘的全量记忆系统 — Event-sourced long-term memory for AI agents. Local-first MCP server, 23 tools, data never leaves your machine.

核心特性 / Highlights

  • 事件溯源：append-only WAL 为唯一事实源，永不删除，衰减只影响召回排序
  • 语义召回：BM25 关键词 + 本地中文向量（BAAI/bge-small-zh-v1.5）+ reranker（BAAI/bge-reranker-base）+ 知识图谱扩展 + 时间衰减
  • 元认知：召回弱时承认知识空白，而不是编造答案
  • 决策护栏：全仓/梭哈/强推/rm -rf 等高风险动作触发置信度拦截，反事实分支让你看到"如果当初听了会怎样"
  • 零参与进化：无需说"记住"，系统自主沉淀、夜间整理、每周轨迹回放
  • 23 个 MCP 工具：记忆记录/召回/搜索/图谱/时序/反事实/桥接/回放/置信度检查等

安装 / Install

pip install wanyimem            # core
pip install "wanyimem[all]"     # + vector & reranker models deps

Requires Python 3.10+. Models are downloaded on first use from HuggingFace; set HF_ENDPOINT=https://hf-mirror.com in mainland China.

快速开始 / Quick Start (MCP)

Add to mcp.json (Claude Desktop, Cursor, Trae, etc.):

{
  "mcpServers": {
    "wanyi": {
      "command": "python",
      "args": ["-m", "wanyi.memory_core"],
      "env": {"万忆中枢_STORE_DIR": "C:/path/to/your/memory"}
    }
  }
}

CI 状态 / Status

  • ✅ Lint (ruff) & Tests (Python 3.10 / 3.11 / 3.12) all passing on GitHub Actions
  • ✅ MIT License
Assets 2
Loading