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。

✨ 亮点（为什么值得看）

1. 可证明的记忆：每条记忆带 SHA-256 审计回执（可独立重算）+ CRDT 版本链 ——全网唯一 inspectable memory 完整实践；

2. 自进化引擎：参数自动调优 → LLM 代码补丁 → 门禁验证自动合入（无人值守）；

3. 自运行平台：39 任务每日维护链（健康/调参/遗忘/联邦/镜像同步）+ 自愈 + 秒级回滚；

4. PG 主存储：PostgreSQL 正式主存储 + SQLite 镜像（一键切换/回滚）；

5. MS 类目突破：multi-session QA 0.237→0.467（答案生成时序列表策略）；

6. 零成本判题：Ollama 本地 judge（云调用 0）+ 启发式蒸馏。

Related MCP server: cortex-engine

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 市场）。

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.

最新基准（2026-09-03，EXECUTION 466）

• LongMemEval oracle 500 题：R@1/3/5/10 = 1.000（六类，两轮独立复现）

• QA AnswerAcc：官方基线 0.560 → 提示路由 0.578 → v2 锁定 0.642（MS 0.391→0.617）

• 明细/档案/实验纪律：docs/LEADERBOARD.md · docs/BENCHMARKS.md · dsh-ops/EXECUTION.md

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