get_metric_lineage

取指标血缘（上下游派生关系 + 物理依赖）。

HTTP 调 Sprint 2b GET /api/graphs/{graph_id}/metrics/{metric_id}/lineage， 按 format 参数返回 graph / list / narrative 三种结构。

设计来源: design-sprint3.md v3 §3 (C12)

输入 Schema

用途

取指标血缘图：上下游 metric 派生关系 + 物理表依赖。支持 3 种返回格式（mermaid / json / table）+ 循环检测 + 最大深度限制。

调用示例

Claude Desktop 中说："用 graphforge 看一下准交率的血缘"

JSON-RPC payload：

{
  "method": "tools/call",
  "params": {
    "name": "get_metric_lineage",
    "arguments": {
      "input": "准交率"
    }
  }
}

显式参数：

{
  "metric_id": "on_time_delivery_rate",
  "graph_id": "kg_xxxxxx",
  "direction": "upstream",
  "depth": 3,
  "format": "mermaid"
}

返回示例（mermaid 格式）

{
  "metric_id": "on_time_delivery_rate",
  "format": "mermaid",
  "diagram": "graph TD\n  on_time_delivery_rate --> on_time_orders\n  on_time_delivery_rate --> total_orders\n  on_time_orders --> wms_outbound\n  total_orders --> oms_orders",
  "node_count": 5,
  "edge_count": 4
}

何时用

• 数字怀疑时排查"这个指标依赖哪些上游数据"
• 修改物理绑定前先看会影响哪些下游指标
• 给 Claude 生成可视化（mermaid 直接渲染成图）

注意

• direction ∈ {upstream, downstream, both}，默认 both
• depth 最大 5（C-21 BFS 上限）
• format ∈ {mermaid, json, table}，Claude Desktop 推荐 mermaid（自动渲染）
• 自动检测循环依赖，发现会返警告