命令速查

LivingMemory 的命令统一使用 /lmem 前缀。

命令	说明
/lmem status	查看记忆库统计；索引维护进行中或异常时同时显示状态、进度和消息
/lmem search <query> [k]	搜索长期记忆，k 默认为 5
/lmem forget <id>	删除指定记忆
/lmem rebuild-index	重建文档索引
/lmem rebuild-graph	重建并压缩图谱索引，迁移到记忆级图向量
/lmem migrate-scope <target> [apply] [source]	迁移既有记忆（文档、原子、图记忆条目）到指定作用域；默认仅预览，apply 才写入；source 可选，all/*/- 表示全部来源
/lmem webui	查看 WebUI 入口信息
/lmem summarize [message_count]	立即总结当前会话；指定条数时重新总结最近 N 条消息
/lmem reset	重置当前会话记忆上下文
/lmem cleanup [preview|exec]	清理历史消息中的旧记忆注入片段
/lmem help	显示帮助

索引维护状态

启动一致性检查和自动修复在后台运行。使用 /lmem status 观察非空闲状态：

状态	含义	建议操作
checking	正在检查文档、向量、BM25 和图谱一致性	无需操作，插件仍可提供服务
rebuilding	正在分批重建并显示当前进度	保持 Provider 可用，不要重复启动重建
partial	重建完成，但存在允许范围内的失败或最终检查仍发现差异	检查 Provider 限流和日志，必要时重新执行 /lmem rebuild-index
failed	后台维护失败；影子代际未切换时会保留原线上索引	根据状态消息和日志修复环境后重新执行重建
cancelled	插件停止或重载时维护任务被取消	插件下次启动会重新检查；也可在稳定后手动重建

idle 和 ready 不会额外显示维护段落。

常用排查

现象	建议
搜不到刚聊过的内容	先执行 /lmem summarize，确认对话已经写入长期记忆
总结为空或遗漏细节	使用 /lmem summarize 20 重新总结最近 20 条消息，或在详情中对已保留原文重新总结
记忆明显串到其他人格	检查 filtering_settings.use_persona_filtering 是否开启
群聊上下文不完整	检查 session_manager.enable_full_group_capture 是否开启
索引疑似异常	执行 /lmem rebuild-index，图谱异常则执行 /lmem rebuild-graph
更换 Embedding 模型后旧记忆召回异常	等待后台 Provider 指纹检查触发完整向量重建，并用 /lmem status 查看进度
报错显示 faiss-cpu 1.14.2 或核心依赖冲突	AstrBot 4.27.1 与插件要求 faiss-cpu>=1.14.3；更新或修复 Desktop 内置环境和依赖锁，不要让插件覆盖核心依赖
FAISS 报 Illegal instruction	插件会先尝试 generic 指令集模式；仍失败时需要安装与当前 CPU 和 Python 匹配的 FAISS wheel，或更换运行环境
FAISS 报 SuperKMeans 未定义	Python 封装与二进制扩展不匹配；在 AstrBot 实际使用的同一 Python 环境中干净重装兼容版本