长期记忆

MEMORY.md 是前台上下文模型中的长期记忆层：用于理解用户和回答问题的长期事实与决定，不具有行为权威。完整的四层模型、指令冲突顺序，以及人设层（ASSISTANT.md / USER.md）见助手画像与用户偏好。

MEMORY.md 使用普通 Markdown 保存关于用户的长期事实与决定，例如所在地、习惯、兴趣、关系、项目、目标和计划。它只帮助理解和回答，不直接支配行为。内容来源有两种：

明确要求：对话中说“记住、改成、不再”等，助手会生成精确 Markdown 修改；一句话中的多项信息会在同一轮逐项处理，并只生成一次最终回应。
自动整理：会话结束后，一个轻量文本模型会查漏补缺，把用户明确提出的长期交互指令写入 USER.md，把稳定事实与决定写入 MEMORY.md。自动整理默认使用 DashScope 的 qwen-flash 模型（复用 DASHSCOPE_API_KEY）；没有可用 API Key 时自动关闭，明确要求的记忆不受影响。设置 QWEN_AUDIO_MEMORY_AUTO=off 可全局关闭；QWEN_AUDIO_MEMORY_MODEL、QWEN_AUDIO_MEMORY_BASE_URL、 QWEN_AUDIO_MEMORY_API_KEY 可指向任意 OpenAI 兼容端点（含本地 Ollama）。

Realtime 与自动整理都通过同一个记忆服务提交受限 Markdown 变更，不能直接写文件。自动整理可以补记用户明确说出的称呼或回复偏好，但不会推测这些设定，也永远不能修改 ASSISTANT.md。密码、密钥等敏感内容会被双重过滤拦截。memory-audit.jsonl 只记录补丁是否执行、版本和错误等诊断信息，不保存完整记忆正文。觉得内容不对，直接在对话中说“那条记错了” 或“忘掉它”即可；助手会修改或删除对应 Markdown 原文。

前台只暴露一个 memory 工具，每次调用执行一个原子操作：read 读取文档， append 追加 Markdown，replace 用文档中唯一匹配的 old_text 替换或删除内容。一句话包含多项持久修改时，Realtime 可在同一轮逐项调用，Gateway 只生成一次后续回应。写入前会重新读取最新文档，精确替换找不到或匹配多处时安全失败。

会话摘要与回溯（默认关闭）

设 QWEN_AUDIO_SESSION_DIGEST=on 后，会话结束时记下这一场的话题与一句不超过 50 字的要点，保留 90 天，供 recall 工具回答「前几天我们聊的那个」。

摘要不注入 instructions：它每场都在变，注入会让 prompt 前缀每场都变、前缀缓存失效。所以它是一个按需调用的工具，而不是上下文的一部分。

recall 只回答「以前聊过什么、派过什么活」。用户自己的资料走 knowledge 工具（见知识检索 Provider）。

摘要里只冻结派过的活的目标，不存状态：状态是活的，存进摘要过几天那个值就是错的且不会报错。状态一律在检索时从任务台账实时读；台账终态只保留 3 天，更早的活查不到记录，此时只回答「派过这件事」而不给状态。

替换记忆 Provider

内置的 USER.md 和 MEMORY.md 是默认实现，不是 Gateway 的固定存储依赖。宿主应用可以从公开入口实现版本化的 MemoryProvider，并在 Composition Root 注入：

import { MEMORY_PROVIDER_PROTOCOL_VERSION } from 'qwen-audio-agent/memory-provider'
import { createGatewayApplication } from 'qwen-audio-agent/gateway-application'

const memoryProvider = {
  describe: () => ({
    protocolVersion: MEMORY_PROVIDER_PROTOCOL_VERSION,
    key: 'company-memory',
    label: 'Company Memory',
  }),
  list(ownerId, options) {
    return []
  },
  async apply(ownerId, changes, context) {
    return { changed: 0, documents: [] }
  },
  health: () => ({ ok: true }),
  async close() {},
}

const gateway = createGatewayApplication({ memoryProvider })

list() 必须返回同步、有界的 Realtime 上下文快照；远程 Provider 应在 Adapter 内维护本地缓存。apply() 可以异步，context 中的来源、Session、Turn 和 Trace 由 Gateway 提供，不属于模型可控的修改内容。Provider 返回的文档会统一限制长度、规范 scope，并丢弃重复或无效文档。

Realtime、自动整理器和工具处理器只依赖 FrontendMemoryRuntime，不会访问供应商 SDK、数据库或 Markdown 文件。未注入 Provider 时继续使用现有 Markdown 实现，现有配置和数据无需迁移。第三方 Adapter 自行负责远程认证、租户映射、缓存刷新和底层记录到 user、 memory 两种公开文档语义的转换。

日志

日志采用 JSON Lines 格式，API Key、Token、Authorization、Cookie、密码和 Secret 字段会在写入前脱敏，默认不记录麦克风音频、用户转写正文、模型回复正文或任务结果。桌面版可在“设置 → 应用 → 日志”中打开日志目录。详见配置说明。

长期记忆 ​

会话摘要与回溯（默认关闭） ​

替换记忆 Provider ​

日志 ​

长期记忆

会话摘要与回溯（默认关闭）

替换记忆 Provider

日志