"""
公共常量定义

统一管理 RAG 系统中的常量值，避免重复定义。
"""

from copy import deepcopy

# ==================== 检索结果常量 ====================

# 空检索结果模板（不要直接返回，使用 get_empty_result()）
_EMPTY_RESULT_TEMPLATE = {
    'ids': [[]],
    'documents': [[]],
    'metadatas': [[]],
    'distances': [[]]
}

# 空检索结果模板（无嵌套列表形式）
_EMPTY_RESULT_FLAT_TEMPLATE = {
    'ids': [],
    'documents': [],
    'metadatas': [],
    'distances': []
}


def get_empty_result() -> dict:
    """返回空检索结果的深拷贝，避免副作用"""
    return deepcopy(_EMPTY_RESULT_TEMPLATE)


def get_empty_result_flat() -> dict:
    """返回扁平空检索结果的深拷贝"""
    return deepcopy(_EMPTY_RESULT_FLAT_TEMPLATE)