记忆与学习
怎样开启长期记忆？
在 WebUI 的长期记忆设置中启用 A_Memorix，并配置可用的 embedding 模型。配置文件中的总开关是 [a_memorix.plugin] 下的 enabled。
如果还要使用图片记忆（以图搜图、相似图召回），需要额外配置图片嵌入模型任务 [model_task_config.image_embedding]；只配文本 embedding 时图片仍会保存，但不可检索。
详细配置见A_Memorix 配置。
为什么提示“关系向量未启用”？
普通记忆向量和关系向量是不同能力。关系向量当前可以使用，但默认关闭；看到这条提示不表示整个长期记忆系统失效。
关系向量由 a_memorix.retrieval.relation_vectorization 下的启用、回填和导入写入设置控制。开启前应确保 embedding 服务稳定，并了解历史数据回填会产生额外请求。
关系向量关闭后，为什么仍然有 embedding 请求？
embedding 还用于段落、实体和长期记忆检索。关闭关系向量只是不为关系数据写入或查询向量，不会关闭整个记忆向量系统。
embedding 模型可以不配置吗？
如果启用了长期记忆、知识导入或依赖向量检索的功能，就需要配置 embedding 模型。完全不使用这些功能时可以不配置，但相关能力将不可用或在调用时报告错误。
图片记忆需要额外配模型吗？
需要，而且是独立的模型任务。文本 embedding（embedding）和图片 embedding（image_embedding）不能互相替代：只配文本 embedding 时，图片仍会入库并保存认知，但检索状态会显示模型不可用。
为什么提示“图片嵌入模型不可用”？
依次检查：
[model_task_config.image_embedding]的model_list是否真的填了模型（留空不会回退到文本 embedding）- 该模型是否支持“图片输入到向量”的协议，而不是只支持文本
- 服务商地址是否使用 HTTPS，Key 是否有效
- 到「长期记忆 → 图片记忆 → 任务诊断」查看最后错误与重试次数
模型不可用时系统会按 [a_memorix.image_memory].probe_retry_seconds 定期重试，不会静默改用别的模型。
相似图召回到的是同一张图片吗？
不一定。返回结果会区分精确同图（内容哈希一致）和视觉相似（向量空间接近）。相似度只说明视觉接近，不能据此认定两张照片是同一对象；把候选图和它关联的讨论一起交给模型判断，才是正确用法。
图片记忆会跨群串数据吗？
图片检索和文本检索共用同一套聊天流作用域解析：默认只检索当前聊天流，开启全局共享后按全局规则，配置了共享组时组内互通。未共享的聊天流查询不到彼此图片，这与文本记忆的边界一致。
表情包会被记住吗？
默认不会。图片记忆处理的是消息里的普通静态图片组件，表情包有独立的识别与发送逻辑，不纳入自动入库范围。
记忆为什么会把人物或主客体记反？
先在记忆管理中查看来源消息，确认原始表达是否存在歧义，再检查抽取或写回时使用的模型日志。如果来源明确而抽取结果错误，可以更换记忆任务使用的模型，并通过反馈纠错或删除后重新写入。
不要仅依据单次错误认定某个型号始终不可用；模型版本和服务商实现都可能变化。
黑话需要出现多少次才会学习？
学习不是达到固定次数后必然成功。样本数量、上下文是否一致、表达是否稳定以及学习模型都会影响结果。出现次数太少时通常无法可靠推测含义；随着一致样本增加，结果才可能逐渐稳定。
学习结果不正确时，可以在 WebUI 中检查和修改，不建议在文档中承诺固定次数或百分之百准确。
怎样让多个群共享表达或黑话？
使用表达或黑话互通组，把需要共享的聊天流放入同一组。互通组的 platform 和 item_id 可以用 "*" 通配，完整字段见Bot 配置。用全局通配前先确认你真的想让所有群共享学习结果。
注意这只是互通组的写法。控制「哪个群学、哪个群用」的 learning_list 从 1.3.4 起不再支持 "*"，留空就是默认规则。