Cortex

Cortex 是一个 Go 语言构建的单二进制 AI Agent 记忆层，采用 Import-first 设计，可直接导入 Markdown、JSON、YAML、CSV、对话日志等已有文件，自动提取主体-谓语-宾语三元组事实并建立知识图谱。核心特性包括：BM25 + 语义嵌入混合检索（支持 WSF/RRF 融合）、基于 Ebbinghaus 遗忘曲线的 7 级事实衰减机制、实时冲突检测与 LLM 自动解决、交互式知识图谱浏览器、递归推理能力。通过 MCP Server（17 工具 + 4 资源，stdio/HTTP/SSE）无缝集成 Claude Code、Cursor、Windsurf 等 Agent。存储基于 pure Go SQLite（零 CGO），完全离线可用，支持 GitHub、Gmail、Slack、Notion 等 8 种外部连接器。提供 cortex stats/stale/conflicts/alerts 全方位可观测性，事实溯源至源文件行号与时间戳，多 Agent 作用域隔离，JSON/Markdown/CSV 无锁定导出。

安装方式#

# Homebrew (macOS)
brew install hurttlocker/cortex/cortex-memory

# MCP server（任意平台，无需安装本体）
npx @cortex-ai/mcp

# 二进制下载
curl -sSL https://github.com/hurttlocker/cortex/releases/latest/download/cortex-darwin-arm64.tar.gz | tar xz

# Go install
go install github.com/hurttlocker/cortex/cmd/cortex@latest

快速开始#

cortex init
cortex import ~/notes/ --recursive --extract
cortex search "what did I decide about the API design"
claude mcp add cortex -- cortex mcp

主要 CLI 命令#

核心数据流#

文件 → Import → 事实提取（规则引擎 + 可选LLM） → SQLite + FTS5
                                                      │
                                    ┌────────┬────────┼────────┐
                                    ▼        ▼        ▼        ▼
                                 Search   Observe   Graph    MCP Server
                                (hybrid)  (stats,   (2D       (17 tools,
                                          stale,    explorer)  any agent)
                                          conflicts)

关键机制#

• 事实提取管道：导入时自动触发，规则引擎为基础层，LLM 为可选增强层
• 衰减评分：搜索时根据事实类型对应的 Ebbinghaus 曲线动态调整排序分数（身份类 693 天、时间类 7 天等）
• 冲突检测：写入时实时比对同一 S-P 组合下的不同 O，触发告警或自动解决
• Governor 防护：单条记忆提取上限 10 条事实 + 质量阈值过滤

外部连接器#

GitHub、Gmail、Google Calendar、Google Drive、Slack、Discord、Telegram、Notion

嵌入模型支持#

Ollama（本地/免费）、OpenAI、DeepSeek、OpenRouter 及任何 OpenAI 兼容端点

环境变量#

项目统计#

• 最新版本：v1.5.0（"Zero Dependencies"）
• 30 releases，479 commits
• 1,081 tests across 15 packages
• Go 87.5%，另含 Python 4.7%、HTML 3.1%、TypeScript 2.6%、Shell 1.8%