快速开始

部署 → 写入 → 检索。MemX 目前处于早期试点，未发布到公共包仓库；部署包与源码随交付提供。

前置条件

Docker Engine 与 Docker Compose v2。使用随交付提供的离线镜像包时不需要外网，也不需要 Rust 工具链。

1. 准备配置

   在交付的源码根目录执行：

   cp deploy/customer/.env.customer.example deploy/customer/.env
   openssl rand -hex 32   # 生成一个密钥，填入 .env 的 MEMORUS_API_KEY=

   服务在非本机地址上启动时必须配置 API 密钥，否则拒绝启动。

2. 加载镜像并启动

   sha256sum -c SHA256SUMS                       # 校验离线镜像包
   docker load -i memorus-image-<version>.tar    # 记下输出的镜像标签，填入 .env 的 MEMORUS_IMAGE=
   docker compose -f deploy/customer/docker-compose.customer.yml \
     --env-file deploy/customer/.env up -d
   curl -i http://localhost:8880/health

   没有离线镜像包时，可以从源码构建，步骤见交付包内的 deploy/customer/INSTALL.md。

3. 写入与检索

命令行常用子命令

memorus-r status                      # 知识库统计
memorus-r search "查询"               # 检索
memorus-r learn "一条经验"            # 手动写入
memorus-r list --limit 20             # 列出记忆
memorus-r forget <memory-id>          # 删除
memorus-r sweep                       # 触发衰减清理
memorus-r conflicts                   # 查看互相矛盾的记忆
memorus-r verify --stale-only         # 核对带锚点的记忆
memorus-r export --format json -o knowledge.json
memorus-r import -i knowledge.json

注意

• 零配置默认使用确定性的哈希向量，不是真实的语义嵌入；要做语义检索，需要配置嵌入服务。
• 目前经服务接口写入的记忆还没有来源记录。

下一步

下一步

核心概念 — 抽取、去重、衰减、检索架构设计 — 写入与检索的数据流常见问题