梦境记忆 Kerberos255/dsh-memory-dreaming

Dream 与长期记忆

使用 DSH 原生 Session Query 整理同一工作区、Agent 预设中的真实用户消息。每日记忆写入 memory/YYYY-MM-DD.md，Dream 写入 DREAMS.md，每周复查写入 memory/reviews/YYYY-MM-DD.md。确认后的稳定事实加入 MEMORY.md；人工维护的其他段落保留。

设置入口：设置 → 插件 → Dream 与长期记忆。配置在 DSH 数据目录旁的 plugins/dsh-memory-dreaming/config.json，正常只需保存。整理模型通过单个下拉框选择官方已配置的模型，提供方与模型 ID 一起保存；留空使用官方默认模型。

自动任务与自动晋升默认关闭；用户可手动整理、查看候选及原始消息出处、确认晋升或遗忘。自动晋升还要求可信度、多个独立观察、有效来源、无冲突及未过期。同一消息重复整理不会增加观察次数。候选不会自动拼进系统提示词；只有已发布的 Markdown 和明确记忆检索参与上下文。

普通会话调用 memory_dream 只读取自身原文并生成待审候选，不能借此读取其他私聊或写入共享记忆文件。工作区级归档由已认证的设置页操作或插件创建的自动任务执行。工作区文件及已发布长期记忆是该工作区的共享内容；需要多个独立用户环境时应配置各自工作区与预设。

自动任务复用官方 Schedule，不另建定时器。执行账本区分投递、运行、等待提问或审批、完成、失败、取消；仅收到任务不算成功。停用设置或卸载插件会收尾任务。卸载清除自己创建的 Schedule；重新加载时按照配置恢复三个任务，原生任务 ID 可能更新，既有运行记录保留。

自动模板先保存创建/修改/删除意图，再调用原生 Schedule；重新加载按持久标记认领既有任务，原生任务的外部修改和删除会提示核对。重复投递按工作区、预设、任务类型和计划时间去重，日期与时区在投递时封存。原生问答仍待回答时恢复等待状态，已被原生接纳的回答可以在下一轮继续同一任务；冷启动不会代替用户批准操作。只有原生轮次成功结束、关联记忆作业完成且产物校验通过，才记为完成。

设置页“自动任务与执行记录 → 核对自动任务记录”可检查模板和原生轮次。移除本插件拥有的任务前，保存原生保留历史中最多 200 条投递摘要；摘要缺失或超出窗口会说明，摘要本身不证明执行成功。中断作业保留已提交产物，用户审阅后可手动整理。

数据放在 DSH_HOME/memory-dreaming/state.sqlite。写入前记录提交意图，再交换文件并更新候选；进程退出后会核对文件和数据库，保留已提交产物，不自动重跑模型。外部修改会显示在本页“记忆写入恢复”，可查看写入前、预期内容与当前文件，再重新核对或明确放弃尚未提交的操作。同一工作区/预设的整理和记忆文件发布使用 SQLite 租约，进程退出后由系统释放。

词语检索默认可用；可选由其他插件注册 EmbeddingProvider 或 VectorStore，默认向量存储为同库 SQLite。Embedding 下拉框列出实际注册的向量模型，独立于聊天模型目录；没有向量提供方时保留词语检索选项。未注册提供方、异常和超时会回退到词语检索；更换提供方版本或模型后可重建。遗忘在同一事务中删除本地向量；外部存储清理进入持久队列，提供方重新注册或点击“重试向量清理”后继续，失败期间事实已被排除。索引途中遗忘会阻止迟到写入重新加入事实。提供方接口通过服务的 registerEmbeddingProvider(name,{version,models:[{id,name}],embed({texts,model,signal})}) 和 registerVectorStore(name,{get,upsert,list,remove,prune}) 注册，返回注销函数；模型目录也可使用异步 listModels(signal)，模型项为 ID 字符串或 {id,name}。异步实现应响应 signal 并支持重复删除，向量不作为事实真源。

首次安装或升级代码需要完整退出、重新打开客户端。兼容官方桌面 0.2.0-rc.2、开发 SDK 0.2.1-alpha.1。本插件独立实现，参考 OpenClaw 的差量整理、来源核验、去重与候选晋升思想，未复制其私有运行状态。

跨会话可信记忆自动召回

设计分层： Dream 提取候选 → 出处核验、人工审阅/按阈值自动晋升 → 发布到同工作区的 MEMORY.md → 后续本地会话按当前消息确定性挑选最多 3 条相关事实，放入独立的 system prompt 参考区。未批准候选、旧 Session 原始对话、工具内容不直接自动注入。

- 本地会话须与配置的 Agent 预设及工作区一致。Discord/飞书会话只有在 Channel Core 确认其为当前主人、且工作区与预设匹配时才允许自动召回；其他用户的私聊与群聊不会注入个人记忆。
- 自动提示并不访问原始历史，也不跨 Agent/工作区；原文需要人工或有权限工具的明确检索。已确认事实的返回附 Session ID 和原生事件序号，便于查证，不将数据中的命令当成指令。
- memory_search 继续只检索已发布记忆；改为词语 + 可选向量相似度真正融合排名。Embedding 未配置或失败则只走关键词，使用时应在设置页核对 provider 的状态，别假定是语义搜索。
- 设置：autoRecall、autoRecallMaxItems、autoRecallMaxChars，默认开启本地自动召回，最多 3 条 / 1200 字符。系统提示词只带入与当前问题相关的少量事实，不会增加第二份 Session 历史。
- 自动每日 Dream automatic 继续独立控制，默认不替用户开启；只有已发布事实才可用于自动召回。

跨渠道主人身份与分层记忆

飞书和 Discord 的主人由 Channel Core 统一认领与核验：默认可由首位符合接收规则的私聊者认领，也可以按渠道设置由管理者指定。两个渠道共用会话时，在 Channel Core 建立身份关联。Dream 只查询核验结果，底层沿用 owner 标识，不要求填写第二份主人身份；更换主人后，旧主人的记忆访问会立即失效。

- 避免在允许所有用户私聊的情况下，把 MEMORY.md 当作公共系统提示词。对于已核验主人，dsh-instruction-files 仅加载人工维护段落；受管事实仍通过 Memory 的按问题召回，防止双重加载。
- 每种 Dream 任务有独立的 Session/事件增量游标，仅在完整成功且没有拒收候选时标记实际纳入模型输入的事件；出错后继续补做。
- SQLite memory_fact_versions 记录发布、替换、遗忘及复核时间，当前事实仍由 MEMORY.md 已发布区块确认。复核到期暂不自动注入，手工检索和审阅页仍可查看，再点击「确认仍有效」更新复核时间。
- memory_topics 提供只读主题目录，memory_search 提供细节；不因为项目历史变多而每轮装入全部记忆。