Trinity — Open Memory Layer with Governance

v8.2.1 — 治理优先的记忆操作系统：模型会换、框架会换，但记忆不换。 Trinity 是让记忆可迁移、可治理、可交易的基础设施。

🚀 开源就绪（2026-08-26）：MIT 许可证 · 数据全本地（无遥测）· 存储加密 + 审计可证明 · 全部基准带可复现 manifest。详见 docs/BENCHMARK_GUIDE.md（复现指南）、 docs/PRIVACY.md（隐私说明）、docs/INDEX.md（文档索引）。

🏆 官方基准（2026-08-27）：LongMemEval-S（ICLR 2025 官方集，500 问） Session Recall@10 = 0.98-0.99 · Turn Recall@10 = 0.93-0.94 · QA accuracy 0.358（旧口径）/ 0.467（升级口径：top-3 完整上下文 + 语义 judge，300 问） ——检索对齐头部（TiMem/Mem0 0.9+）；结果带 manifest 完全可复现。

🧠 自进化认知协作平台（2026-08-29）：八大能力在线——记忆（加密+审计+版本链）、 知识层（198 源）、自进化引擎（记忆/系统/代码三类指标）、自动化编排（8 规则+全编排）、 AgentMesh 协作（委托+订阅+配额）、记忆资产化、联邦同步、RAG 服务化（/v1/retrieval）。 代码自改三级达成（参数/脚本/自动合入，fulltest 门禁保障）。 快速接入见 docs/QUICKSTART_20260829.md · 完整总览见 docs/TRINITY_SUMMARY_20260827.md · 优化报告见 docs/OPTIMIZATION_REPORT_20260827.md。

Quick Start

# 安装（本地运行，无遥测）
pip install -e ".[dev,test]"

# 启动 API（:8001）+ MCP（:8000/:8003）
python -m trinity.api.server --port 8001
python -m trinity.mcp.server --mode sse --port 8000

# 写入与检索
python -m trinity ingest --content "用户偏好暗色模式"
python -m trinity search --query "用户偏好" --top-k 5

# 维护（每日链：health/evolution/decay/tiers/sync/backup...）
powershell -File dsh-ops/trinity-dsh-maintenance.ps1 -Tasks all

# 评测（12 项功能断言 + 官方基准复现）
python scripts/run_evals.py --all
python benchmark/longmemeval_official_runner.py --limit 100 --qa --out results.json

Trinity is not a "memory library." It is a Memory Operating System — an infrastructure layer that any memory store (vector DB, graph DB, SQLite) can plug into, with retrieval, governance, identity, evolution, and economic protocols on top.

定位（2026-08-15, V2）：记忆是 AI 最后的切换成本。Trinity = 开放记忆层 + 治理底座—— 记忆可进可出（可迁移标准）、企业敢存（治理/合规/审计）、 记忆值钱（TrustExchange 市场）。

Related MCP server: Strata Memory MCP Server

Architecture

┌──────────────────────────────────────────────────────────┐
│ Agent Layer      A2A v0.3 · DSH 原生 · 共享聚合池 · 身份   │
├──────────────────────────────────────────────────────────┤
│ Governance Layer RBAC(6) · 50-Guardian · 审计签名 · 加密  │
│                  B3 策略层（isolated/shared/delegated）    │
├──────────────────────────────────────────────────────────┤
│ Memory Layer     47 通道 · PPR · 意图压缩 · 蒸馏 11x      │
│                  个性化(PAHF) · 跨模态 · 联邦              │
├──────────────────────────────────────────────────────────┤
│ Storage Layer    SQLite(FTS5) · PostgreSQL · AES-GCM 加密 │
├──────────────────────────────────────────────────────────┤
│ Economic Layer   TrustExchange 记忆市场 · 资产定价         │
└──────────────────────────────────────────────────────────┘

528 Python files · 206K+ lines · 147 API endpoints · 815 tests passing

Quick Start

# 安装（系统 Python 3.11+）
cd trinity
pip install -e .

# 验证
python -c "import trinity; print(trinity.__version__)"   # → 8.2.1

# 全量测试（815 passed / 50 skipped / 0 failed，系统 Python 3.14）
python -m pytest tests/ -q

服务（全在线，supervisor 自愈）

Key Features（名实一致，2026-08-15 实测）

记忆可迁移（V2 核心）

# 导出标准格式（记忆护城河入场券：可进可出）
python scripts/memory_portability.py export --out memories.json
python scripts/memory_portability.py export --out memories.ndjson --format ndjson

# 导入（幂等：content_hash 去重）
python scripts/memory_portability.py import --file memories.json

# 从 Mem0 / Zep 迁移
python scripts/memory_portability.py import-mem0 --file mem0_export.json --persona p1
python scripts/memory_portability.py import-zep --file zep_export.json --persona p1

Benchmark（实测；官方 LongMemEval_S 已跑，2026-08-16）

📊 官方 LongMemEval_S 详情与分题型：docs/bench-official/LongMemEval_S_REPORT_20260816.md QA accuracy（DeepSeek judged，官方模板，500 题）= 54.0%（dated 优化：时间戳+全量证据+ temporal 分步推理；优化前基线 49.6%，temporal-reasoning +15.7pp）。 分题型：assistant 91% / user 87% / knowledge-update 64% / multi 36% / temporal 44% / preference 3%。

⚠️ 口径声明（2026-08-16）：README 旧版引用的 "LongMemEval 96.4% / BEAM 10M 64.1%" 系 Exabase M-1 / Hindsight 的成绩，非 Trinity 实测，已移除。BEAM/LoCoMo 英文官方集 仍未跑（网络限制），不构成对外宣称。

Research Foundation

Trinity 的 second_brain 与 2026 前沿对齐：PPR/HippoRAG 2、SimpleMem (ICML 2026)、 Structured Distillation (11x)、PAHF (Meta ICLR 2026)、Hindsight/BEAM、Mem0/Zep/Graphiti 思路。

Requirements

• Python 3.11+（推荐 3.14）

• Docker Desktop（容器化部署）

• jieba（中文分词）、fastapi、strawberry-graphql

License

MIT — see pyproject.toml.

Trinity: model changes, framework changes, memory doesn't.