Lore Context

---

什么是 Lore Context

Lore Context 是面向 AI Agent 记忆的开放核心控制平面：它整合记忆、搜索、代码库图谱和工具调用记录中的上下文；使用你自己的数据集评估检索质量；为敏感内容安排治理审核；并将记忆导出为可在不同后端之间迁移的可移植交换格式。

它并不打算成为另一个记忆数据库。其独特价值在于构建于记忆之上的能力：

• 上下文查询 — 通过单一端点整合记忆 + 网络 + 代码库 + 工具调用记录，返回带有溯源信息的分级上下文块。
• 记忆评估 — 在你自己的数据集上运行 Recall@K、Precision@K、MRR、陈旧命中率和 p95 延迟指标；持久化运行记录并进行差异比较，以检测回归。
• 治理审核 — 六种状态的生命周期（candidate / active / flagged / redacted / superseded / deleted）、风险标签扫描、投毒启发式检测、不可变审计日志。
• 类似 MIF 的可移植性 — 通过 JSON + Markdown 导出/导入，并保留 provenance / validity / confidence / source_refs / supersedes / contradicts。可作为不同记忆后端之间的迁移格式。
• 代码库图谱 — 对代码库进行确定性索引（文件、符号、导入、调用、路由、测试），并通过 API 路由和只读 MCP 工具提供访问，让 Agent 基于稳定的项目上下文约定生成代码库相关回答。
• 多 Agent 适配器 — 原生支持 agentmemory 集成，具备版本探测和降级模式回退；为其他运行时提供清晰的适配器约定。

适用场景

在以下情况下使用 Lore Context……	在以下情况下使用记忆数据库（agentmemory、Mem0、Supermemory）……
你需要证明 Agent 记住了什么、为什么记住，以及是否用到了这些信息	你只需要原始记忆存储
你运行多个 Agent（Claude Code、Cursor、Qwen、Hermes、Dify），并希望它们共享可信的上下文	你正在构建单个 Agent，并且可以接受被供应商锁定的记忆层
出于合规要求，你需要本地或私有部署	你更倾向于托管式 SaaS
你需要使用自己的数据集进行评估，而不是使用供应商的基准测试	供应商的基准测试已足以作为参考
你希望在不同系统之间迁移记忆	你不打算切换后端

快速开始

# 1. Clone + install
git clone https://github.com/Lore-Context/lore-context.git
cd lore-context && pnpm install

# 2. Run the quickstart helper and inspect the activation report
pnpm quickstart -- --dry-run --activation-report

# 3. Generate a real API key (do not use placeholders in any environment beyond local-only dev)
export LORE_API_KEY=$(openssl rand -hex 32)

# 4. Start the API (file-backed, no Postgres required)
pnpm build && PORT=3000 LORE_STORE_PATH=./data/lore-store.json pnpm start:api

# 5. Write a memory
curl -H "Authorization: Bearer $LORE_API_KEY" -H "Content-Type: application/json" \
  -X POST http://127.0.0.1:3000/v1/memory/write \
  -d '{"content":"Use RDS as truth store and Qdrant as the derived recall index for Lore Context production.","memory_type":"project_rule","project_id":"demo"}'

# 6. Query context, then inspect the returned traceId in the Evidence Ledger
curl -H "Authorization: Bearer $LORE_API_KEY" -H "Content-Type: application/json" \
  -X POST http://127.0.0.1:3000/v1/context/query \
  -d '{"query":"production storage","project_id":"demo","token_budget":1200}'

如需查看公共网站上的快速入门指南，请访问 lorecontext.com/quickstart。如需查看完整 的设置说明（Postgres、Docker Compose、Dashboard、MCP 集成），请参阅 docs/getting-started.md。

官方 alpha 快速入门方式是 git clone + pnpm quickstart。Lore 目前不发布或宣称提供公共的 @lore-context/quickstart npm 包。 MCP stdio 服务单独发布为 @lore-context/server， 用于注册表和客户端分发；SDK 中间件则以 @lore-context/sdk-middleware （npm）和 lore-context-middleware（PyPI）的形式发布。

为便于 AI 读取和发现，网站仅基于公共文档发布 /llms.txt 和 /llms-full.txt。 官方 MCP 注册表条目已发布，其他分发草案见 docs/distribution。 发布草案见 docs/launch，设计合作伙伴申请见 docs/design-partners。公共基准测试页面提供可复现的方法和小规模冒烟测试报告，不宣称在竞争性基准测试中获胜。

架构

下图展示了完整的开源核心加托管生产环境架构。在公共 OSS 仓库中，可直接使用本地文件/Postgres 部署；托管式 Google 登录、AWS SQS worker、私有嵌入、计费和多租户运维则属于商业托管云服务。

                       ┌───────────────────────────────────────────────┐
  MCP/REST clients ─► │ apps/api  (auth + rate limit + evidence)       │
  (Claude Code,       │   ├── Memory Inbox / lifecycle / audit         │
   Codex, Cursor,     │   ├── capture ingestion + recall hydration     │
   OpenCode...)       │   ├── context query (memory/web/repo/traces)   │
                       │   ├── repo graph query / symbol / impact       │
                       │   ├── Google sign-in + hosted MCP metadata     │
                       │   └── OpenAPI + usage + operator surfaces      │
                       └───────────────┬───────────────────────────────┘
                                       │
                         capture / embedding / graph jobs
                                       ▼
                       ┌───────────────────────────────────────────────┐
                       │ memory-worker  (AWS SQS + DLQ fan-out)        │
                       │   ├── auto redaction / curation / save        │
                       │   ├── dreaming butler (prune/merge/resolve)    │
                       │   ├── private Qwen3 embedding service         │
                       │   └── Qdrant dense+sparse indexing            │
                       └───────────────┬───────────────────────────────┘
                                       │
                  ┌────────────────────┼────────────────────┐
                  ▼                    ▼                    ▼
          RDS PostgreSQL 16      Qdrant derived index   apps/dashboard
          truth store + audit    lore_memories_v12      user-facing SaaS

详情请参阅 docs/architecture.md。

v2.1.0 的内容

v2.1.0 是 Repo Graph API 和 MCP 工具版本。它将 Lore 自身的仓库图谱打造成一等 Agent 记忆界面：以确定性方式为文件、符号、导入、调用、路由、测试和流程提示建立 TypeScript/JavaScript 仓库索引，并通过 API 路由和只读 MCP 工具提供这些信息，让 Agent 能依据稳定的项目上下文契约生成仓库相关回答，而不是依赖临时的文本搜索。

v2.1.0 是当前的开源核心源代码版本。托管版 Lore Cloud 生产环境也在商业 AWS/Qdrant/私有嵌入基础设施上运行 v2.1.0，但托管运维、计费、生产发布自动化和 Secret Vault 运行时仍保留在 Lore-Context/lore-cloud 中。

能力	状态	位置
仓库图谱 API + MCP 工具（repo.graph_query / symbol_context / impact / detect_changes）	✅ 开源 + 托管生产环境	packages/repo-graph、apps/api、apps/mcp-server
代码知识图谱索引器	✅ 开源 + 托管生产环境	packages/code-indexer、packages/code-indexer-python
融合记忆 + 网络 + 仓库 + 工具轨迹的上下文查询	✅ 开源 + 托管生产环境	apps/api、docs/api-reference.md
7 路流 HybridSearchOrchestrator（FTS / pgvector / Qdrant 稠密 + 稀疏 / 图谱 / 时序 / wiki）	✅ 开源 + 托管生产环境	packages/search
跨编码器重排器（融合后重排，可选启用）	✅ 开源，需提供商密钥	apps/api/src/rerankers/
梦境管家记忆整合（裁剪 / 合并 / 解决 / 呈现）	✅ 开源，由标志控制	apps/api/src/workers/butler-v18.ts
Agent 记忆自我改进循环 + 上下文配方	✅ 开源，晋级需人工审核	packages/eval、packages/search
SDK 中间件（为 OpenAI / Anthropic 客户端自动注入 + 自动保留）	✅ 已发布	packages/sdk-middleware-typescript、packages/sdk-middleware-python
生成的 SDK 源码预览	✅ 开源源码预览	packages/sdk-python、packages/sdk-go、packages/sdk-java、packages/sdk-dotnet
浏览器扩展捕获脚手架	✅ 开源脚手架	apps/browser-extension
AI Agent 密钥保险库（原生 MCP，三按钮授权）	托管测试版，待加密审计	Lore-Context/lore-cloud 中的商业运行时
云端记忆引擎：RDS 真值存储 + SQS 工作进程扇出 + Qdrant 索引	托管生产环境	商业托管云
私有 Qwen3-Embedding-0.6B 1024 维向量服务	托管生产环境	商业托管云
自动捕获摄取和记忆收件箱异常处理	✅ 开源 + 托管生产环境	apps/api、packages/capture、apps/dashboard
Google 登录 + 个人保险库初始化	托管生产环境	商业托管云
商业 SaaS：个人订阅、计费、配额限制	托管生产环境	Lore-Context/lore-cloud
使用 API 密钥认证（读取者 / 写入者 / 管理员）的 REST API	✅ 开源 + 托管生产环境	apps/api
/openapi.json 中的 OpenAPI 3.1 契约（报告版本为 2.1.0）	✅ 开源 + 托管生产环境	apps/api/src/openapi.ts
MCP stdio 服务端（旧版 + 官方 SDK 传输）	✅ 开源 + 托管生产环境	apps/mcp-server
Next.js 仪表板客户工作流脚手架	✅ 开源脚手架 + 托管生产环境	apps/dashboard
证据账本 API + 仪表板摘要	✅ 开源 + 托管生产环境	apps/api、apps/dashboard
治理状态机 + 审计日志	✅ 开源 + 托管生产环境	packages/governance
评估运行器（Recall@K / Precision@K / MRR / staleHit / p95）	✅ 开源 + 托管生产环境	packages/eval
支持 supersedes + contradicts 的 MIF v0.2 导入 / 导出	✅ 开源	packages/mif
模型网关（多提供商任务→模型路由）	✅ 开源	packages/model-gateway
带版本探测 + 降级模式的 agentmemory 适配器	✅ 开源	packages/agentmemory-adapter
速率限制、带字段脱敏的结构化 JSON 日志	✅ 开源 + 托管生产环境	apps/api
Docker Compose 私有部署	✅ 开源，可自托管	docker-compose.yml、docs/deployment/
pnpm quickstart 本地接入辅助工具 + 激活报告	✅ 开源	scripts/lore-quickstart.mjs
官方 MCP Registry + 分发 / 发布 / 设计合作伙伴文档	✅ 开源文档	server.json、docs/distribution/、docs/launch/

完整发布历史请参阅 CHANGELOG.md。

当前发布状态

v2.1.0 是当前的源代码、托管生产环境和发布分支。它通过优化后的发布流程部署到 AWS 生产环境和公共网站：不可变的 arm64 优先制品、暂存环境 API 冒烟测试、生产 API 部署、独立的网站部署、发布后审计，以及标签和发布收尾。外部检查确认 https://api.lorecontext.com/health 返回 status=ok，/openapi.json 显示 2.1.0，且 https://lorecontext.com/status.html 包含 v2.1.0。

生产环境保留了 v1.1+ 的 RDS / SQS / memory-worker / Qdrant 云端架构，使用 lore_memories_v12 作为 Qdrant 集合，并为 Postgres 路径保留 1024 维 pgvector，同时新增了增量式仓库图谱架构（apps/api/src/db/schema-v21-repo-graph.sql）。

请参阅 docs/release-status.md，了解当前可公开的状态快照；并参阅 docs/release-notes/v2.1.0.md，查看完整发布说明。

发布重点

v2.1 版本将 Lore 的仓库图谱打造为一流的 Agent 记忆界面。目标是让 Agent 能够基于确定、稳定的项目上下文约定，而不是临时文本搜索，回答“X 定义在哪里”“哪些内容会调用它”以及“如果我更改它，会有什么内容受到影响”：

• @lore/repo-graph — 用于对 TypeScript/JavaScript 仓库中的文件、符号、导入、调用、路由、测试和进程提示进行确定性索引。
• API 路由：POST /v1/repo/graph/query、POST /v1/repo/symbol/context、POST /v1/repo/impact 和 POST /v1/repo/detect-changes。
• MCP 工具：repo.graph_query、repo.symbol_context、repo.impact 和 repo.detect_changes（只读）。
• context_query(repo) 现在会在可用时使用由提供方支持的仓库图谱证据；未配置仓库图谱存储时，则会如实回退并说明不可用。
• 仓库图谱 Postgres 架构采用增量式设计，基于现有生产架构，并在生产／暂存架构设置期间应用。

根目录和 API 软件包版本均显示为 2.1.0，使 /openapi.json 与发布标签一致。发布流程采用 v2.0.9 之后引入的优化型 API／网站拆分部署防护措施。

请参阅 docs/project-plan.md、docs/roadmap.md 和 docs/release-governance.md。

集成

Lore Context 支持 MCP 和 REST，并可与大多数 Agent IDE 和聊天前端集成：

工具	设置指南
Claude Code	docs/integrations/claude-code.md
Cursor	docs/integrations/cursor.md
Qwen Code	docs/integrations/qwen-code.md
OpenClaw	docs/integrations/openclaw.md
Hermes	docs/integrations/hermes.md
Dify	docs/integrations/dify.md
FastGPT	docs/integrations/fastgpt.md
Cherry Studio	docs/integrations/cherry-studio.md
Roo Code	docs/integrations/roo-code.md
OpenWebUI	docs/integrations/openwebui.md
其他／通用 MCP	docs/integrations/README.md

部署

模式	适用场景	文档
本地文件存储	个人开发、原型、冒烟测试	本 README、上方的快速入门
本地 Postgres+pgvector	单节点本地回退和迁移测试	docs/deployment/README.md
Docker Compose 私有部署	团队自托管部署、隔离网络	docs/deployment/compose.private-demo.yml
托管云	RDS / SQS / memory-worker / Qdrant / 私有嵌入服务，以及图增强混合召回栈和商业 SaaS 基础设施	docs/release-status.md

所有部署方式都需要明确配置密钥。本地／私有部署需要 POSTGRES_PASSWORD、LORE_API_KEYS 和仪表板身份验证。托管部署还 需要 RDS、SQS、Qdrant、嵌入服务、OAuth、隧道配置和 生产运行时导出变量。若任何值与占位符模式匹配，scripts/check-env.mjs 脚本会拒绝启动生产环境。

安全

v2.1.0 延续了本地／私有部署的安全态势，并为普通用户访问托管云提供了 防护措施：

• 身份验证：使用 API 密钥承载令牌并区分角色（reader／writer／admin），同时按项目进行范围限制。生产环境中，空密钥模式会默认拒绝访问。
• 速率限制：按 IP 和密钥分别使用双重令牌桶，并针对身份验证失败启用退避机制（60 秒内失败 5 次后返回 429，并锁定 30 秒）。
• 仪表板：托管产品使用 Google 会话流程；本地／私有运维部署仍可使用 HTTP Basic Auth。
• 容器：所有 Dockerfile 均以非 root 的 node 用户运行；API 和仪表板均配置了 HEALTHCHECK。
• 密钥：不硬编码任何凭据；所有默认值均为必填，否则启动失败。生产环境中，scripts/check-env.mjs 会拒绝占位符值。
• 治理：写入时扫描 PII／API 密钥／JWT／私钥正则模式；带风险标签的内容会自动转至审核队列；每次状态转换都会写入不可变审计日志。
• 记忆投毒：通过共识模式和祈使动词模式进行启发式检测。
• MCP：使用 zod 对每个工具输入进行架构验证；变更类工具要求提供 reason（≥8 个字符），并显示 destructiveHint: true；返回客户端前会对上游错误进行清理。
• 工作进程隔离：捕获、嵌入、图、连接器和回填作业通过 AWS SQS 队列运行，并配置 DLQ；Qdrant 是派生索引，RDS 仍是权威数据源。
• 日志记录：使用结构化 JSON，并自动隐藏 content、query、memory、value、password、secret、token、key 字段。

漏洞披露：SECURITY.md。

项目结构

apps/
  api/                # REST control plane + Postgres + governance + eval + repo graph
  dashboard/          # Next.js dashboard scaffold; hosted Google session stays commercial
  mcp-server/         # MCP stdio server (legacy + official SDK transports)
  cli/                # lore CLI (doctor, wiki-recompile, dataset import/export)
  browser-extension/  # Capture surface scaffold
  web/                # Server-side HTML renderer (no-JS fallback UI)
  website/            # Marketing site (handled separately)
packages/
  shared/             # Shared types, errors, ID/token utilities
  agentmemory-adapter # Bridge to upstream agentmemory + version probe
  search/             # 7-stream HybridSearchOrchestrator + recipe adapter
  repo-graph/         # Deterministic repository indexing (v2.1)
  code-indexer/       # Code knowledge graph indexer (TypeScript/JavaScript)
  code-indexer-python # Code knowledge graph indexer (Python)
  capture/            # Capture ingestion primitives
  connectors/         # External source connectors
  model-gateway/      # Multi-provider task→model routing
  mif/                # Memory Interchange Format (v0.2)
  eval/               # EvalRunner + metric primitives + context recipes
  governance/         # State machine + risk scan + poisoning + audit
  profile/            # Vault / account profile types
  sdk-typescript/     # TypeScript client SDK
  sdk-python/         # Python client SDK
  sdk-go/ sdk-java/ sdk-dotnet/   # Additional language SDKs
  sdk-middleware-typescript/      # Auto-inject + auto-retain middleware (npm)
  sdk-middleware-python/          # Auto-inject + auto-retain middleware (PyPI)
docs/
  i18n/<lang>/        # Localized README in 17 languages
  integrations/       # Agent-IDE integration guides
  deployment/         # Local and Docker Compose private deployment docs
  legal/              # Privacy / Terms / Cookies (Singapore law)
scripts/
  check-env.mjs       # Production-mode env validation
  smoke-*.mjs         # End-to-end smoke tests
  apply-postgres-schema.mjs

要求

• Node.js >=22
• pnpm 10.30.1
• （可选本地回退）带 pgvector 的 Postgres 16
• （托管／高级）RDS PostgreSQL 16、AWS SQS、Qdrant 和私有嵌入服务

贡献

欢迎贡献。请阅读 CONTRIBUTING.md，了解开发工作流、提交消息规范和评审要求。

文档翻译请参阅 i18n 贡献者指南。

运营方

Lore Context 由 REDLAND PTE. LTD.（新加坡，UEN 202304648K）运营。公司简介、法律条款和数据处理说明见 docs/legal/。

许可证

Lore Context 仓库采用 Apache License 2.0 许可。packages/* 下的各个软件包声明使用 MIT 许可，以便下游使用。上游署名信息请参阅 NOTICE。

致谢

Lore Context 基于 agentmemory 构建，作为本地记忆运行时。上游契约详情和版本兼容性策略见 UPSTREAM.md。