跨会话长期记忆

长期记忆保存调用者的资料、表达偏好、稳定事实和长期关注，供后续会话使用。数据按工作空间和调用者身份隔离，不同空间、IM 用户或嵌入访客分别维护个人记忆。

开启长期记忆

模式	行为
`explicit_only`	只记录明确要求记住的内容，不运行后台 LLM 蒸馏
`auto`	额外在后台从对话提取，按延迟和最短间隔合并处理

智能体的 memory_enabled=false 可单独禁用记忆读写，省略则继承空间设置。IM/Embed 使用所绑定智能体的记忆偏好；API Key 必须 full-access 才能使用个人记忆管理接口。功能受空间、个人和当前请求的开关共同约束。

操作	用途
新增 / 编辑	直接维护个人资料、偏好、事实、事项或兴趣；手工编辑不再由后台抽取覆盖
确认待确认项	推断条目从 pending 变为可用；未确认不会注入提示词
拒绝 / 删除	撤销错误或不再需要的记忆，拒绝留下抑制记录，减少重复提取
主题提升	把反复讨论的主题立即变为长期关注，也可停止跟踪主题
文档偏好	查看反复引用的文档，移除不再需要的个性化检索偏好
立即整理	合并近义条目、归档到期事项，不必等待后台整理
导出 / 清空	下载自己的 JSON 记忆，或清空自己的记忆数据

记忆条目分为资料、偏好、事实、事项和兴趣。同一主题的新事实可替代旧事实。关闭个人开关会暂停使用，删除或清空会移除数据。接口中的类别与状态值见记忆 API。

系统将资料、偏好和兴趣作为受长度限制的常驻上下文，按当前问题召回相关事实和事项。智能推理还可主动搜索记忆与历史对话。记忆仅影响问题理解和资料选择，不扩展知识库访问权限。

开启检索个性化后，系统用主题帮助理解问题，并用反复引用的文档辅助排序。对话时间线会显示记忆相关步骤。后台任务通过游标及待处理会话记录续接，避免短时间连续发问导致提取遗漏。

现象	检查
没有使用记忆	空间开关、个人开关、智能体开关，确认是否换了空间或身份
自动提取未出现	write_mode、抽取延迟/最短间隔、模型连接与后台任务
推断未影响回答	是否仍为 pending；确认后才会使用
不再希望引用某文档	在文档偏好中移除；知识库权限仍独立控制
立即整理未合并任何条目	查看返回的 skipped 原因，可能条目过少或无候选

空间管理员可通过设置页维护记忆开关、提取模式和模型。配置保存在 memory_config，通过 GET/PUT /tenants/kv/memory-config 读取和更新，完整字段见记忆 API。

字段	说明
`enabled`	空间开关，默认 false
`write_mode`	`explicit_only` / `auto`
`extract_model_id`	抽取模型，空值沿用对话模型
`extract_delay_seconds`	回答完成后延迟提取，合并短时间内的多轮消息
`extract_min_interval_seconds`	同一人的提取最短间隔，控制调用频率
`extract_instructions`	空间自己的提取规则
`max_items`	每个身份的活跃记忆上限，0 使用默认 200
`interest_threshold`	主题重复出现后形成关注的门槛，默认 3
`embedding_model_id` / `vector_recall`	选择记忆召回的向量模型并开启语义召回；无模型时用词法匹配
`retrieval_conditioning`	允许记忆影响问题理解和文档排序

提取模型用于后台归纳，向量模型用于匹配当前问题。记忆功能会增加对应的模型调用；模型被记忆配置引用时，删除模型会显示依赖详情。