@fslong520/1memory-cli

1memory 记忆 CLI（Rust 二进制分发）——跨设备跨软件统一 AI 记忆系统，端到端加密，服务器只见密文。

安装

npm i -g @fslong520/1memory-cli
1memory doctor        # 首次自动安装 BGE 模型
1memory --help

安装即得 1memory 命令：npm/pnpm 按平台自动装对应二进制子包。也可用 pnpm add -g @fslong520/1memory-cli。BGE 模型由 1memory doctor 自动安装（国内可先设 ONEMEMORY_MIRROR=https://hf-mirror.com）。

纯离线：1memory keygen --pass <密码>。要连服务器并自动同步：必须 CLI 登录——

1memory register --addr <url> --user U --pass P --super <超级密码>
1memory login --addr <url> --user U --pass P --super <超级密码> [--secret-key A3-…]
1memory sync

ONEMEMORY_MODEL_DIR 自定义模型目录后，后续 remember 必须设为同一路径。

客户端引入

1memory 桌面客户端安装/首次启动时，经本包装 CLI 到用户电脑：

npx @fslong520/1memory-cli --version

客户端「账号与同步」页可检测并一键安装。

命令面（纯记忆核心）

register / login / keygen / remember / recall / list / show / forget / attach / promote / demote / tree / retitle / import / defrag / reembed / sync / status / inject

CLI 可以登录：1memory register / 1memory login 写 session.json（addr/token），之后 sync 和写后自动同步才能连服务器。纯离线用 keygen。注入：1memory inject --id codex|pi|…。

语义检索模型（BGE）

CLI 语义检索用 bge-base-zh-v1.5（约 407MB ONNX，本地推理零网络）。必要文件只有 tokenizer.json 与 onnx/model.onnx。查找序：

1. ONEMEMORY_MODEL_DIR（一旦设置即独占，缺失不回退）
2. CLI 同目录 models/bge-base-zh-v1.5/（桌面随包）
3. 跨平台用户数据目录（Linux ~/.local/share/yishi/…，Windows %LOCALAPPDATA%\yishi\…）
4. 旧目录 ~/.local/share/yishi/models/bge-base-zh-v1.5/
5. /usr/lib/1memory/models/bge-base-zh-v1.5/（deb 随包位）

来源：Hugging Face Xenova/bge-base-zh-v1.5（revision 71e50dc531959f9e04ebf190ea25b00261a0a186）。模型安装由 doctor 兜底：缺模型时跑 1memory doctor 自动下载安装；不会在 remember 时自动下载。

1memory doctor
# 国内镜像（只替换下载 host）：先设环境变量
#   ONEMEMORY_MIRROR=https://hf-mirror.com
# 自定义目录后，remember/recall/doctor 必须：
#   ONEMEMORY_MODEL_DIR=<同一目录>

无模型时 remember/recall 失败并提示跑 1memory doctor，不落记忆、不降级为空向量。

仓库

https://github.com/one-memory/1memory