AGENTS.md

AGENTS.md

项目文档见 docs/README.md。 提交前检查和 commit message 格式见 docs/develop/commit_requirements.md。

模块关系（缩略图）

修改功能前先确认当前模块的上下游约束，避免遗漏关联模块。完整职责说明、运行时数据流/控制流、以及各模块的关联性检查清单见 模块架构与关联关系。

服务端核心依赖链（单向下降）：service → manager → meta → config → data_storage → common。

flowchart TD
    main["main.cpp"] --> service["service（接入层/装配入口）"]
    service --> manager["manager（CacheManager）"]
    manager --> meta["meta（索引/CacheLocation）"]
    meta --> config["config（注册表/选主）"]
    config --> data_storage["data_storage（存储后端）"]
    data_storage --> common["common"]

    manager --> event["event"]
    manager --> metrics["metrics"]
    service --> metrics
    service --> config
    service --> data_storage
    manager --> protocol["protocol（proto/grpc）"]

    %% 有意的反向边（近似环，改动需谨慎）
    common -. request_context .-> metrics
    metrics -. metrics_reporter .-> manager

    %% 对外分支与 optimizer
    py_connector["py_connector"] --> client["client SDK"]
    client -.-> config
    optimizer["optimizer（仿真与优化）"] -. cache_location .-> meta

Loading

若模块职责、依赖方向或调用关系变动，或新增/删除模块，请同步更新本图与 docs/design/module_architecture.md。

约束

• Instance 隔离：KVCache 仅在同一个 instance_id 内复用，跨 Instance 不匹配。