产品
面向 AI 智能体的持久本地连续性。
开源、本地优先、不绑定模型与服务商。15 个 Rust crate、签名发布，以及刻意保持精简的 MCP 表面——存储在你的机器上，无需第三方即可验证。
curl -fsSL "https://www.whitemagic.dev/install.sh?ref=product-a" | sh
无需 sudo · 纯用户空间执行 · 2–4 秒 · 兼容 glibc 与 musl
v9.2.1 · 发布于 2026年9月20日 · 15 个 crate · npm · Docker · MCP 注册表 · MIT
无需注册账户 · 记忆与会话保留在你的机器上 · 默认无设备外使用遥测
上手路径
安装 → 就绪探测 → 接入 → 工作 → 接续。
五步，按人们实际使用的顺序。
- 01
安装
curl -fsSL "https://www.whitemagic.dev/install.sh?ref=product-step" | shLinux x86-64 一行命令（支持脚本安装）。macOS 与 Windows 二进制已发布，尚未提供安装脚本。
- 02
就绪探测
wm grimoire检查主机、验证记忆层、证明重启连续性，并报告五项独立的就绪事实，而不是一枚绿灯。加上 --write（或运行 wm connect --write）即可真正改写检测到的客户端配置。
- 03
接入
wm serve让符合标准的 MCP 客户端指向本地服务——wm connect 接入检测到的客户端；wm setup <client> 写入单个配置。
- 04
工作
照常使用你的智能体。记忆、会话与检查点会随用随写到本地；治理与溯源在调度接缝处运行，而不是作为提示词。
- 05
接续
"where did we leave off?"在新的会话里——或崩溃、升级、更换模型之后——检查点连同它的理由与来源一起从本地存储中回来。
为什么是连续性
上下文窗口会重置，工作不会。
WhiteMagic 赋予 AI 智能体持久的本地记忆与会话连续性，以及治理、溯源与保存能力——全部运行在你自己的硬件之上，由你明确设定的策略治理，无需第三方即可审计。基于 MIT 协议开源，由超过 4,777 项公开测试验证，并以签名发布公开发布。
像平常一样对话即可。你的智能体在后台通过 MCP 调用 WhiteMagic。连续性无损：会话回放逐字节精确并排除隐私记录；选择加入的冷层发现无需解冻即可触达归档记忆。
实际差别在于：能够找回一个决定及其理由与来源的智能体，不需要把整段历史再解释一遍。上下文成本因此下降——承载状态的是记忆，而不是对话记录。
数据存放在哪里
你的磁盘，你的规则。
存储位于你的主目录下（初始化后不足 1MB——2026-09-15 实测；LMDB 映射是稀疏的）。记忆、提示词与会话内容不会传出设备，默认也不发送任何设备外使用遥测。本地诊断遥测可能记录在设备上用于自我观察；唯一的共享路径是可选的安装漏斗报告，默认关闭、需明确选择加入（`wm telemetry enable --share` 会先展示完整载荷；标识符可用 reset-id 轮换）。版本更新检查仅在执行时访问 GitHub，离线亦可用。 本地存储默认不加密；删除一个存储目录不会移除备份、导出、副本或其他项目存储——请先清点这些副本。
备份并导出星系，可在任何地方恢复；恢复后的存储会先重新验证，再被信任。
支持的客户端
为符合标准的 MCP 客户端而设计。
服务端在本机运行；这份客户端列表是文档列表，不是集成矩阵。每个名称都链接到指南中对应的设置条目。
MCP 表面
一个元路由，九个生命周期工具。
不绑定模型、IDE 或服务商——记忆存放在你的磁盘上，切换智能体也不会丢失历史。
注册路由并不都是公开表面：已编写能力逐层压缩为精选路由、tools/list 生命周期入口，最终收敛为一个自适应 wm 元路由（PRAY）。
tools/list: wm · memory.create · memory.search · memory.read · memory.list · memory.hybrid_recall · session.record · session.continuity · session.start
自行验证
你准备好时它就绪——而不是我们说了算。
就绪状态，不靠单一绿灯
wm grimoire 报告五个独立事实，而不是一个布尔值：记忆层就绪、智能体已接入、连续性已验证、语义召回可用、完全激活。“记忆层可用”与“你已连上它”是不同的结论，因此分开呈现。
发布渠道与支持
开放 alpha——是一个渠道，不是里程碑。
版本号是兼容性信号；发布渠道是证据主张。WhiteMagic v9.2.1 以 开放 alpha 渠道发布——beta 与 stable 由各自的退出条件赢得，绝不会因为版本号上涨而自动获得。
- 当前次版本
- 安全与缺陷修复，作用于安装脚本支持的 Linux x86-64 线。
- 上一个次版本
- 安全修复。
- 更早的次版本
- 归档——不再修复。macOS 与 Windows 二进制在每个版本中都会发布，但不提供安装脚本，也不在支持范围内。
完整支持策略：SECURITY.md
备份与卸载
离开与留下同样受支持。
备份 / 导出——星系可导出为可移植的工件，也可导入；恢复后的存储会先重新验证，再被信任。密封（HMAC-SHA256 清单）可以对照存储之外的快照重新校验。
卸载——移除二进制与存储目录。删除已配置的存储不会移除备份、导出、副本或其他项目存储，也不等于安全擦除；请先清点这些副本。
v9.2.1 — 变更摘要
网格权限、可选遥测与静态加密地基
- —基准测试发现的入库修复：代码密集型内容（HTML/jQuery、十六进制颜色列表、带格式的代码片段）重新被接纳；memory.batch_create 会跳过并报告问题条目，而不是作废整批。
- —备份完整性：envelope.json 纳入备份的 SHA256 清单，恢复时会检测到对备份标签的篡改，而不是把它显示出来。
- —静态记录封存（默认关闭）：设置 WM_AT_REST_MODE=keyfile|passphrase 后，记录正文用星系密钥封存；wm at-rest migrate 以崩溃安全的账本迁移旧库；wm doctor 只披露计数、不解密密钥；off 模式保持字节不变。在后续切片完成前不宣称加密擦除。
- —搜索不再因错误的 limit 而崩溃：limit 0 过去会直达索引引擎并使服务进程 panic；现在在工具边界校验（schema 中 minimum 为 1），引擎内也有防护。
- —会话记录契约：越界的 importance 会被拒绝而非静默截断；turn_type 必须是文档列出的取值；空白内容被拒绝；CLI 拒绝 NaN 或越界的 importance。
- —检索真值与成本：BM25 排序的搜索现在披露 recall_mode 为 bm25；重排池与候选宽度解耦（实测：小池 R@1 58.0，嵌入成本约为五分之一）；BM25 加权的搜索完全跳过查询嵌入。
- —治理与首次运行体验：命令护栏不再因交接文本字段要求确认（箭头和数值比较不是命令）；网格密钥与只读索引警告只在需要行动时出现；wm contract --check 会打印成功行。
- —安装与发布：安装脚本新增经校验和验证的 macOS 目标（arm64/x86_64），Windows 仍被拒绝；每次打标签前，站点指南中的命令都会对着发布二进制核验。
- —边界与威胁模型：机器校验的派发边界矩阵（direct/wrapper/NLU/autonomous/federated × 权限/效应门）与机密性/注入威胁模型已记录。