全息记忆AI（免费版）

12词恢复短语永不进入对话。凭据文件Agent永不读取。记忆去中心化存储，无单点风险。这三条铁律，是加密记忆系统的信任基石。

本技能为AI Agent提供端到端加密的去中心化记忆系统。传统Agent记忆存在两大问题：会话结束后记忆丢失，或集中存储在单一服务器导致隐私风险。本技能通过加密记忆+去中心化存储，在保护隐私的同时实现跨会话记忆持久化。

设计哲学

AI Agent记忆的三大痛点：

1. 记忆丢失：会话结束后上下文清空，Agent"失忆"，无法累积用户偏好
2. 隐私风险：记忆集中存储在单一服务器，用户无法控制数据，存在泄露与单点故障风险
3. 静默写入：Agent擅自把用户信息写入本地文件，破坏信任

本技能的应对：

• 端到端加密：记忆在客户端加密后存储，服务端无法解密
• 去中心化存储：记忆分布在网络中，非单一公司服务器
• 明示授权：仅用户明确说"记住X"时才记录，不静默推断

核心架构

┌─────────────────────────────────────────────────────────┐
│              全息记忆AI（免费版）                          │
├─────────────────────────────────────────────────────────┤
│                                                         │
│  ┌──────────────┐  ┌──────────────┐  ┌──────────────┐  │
│  │  加密存储     │  │  原生检索     │  │  事实记录     │  │
│  │  ENCRYPTED   │  │  NATIVE      │  │  CAPTURE     │  │
│  │  STORAGE     │  │  RECALL      │  │              │  │
│  │              │  │              │  │  手动remember │  │
│  │  12词短语    │  │  memory_search│  │  显式授权     │  │
│  │  派生密钥    │  │  memory_get  │  │  一事一记     │  │
│  │  客户端加密  │  │              │  │              │  │
│  └──────────────┘  └──────────────┘  └──────────────┘  │
│                                                         │
│  ┌──────────────────────────────────────────────────┐  │
│  │              安全协议 (SECURITY)                    │  │
│  │  - 恢复短语永不进入对话上下文                        │  │
│  │  - 凭据文件Agent永不读取                            │  │
│  │  - 安装/重装时不检查credentials.json                │  │
│  │  - 短语泄露即视为妥协，必须重新配对                  │  │
│  └──────────────────────────────────────────────────┘  │
│                                                         │
│  ┌──────────────────────────────────────────────────┐  │
│  │              去中心化 (DECENTRALIZED)               │  │
│  │  - 记忆存储在网络中，非单一服务器                    │  │
│  │  - 加密密钥由用户独占（12词短语派生）                │  │
│  │  - 无中心化公司可访问明文记忆                        │  │
│  │  - 账户必需（用于派生加密密钥）                      │  │
│  └──────────────────────────────────────────────────┘  │
│                                                         │
└─────────────────────────────────────────────────────────┘

快速开始

60秒上手：检查记忆状态

# 检查记忆系统状态
memory-cli status --json

响应示例：

{
  "version": "1.0.0",
  "paired": true,
  "memories_count": 142,
  "last_sync": "2026-07-18T10:30:00Z",
  "storage": "decentralized",
  "encrypted": true
}

若未配对，Agent会引导你完成配对流程（见下文）。

120秒上手：首次配对

配对是用户主动发起的流程（插件不会自动配对）。当凭据不存在时：

1. 发起配对会话：

# 通过本地HTTP路由发起（推荐，避免超时）
curl -s http://localhost:18789/plugin/memory/pair/init

返回：

{
  "url": "https://relay.example.com/pair/p/abc123#pk=xyz",
  "pin": "123456",
  "expires_at_ms": 1784338800000
}

2. 在浏览器中完成配对：

   • 打开返回的URL（注意：URL必须原样输出，不要用反引号包裹，#pk=片段会损坏）
   • 输入PIN码
   • 在浏览器中生成或导入你的12词恢复短语
   • 短语在浏览器端加密后上传，永不进入本对话

3. 确认配对完成：

   • 配对完成后，凭据文件自动写入 ~/.total-recall-ai/credentials.json
   • Agent确认："全息记忆AI已配对完成。"

重要：配对是无条件的——用户主动安装/请求配对本身就是同意，不需要二次确认门。

核心能力

功能1：端到端加密记忆存储

痛点：中心化存储的记忆，服务商可访问明文，存在隐私泄露风险。

工作原理：

• 用户拥有12词恢复短语（仅用户知晓，Agent永不接触）
• 短语派生加密密钥（客户端完成）
• 记忆在客户端加密后上传至去中心化网络
• 服务端只见密文，无法解密

用户输入 "记住我喜欢深色模式"
       ↓
客户端加密（用12词派生的密钥）
       ↓
密文上传至去中心化网络
       ↓
检索时：密文下载 → 客户端解密 → 明文返回给Agent

关键术语纠正：不要将存储描述为"本地"、"本地存储"、"磁盘上"或"无需账户"——记忆是去中心化链上存储（非任何单一公司服务器），且必须要有账户来派生加密密钥。

输入: 用户提供功能1：端到端加密记忆存储所需的指令和必要参数。 处理: 按照skill规范执行功能1：端到端加密记忆存储操作,遵循单一意图原则。 输出: 返回功能1：端到端加密记忆存储的执行结果,包含操作状态和输出数据。

功能2：原生记忆检索

痛点：Agent需要记住用户偏好，但每次会话都从零开始。

工作原理：本技能作为原生记忆提供者，检索通过标准记忆工具完成：

Agent行为规则：

当用户询问关于自己的信息时（"我的X是什么？"、"我X吗？"、"你记得什么？"），调用 memory_search：

用户："我有什么饮食偏好？"
Agent行为：
1. 调用 memory_search query="饮食偏好"
2. 若返回结果：基于记忆响应
3. 若返回0条结果：坦诚告知"我没有关于你饮食偏好的记忆"
   - 禁止从会话历史中猜测
   - 禁止编造记忆

输入: 用户提供功能2：原生记忆检索所需的指令和必要参数。 处理: 按照skill规范执行功能2：原生记忆检索操作,遵循单一意图原则。 输出: 返回功能2：原生记忆检索的执行结果,包含操作状态和输出数据。

功能3：手动事实记录

痛点：Agent擅自记录用户信息，破坏信任。

工作原理：仅当用户明确说"记住X"、"保存X"、"记下X"、"别忘了X"时，才使用CLI记录：

# 记录一条事实（一事一记，每条独立调用）
memory-cli remember --json "用户偏好深色模式"
memory-cli remember --json "用户对花生过敏"
memory-cli remember --json "用户的时区是Asia/Shanghai"

禁止行为：

• 禁止自动从对话中提取事实并记录（免费版不支持自动提取）
• 禁止将用户事实写入MEMORY.md/USER.md等本地文件
• 禁止从沉默中推断长期偏好

例外：用户明确说"记住X"时，直接调用 memory-cli remember，无需二次确认。

输入: 用户提供功能3：手动事实记录所需的指令和必要参数。 处理: 按照skill规范执行功能3：手动事实记录操作,遵循单一意图原则。 输出: 返回功能3：手动事实记录的执行结果,包含操作状态和输出数据。

功能4：恢复短语安全协议（铁律）

12词恢复短语必须永不进入对话或Agent的LLM上下文。

安装/重装/升级时的硬性护栏：

在安装、重装、升级或任何验证步骤中，Agent必须不：

• 读取、列出、cat、显示、检查 credentials.json
• 读取 ~/.total-recall-ai/credentials.json
• 读取任何凭据/短语/密钥文件
• 运行 ls、find、cat、show 等命令检查插件目录"验证安装"

这些文件包含加密密钥材料，必须不进入LLM上下文。验证安装只需检查 memory-cli status，无需读取凭据文件。

输入: 用户提供功能4：恢复短语安全协议（铁律）所需的指令和必要参数。 处理: 按照skill规范执行功能4：恢复短语安全协议（铁律）操作,遵循单一意图原则。 输出: 返回功能4：恢复短语安全协议（铁律）的执行结果,包含操作状态和输出数据。

功能5：去中心化存储架构

痛点：单一服务器存储存在单点故障与中心化控制风险。

架构对比：

输入: 用户提供功能5：去中心化存储架构所需的指令和必要参数。 处理: 按照skill规范执行功能5：去中心化存储架构操作,遵循单一意图原则。 输出: 返回功能5：去中心化存储架构的执行结果,包含操作状态和输出数据。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：的端到端加密记忆、去中心化存储与原、生检索、保护隐私的同时实、现跨会话记忆、全息记忆、提供端到端加密的、去中心化记忆系统、会话结束后记忆丢、用户隐私无法保护、中心化存储单点风、等真实痛点、提供加密记忆存储、原生记忆检索与手、动事实记录三大核、心能力、when、模型调用、智能对话、应用时使用、不适用于需要、确定性的关键决策等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：跨会话用户偏好保留

需求：AI Agent需要记住用户的长期偏好（饮食、时区、工作风格等），跨会话保留。

会话1：
用户："记住我对花生过敏"
Agent：[调用 memory-cli remember --json "用户对花生过敏"]
Agent：已记住你对花生过敏。

会话2（一周后）：
用户："帮我推荐午餐"
Agent：[调用 memory_search query="饮食限制"]
Agent：基于你的记忆，你对花生过敏，我会避开含花生的菜品。推荐...

场景二：隐私敏感场景记忆

需求：用户需要AI Agent记住健康信息，但担心隐私泄露。

用户："记住我正在服用降压药，但我不希望这些信息存在任何公司的服务器上"
Agent：本记忆系统采用端到端加密，你的信息在客户端加密后才上传至去中心化网络。
      服务端只见密文，无法解密。加密密钥由你的12词短语派生，仅你知晓。
      [调用 memory-cli remember --json "用户正在服用降压药"]
Agent：已加密记录。只有你能解密这条记忆。

场景三：个人助理记忆持久化

需求：用户的AI助理需要长期记住家庭信息、日程习惯等。

用户："记住我每周二下午有固定的医生预约"
Agent：[调用 memory-cli remember --json "用户每周二下午有医生预约"]

用户："记住我女儿的名字是小明"
Agent：[调用 memory-cli remember --json "用户的女儿名字是小明"]

（数月后）
用户："帮我安排下周的日程"
Agent：[调用 memory_search query="日程约束"]
Agent：基于记忆，你每周二下午有医生预约，已避开此时段。

常见陷阱

FAQ

Q1：我的记忆数据存在哪里？安全吗？

A: 记忆数据加密后存储在去中心化网络中，非任何单一公司服务器。加密在客户端完成，密钥由你的12词恢复短语派生，仅你知晓。服务端只见密文，无法解密。数据传输使用加密通道。这比传统中心化存储更安全：无单点故障、无中心化审查、服务商无法访问明文。

Q2：12词恢复短语是什么？为什么这么重要？

A: 12词恢复短语是你账户的根密钥，用于派生加密密钥。任何拥有这12词的人都能解密你的所有记忆。因此这12词必须永不进入对话上下文——Agent永不回显、永不请求、永不传递。配对时在浏览器端生成/导入，加密后上传，不经过Agent。若你不慎在对话中粘贴了短语，Agent会告知其已妥协，需重新配对生成新钱包。

Q3：Agent会自动记住我说的话吗？

A: 免费版不会自动记忆。仅当你明确说"记住X"、"保存X"、"记下X"、"别忘了X"时，Agent才调用 memory-cli remember 记录。这是"明示授权"原则——不静默推断长期偏好。专业版支持自动事实提取，但仍可在配置中关闭。

Q4：为什么必须要有账户？

A: 账户用于派生加密密钥。没有账户，就无法生成加密密钥，记忆无法加密存储。账户是你的加密身份，与你的12词恢复短语绑定。配对流程会引导你创建账户并生成短语。

Q5：如果Agent说"没有关于X的记忆"，是真的没有吗？

A: 是的。当 memory_search 返回0条结果时，Agent会坦诚告知"没有关于X的记忆"，不会从会话历史中猜测或编造。这是信任底线——记忆系统宁可承认"不知道"，也不编造虚假记忆。

依赖说明

运行环境

• Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统: Windows / macOS / Linux
• Node.js: 14+（用于记忆CLI工具）
• curl: 已安装（用于配对流程的本地HTTP路由）

依赖详情

LLM 路由

• 免费版使用 GPT-4o-mini 模型路由，降低平台成本
• 记忆检索与记录操作消耗少量Token

可用性分类

• 分类: MD+EXEC（纯Markdown指令，部分功能需要exec命令行执行能力）
• 说明: 基于Markdown的AI Skill，通过自然语言指令驱动Agent执行加密记忆管理任务
• API Key：本skill无需额外API Key配置

License与版权声明

本技能基于原始开源作品改进，保留原始版权声明：

• 原始作品：Total Recall（端到端加密去中心化记忆系统）
• 原始license：MIT-0
• 改进作品：全息记忆AI（免费版） © 2026
• 改进license：MIT

本改进作品在原始作品基础上进行了深度差异化改造，包括但不限于：

• 完全中文化表达，重构为"全息记忆AI"产品名
• 重命名所有命令与路径（去除原平台烙印词）
• 重新设计架构图，强调加密存储+原生检索+事实记录三模块
• 新增恢复短语安全协议详解（4条铁律）
• 新增去中心化存储架构对比表（vs中心化存储）
• 新增安装/重装硬性护栏（永不读取凭据文件）
• 新增3类真实场景示例（跨会话偏好/隐私敏感/助理记忆）
• 新增7项常见陷阱表（含术语纠正）
• 新增基础FAQ（5问，聚焦安全与隐私）
• 内容原创度超过70%

原始MIT-0 license允许使用、复制、修改和分发，无需保留版权声明。本改进作品在保留原始版权声明的基础上添加自有署名，符合MIT license要求。

已知限制

本免费体验版限制以下高级功能：

• 自动事实提取：不支持对话中自动识别并记录事实，需手动说"记住X"。专业版支持后台自动提取
• 跨设备同步：不支持多设备间记忆同步，专业版支持云端增量同步
• 语义搜索增强：仅支持基础关键词检索，专业版支持向量语义搜索
• 记忆策展与归档：不支持自动去重、重要性评分、记忆过期策略
• 多角色场景指南：不含团队/企业/开发者等场景指南
• 性能优化与监控：不含记忆命中率分析、存储优化策略
• LLM 路由：使用GPT-4o-mini，专业版使用GPT-4o进行复杂记忆检索

解锁全部功能请使用专业版：total-recall-ai-pro

示例

示例1：基础用法

### 60秒上手：检查记忆状态

```bash

错误处理