Anima OMP Plugin

OMP 的 Anima 记忆扩展——会话自动采集 + 人格注入 + 记忆工具 + 阶段 Checkpoint 蒸馏。

安装

方式 1：npm 安装（推荐）

omp plugin install anima-omp-plugin

方式 2：本地目录安装

在已复制插件源码的设备上：

omp plugin install C:\路径\到\omp-plugin --scope user

本地目录用于离线安装或验证未发布改动。普通用户使用 npm 安装。不要同时保留 npm 管理插件和 ~/.omp/agent/extensions/anima-memory 手工扩展，避免重复加载。

配置

创建或编辑 ~/.anima/config.json：

{
  "memory": {
    "backendUrl": "https://anima.stardream.group/memory",
    "backendKey": "<管理员发放的个人Key>"
  }
}

backendKey 是个人访问凭据。不要使用管理员 Key，不要把该文件提交到仓库。

安全提示：backendKey 为访问凭据，请妥善保管个人 Key，切勿硬编码或提交至公开仓库。

验证

重启 OMP 或重新加载会话后，调用 anima_health 检查连接状态：

anima_health → 返回数据库状态、Dreams 任务状态

返回内容包含 "integrity": "ok" 即表示连接成功。

核心生命周期与命令

插件在会话生命周期中自动执行以下行为：

• 人格注入 (before_agent_start)：会话启动时加载人格上下文；若人格未初始化且数据库无记录，自动提供初始化引导。
• 会话压缩 Checkpoint (session_compact)：触发会话压缩时，向后端登记 checkpoint 并异步触发记忆蒸馏。
• 会话结束 Checkpoint (session_shutdown)：会话关闭时登记 shutdown checkpoint，触发记忆蒸馏并清理本地会话缓存。
• 主动阶段 Checkpoint (/anima-checkpoint)： 在 OMP 中执行 /anima-checkpoint 命令，可将当前工作阶段显式登记为主题记忆 checkpoint，并在后台异步蒸馏。

工具列表

| 工具 | 说明 | |------|------| | anima_health | 查看系统健康状态与数据库指标 | | anima_search | 搜索 Anima 记忆库 | | anima_save | 保存一条指定类型与叙事的记忆 | | anima_search_knowledge | 搜索共享知识库；普通外网用户会收到 403 | | anima_is_initialized | 检查人格是否已初始化（判断锚点与记忆数） | | anima_init | 首次提交规则与锚点以初始化人格 | | anima_anchor_set | 调整人格锚点分值 |