Skip to content
Python
4.3 KB
Raw Blame
"""L0 基础画像层的 client_meta 透传。

线上实测发现:一次写入产出的多条记忆里,l2_fact 能带回 meta,
l0_basic_info 拿不到——画像走独立的 upsert 路径,透传时漏了。
这组测试锁住修复后的行为。
"""
import asyncio

from hy_memory.agent.tools.basic_profile import upsert_basic_profile
from hy_memory.models.memory import MemoryLayer, MemoryStatus


class FakeVectorStore:
    def __init__(self, nodes=None):
        self.nodes = list(nodes or [])
        self.upserted = []
        self.payload_updates = []

    async def list_by_user(self, **kwargs):
        return list(self.nodes)

    async def get_by_id(self, node_id):
        return next((n for n in self.nodes if n.node_id == node_id), None)

    async def upsert(self, node):
        self.upserted.append(node)
        self.nodes.append(node)

    async def update_payload(self, node_id, updates):
        self.payload_updates.append((node_id, updates))


class FakeEmbedService:
    async def embed_queued(self, text):
        return [0.1] * 8


FIELDS = ["name", "age", "location"]


def upsert(store, kv, meta=None, user="u1"):
    return asyncio.run(
        upsert_basic_profile(
            user_id=user,
            kv=kv,
            vector_store=store,
            embed_service=FakeEmbedService(),
            allowed_fields=FIELDS,
            client_meta=meta,
        )
    )


class TestBasicProfileClientMeta:
    def test_meta_attached_to_new_node(self):
        store = FakeVectorStore()
        meta = {"source": "codebuddy", "trace_id": "t-1"}

        r = upsert(store, {"name": "张伟"}, meta=meta)

        assert r.success and r.changed
        assert len(store.upserted) == 1
        node = store.upserted[0]
        assert node.layer == MemoryLayer.L0_BASIC_INFO
        assert node.custom["meta"] == [meta]

    def test_basic_info_kv_still_stored_alongside_meta(self):
        """meta 不能挤掉原有的 basic_info_kv——后者是画像装配的依据。"""
        store = FakeVectorStore()

        upsert(store, {"name": "张伟", "age": 35}, meta={"k": "v"})

        custom = store.upserted[0].custom
        assert custom["basic_info_kv"] == {"name": "张伟", "age": 35}
        assert custom["meta"] == [{"k": "v"}]

    def test_no_meta_key_when_not_provided(self):
        """不传 meta 时不应凭空造出该键,否则旧数据形态被改。"""
        store = FakeVectorStore()

        upsert(store, {"name": "张伟"})

        assert "meta" not in store.upserted[0].custom

    def test_empty_meta_treated_as_absent(self):
        store = FakeVectorStore()

        upsert(store, {"name": "张伟"}, meta={})

        assert "meta" not in store.upserted[0].custom

    def test_meta_is_copied_not_referenced(self):
        """存进去后调用方再改自己的 dict,不应影响已落库的内容。"""
        store = FakeVectorStore()
        meta = {"source": "a"}

        upsert(store, {"name": "张伟"}, meta=meta)
        meta["source"] = "mutated"

        assert store.upserted[0].custom["meta"] == [{"source": "a"}]

    def test_new_version_carries_only_current_meta(self):
        """L0 每次变更新建节点、旧节点转 SUPERSEDED,与 SUPERSEDE 同构:
        新节点只带本次 meta,不继承旧链,避免长链上无限累积。"""
        store = FakeVectorStore()

        upsert(store, {"name": "张伟"}, meta={"round": 1})
        upsert(store, {"name": "张伟", "age": 35}, meta={"round": 2})

        assert len(store.upserted) == 2
        assert store.upserted[1].custom["meta"] == [{"round": 2}]

        # 旧节点被标记取代,其 meta 原样留在链上
        assert store.payload_updates
        old_id, updates = store.payload_updates[-1]
        assert old_id == store.upserted[0].node_id
        assert updates["status"] == MemoryStatus.SUPERSEDED.value
        assert store.upserted[0].custom["meta"] == [{"round": 1}]

    def test_no_diff_writes_nothing_even_with_meta(self):
        """内容无变化时本就不落新版本,带了 meta 也不应因此凭空建节点。"""
        store = FakeVectorStore()

        upsert(store, {"name": "张伟"}, meta={"round": 1})
        r = upsert(store, {"name": "张伟"}, meta={"round": 2})

        assert r.success and not r.changed
        assert len(store.upserted) == 1