┌────────────────────────────────┐
                  │      Agent (Claude / Cursor)   │
                  └───────────────┬────────────────┘
                                  │ MCP (stdio)
                  ┌───────────────▼────────────────┐
                  │          mcp_server.py         │
                  │ search / read_raw / save / link│
                  └───────────────┬────────────────┘
                                  │
                  ┌───────────────▼────────────────┐
                  │          memory_core.py        │
                  │  唯一一份 schema 与访问逻辑      │
                  └───────┬────────────────┬───────┘
                          │                │
              ┌───────────▼──────┐  ┌──────▼─────────────────┐
              │ data/memory.db   │  │ raw_data/<id>/raw.txt  │
              │ 索引：小、常驻    │  │ 原文：大、按需加载       │
              │ 可全表扫描        │  │ 不进入上下文直到被点名    │
              └──────────────────┘  └────────────────────────┘

              init_db.py  ── 初始化
              cli.py      ── 人用
              mcp_server.py ── Agent 用
                    ↑ 三者共用 memory_core，没有第二套存储逻辑

agent-memory-router/
├── memory_core.py              # 存储核心：schema、连接、增删查改
├── mcp_server.py               # MCP Server（4 个工具）
├── cli.py                      # 命令行（8 个子命令）
├── init_db.py                  # 初始化
├── CLAUDE.md                   # Claude Code 强制规则
├── .cursorrules                # Cursor 强制规则
├── .claude/skills/
│   └── memory-manager/
│       └── SKILL.md            # 检索/写入的标准作业流程
├── tests/
│   └── test_memory_core.py     # 29 个离线测试
├── data/memory.db              # 索引（gitignore）
└── raw_data/<id>/raw.txt       # 原文（gitignore）

git clone https://github.com/<your-name>/agent-memory-router.git
cd agent-memory-router
pip install -r requirements.txt

python init_db.py --stats          # 建库
python cli.py add --type decision \
  --title "选 SQLite 而非向量库" \
  --keywords "sqlite,检索,本地" \
  --content "背景：……
做法：……
原因：……
遗留：……"

python cli.py search sqlite
python cli.py show D_0001

{
  "mcpServers": {
    "memory-router": {
      "command": "python",
      "args": ["D:/agent-memory-router/mcp_server.py"]
    }
  }
}

claude mcp add memory-router -- python D:/agent-memory-router/mcp_server.py

CREATE TABLE entities (
    id             TEXT PRIMARY KEY,   -- D_0001 / C_0002，前缀表示类型
    type           TEXT NOT NULL,      -- decision / code_change / issue / ...
    title          TEXT NOT NULL,      -- 一行摘要，检索时唯一可见的内容
    keywords       TEXT NOT NULL,      -- 逗号分隔
    file_path      TEXT NOT NULL,      -- 指向 raw_data/<id>/raw.txt
    created_at     TIMESTAMP NOT NULL,
    update_version INTEGER NOT NULL
);

CREATE TABLE relations (
    source_id     TEXT NOT NULL,
    target_id     TEXT NOT NULL,
    relation_type TEXT NOT NULL,       -- supersedes / caused_by / implements
    PRIMARY KEY (source_id, target_id, relation_type)
);

pip install -r requirements-dev.txt
python -m pytest tests/ -q