内容
# 🧠 Cortex — 主动记忆代理，用于 AI 编程助手
> 基于 Obsidian 的知识图谱，具备语义搜索、实体提取和跨会话记忆。包含 11 种 MCP 工具。与 Claude Code、Cursor、Windsurf 以及任何兼容 MCP 的编辑器配合使用。
---
## 功能介绍
```
你： “记忆系统如何处理遗忘？”
Cortex：💡 这让我想起了你之前的工作：
1. decisions/memory-architecture-choice — 采用艾宾浩斯衰减，半衰期为 14 天
2. daily/2026-06-19 — 你设计了三层记忆架构
3. moc/system-architecture — 完整系统图
```
- **语义搜索** — 跨语言查找概念（英文查询 → 中文内容）
- **知识图谱** — 928 个实体，106K 个关系，从你的笔记中自动提取
- **主动上下文** — `memory_monitor` 监控对话主题，提供相关记忆
- **差距分析** — 将你的学习目标与实际知识覆盖进行比较
- **跨会话** — 每个会话自动加载你的记忆索引 + 最近的每日日志
## 架构
```
MCP 客户端（Claude Code / Cursor / Windsurf）
│ 标准输入输出 JSON-RPC
▼
┌─────────────────────────────────┐
│ Cortex MCP 服务器（TypeScript） │
│ 11 种工具 + 1 种资源 │
│ ┌───────────────────────────┐ │
│ │ SQLite（sql.js） │ │ ← 知识图谱（8 张表）
│ │ LanceDB │ │ ← 向量嵌入（384 维）
│ │ ONNX（all-MiniLM-L6-v2） │ │ ← 本地，零 API 成本
│ └───────────────────────────┘ │
└──────────────┬──────────────────┘
│ 读取和索引
▼
┌─────────────────────────────────┐
│ Obsidian 保险库（真实来源） │
│ daily/ decisions/ moc/ │
│ 学习计划/ ... │
└─────────────────────────────────┘
```
## 快速入门
```bash
# 1. 安装
cd Cortex/mcp-server
npm install --ignore-scripts
npx tsc
# 2. 配置（Claude Code）
# 将 MCP 配置复制到全局 Claude Code 设置：
# ~/.claude/.mcp.json
# 3. 使用
# 启动 Claude Code 会话。MCP 服务器自动启动。
# 说：“memory_ingest”以索引你的保险库
# 说：“search for architecture decisions”以查找记忆
```
## MCP 工具
| 工具 | 描述 |
|------|-------------|
| `memory_search` | 混合关键词 + 向量语义搜索 |
| `memory_ingest` | 扫描保险库，提取实体，构建索引 |
| `memory_status` | 系统健康报告 |
| `memory_entity_extract` | 从文本中提取类型化实体 |
| `memory_graph_query` | 查询知识图谱（多跳） |
| `memory_auto_link` | 在笔记之间建议 `[[维基链接]]` |
| `memory_monitor` | 处理对话，返回主动上下文 |
| `memory_conflict_resolve` | 检测与现有记忆的矛盾 |
| `memory_gap_analysis` | 分析知识差距与学习目标 |
| `memory_consolidate` | 应用衰减，找到存档候选 |
| `memory_session_end` | 生成每日笔记（可移植的停止钩子） |
## 编辑器支持
| 编辑器 | 设置 |
|--------|-------|
| **Claude Code** | `~/.claude/.mcp.json`（全局）或 `.mcp.json`（项目） |
| **Cursor** | 复制 `editors/cursor.mcp.json` → `.cursor/mcp.json` |
| **Windsurf** | 复制 `editors/windsurf.mcp.json` |
| **Cline / VS Code** | 复制 `editors/cline.mcp.json` |
## 项目结构
```
Cortex/
├── mcp-server/ ← TypeScript MCP 服务器（32 个源文件）
│ ├── src/
│ │ ├── tools/ ← 11 种 MCP 工具
│ │ ├── graph/ ← 知识图谱 + 衰减 + 差距检测
│ │ ├── ingest/ ← 保险库扫描器，分块器，实体提取器
│ │ ├── embeddings/ ← ONNX 管道（all-MiniLM-L6-v2）
│ │ ├── db/ ← SQLite + LanceDB
│ │ └── resources/ ← MCP 资源端点
│ ├── editors/ ← 其他编辑器的配置模板
│ └── tests/
├── src/
│ ├── hooks/ ← Bash 钩子（SessionStart，Stop 等）
│ ├── lib/ ← Bash 实用程序
│ └── templates/ ← 保险库文件模板
├── skills/ ← Claude Code 技能
├── commands/ ← 斜杠命令
├── docs/ ← 架构文档
└── tests/ ← 钩子测试
```
## 许可证
MIT — 请参阅 [LICENSE](LICENSE)
