Enigma

官方 $ENIGMA 代币（Solana 主网）：
合约地址（CA）：EknDj8VZUHL6FhV9pSk3m6xP2U2sDzwjRDVstKeQpump
Solscan 浏览器 • Pump.fun • 官方网站

Enigma Memory 是一款本地优先的 AI 记忆护照。它为你提供一个权威的本地记忆保险库、以收据为凭证的 Enigma 控制事件证明，以及通往 Claude Desktop、Cursor、Kimi Code 和通用 MCP 客户端等助手的 MCP 连接。

从下面的 Memory Drive 循环开始——一次安装、一次连接，然后进行健康与状态验证。在本地试用 Enigma 之前，你无需理解 relay、gateway、mesh、浏览器、桌面端、托管基础设施或证明网络。

托管云和 BYOC 运营仅限候补名单/运营商部署；它们需要真实的部署凭证、域名、TLS、持久化存储、KMS/机密、监控、备份以及运营商验收。包内附带的 relay 和 gateway 二进制文件是本地引导探测程序，而非实时托管服务。

Enigma 并不声称某个封闭提供商删除了内部数据、模型权重遗忘了内容，或提供商原生记忆已消失。它证明的是关于 Enigma 控制的保险库状态、收据、检查点以及声明的边界操作的事实。

一次安装，随处使用

前置条件：

• Node.js >=24

• 本地设置路径无需数据库、包注册表账户、提供商凭证、云凭证、托管 Enigma 账户或任何外部账户

• 仅当你选择高级源码检出路径时才需要 Git

将 Enigma 用作你的私人 AI Memory Drive：一次安装，连接你已有的 AI 客户端，然后在记忆、检索、打包和验证上下文之前检查驱动器健康状态与护照状态。

npm install -g enigma-memory
enigma setup --bundle "$HOME/.enigma/bundle.json" --client auto --connect-installed --overwrite
echo "Keep all Q3 planning notes in the project-context tag." > memory.txt
enigma remember --bundle "$HOME/.enigma/bundle.json" --text-file memory.txt
enigma search --bundle "$HOME/.enigma/bundle.json" --query "Q3 planning"
enigma context --bundle "$HOME/.enigma/bundle.json" --query "Q3 planning" --out "$HOME/.enigma/context-pack.json"
enigma verify --export "$HOME/.enigma/export.json"

Windows CMD：

npm install -g enigma-memory
enigma setup --bundle "%USERPROFILE%\.enigma\bundle.json" --client auto --connect-installed --overwrite
echo Keep all Q3 planning notes in the project-context tag.> memory.txt
enigma remember --bundle "%USERPROFILE%\.enigma\bundle.json" --text-file memory.txt
enigma search --bundle "%USERPROFILE%\.enigma\bundle.json" --query "Q3 planning"
enigma context --bundle "%USERPROFILE%\.enigma\bundle.json" --query "Q3 planning" --out "%USERPROFILE%\.enigma\context-pack.json"
enigma verify --export "%USERPROFILE%\.enigma\export.json"

enigma setup 是无需凭证的首次运行：它会创建本地 .enigma 工作区、bundle、证明工件和一条演示记忆，然后连接它检测到的所有已安装/配置存在的客户端（Claude Desktop、Cursor、Kimi Code、VS Code/Cline、Roo、OpenCode、通用 MCP）。enigma start 是快速启动流程的别名。Setup 会跳过未安装的客户端，并且绝不会从零创建配置；如果你想查看哪些客户端将被写入，可先用 --dry-run 预览。

密钥环安全模式与静态保密性

• 开发者默认模式（local_secret）：在不带凭证参数的情况下运行 enigma setup 或 enigma quickstart 会初始化一个未加密的开发者密钥环（unencrypted: true）。此模式对本地文件访问不提供任何静态保密性，仅用于零配置的本地评估。

• 主权加密模式（local_secret_encrypted）：在环境中设置 ENIGMA_PASSPHRASE，或传入 --passphrase-file <path>，即可使用 AES-256-GCM AEAD 对保险库密钥进行静态加密，并采用 scrypt 密钥派生和 GCM AAD 元数据认证。

加密 + Solana 连接的本地流程：

npm install -g enigma-memory
printf "choose-a-long-local-passphrase\n" > ~/.enigma-passphrase
enigma quickstart --bundle "$HOME/.enigma/bundle.json" --passphrase-file ~/.enigma-passphrase --overwrite
enigma remember --bundle "$HOME/.enigma/bundle.json" --passphrase-file ~/.enigma-passphrase --text-file memory.txt
enigma-terminal --exec "solana status --cluster devnet"
enigma chain anchor-bundle --bundle "$HOME/.enigma/bundle.json" --cluster devnet --out "$HOME/.enigma/anchor-batch.json"
enigma chain submit-solana --file "$HOME/.enigma/anchor-batch.json" --cluster devnet
# Actual on-chain write, when you provide a funded Solana CLI keypair:
# enigma chain submit-solana --file "$HOME/.enigma/anchor-batch.json" --cluster devnet --execute --keypair ~/.config/solana/id.json

chain anchor-bundle 仅锚定公共承诺根（active_set_root、receipt_log_root）和公共引用。它绝不会将原始记忆、明文提示、保险库密钥、口令、私钥或加密的 bundle 主体上链。chain submit-solana 默认处于 dry-run 模式；--execute 会使用你显式提供的已注资密钥对，向 Solana 写入一条紧凑的 SPL Memo 证明引用。

cypherpunk 研究基础记录在 docs/research/sovereign-cypherpunk-memory.md 中：Shamir 1979 阈值共享、Merkle 1979 累加器、Rubberhose/TrueCrypt 的可否认存储模式、OTR/Signal 棘轮，以及 Unix/Windows 内存锁定约束。该文档明确属于探索性质；生产版 Enigma 仅提供上述经过评审的本地保险库原语和公共安全的 Solana 承诺锚定。

在把 enigma doctor 视为完全绿色的安装检查之前，请先运行 setup 或 quickstart。Doctor 会同时检查本地包/运行时环境和现有的连接器配置；在全新安装时，如果某个 MCP 客户端配置已经指向一个尚未初始化的 Enigma bundle，或者客户端仍然指向其他位置，doctor 可能显示红色。这是预期的首次运行状态，并不代表 npm 包安装失败。无摩擦路径是 enigma quickstart --bundle ./.enigma/bundle.json --overwrite 或 enigma setup --bundle ./.enigma/bundle.json --overwrite，然后运行 enigma doctor --bundle ./.enigma/bundle.json。如果未安装任何客户端，setup 仍然会成功，本地 CLI 路径也可用；之后可使用下面的复制粘贴 MCP 片段来连接客户端。

对于无全局安装路径，请先运行 npx --yes --package enigma-memory enigma quickstart --bundle ./.enigma/bundle.json --overwrite，再运行 npx --yes --package enigma-memory enigma doctor --bundle ./.enigma/bundle.json；先运行 npx doctor 可能会显示同样的预期红色 generic-MCP 缺失 bundle 状态。

Related MCP server: Sovereign Universal Memory MCP

Enigma Proof Network

Enigma Proof Network 是面向 AI 记忆的公共证明层：本地工具可以打包隐私保护的根、引用、计数、签名、受限能力授权、撤销和基准证明，而不会暴露原始记忆、提示、转录文本、补全结果、嵌入、租户名称、私钥、提供商响应或提供商凭证。

enigma chain anchor|grant|revoke|attest|verify 命令是本地规划与验证命令。它们输出公共安全的 JSON，其中 transaction_submitted:false 和 raw_memory_on_chain:false；它们不会提交 Solana 交易、部署托管 SaaS、创建账户或调用外部提供商。

先从 docs/market-category-narrative.md 中的类别叙述开始，然后阅读 docs/proof-network.md 中的技术概述，使用其中的 Solana 角色 一节了解 Solana 就绪的锚定边界，并阅读 docs/proof-network-faq.md 了解声明边界。

高级/仅源码路径

仅当你需要仅源码文档、Docker 资产、浏览器扩展脚手架、包开发或发布脚本时，才使用源码检出：

git clone https://github.com/Enigma-Memory/enigma-memory.git
cd enigma-memory
npm run install:local -- --execute --init-vault --bundle ./.enigma/bundle.json
enigma doctor --bundle ./.enigma/bundle.json
enigma-relay demo
enigma-gateway demo

install:local 默认是 dry-run，除非带有 --execute。上面的命令会将检出的包全局安装，并创建一个本地保险库 bundle。它不需要 Cloudflare、OpenAI、Anthropic、npm 发布凭证、数据库或托管基础设施。

手动替代方案：检查 enigma setup 为你准备的底层本地保险库步骤。使用租户批准的 smoke 文件；不要将私有记忆展开到 shell argv 中。

POSIX shell：

mkdir -p .enigma
ENIGMA_DEMO_MEMORY_FILE=/absolute/path/to/tenant-approved-smoke-memory.txt
test -f "$ENIGMA_DEMO_MEMORY_FILE"
enigma init --bundle ./.enigma/bundle.json --subject local-user --display-name "Local user"
enigma remember --bundle ./.enigma/bundle.json --text-file "$ENIGMA_DEMO_MEMORY_FILE" --purpose user_memory --tags local
enigma context --bundle ./.enigma/bundle.json --query "local context" --purpose local_answer --out ./.enigma/context-pack.json
enigma export --bundle ./.enigma/bundle.json --out ./.enigma/export.json
enigma verify --export ./.enigma/export.json

Windows PowerShell：

New-Item -ItemType Directory -Force .enigma | Out-Null
$env:ENIGMA_DEMO_MEMORY_FILE = "C:\path\to\tenant-approved-smoke-memory.txt"
if (-not (Test-Path -LiteralPath $env:ENIGMA_DEMO_MEMORY_FILE)) { throw "Missing ENIGMA_DEMO_MEMORY_FILE" }
enigma init --bundle .\.enigma\bundle.json --subject local-user --display-name "Local user"
enigma remember --bundle .\.enigma\bundle.json --text-file $env:ENIGMA_DEMO_MEMORY_FILE --purpose user_memory --tags local
enigma context --bundle .\.enigma\bundle.json --query "local context" --purpose local_answer --out .\.enigma\context-pack.json
enigma export --bundle .\.enigma\bundle.json --out .\.enigma\export.json
enigma verify --export .\.enigma\export.json

bundle 是本地的。导出的证明工件包含加密/已提交的保险库状态和收据元数据；不要将原始记忆明文粘贴到 relay 记录、见证检查点、SIEM 事件、公共证明工件或 shell 命令行中。

MCP 设置

通过 stdio 运行 Enigma MCP 服务器：

POSIX shell：

ENIGMA_BUNDLE="$HOME/.enigma/bundle.json" enigma-mcp

Windows PowerShell：

$env:ENIGMA_BUNDLE = "$HOME\.enigma\bundle.json"
enigma-mcp.cmd

或通过 CLI：

ENIGMA_BUNDLE="$HOME/.enigma/bundle.json" enigma mcp serve

Windows PowerShell CLI 形式：

$env:ENIGMA_BUNDLE = "$HOME\.enigma\bundle.json"
enigma.cmd mcp serve

通用 MCP 客户端条目：

{
  "mcpServers": {
    "enigma": {
      "command": "enigma-mcp",
      "args": [],
      "env": {
        "ENIGMA_BUNDLE": "/absolute/path/to/.enigma/bundle.json"
      }
    }
  }
}

MCP 服务器暴露 enigma_init、enigma_remember、enigma_search、enigma_context_pack、enigma_delete 和 enigma_verify_receipts，以及一个 Enigma 护照摘要资源和一条记忆使用提示。提供商原生记忆应仅视为缓存；Enigma 保险库状态保持规范地位。

连接客户端

支持的连接器配置如下：

• claude-desktop

• cursor

• kimi-code

• vscode-cline

• roo

• opencode

• generic-mcp

上面的一键命令路径（enigma setup --client auto --connect-installed --overwrite）已经连接了所有已安装/配置存在的客户端。若要改为连接或预览单个客户端：

enigma connect claude-desktop --dry-run
enigma connect cursor --dry-run
enigma connect kimi-code --dry-run
enigma connect generic-mcp --dry-run

只有当你准备好让 Enigma 将 mcpServers.enigma 条目合并到该特定客户端配置中时，才从 enigma connect <client> 中移除 --dry-run。不带 --connect-installed 或 --write-connectors 的裸 enigma setup 绝不会写入第三方应用配置。

复制粘贴 MCP 片段：

Claude Desktop：

{
  "mcpServers": {
    "enigma": {
      "command": "enigma-mcp",
      "args": [],
      "env": {
        "ENIGMA_BUNDLE": "/absolute/path/to/.enigma/bundle.json"
      }
    }
  }
}

Cursor：

{
  "mcpServers": {
    "enigma": {
      "command": "enigma-mcp",
      "args": [],
      "env": {
        "ENIGMA_BUNDLE": "/absolute/path/to/.enigma/bundle.json"
      }
    }
  }
}

Kimi Code：

{
  "mcpServers": {
    "enigma": {
      "command": "enigma-mcp",
      "args": [],
      "env": {
        "ENIGMA_BUNDLE": "/absolute/path/to/.enigma/bundle.json"
      }
    }
  }
}

通用 MCP：

{
  "mcpServers": {
    "enigma": {
      "command": "enigma-mcp",
      "args": [],
      "env": {
        "ENIGMA_BUNDLE": "/absolute/path/to/.enigma/bundle.json"
      }
    }
  }
}

当 GUI 应用无法找到 shell 安装的二进制文件，或在 Windows 上需要 .cmd 路径时，请使用 --mcp-command（别名 --command）。

浏览器扩展与原生主机

浏览器扩展是位于以下位置的未打包 Manifest V3 脚手架：

apps/browser-extension

本地原生消息主机安装资产位于：

apps/native-host

通过生成浏览器特定的 manifest 来注册主机名 com.enigma.native_host：

enigma native-host manifest --browser chrome --host-path "/absolute/path/to/enigma-native-host" --extension-id "REPLACE_WITH_EXTENSION_ID" --out ./com.enigma.native_host.json

对这些浏览器使用 --browser edge 或 --browser firefox。在 chrome://extensions > 开发者模式 > Enigma > 详细信息中查找未打包的 Chrome ID，在 edge://extensions > 开发者模式 > Enigma > 详细信息中查找 Edge ID，在 about:debugging#/runtime/this-firefox 或从稳定的 browser_specific_settings.gecko.id/已签名附加组件 ID 中查找 Firefox ID。主机路径必须是绝对路径，并指向 enigma-native-host 或在启动前设置 ENIGMA_BUNDLE 的包装脚本。不带 --out 时，生成器会将 manifest JSON 打印到 stdout；带 --out 时，它会写入文件并报告 { ok, path }。将生成的 com.enigma.native_host.json 复制到浏览器/操作系统的原生主机位置，或自行创建文档中描述的 Windows 注册表项。手动模板仍保留在 apps/native-host/manifests/ 中。确切的复制和注册表命令见 apps/native-host/README.md。

原生主机位于本地信任边界之内：保护 manifest、包装脚本、可执行文件和 ENIGMA_BUNDLE 路径免受本地篡改。扩展完全不使用浏览器同步存储（chrome.storage.sync），并且在将 Enigma 上下文插入 ChatGPT、Claude、Kimi、Perplexity 或其他受支持的提供商页面之前，需要用户显式点击。提供商原生记忆仍仅作为缓存；Enigma 收据不证明提供商删除或模型遗忘。参见源码检出中的 apps/browser-extension/README.md、apps/native-host/README.md 和 docs/install-anywhere.md。

桌面脚手架

桌面端是一个位于以下位置的静态本地脚手架：

apps/desktop/src/index.html

直接在浏览器中打开它，或将其打包到桌面 shell 中。它模拟了保险库、MCP、客户端、导入/导出、验证器、删除、mesh 和企业版界面。桌面 UI 状态仅是操作证据；加密证明仍然来自 Enigma 收据和验证器输出。

Relay、gateway、Docker 与企业模式

本地 relay 和 gateway 服务器是 Node HTTP 模块：

• apps/relay/src/server.mjs 存储不透明的加密 relay 记录、签署见证检查点，并处理配对。它会拒绝看起来像明文的记忆字段。

• apps/gateway/src/server.mjs 评估企业策略、输出签名决策，并导出明文最小化的 SIEM 事件。它不会调用模型提供商。

源码或包安装后即可使用直接二进制文件。当本地演示需要在重启后仍然存在时，添加 --state-file <path>：

mkdir -p .enigma/state
enigma-relay demo
enigma-relay serve --host 127.0.0.1 --port 8787 --state-file ./.enigma/state/relay-state.json
enigma-gateway demo
enigma-gateway serve --host 127.0.0.1 --port 8797 --state-file ./.enigma/state/gateway-state.json

相同的行为也可以通过主 CLI 使用：

enigma relay demo
enigma relay serve --host 127.0.0.1 --port 8787 --state-file ./.enigma/state/relay-state.json
enigma gateway demo
enigma gateway serve --host 127.0.0.1 --port 8797 --state-file ./.enigma/state/gateway-state.json

--state-file 是本地演示持久性存储，而非生产数据库。中继状态文件可能包含中继节点/信任元数据、本地演示签名材料、仅哈希或不透明的中继记录、见证检查点、已完成的配对以及授权模式；它们绝不能包含原始内存明文、提示、记录、解密后的胶囊内容、原始请求主体或待处理的挑战。网关状态业务数据仅限于活动策略/最小化策略元数据、策略哈希以及明文最小化的 SIEM/决策证据，但快照也可能包含验证决策所需的本地演示身份和 Ed25519 签名密钥材料；它不得包含原始内存、提示词、补全、记录、提供方响应、嵌入、租户机密、KMS 材料或提供方隐藏状态声明。未知、格式错误或看似明文本的状态会以失败关闭的方式处理，而不是静默重置。

将状态文件置于源代码控制之外，并设置仅所有者可读的文件权限。备份仅对本地演示恢复有用；托管和 BYOC 部署仍需要真正的持久存储、KMS/机密、受监控的备份、恢复演练以及已接受的运营商数据包。

对于源代码签出的 Docker 演示：

cd enigma
docker compose up --build relay gateway

请参阅源代码签出中的 docs/install-anywhere.md 和 docs/deployment-runbook.md，了解具体的本地服务器、Docker、托管和 BYOC 步骤。

企业模式：

• 托管：Enigma 运营商为租户运行中继/网关。需要部署凭据、TLS、生产持久存储、KMS/机密、监控、备份、事件响应和租户策略。

• BYOC：客户在其自己的云或网络中运行中继/网关。客户控制 KMS、网络策略、日志、数据驻留、备份和部署凭据。

两种模式都将提供方原生内存仅作为缓存。Enigma 可以证明其自身的已提交状态和策略决策；但无法证明第三方提供方已擦除隐藏状态或更改了模型权重。

导入与迁移

导入器 API 将来自 ChatGPT、Claude、Mem0、Letta、LangGraph、Zep/Graphiti 以及 Enigma 胶囊的导出内存/上下文规范化为带有源引用、限制、置信度和完整性标志的候选对象。导入保留源注意事项。只有在候选对象通过 Enigma 保险库写入并获得 Enigma 收据后，源导出才成为规范。

迁移 CLI 示例：

enigma import chatgpt --file ./chatgpt-export.json --out ./enigma-import-report.json
enigma capsule export --file ./enigma-import-report.json --out ./enigma-capsule.json
enigma capsule import --file ./enigma-capsule.json --bundle "$HOME/.enigma/bundle.json"

验证命令

可重复的包/演示审计：

npm run release:audit

这是单命令本地发布证据路径；当另一个 Enigma 生产命令需要消费审计 JSON 时，添加 -- --out <file>。Docker 运行时、托管云、npm 发布和实时网站审查仍然是外部/运营商门控检查，而非 release:audit 的先决条件。

本地来源/SBOM 校验和证据：

npm run provenance:local -- --out ./.enigma/release-provenance.json

使用 docs/release-provenance-and-sbom.md 来解释生成的 JSON。审查者可以将记录的 (path, sha256) 条目与重新计算的 SHA-256 值或其他来源文件进行比较。在审查包 tarball 内容时，请单独运行 npm pack --dry-run，并在可选 public_site_manifest 校验和范围内时，在重新运行来源之前构建公共站点工件。来源文件仅是本地未签名校验和证据。

人工审查数据包：

python scripts/build_public_site.py
npm run review:packet -- --out ./.enigma-review-packet --public-site ./_public_site

使用 docs/reviewer-packet.md 检查 REVIEW_PACKET_MANIFEST.json、evidence/release-audit.json、evidence/local-provenance.json、package/npm-pack-dry-run.json、复制的 docs/、可选的 site/ 以及记录的 SHA-256 值。仅对已构建的生成公共站点工件（如 ./_public_site）传递 --public-site；数据包复制本地证据以供审查，并不证明 npm 发布、实时 Cloudflare 部署、Docker 镜像/运行时行为、托管/BYOC 就绪性、法律批准、签名来源或合规状态。

本地冒烟路径：

ENIGMA_DEMO_MEMORY_FILE=/absolute/path/to/tenant-approved-smoke-memory.txt
test -f "$ENIGMA_DEMO_MEMORY_FILE"
enigma init --bundle ./.enigma/bundle.json
enigma remember --bundle ./.enigma/bundle.json --text-file "$ENIGMA_DEMO_MEMORY_FILE" --purpose local_test
enigma export --bundle ./.enigma/bundle.json --out ./.enigma/export.json
enigma verify --export ./.enigma/export.json
enigma boundary run --scenario committed_crossing

MCP JSON-RPC 握手：

printf '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"manual","version":"0"}}}\n{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}\n' | ENIGMA_BUNDLE="$PWD/.enigma/bundle.json" enigma-mcp

连接器演示：

node --input-type=module -e "import { runConnectorDemo } from './packages/connectors/src/index.js'; console.log(JSON.stringify(runConnectorDemo({ clientId: 'generic-mcp' }), null, 2));"

导入器演示：

node --input-type=module -e "import { runImporterDemo } from './packages/importers/src/index.js'; console.log(JSON.stringify(runImporterDemo(), null, 2));"

中继和网关演示：

enigma-relay demo
enigma-gateway demo

中继和网关服务器：

enigma-relay serve --host 127.0.0.1 --port 8787
enigma-gateway serve --host 127.0.0.1 --port 8797

声明边界

Enigma 可以诚实声明：

• 本地 Enigma 保险库包含或不再提供已提交的内存地址。

• 内存创建、检索、上下文打包、更新或墓碑事件产生了可离线验证的收据。

• 边界测试工具将观察到的边界事件分类为已提交、已阻止、超出范围或失败。

• 中继存储了不透明的加密记录或签署了见证检查点，而无需原始内存明文。

• 网关决策遵循了特定 Enigma 企业策略，并具有特定的策略哈希。

Enigma 不能诚实声明：

• 关闭的提供方物理删除了所有内部副本。

• 模型忘记了训练、微调、缓存、遥测或隐藏个性化状态。

• Enigma 在模型输出、隐藏个性化、嵌入、摘要、缓存或 Enigma 状态之外的第三方系统中导致了语义遗忘。

• 导入的提供方内存是完整的，除非源导出明确证明了完整性。

• 签名的内存声明在现实世界中为真；收据证明保管和生命周期，而非事实正确性。

• 代币投资回报率、利润、股权、收入分成、投资回报或代币价格预期。

• 防篡改硬件或原始计算能力优势。

• 没有可测量的存储库证据的基准领先地位。

• 托管云或客户 BYOC 部署是实时的，而无需所需的凭据、域名/TLS、生产持久存储、KMS/机密、监控、备份、事件所有权和 SIEM/日志路由；本地 --state-file 演示状态并非托管/BYOC 就绪。

• 本地审查数据包或本地来源/SBOM 输出是签名来源、注册表证明、git/源代码控制证据、SLSA 级别、合规认证、Docker 镜像摘要/运行时证据、npm 发布、托管/BYOC 就绪或托管/云部署证明。

继续阅读：

• docs/overnight-build-master-plan.md

• docs/release-evidence-2026-06-23.md

• docs/release-provenance-and-sbom.md

• docs/reviewer-packet.md

• SECURITY.md

• docs/security-threat-model.md

• docs/operator-acceptance-packet.md

• docs/cloudflare-token-and-domain-runbook.md

• docs/public-api-reference.md

• docs/install-anywhere.md

• docs/client-connectors.md

• docs/deployment-runbook.md

• docs/production-release-checklist.md