flowchart TB
    subgraph A[项目 A]
        A1[".mcp.json<br/>--project_path D:/proj-a"]
        A2["memory.db<br/>raw_data/"]
    end

    subgraph B[项目 B]
        B1[".mcp.json<br/>--project_path D:/proj-b"]
        B2["memory.db<br/>raw_data/"]
    end

    A1 --> SA["MCP Server 进程 A"]
    SA --> A2
    B1 --> SB["MCP Server 进程 B"]
    SB --> B2

    IDX["~/.agent-workflow/<br/>projects_index.json"]
    IDX -. "只登记路径" .-> A
    IDX -. "只登记路径" .-> B

    CLI["agent-projects list"] --> IDX

git clone https://github.com/lss486558354-ship-it/agent-memory-router-v2.git
cd agent-memory-router-v2
python -m pip install -e ".[dev]"

cd D:/my-project
agent-projects init

agent-projects init D:/my-project --name my-project

D:/my-project/
├── .mcp.json
├── .cursorrules
├── .claude/skills/memory-manager/SKILL.md
├── .gitignore
├── memory.db                    # 索引（gitignore）
├── raw_data/<记录ID>/raw.txt    # 原文（gitignore）
├── .agent-workflow-backups/     # 覆盖前的备份（gitignore）
└── ...你的代码

{
  "mcpServers": {
    "agent-memory-router": {
      "command": "C:/Python313/python.exe",
      "args": [
        "D:/agent-memory-router-v2/mcp_server.py",
        "--project_path",
        "D:/my-project"
      ],
      "env": {
        "PYTHONIOENCODING": "utf-8",
        "PYTHONUTF8": "1"
      }
    }
  }
}

agent-projects list

NAME                     DB   RAW  PATH
my-project               yes  yes  D:\my-project
another-app              yes  yes  D:\another-app

全局索引：C:\Users\<你>\.agent-workflow\projects_index.json

python register_project.py D:/my-project --name my-project

configure(project_path)  >  MEMORY_ROUTER_HOME  >  os.getcwd()

cd D:/my-project
agent-projects init
# 已迁移旧库：D:\my-project\data\memory.db

{
  "version": 1,
  "updated_at": "2026-10-25T00:30:00+08:00",
  "projects": [
    {
      "name": "my-project",
      "path": "D:/my-project",
      "db_path": "D:/my-project/memory.db",
      "raw_dir": "D:/my-project/raw_data",
      "router_path": "D:/agent-memory-router-v2",
      "mcp_server": "D:/agent-memory-router-v2/mcp_server.py",
      "registered_at": "2026-10-25T00:20:00+08:00",
      "last_seen": "2026-10-25T00:30:00+08:00"
    }
  ]
}

# 初始化当前项目的库
python init_db.py --project_path D:/my-project

# 手动检查 Server 会打开哪个库
python mcp_server.py --check --project_path D:/my-project

# 人用 CLI，默认当前目录
python cli.py search 报价 --type decision --project_path D:/my-project

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)
);

agent-memory-router-v2/
├── memory_core.py          # 唯一存储实现：schema、连接、CRUD、项目根解析
├── mcp_server.py           # MCP Server，支持 --project_path
├── cli.py                  # 人用 CLI，子命令支持 --project_path
├── init_db.py              # 初始化单个项目的库
├── project_registry.py     # 全局项目索引的唯一读写实现
├── register_project.py     # 只登记项目，不改项目文件
├── projects_cli.py         # agent-projects init / list / register / ...
├── templates/              # .cursorrules 与 memory-manager Skill 模板
├── tests/                  # 47 个离线测试
├── CLAUDE.md               # Claude Code 强制规则
├── .cursorrules            # Cursor 强制规则
├── .claude/skills/memory-manager/SKILL.md
└── docs/GOAL.md            # 需求原点与验收标准

python -m pytest tests/ -q