本机优先 · 用户持有

加密记忆,
由你自己持有。

由你持有的保险库,保存记忆、私人文件和凭据。从本机开始,再按需连接其他设备与 AI 工具。

Rust CLI Android & iOS MCP

你的本机保险库

个人

  • 记忆笔记与知识卡片
  • 私人文件你保存的文档
  • 凭据单独保护的机密值
密钥留在你手中。
保险库概念示意,非应用截图。

数据保存在自己的设备上

按需选择连接方式

明确授权后再访问

实用的私人数据基础

一套保险库,
多种使用方式。

命令行与移动客户端共用 Rust 核心。可选服务拓展连接方式,数据仍由你持有。

本机保险库与加密

记忆、类型化知识卡片、私人文件与凭据在本机加密保存。可复用模板并添加有序自定义字段;敏感值默认隐藏,验证后才能显示。支持读取、搜索和版本历史;显式标记为私有的内容不进入普通搜索。

自己的数据,自己的设备

命令行与本机守护进程

Rust 命令行 memories 通过本机守护进程工作:Windows 使用命名管道,Linux/macOS 使用 Unix socket,仅限当前操作系统用户。

本机进程间通信

可选远程守护进程

按需通过令牌认证的 HTTP/WebSocket 或中继 RPC 连接。远程访问使用相同的服务协议,仍需经过解锁与提权检查。

连接指南

可选授权中心

授权中心签发设备注册票据和限定范围的授权票据,也可禁止本机自行初始化。使用 --data DIR 时,它还可运行完整的托管保险库,支持远程解锁与成员管理。管理员签发的授权默认只读;成员可申请权限,获批后领取一次授权,审计日志为哈希链。

授权中心指南

移动端与 MCP

Android/iOS 客户端通过 memories_ffi 调用共用的 Rust 服务。本机 MCP 服务与 AI skill 注入,让 AI 工作流访问获授权的普通记忆和卡片,不返回已保存的凭据值。

Android / iOS / MCP

设备配对与保险库传输

通过邀请、指纹核对与批准完成设备配对。加密保险库可经文件或 WebSocket 中继传输;在线传输需明确发起,采用整库传输,并非自动增量同步。

明确建立连接

持续更新的上下文

World(世界):
人格的当下状态。

人格卡片保存身份核心、关联档案和行为事件。World(世界)将场景与日常状态记录为 profile.world 中可持续更新的快照,不混入核心 SKILL 的语气与行为规则。

场景

集中记录当前地点、姿态、装扮和身体状态。所在房间、换上的衣服,或片刻休息,都能成为下一次互动的上下文。

物品

为任意物品记录名称、描述、图片和自由定义的 JSON 属性。杯子、桌子或衣物都能保存需要的细节,不受固定属性模板限制。

日常账本

记录计数、餐食、待办与已完成的指令,以及常设安排。将今日活动与累计记录、跨日保留的状态区分开来。

工具

骰子、转盘和日程支持随机选择与日常安排。这些实用工具与世界状态放在一起,无需写进人格的核心指令。

天气与预报

记录天气状况、温度、湿度、风况及可选的预报。智能体可从外部获取天气后更新快照;World 本身不会自动获取实时天气。

自动化钩子

为日程、随机间隔、Webhook 或物品属性变化设置触发动作。定时钩子由智能体检查,保险库本身不运行后台计时器。

各部分如何协作

以本机为核心,
按需连接。

从本机保险库开始。只有在工作流需要时,才添加中继、远程端点或授权中心。

01 / 你的工具

命令行、手机、AI

桌面 CLI 与 MCP 使用本机守护进程;移动端通过 FFI 使用共用的 Rust 核心。

memories · memories_ffi
02 / 在你的设备上

加密保险库

本机存储、密钥与授权检查。本机守护进程仅服务当前操作系统用户。

从本机开始
03 / 可选连接

拓展你的配置

  • 中继设备间加密传输
  • 远程守护进程令牌认证访问
  • Center注册与 MCP 授权票据

这些是独立的可选服务,不是必须依次经过的链路。无状态的 memories-relay 不存储资产,也不为离线设备排队传输。

从简单的一步开始

创建第一个本机保险库。

需要 Rust 1.88+ 和平台 C 工具链,用于编译随附的 SQLite。以下示例来自仓库 README。

  1. 从源码安装

    克隆仓库,在仓库根目录安装 Rust 命令行程序。

    终端
    git clone https://github.com/mbcc2006/memories.git
    cd memories
    cargo install --path crates/cli --locked
  2. 启动本机守护进程

    在单独的终端中保持运行。使用新的专用数据目录:--home 会限制目录权限,切勿指向已有的通用文件夹。

    终端 A · 保持运行
    memories --home ./memories-demo daemon
  3. 创建、写入、搜索

    在相同目录打开另一个终端。将 VAULT_ID 替换为创建保险库时返回的 ID,并在导入前准备好 notes.md 文件。

    终端 B · 相同目录
    memories --home ./memories-demo init --name laptop
    memories --home ./memories-demo vault create Personal
    memories --home ./memories-demo memory put VAULT_ID \
      --title "Project notes" --input notes.md
    memories --home ./memories-demo memory search VAULT_ID "project"
    memories --home ./memories-demo lock

预编译包

下载发布包。

包托管在 r2.ivjn.us。运行前请先核对 SHA-256。macOS 目前仅提供 Apple 芯片(arm64)版本。

v0.1.7 · 2026 年 10 月 14 日:Windows、Linux 和 Android 基于 7647166 重新构建,包含知识卡片模板与自定义字段、托管内容编辑,以及桌面端 memories file exec 命令,可使用保险库中的配置文件运行程序。Android 另修复了优化构建的启动崩溃,沿用原发布签名,构建号为 8,并提供对应源码补丁。macOS 仍为 v0.1.3。安装前请核对各包的 BUILD-INFO.json 与 SHA-256。

MEMORIES WEB

浏览器里,也能打开你的 Center。

使用已有 Center 授权管理记忆、卡片和文件,无需安装。

打开网页版

Linux x86_64

v0.1.7

GNU/Linux 归档(约 43 MiB):CLI、中继、FFI、文档与示例配置。构建环境为 glibc 2.39、OpenSSL 3。构建提交 7647166。

SHA-256 2a58ab5702e82baa4dc7fcc30a42b4ca01811d3a9312facf5429d444b0f64b7d

Windows x86_64

v0.1.7

Windows zip(约 49 MiB),含托盘程序。构建提交 7647166。

SHA-256 755663b54323bfcf4ba9bef474c10599542372416ac6b50dcc4bd0d3f75fdcad

macOS arm64

v0.1.3

Apple 芯片 zip(约 53 MiB),内含未签名的 Memories.app。

SHA-256 0902ab07e4822a037eb729f3c52186aad41895427d2e360826e1164484031272

Android arm64 / x86_64

v0.1.7

已签名 APK(约 140 MiB),构建号 8:托管中心客户端、扫码配对、设备端到端同步。构建提交 7647166。

SHA-256 74256790a248ea17b0f9ad60aa74be311da7ef77b243023fa8d4490b76a1d24d

使用前了解一下

明确的边界,
实用的解答。

阅读项目文档
哪些内容在本机加密?

记忆、私人文件、凭据与私钥材料在本机存储中加密,密钥留在用户设备上。设备公钥与安全指纹有意保持可见。解锁后,获授权的客户端可以访问权限范围内的内容;本机加密不保护已被攻陷的设备。

中继能看到什么?

保险库设备间同步(/v1/channel)采用端到端加密:中继能看到密文和流量元数据,而非资产明文。远程守护进程的 Relay RPC 则不同:其经认证的 JSON 并非端到端加密,中继运营者或 TLS 终止端可以读取共享监听令牌及请求/响应内容。RPC 应使用可信中继。随附的中继不存储资产或离线队列,但运营者仍可记录流量或阻断连接;设备间同步仍需核对设备指纹。

必须使用中继或授权中心吗?

不需要。本机保险库与守护进程即可开始使用。中继用于设备间在线加密传输,远程守护进程提供令牌认证访问,授权中心签发设备注册与授权票据,或托管保险库。它们各有用途,均为可选。

AI 工具能读取我的凭据吗?

普通 MCP 访问受明确的保险库授权限制,可处理获授权的普通记忆和卡片,但不返回已保存的凭据值或显式标记为私有的内容,也不继承终端提权。另行注册的 mcp serve-unattended 模式则刻意允许按请求返回所选保险库中的凭据明文、私有内容和文件;仅在明确同意后为可信客户端启用。Skill 注入不会改变两种模式的访问边界。

项目目前处于什么阶段?

这是使用 v1 存储格式的开发版,包含可执行代码与安全回归测试,尚未经过独立的密码学审查或应用安全审计。具体保证与当前限制请参阅卡片类型与字段和安全说明。

从自己的数据开始

给自己的记忆留个位置。

了解源码,阅读指南,试用本机保险库。

打开使用文档