零知识记忆层（用于 AI 代理）
持久化。加密。一行集成。🧠
官网 ·
Forge ·
文档 ·
PyPI ·
Smithery ·
MCP 注册表
## ⚡ 快速启动（< 60 秒）
### 选项 A：MCP（零代码 — Claude、Cursor、Windsurf）
添加到你的 MCP 配置并重启。无需 API 密钥。无需代码。完成。
```
{
"mcpServers": {
"synapse-layer": {
"url": "https://forge.synapselayer.org/api/mcp"
}
}
}
```
📁 配置文件位置
| 客户端 | 路径 |
|---|---|
| **Claude Desktop**（macOS） | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| **Claude Desktop**（Windows） | `%APPDATA%\Claude\claude_desktop_config.json` |
| **Cursor** | `.cursor/mcp.json`（项目）或 `~/.cursor/mcp.json`（全局） |
| **Windsurf** | `~/.codeium/windsurf/mcp_config.json` |
**5 工具即刻可用：**
| 工具 | 描述 |
|---|---|
| `save_to_synapse` | 使用完整的认知安全流水线存储记忆 |
| `recall` | 按信任商数™ 检索记忆 |
| `search` | 跨代理全文匹配记忆搜索 |
| `process_text` | 自动识别决策、里程碑和告警 |
| `health_check` | 系统健康、版本与能力报告 |
### 选项 B：Python SDK
```
pip install synapse-layer
```
```
from synapse_memory import SynapseMemory, SqliteBackend
memory = SynapseMemory(
agent_id="my-agent",
backend=SqliteBackend(), # persistent, zero-config
)
# 存储（完整安全流水线自动运行）
result = await memory.store("User prefers dark mode", confidence=0.95)
print(result.trust_quotient) # 0.89
print(result.sanitized) # True (PII auto-redacted)
print(result.privacy_applied) # True (DP noise injected)
# 按排名召回
recalls = await memory.recall("user preferences")
for r in recalls:
print(f"{r.content} (TQ: {r.trust_quotient:.2f})")
```
### 选项 C：`@remember` 装饰器（1 行）
```
from synapse_memory import SynapseMemory, remember
memory = SynapseMemory(agent_id="my-agent")
@remember(memory)
async def answer(prompt: str) -> str:
return llm.chat(prompt) # auto recall + store
```
## 🧠 为何选择 Synapse Layer？
AI 代理会在会话之间遗忘一切。它们在切换模型时丢失上下文。每次调用都会重复处理相同信息。
**Synapse Layer 是缺失的记忆原语。**
| | 无记忆 | 使用 Synapse Layer |
|---|---|---|
| **会话状态** | 每轮重置 | 会话间持久化 |
| **Token 使用** | 重复处理上下文 | 通过回忆最高减少 70% |
| **模型切换** | 上下文丢失 | 签名交接（GPT-4 ↔ Claude） |
| **隐私** | 明文嵌入 | AES-256-GCM + PII 脱敏 + DP 噪声 |
| **回忆质量** | 非确定性 | 按信任商数™ 排序 |
## 🛡️ 安全架构
每条记忆都经过一个**不可绕过的 4 层认知安全流水线**：
```
Agent → Sanitize (PII) → Validate Intent → Encrypt (AES-256-GCM) → DP Noise → Vault
```
| 层 | 名称 | 作用 |
|:---:|---|---|
| 1 | **语义隐私卫士™** | 15+ 种正则表达式匹配 PII、密钥、凭证 |
| 2 | **智能意图验证™** | 两步分类并具备回忆自愈能力 |
| 3 | **AES-256-GCM 加密** | 认证加密与 PBKDF2 密钥派生 |
| 4 | **差分隐私** | 在嵌入上添加校准的高斯噪声 |
### 🔑 MCP 权限
| 权限 | 是否必需 | 理由 |
|---|:---:|---|
| `file_system` | **仅本地** | 仅由 `SqliteBackend` 用于本地 `.synapse/memories.db` 持久化。**远程模式**（`forge.synapselayer.org/api/mcp`）**不使用文件系统** — 所有数据存储在 PostgreSQL 中。 |
| `network` | ✅ | 远程 MCP 端点通信需要网络权限。 |
## 🔌 框架集成
通过额外安装即可获得原生适配器并导入：
| 框架 | 安装 | 导入 | 状态 |
|---|---|---|---|
| **LangChain** | `pip install synapse-layer[langchain]` | `from synapse_memory.integrations import SynapseChatMessageHistory` | ✅ 稳定 |
| **CrewAI** | `pip install synapse-layer[crewai]` | `from synapse_memory.integrations.crewai_memory import SynapseCrewStorage` | ✅ 稳定 |
| **AutoGen** | `pip install synapse-layer[autogen]` | `from synapse_memory.integrations import SynapseAutoGenMemory` | ✅ 稳定 |
| **LlamaIndex** | `pip install synapse-layer[llamaindex]` | `from synapse_memory.integrations.llamaindex import SynapseRetriever` | ✅ 稳定 |
| **Semantic Kernel** | `pip install synapse-layer[semantic-kernel]` | `from synapse_memory.integrations.semantic_kernel import SynapseChatHistory` | ✅ 稳定 |
| **MCP** | 无需安装 | `forge.synapselayer.org/api/mcp` | ✅ 运行中 |
### LangChain 示例
```
from synapse_memory.integrations import SynapseChatMessageHistory
history = SynapseChatMessageHistory(agent_id="my-agent", session_id="session-1")
history.add_user_message("I prefer concise answers.")
history.add_ai_message("Got it — I'll keep it brief.")
# 适用于 RunnableWithMessageHistory：
# chain_with_history = RunnableWithMessageHistory(
# runnable=your_chain,
# get_session_history=lambda sid: SynapseChatMessageHistory(agent_id="agent", session_id=sid),
# )
```
### CrewAI 示例
```
from synapse_memory.integrations.crewai_memory import SynapseCrewStorage
storage = SynapseCrewStorage(agent_id="research-crew")
# 与 CrewAI 配合使用：Memory(storage=storage)
```
请参阅 [`examples/`](examples/) 获取完整可运行示例。
## 🔐 加密
```
from synapse_memory import SynapseCrypto
key = SynapseCrypto.generate_key()
crypto = SynapseCrypto(key)
ciphertext = crypto.encrypt("sensitive memory")
plaintext = crypto.decrypt(ciphertext) # AES-256-GCM
# 或从环境变量获取
crypto = SynapseCrypto.from_env("SYNAPSE_ENCRYPTION_KEY")
```
## 🏗️ 存储后端
```
from synapse_memory import SynapseMemory, SqliteBackend, MemoryBackend
memory = SynapseMemory(agent_id="test") # In-memory (default)
memory = SynapseMemory(agent_id="prod", backend=SqliteBackend()) # SQLite (persistent)
memory = SynapseMemory(agent_id="x", backend=MyBackend()) # Custom (implement StorageBackend)
```
## 🔍 插件架构
通过策略模式实现清晰的 **OSS/PRO 分离**：
```
from synapse_memory import AutoSaveEngine
engine = AutoSaveEngine(database=db, redactor=redact) # OSS
engine = AutoSaveEngine(database=db, redactor=redact, mode="pro") # PRO (auto-loads synapse-layer-pro)
engine = AutoSaveEngine(database=db, importance_scorer=MyScorer()) # Custom strategies
```
接口：`ImportanceScorer`、`ConflictResolver`、`DedupStrategy`、`RedactionStrategy`
## 🏆 与其他方案的对比
| 能力 | Synapse Layer | Mem0 | Zep | pgvector |
|---|:---:|:---:|:---:|:---:|
| AES-256-GCM 加密 | ✅ | ❌ | ❌ | ❌ |
| PII 脱敏（15+ 模式） | ✅ | ❌ | ❌ | ❌ |
| 差分隐私 | ✅ | ❌ | ❌ | ❌ |
| 意图验证 + 自愈 | ✅ | ❌ | ❌ | ❌ |
| 跨模型交接（JWT） | ✅ | ❌ | partial | ❌ |
| 信任商数™ 评分 | ✅ | ❌ | ❌ | ❌ |
| 原生 MCP（官方注册表） | ✅ | ❌ | ❌ | ❌ |
| 可插拔存储后端 | ✅ | ❌ | ❌ | ✅ |
| 插件架构 | ✅ | ❌ | ❌ | ❌ |
| 零知识架构 | ✅ | ❌ | ❌ | ❌ |
## 📊 v1.1.7 数据
- **481 个测试** | **90% 覆盖率**
- **5 个框架集成**（LangChain、CrewAI、AutoGen、LlamaIndex、Semantic Kernel）
- **5 个 MCP 工具**（真实数据库，非存根）
- **2 个存储后端**（Memory、SQLite）+ 自定义协议
- **AES-256-GCM** 配合 PBKDF2 密钥派生（600,000 次迭代）
## 🌐 开放核心模型
- **社区版（Apache 2.）** — 完整 SDK、安全流水线、MCP 集成、所有后端、所有集成。
- **企业版** — 高级 TQ 校准、多租户保险库、生产级基础设施。
## 🛣️ 路线图
| 版本 | 状态 | 亮点 |
|---|---|---|
| **v1.1.x** | ✅ **稳定** | SqliteBackend、AES-256-GCM、`@remember`、5 个 MCP 工具、5 个框架集成、481 个测试 |
| **v1.2.0** | 🚧 研发中 | 嵌入模型选择、向量相似性搜索、批量操作 |
| **v2.0.0** | 📋 规划中 | 多租户保险库、团队记忆空间、RBAC |
## 🤝 贡献
```
git clone https://github.com/SynapseLayer/synapse-layer.git
cd synapse-layer
pip install -e ".[dev]"
python -m pytest tests/ -q # 481 tests
```
请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 获取指南。
## 📎 联系
- 📦 **PyPI：** [`pip install synapse-layer`](https://pypi.org/project/synapse-layer/)
- 🔌 **MCP：** `forge.synapselayer.org/api/mcp`
- 📖 **文档：** [synapselayer.org/docs](https://synapselayer.org/docs)
- 📣 **X（推特）：** [@synapselayer](https://x.com/synapselayer)
- 🧠 **Forge：** [forge.synapselayer.org](https://forge.synapselayer.org)
## 许可证
Apache License 2.0 — 参见 [LICENSE](LICENSE)。
开放核心模型：SDK、MCP 服务器与安全流水线均为完全开源。信任商数™ 权重、神经交接™ 内部实现与 Synapse Forge 属于专有技术。
赋予代理过去。赋予模型灵魂。 ⚗️
由
Ismael Marchi 构建 ·
@synapselayer