SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI智能体whitemagic

whitemagic

WhiteMagic 是一个面向 AI 编程智能体的本地优先（local-first）记忆与会话连续性层，通过 MCP 协议为智能体提供持久化项目记忆。它可以记录重要上下文、在重启后检索，并把有用的决策带入下一次会话，而无需将记忆存储上传到任何托管服务。项目使用 Rust 编写，采用 MIT 许可证，默认不收集遥测数据。它支持通过签名的连续性回执（continuity receipts）实现可验证的交接，并提供哈希链审计账本以及跨设备备份、导出与导入能力。

访问官网

工具介绍

WhiteMagic 是一个面向 MCP 智能体的本地优先记忆层，主要服务于 AI 编程智能体。它让智能体拥有持久的项目记忆：记录重要上下文、在重启后找回这些内容，并把有用的决策延续到下一次会话，同时不把记忆存储发送到任何托管服务。

用途

WhiteMagic 解决的是 AI 智能体在跨会话工作时缺乏持久记忆的问题。它通过 MCP（Model Context Protocol）为智能体提供记忆的创建、检索与会话连续性能力，并强调本地优先、受治理（governed）的单用户运行模式。

主要能力

  • 持久记忆：记录重要上下文，重启后可检索，支持无需外部模型的记忆创建与词法搜索。
  • 会话连续性：支持会话记录（session record）、回放（replay）以及跨会话连续性。
  • 可验证交接：通过签名的连续性回执（continuity receipts）实现可验证的任务交接。
  • 审计与治理：提供哈希链审计账本，以及 Landlock 隔离与 firebreak 防护。
  • 备份与迁移：支持跨设备的备份、导出与导入；Gen3 版本没有 backup/restore 子命令，需在服务器未运行时备份整个存储目录。
  • 自检与诊断：提供 wm selftest 端到端安装不变量检查与主机健康诊断。
  • 隐私：默认无遥测，不要求使用 WhiteMagic 云服务；隐私标志用于将记忆排除在响应与推理之外，属于访问控制而非加密。

使用方式

安装：从最新 release 下载二进制及其校验和，或使用安装脚本（自动解析最新版本、选择对应平台产物并校验校验和）。支持的安装路径包括 Linux x86-64、Linux arm64、macOS arm64 和 Windows x86_64。Linux 构建为动态链接（glibc 2.39+）。

验证安装：

  • wm grimoire 验证环境并预览客户端接线，加 --write 可写入检测到的 MCP 客户端配置，--json 输出机器可读报告。
  • wm selftest 运行完整不变量检查（临时存储加主机健康）。

连接 MCP 客户端：将任意 MCP 客户端指向该服务器，服务器通过 stdio 通信。提供两种配置档：

  • cyberbrain（默认）：12 个精简 MCP 工具，包括 memory_recall、memory_remember、memory_get、memory_stats、wm 元工具（通过 route= 显式分发到目录）、session_checkpoint、session_continuity、session_record、session_list、galaxy_list、galaxy_fork、mesh_sync。
  • full：40 条精选路由，覆盖记忆 CRUD、搜索、会话、回执、galaxies、mandala、gnosis、sangha 和 mesh；可选功能在编译时加入受门控路由（decision.shortlist、decision.deliberate、decision.outcome、systemone.decide）。默认构建通过 wm contract --json 报告 43 条路由。

显式路由示例：

  • wm(route="memory.create", args={...})
  • wm(route="session.start", args={...})
  • wm(route="galaxy.list", args={})

数据存储：存储位于本地 ~/.local/share/whitemagic/gen3，可用 --store <path> 或 WM_STORE 覆盖。

从源码构建：需要 Rust 1.85+。

从 v26 / Gen2（LMDB 存储）迁移：使用 wm quarantine <file> 审查迁移隔离日志，WM_STORE / --store 覆盖可选择目标位置。

托管服务（与本地包分离）

  • 远程 MCP：https://mcp.whitemagic.dev/mcp（streamable-http），对精选公共语料提供只读召回；支持无密钥发现；评估密钥公布每日 50 次召回额度；OAuth 2.1；x402 会话租约公布为 5 分钟 $0.01 或 24 小时 $0.50，公布 10,000 RPM 限制；memory.search_batch 支持单次 MCP 调用最多 10 个查询。本地存储不会上传到该只读召回通道。
  • 回执验证与智能体信任 API：https://api.whitemagic.dev，无状态 POST /verify 用于连续性回执包（/health 和 /info 无需密钥），另有面向 Base 的 /erc8004/validate 适配器。
  • Memory Crystal 客户端与 API：scripts/crystal_client.py 在本地用 AES-256-GCM 或 ChaCha20-Poly1305 封装与打开 crystal 信封（需安装可选依赖 python3 -m pip install cryptography）。该辅助脚本以源码形式分发，不打包进 wm 二进制或平台安装器。生成客户端密钥：python3 scripts/crystal_client.py genkey --out crystal.key，再通过 --key 传入该文件进行 seal 与 unseal。seal 从已认证的 /crystals/owner-locator 端点获取所有者定位符，需要所有者凭据和已有注册表映射；支付或会话通行证不构成所有权。凭据通过 WM_CRYSTAL_TOKEN 环境变量或 --token-file /path/to/credential 提供；令牌文件必须是常规非符号链接文件，权限为 0600 或更严格。seal、push、pull 和 lineage 需要已认证的所有者访问权限；seal、pull 和 lineage 不再接受 --tenant；无密钥 pull 和 lineage 查询不再支持。

适用场景

  • AI 编程智能体需要跨会话保留项目上下文与决策。
  • 需要在本地、单用户、受治理环境下运行记忆层，且不希望数据离开本机。
  • 需要可验证的任务交接与审计记录。
  • 需要在多设备间备份、导出与导入记忆存储。

限制

  • 当前发布通道为 open alpha（wm 10.4.0 线），版本号是兼容性信号，通道是证据声明。
  • 支持窗口：安装门控线（Linux x86-64、Linux arm64、macOS arm64、Windows x86_64）的当前次版本与上一个次版本接收修复，更早的次版本为归档状态。
  • 隐私标志是访问控制而非加密；能读取存储文件的人即可读取内容，不应在记忆中存储凭据。
  • 对话捕获通过显式工具调用发生，不会自动进行。
  • Gen3 wm 没有 backup / restore 子命令；事务回滚（mandala/session 内部）是短期撤销，不能替代备份。
  • 代码库中存在超出产品边界的研究系统（自主循环、梦境整合、双院制推理、想象引擎、自对弈训练循环、多语言 sidecar、签名多智能体 mesh、全息记忆坐标等），这些研究面没有产品验收证据，可能变更或移除。
  • 托管服务的持久化与检索成功并不由本地加密支持所暗示。
  • 部分事实（如具体价格、平台支持细节等）以官方发布为准，本介绍未提供的内容暂未提供。

同类工具

查看分类