pip install -r requirements.txt

python scripts/semantic_search.py --download

{
  "mcp": {
    "memory": {
      "type": "local",
      "command": ["python", "-u", "scripts/mcp_server.py"],
      "enabled": true
    }
  }
}

mcp_servers:
  memory:
    type: stdio
    command: ["python", "-u", "/path/to/scripts/mcp_server.py"]

{
  "mcpServers": {
    "memory": {
      "command": "python",
      "args": ["-u", "/path/to/scripts/mcp_server.py"]
    }
  }
}

opencode-memory/
├── scripts/                    # MCP Server 核心脚本
│   ├── mcp_server.py          # MCP Server 主入口（JSON-RPC over stdio）
│   ├── semantic_search.py     # 语义向量检索（sentence-transformers + FAISS）
│   ├── dual_memory_engine.py  # 双记忆协同引擎
│   ├── build_full_index.py    # 向量索引构建工具
│   ├── memory_config.py       # 路径配置（自动适配系统）
│   ├── memory_git.py          # Git 自动版本管理
│   ├── storage_tiers.py       # 三层存储（热/温/冷）
│   ├── memory_maintain.py     # 记忆维护工具
│   ├── memory_dedup.py        # 记忆去重
│   ├── auto_index_updater.py  # 自动索引更新
│   ├── plugin_bridge.py       # 插件桥接（BM25 混合检索）
│   └── init_dual_memory.py    # 双记忆引擎初始化
├── plugins/
│   └── memory-plugin/
│       └── index.ts           # OpenCode 插件（可选）
├── skills/
│   └── memory-system/
│       └── SKILL.md           # AI 技能文档
├── requirements.txt           # Python 依赖
├── .gitignore
└── README.md

客户端发送 UTF-8 字节
        ↓
┌─────────────────────────────────────┐
│  _detect_decode() 自动识别编码       │
│  ① 先试 UTF-8（MCP 标准协议）        │
│  ② 失败→试系统编码（cp936/cp1252）   │
│  ③ 再失败→UTF-8 + 替换非法字符       │
└─────────────────────────────────────┘
        ↓
┌─────────────────────────────────────┐
│  _clean_surrogates() 移除代理字符    │
│  _clean_obj() 递归清洗整个响应       │
└─────────────────────────────────────┘
        ↓
  存储为 UTF-8 JSON 文件

memory_recall("查询")
        ↓
   ┌────┴────┐
   ↓         ↓
FAISS 索引  STM 文件实时编码
(预构建)    (即时搜索)
   ↓         ↓
   └────┬────┘
        ↓
   合并去重 + 按相似度排序
        ↓
   返回 Top-K 结果