内容
# 🧠 全息记忆 — MCP 服务器 (Go)
**🌐 [holo.ai3d.art](https://holo.ai3d.art)** · 开源 · 隐私优先 · 5美元/月 云服务
> 首个 **完全开源、隐私优先的全息长期记忆**，适用于 AI 代理。
> 基于 Kanerva 的 **稀疏分布式记忆（SDM）** — 联想记忆，最近的研究（2021–2026）证明其在数学上等同于 **注意力** 机制
> 在 Transformers（GPT-4, Claude）中。
给予 Claude Desktop、Cursor 和任何与 MCP 兼容的代理一个 **通过关联思考** 的记忆，而不是通过关键词匹配。 今天说 *"我不喜欢 Python"*，下个月问 *"我应该用什么编写这个脚本？"* — 代理回忆 *"Go，因为你不喜欢 Python。"* 普通向量 RAG 无法做到这一点。基于干扰的回忆可以。
---
## 目录 / Оглавление
| # | 中文 |
|---|---------|
| 1 | [为什么需要全息记忆](#1-为什么需要全息记忆) |
| 2 | [工作原理](#2-工作原理) |
| 3 | [数学模型](#3-数学模型) |
| 4 | [MCP 工具](#4-mcp-工具) |
| 5 | [架构](#5-架构) |
| 6 | [版本和定价](#6-版本和定价) |
| 7 | [安装](#7-安装) |
| 8 | [技术栈](#8-技术栈) |
| 9 | [路线图](#9-路线图) |
| 10 | [文档](#10-文档) |
| 11 | [许可证](#11-许可证) |
---
## 1. 为什么需要全息记忆
经典 RAG 是字面意义上的：没有关键词重叠 → 没有命中。SDM 将每个事实存储为一个 **高维二进制向量（{0,1}ⁿ，n ≈ 10,000）**，**分散在多个地址上**。
回忆通过激活半径内的所有内容的多数投票来重建信号，因此它可以抵抗噪声、部分提示和模糊提示 — 并揭示用户仅暗示的 **联系**。
| | 向量 RAG | 全息记忆（SDM） |
|---|---|---|
| 匹配模型 | 关键词 / 余弦相似度 | 联想干扰 |
| 模糊查询 | 丢失 | 从噪声中重建 |
| 冲突事实 | 静默共存 | 标记为干扰 |
| 基础 | 临时嵌入 | Kanerva SDM ≈ Transformer 注意力 |
## 2. 工作原理
```mermaid
flowchart LR
A["事实：<br/>'用户不喜欢 Python'"] -->|编码| B["超向量<br/>{0,1}^10000"]
B -->|"写入半径 r"| C[(分布式<br/>地址云)]
Q["模糊查询：<br/>'什么语言？'"] -->|编码| D["查询向量"]
D -->|"激活半径 r"| C
C -->|"多数规则读取"| E["去噪回忆：<br/>'使用 Go — 你不喜欢 Python'"]
```
事实并非存储在一行中 — 它 **叠加在汉明半径内的每个硬件位置**。 读取噪声或模糊提示时，会重新收集那些重叠的轨迹，并将它们投票回一个干净的答案。
## 3. 数学模型
在 Go 中实现，直接来自 Kanerva 的 SDM：
- **距离 — 汉明距离：** `d(A, B) = Σᵢ (Aᵢ ⊕ Bᵢ)`
- **写入 — 干扰：** 激活地址 `X` 半径 `r` 内的所有硬件位置，然后增加/减少它们的计数器（波叠加）：
`Activate(X) = { Y ∈ HardLocations | d(X, Y) ≤ r }`
- **读取 — 联想回忆：** 对查询 `Q` 周围的激活单元格求和，应用多数规则：
`Outputᵢ = sign( Σ_{Y ∈ Activate(Q)} CellContents(Y)ᵢ )`
这甚至可以从噪声或部分遗忘的查询中重建 100% 清洁的上下文。
## 4. MCP 工具
| 工具 | 功能 |
|---|---|
| `store_holographic_snapshot` | 将结构化记忆（事实 + 上下文 + 情感价值 + 重要性 + 标签）存储为叠加的超向量。 |
| `recall_by_association` | 从模糊或情感提示中检索去噪的“意义云”。 |
| `interference_analysis` | 检测新事实与现有信念发生冲突时；返回冲突 + 置信度。 |
| `consolidate_and_prune` | “睡眠”：丢弃弱关联，加强频繁使用的关联，保持存储快速。 |
<details>
<summary><b>示例 — 联想回忆</b></summary>
```json
{
"name": "recall_by_association",
"arguments": { "query": "我感到沮丧时正在做的项目", "association_depth": 3 }
}
```
</details>
<details>
<summary><b>示例 — 干扰检测</b></summary>
```json
{ "name": "interference_analysis", "arguments": { "new_fact": "我搬到了柏林" } }
// → { "conflict_detected": true, "previous_memory": "用户居住在伦敦", "confidence": 0.85 }
```
</details>
## 5. 架构
```mermaid
flowchart TB
subgraph Client["AI 代理 — Claude Desktop / Cursor"]
AG[LLM 代理]
end
subgraph Server["全息记忆服务器（Go）"]
MCP["MCP 处理器<br/>(stdio / JSON-RPC)"]
LIC{"许可证门<br/>LOCAL = 免费"}
SDM["SDM 引擎<br/>编码 · 写入 · 回忆"]
STORE[("SQLite / 二进制<br/>关联存储")]
end
CLOUD["☁️ 云同步（专业版 5美元/月）<br/>加密跨设备"]
AG <-->|"工具/调用"| MCP
MCP --> LIC --> SDM --> STORE
SDM -. 可选 .-> CLOUD
```
## 6. 版本和定价
该项目采用 **开源核心**：引擎免费开源，方便使用需付费。
```mermaid
flowchart LR
Free["🆓 本地 — 免费<br/>MIT/Apache-2.0<br/>完整 SDM 引擎 · 4 个工具<br/>本地 SQLite · 100% 私有"]
Pro["⭐ 云 / 专业版 — 5美元/月<br/>加密跨设备同步<br/>托管 + 备份<br/>语义云可视化"]
Biz["🏢 企业<br/>双重许可<br/>自定义 SDM 集成"]
Free --> Pro --> Biz
```
- **本地（免费）** — 100% 在您的机器上运行；您的记忆永远不会离开您的计算机。
- **云 / 专业版（5美元/月）** — 在工作时与 Claude 在家中使用相同的记忆；托管、备份和可视化。
- **企业** — 闭源嵌入权限 + 定制集成。
## 7. 安装
```bash
# 使用 Smithery 一键安装
npx -y @smithery/cli install holographic-memory
```
或手动添加到 `claude_desktop_config.json`:
```json
{
"mcpServers": {
"holographic-memory": {
"command": "uvx",
"args": ["holographic-memory-server"],
"env": {
"MEMORY_MODE": "LOCAL",
"MEMORY_LICENSE_KEY": "可选 — 仅用于云/专业版同步"
}
}
}
}
```
`MEMORY_MODE=LOCAL` 不需要密钥，永久免费。设置 `MEMORY_LICENSE_KEY`（在 **[holo.ai3d.art](https://holo.ai3d.art)** 获取）仅用于解锁加密的跨设备同步。
## 8. 技术栈
- **Go 1.24+** — 快速、低 RAM、单个静态二进制文件
- **MCP over stdio** （JSON-RPC）
- **本地存储** — SQLite / 二进制关联文件，实现 Kanerva SDM
- **Docker** — 多阶段 Alpine 构建
- **支付** — Lemon Squeezy（许可证密钥 + 订阅）
## 9. 路线图
| 层级 | 焦点 | 状态 |
|---|---|---|
| **1** | Claude Desktop / Cursor 的长期记忆 | 🚧 进行中 |
| **2** | 游戏引擎（Unity / Unreal）— NPC 骨骼“肌肉记忆” | 🔭 计划中 |
| **B2B** | 日志 / SIEM 异常检测（模式弥散在时间上） | 🔭 计划中 |
完整时间线和甘特图：请参见 **[docs/GTM_PLAN.md](docs/GTM_PLAN.md)**。
## 10. 文档
- 📋 **[技术规格（SRS）/ 技术要求](docs/TECHNICAL_SPEC.md)**
- 🚀 **[上市计划和甘特图 / 上市计划](docs/GTM_PLAN.md)**
## 11. 许可证
**双重许可：**
- **AGPL-3.0** （免费）— 个人、自我托管和开源使用。如果您运行修改后的版本作为网络服务，AGPL 要求您发布相应的源代码。请参见
[`LICENSE`](LICENSE)。
- **商业许可证** （付费）— **需要** 将此软件嵌入闭源或商业产品中，或在不发布源代码的情况下在专有服务中运行。 在 **[holo.ai3d.art](https://holo.ai3d.art)** 获取。 请参见
[`COMMERCIAL-LICENSE.md`](COMMERCIAL-LICENSE.md)。
---
*"适用于 Claude 的智能长期记忆，不会忘记一周前的聊天上下文。"*
