feat(memory): Memory V2 重写 - 可插拔 provider + Hindsight 集成
以 Hermes 的可插拔记忆架构为骨架重写 deerflow 记忆模块,兼容原有 结构化数据,并新增 Hindsight 作为外部记忆后端。 P1 - 抽象层 + builtin 本地记忆: - MemoryProvider 抽象基类 + MemoryManager 编排层(builtin + ≤1 外部) - BuiltinFileProvider:USER.md/MEMORY.md 二元存储、字符配额、文件锁、 原子写、frozen snapshot - memory 工具(LangChain @tool):LLM 主动写入用户画像/工作笔记 - 记忆内容安全扫描(注入/外渗模式 + 不可见 unicode) - memory_config 改为嵌套结构 + 旧扁平字段兼容 + per-user 三层覆盖 - 迁移脚本 migrate_memory_to_v2.py:旧 memory.json -> USER.md/MEMORY.md - Gateway 新增 /api/memory/v2 与 v2/config 端点(用户可配置白名单字段) P2 - Hindsight 外部 provider: - HindsightProvider:双 bank 隔离(user bank 跨 agent 共享 + work bank agent 私有)、并发召回合并、auto-retain、on_memory_write 镜像 - hindsight_recall/reflect/retain 三个 LangChain 工具 - MemoryMiddleware.before_model 注入 Hindsight 动态召回 - context/tools/hybrid 三种 memory_mode - hindsight-client 作为可选依赖,未装时自动退回纯 builtin 注入走系统提示词(builtin frozen snapshot)+ before_model(Hindsight 动态召回)。后台抽取保留但默认关闭,P3 期重接入。 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
1 parent
6947a3ffa7
commit
f9d7610679
21 files changed
+3970
-188
No files matched your search
@@ -155,6 +155,33 @@ class Paths:
|
||||
"""Per-user per-agent memory: `{base_dir}/users/{user_id}/agents/{id}/memory.json`."""
|
||||
return self.user_dir(user_id) / "agents" / agent_name.lower() / "memory.json"
|
||||
|
||||
# --- Memory V2 布局 (USER.md / MEMORY.md / per-user 配置覆盖) ---
|
||||
# 详见 docs/MEMORY_V2_DESIGN_ZH.md §5.1。注意与 ``user_md_file`` 区分:
|
||||
# 后者是 base_dir 下的全局 USER.md (旧布局),这里是 per-user 的 V2 布局。
|
||||
|
||||
def user_profile_md_file(self, user_id: str) -> Path:
|
||||
"""Memory V2 用户画像文件:`{base_dir}/users/{user_id}/USER.md`。
|
||||
|
||||
存放 LLM 主动写入的 ``target="user"`` 记忆 (用户身份、偏好,跨 agent 共享)。
|
||||
"""
|
||||
return self.user_dir(user_id) / "USER.md"
|
||||
|
||||
def user_agent_memory_md_file(self, user_id: str, agent_name: str) -> Path:
|
||||
"""Memory V2 agent 工作笔记文件:`{base_dir}/users/{user_id}/agents/{id}/MEMORY.md`。
|
||||
|
||||
存放 LLM 主动写入的 ``target="memory"`` 记忆 (agent 私有工作笔记)。
|
||||
"""
|
||||
return self.user_dir(user_id) / "agents" / agent_name.lower() / "MEMORY.md"
|
||||
|
||||
def user_memory_config_file(self, user_id: str) -> Path:
|
||||
"""Memory V2 per-user 运行时配置覆盖:`{base_dir}/users/{user_id}/memory_config.json`。"""
|
||||
return self.user_dir(user_id) / "memory_config.json"
|
||||
|
||||
@property
|
||||
def memory_global_overrides_file(self) -> Path:
|
||||
"""Memory V2 全局配置覆盖 (管理员配):`{base_dir}/memory_user_overrides.json`。"""
|
||||
return self.base_dir / "memory_user_overrides.json"
|
||||
|
||||
def thread_dir(self, thread_id: str, *, user_id: str | None = None) -> Path:
|
||||
"""
|
||||
Host path for a thread's data.
|
||||
|
||||
Reference in new issue
Block a user