Python
"""
HY Memory - Component Factory
ComponentFactory 负责:
1. 管理共享资源 (EmbedService, VectorStore, GraphStore, Cache)
2. 创建 MemoryWriter / MemoryReader / System2Writer 实例(单例缓存)
3. 管理组件生命周期
使用方式:
factory = ComponentFactory(config=config)
writer = await factory.get_writer()
reader = await factory.get_reader()
system2 = await factory.get_system2_writer()
"""
from typing import Optional, Dict
import logging
from .base import WritePipeline, ReadPipeline
from ..config import MemoryConfig
from ..core.embed_service import EmbedService
from ..embedding import EmbeddingService
from ..data.vector_store import create_vector_store
from ..data.vector_store_base import VectorStoreBase
logger = logging.getLogger(__name__)
# ================================================================
# 向后兼容别名 — 供旧代码 / 外部 import 使用
# ================================================================
class PipelineConfig:
"""向后兼容:已废弃,保留避免 ImportError。"""
def __init__(self, **kwargs):
pass
class ComponentFactory:
"""
组件工厂
管理 Writer / Reader / System2Writer 实例及共享资源。
client.py 通过此工厂创建和获取组件。
使用方式:
factory = ComponentFactory(config=config)
writer = await factory.get_writer() # MemoryWriter
reader = await factory.get_reader() # MemoryReader (default)
reader = await factory.get_reader(reader_name="hybrid") # 指定 reader
s2 = await factory.get_system2_writer() # System2Writer (ultra mode)
"""
def __init__(
self,
config: Optional[MemoryConfig] = None,
*,
embedding_service: Optional[EmbeddingService] = None,
):
self.config = config or MemoryConfig.from_env()
# 实例缓存(单例)
self._writer: Optional[WritePipeline] = None
self._reader: Optional[ReadPipeline] = None
self._system2_writer: Optional[WritePipeline] = None
# 多 reader 缓存(按 reader_name 索引)
self._readers: Dict[str, ReadPipeline] = {}
# 共享资源
self._shared_embed_service: Optional[EmbeddingService] = embedding_service
self._shared_vector_store: Optional[VectorStoreBase] = None
self._shared_vector_store_initialized: bool = False
self._shared_graph_store = None
self._shared_cache = None
# ================================================================
# 共享资源
# ================================================================
def _get_shared_embed_service(self) -> EmbeddingService:
if self._shared_embed_service is None:
self._shared_embed_service = EmbedService(self.config)
return self._shared_embed_service
def _get_shared_vector_store(self) -> VectorStoreBase:
if self._shared_vector_store is None:
self._shared_vector_store = create_vector_store(self.config)
logger.debug("ComponentFactory: VectorStore created")
return self._shared_vector_store
# ================================================================
# 获取组件(自动初始化 + 缓存)
# ================================================================
async def get_writer(self, **kwargs) -> WritePipeline:
"""
获取 MemoryWriter 实例(System 1 写入器)。
所有 mode (lite/pro/ultra) 都使用同一个 MemoryWriter,
区别只在于 client 传入的 agent_mode 参数。
"""
if self._writer is not None:
return self._writer
from .writer import MemoryWriter
writer = MemoryWriter(
config=self.config,
embed_service=self._get_shared_embed_service(),
vector_store=self._get_shared_vector_store(),
cache=self._shared_cache,
# 记忆关系图(pro 模式):写侧把 L2_FACT 投影进图并建 RELATED_TO / TAGGED_WITH。
# None 时 writer 里的图投影整段跳过。
graph_store=self._shared_graph_store,
)
await writer.initialize()
self._writer = writer
logger.debug("MemoryWriter initialized")
return writer
async def get_reader(self, reader_name: str = "", **kwargs) -> ReadPipeline:
"""
获取 MemoryReader 实例。
Args:
reader_name: 指定 reader 类型(legacy / hybrid)。
空字符串 = 使用 HY_MEMORY_READER 环境变量或默认 legacy。
支持按请求动态切换 reader,每种 reader 缓存一个实例。
"""
# 确定实际的 reader name
from ._retrieval.config import resolve_reader_name
effective_name = resolve_reader_name(reader_name)
# 检查缓存
if effective_name in self._readers:
return self._readers[effective_name]
# 向后兼容:无指定时走旧的 _reader 单例
if not reader_name and self._reader is not None:
return self._reader
reader_kwargs = {
"config": self.config,
"embed_service": self._get_shared_embed_service(),
"vector_store": self._get_shared_vector_store(),
"cache": self._shared_cache,
}
if self._shared_graph_store is not None:
reader_kwargs["graph_store"] = self._shared_graph_store
# 用 _build_impl 直接构建指定 reader(绕过 MemoryReader dispatcher)
import os
old_env = os.environ.get("HY_MEMORY_READER", "")
os.environ["HY_MEMORY_READER"] = effective_name
try:
from .reader import MemoryReader
reader = MemoryReader(**reader_kwargs)
await reader.initialize()
finally:
if old_env:
os.environ["HY_MEMORY_READER"] = old_env
else:
os.environ.pop("HY_MEMORY_READER", None)
# 缓存
self._readers[effective_name] = reader
if not reader_name:
self._reader = reader
logger.debug(f"MemoryReader initialized: {effective_name}")
return reader
async def get_system2_writer(self, **kwargs) -> WritePipeline:
"""
获取 System2Writer 实例(ultra mode 专用)。
System2Writer 内部包含 MemoryWriter (System 1) + System 2 认知加工。
"""
if self._system2_writer is not None:
return self._system2_writer
from .system2_writer import System2Writer
s2_kwargs = {
"config": self.config,
"embed_service": self._get_shared_embed_service(),
"vector_store": self._get_shared_vector_store(),
"cache": self._shared_cache,
}
if self._shared_graph_store is not None:
s2_kwargs["graph_store"] = self._shared_graph_store
s2 = System2Writer(**s2_kwargs)
await s2.initialize()
self._system2_writer = s2
logger.debug("System2Writer initialized")
return s2
# ================================================================
# 生命周期
# ================================================================
async def close(self) -> None:
"""关闭所有组件和共享资源"""
for name, inst in [("writer", self._writer), ("reader", self._reader),
("system2_writer", self._system2_writer)]:
if inst is not None:
try:
await inst.close()
except Exception as e:
logger.error(f"Failed to close {name}: {e}")
if self._shared_vector_store:
try:
await self._shared_vector_store.close()
except Exception as e:
logger.error(f"Failed to close VectorStore: {e}")
self._writer = None
self._reader = None
self._system2_writer = None
self._shared_vector_store = None
self._shared_vector_store_initialized = False
self._shared_embed_service = None
logger.debug("ComponentFactory closed")
# ================================================================
# 向后兼容别名
# ================================================================
PipelineRegistry = ComponentFactory