{
  "schema_version": "gendangzou-capabilities-v1",
  "contract_version": "gendangzou-api-v2",
  "api_prefix": "/api/gendangzou",
  "discovery": {
    "bootstrap": "/api/gendangzou/bootstrap",
    "capabilities": "/api/gendangzou/capabilities",
    "capability_detail_template": "/api/gendangzou/capabilities/{capability_id}"
  },
  "agent_defaults": {
    "primary_access_mode": "direct_task_capability",
    "response_profile": "compact",
    "snapshot_required_for_direct_queries": false,
    "snapshot_expansions": [
      "coverage",
      "sector_dynamics"
    ],
    "evidence_presentation": "material",
    "bind_follow_up_calls_with": "snapshot_id",
    "bind_snapshot_when": [
      "cross_endpoint_consistency",
      "historical_replay"
    ]
  },
  "error_contract": {
    "fields": [
      "code",
      "detail",
      "retryable",
      "request_id"
    ],
    "retry_statuses": [
      429,
      503
    ],
    "do_not_retry_statuses": [
      400,
      401,
      404,
      422
    ],
    "honor_retry_after": true
  },
  "recommended_flow": [
    "system.bootstrap",
    "system.capabilities",
    "select one task capability",
    "call the task capability with latest available data",
    "optional: snapshot.latest for cross-endpoint consistency, or historical replay",
    "fetch evidence only when needed"
  ],
  "$defs": {
    "Pagination": {
      "properties": {
        "page": {
          "title": "Page",
          "type": "integer"
        },
        "page_size": {
          "title": "Page Size",
          "type": "integer"
        },
        "total": {
          "title": "Total",
          "type": "integer"
        },
        "pages": {
          "title": "Pages",
          "type": "integer"
        }
      },
      "required": [
        "page",
        "page_size",
        "total",
        "pages"
      ],
      "title": "Pagination",
      "type": "object"
    },
    "PolicyMaterialItem": {
      "properties": {
        "material_id": {
          "title": "Material Id",
          "type": "string"
        },
        "material_ids": {
          "items": {
            "type": "string"
          },
          "title": "Material Ids",
          "type": "array"
        },
        "duplicate_count": {
          "default": 0,
          "title": "Duplicate Count",
          "type": "integer"
        },
        "source_id": {
          "title": "Source Id",
          "type": "string"
        },
        "source_name": {
          "title": "Source Name",
          "type": "string"
        },
        "authority": {
          "title": "Authority",
          "type": "string"
        },
        "source_tier": {
          "title": "Source Tier",
          "type": "string"
        },
        "sources": {
          "items": {
            "$ref": "#/$defs/PolicyMaterialSource"
          },
          "title": "Sources",
          "type": "array"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "url": {
          "title": "Url",
          "type": "string"
        },
        "material_date": {
          "title": "Material Date",
          "type": "string"
        },
        "doc_no": {
          "default": "",
          "title": "Doc No",
          "type": "string"
        },
        "first_seen_at": {
          "title": "First Seen At",
          "type": "string"
        },
        "signal_ready_at": {
          "default": "",
          "description": "正文、观点分析和当前板块目录映射全部完成的时间。",
          "title": "Signal Ready At",
          "type": "string"
        },
        "lifecycle_stage": {
          "default": "",
          "title": "Lifecycle Stage",
          "type": "string"
        },
        "lifecycle_status": {
          "default": "",
          "title": "Lifecycle Status",
          "type": "string"
        },
        "evidence_count": {
          "default": 0,
          "title": "Evidence Count",
          "type": "integer"
        },
        "sector_count": {
          "default": 0,
          "title": "Sector Count",
          "type": "integer"
        },
        "included_in_snapshot": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Included In Snapshot"
        },
        "results": {
          "items": {
            "$ref": "#/$defs/PolicyMaterialResult"
          },
          "title": "Results",
          "type": "array"
        }
      },
      "required": [
        "material_id",
        "source_id",
        "source_name",
        "authority",
        "source_tier",
        "title",
        "url",
        "material_date",
        "first_seen_at"
      ],
      "title": "PolicyMaterialItem",
      "type": "object"
    },
    "PolicyMaterialSource": {
      "properties": {
        "source_id": {
          "title": "Source Id",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        },
        "authority": {
          "title": "Authority",
          "type": "string"
        },
        "tier": {
          "title": "Tier",
          "type": "string"
        },
        "weight": {
          "default": 0.0,
          "title": "Weight",
          "type": "number"
        }
      },
      "required": [
        "source_id",
        "name",
        "authority",
        "tier"
      ],
      "title": "PolicyMaterialSource",
      "type": "object"
    },
    "PolicyMaterialResult": {
      "properties": {
        "evidence_id": {
          "title": "Evidence Id",
          "type": "string"
        },
        "viewpoint": {
          "title": "Viewpoint",
          "type": "string"
        },
        "quote": {
          "default": "",
          "title": "Quote",
          "type": "string"
        },
        "signal_type": {
          "title": "Signal Type",
          "type": "string"
        },
        "confidence": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Confidence"
        },
        "impact_direction": {
          "default": "unknown",
          "title": "Impact Direction",
          "type": "string"
        },
        "direction_score": {
          "default": 0.0,
          "title": "Direction Score",
          "type": "number"
        },
        "direction_confidence": {
          "default": "unknown",
          "title": "Direction Confidence",
          "type": "string"
        },
        "impact_horizon": {
          "default": "unknown",
          "title": "Impact Horizon",
          "type": "string"
        },
        "direction_rationale": {
          "default": "",
          "title": "Direction Rationale",
          "type": "string"
        },
        "sectors": {
          "items": {
            "$ref": "#/$defs/PolicyMaterialSector"
          },
          "title": "Sectors",
          "type": "array"
        }
      },
      "required": [
        "evidence_id",
        "viewpoint",
        "signal_type"
      ],
      "title": "PolicyMaterialResult",
      "type": "object"
    },
    "PolicyMaterialSector": {
      "properties": {
        "sector_id": {
          "title": "Sector Id",
          "type": "string"
        },
        "sector_name": {
          "title": "Sector Name",
          "type": "string"
        },
        "layer": {
          "default": "",
          "title": "Layer",
          "type": "string"
        },
        "current_catalog_match": {
          "default": false,
          "title": "Current Catalog Match",
          "type": "boolean"
        },
        "confidence": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Confidence"
        },
        "rationale": {
          "default": "",
          "title": "Rationale",
          "type": "string"
        },
        "impact_direction": {
          "default": "unknown",
          "title": "Impact Direction",
          "type": "string"
        },
        "direction_score": {
          "default": 0.0,
          "title": "Direction Score",
          "type": "number"
        },
        "direction_confidence": {
          "default": "unknown",
          "title": "Direction Confidence",
          "type": "string"
        },
        "direction_rationale": {
          "default": "",
          "title": "Direction Rationale",
          "type": "string"
        }
      },
      "required": [
        "sector_id",
        "sector_name"
      ],
      "title": "PolicyMaterialSector",
      "type": "object"
    },
    "PolicyMaterialSummary": {
      "properties": {
        "total": {
          "title": "Total",
          "type": "integer"
        },
        "signal": {
          "title": "Signal",
          "type": "integer"
        },
        "no_signal": {
          "title": "No Signal",
          "type": "integer"
        },
        "sources": {
          "items": {
            "$ref": "#/$defs/PolicyMaterialSourceSummary"
          },
          "title": "Sources",
          "type": "array"
        }
      },
      "required": [
        "total",
        "signal",
        "no_signal"
      ],
      "title": "PolicyMaterialSummary",
      "type": "object"
    },
    "PolicyMaterialSourceSummary": {
      "properties": {
        "source_id": {
          "title": "Source Id",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        },
        "count": {
          "title": "Count",
          "type": "integer"
        }
      },
      "required": [
        "source_id",
        "name",
        "count"
      ],
      "title": "PolicyMaterialSourceSummary",
      "type": "object"
    },
    "SnapshotReference": {
      "additionalProperties": false,
      "properties": {
        "snapshot_id": {
          "title": "Snapshot Id",
          "type": "string"
        },
        "namespace": {
          "title": "Namespace",
          "type": "string"
        },
        "as_of": {
          "title": "As Of",
          "type": "string"
        },
        "release_id": {
          "title": "Release Id",
          "type": "string"
        },
        "taxonomy_version": {
          "title": "Taxonomy Version",
          "type": "string"
        },
        "heat_run_id": {
          "title": "Heat Run Id",
          "type": "string"
        },
        "mapping_run_id": {
          "title": "Mapping Run Id",
          "type": "string"
        },
        "etf_run_id": {
          "default": "",
          "title": "Etf Run Id",
          "type": "string"
        },
        "market_run_id": {
          "default": "",
          "title": "Market Run Id",
          "type": "string"
        },
        "market_trade_date": {
          "default": "",
          "title": "Market Trade Date",
          "type": "string"
        },
        "market_status": {
          "default": "unavailable",
          "enum": [
            "fresh",
            "carried_forward",
            "reaggregated",
            "unavailable"
          ],
          "title": "Market Status",
          "type": "string"
        },
        "market_age_days": {
          "default": 0,
          "title": "Market Age Days",
          "type": "integer"
        },
        "market_mapping_reaggregated": {
          "default": false,
          "title": "Market Mapping Reaggregated",
          "type": "boolean"
        },
        "published_at": {
          "title": "Published At",
          "type": "string"
        },
        "publication_mode": {
          "enum": [
            "published",
            "derived"
          ],
          "title": "Publication Mode",
          "type": "string"
        },
        "data_status": {
          "const": "complete",
          "default": "complete",
          "title": "Data Status",
          "type": "string"
        },
        "response_profile": {
          "const": "compact",
          "default": "compact",
          "title": "Response Profile",
          "type": "string"
        },
        "sector_dynamics": {
          "anyOf": [
            {
              "$ref": "#/$defs/SnapshotSectorDynamics"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "coverage": {
          "anyOf": [
            {
              "additionalProperties": {
                "type": "integer"
              },
              "type": "object"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Coverage"
        }
      },
      "required": [
        "snapshot_id",
        "namespace",
        "as_of",
        "release_id",
        "taxonomy_version",
        "heat_run_id",
        "mapping_run_id",
        "published_at",
        "publication_mode"
      ],
      "title": "SnapshotReference",
      "type": "object"
    },
    "SnapshotSectorDynamics": {
      "additionalProperties": false,
      "properties": {
        "schema_version": {
          "title": "Schema Version",
          "type": "string"
        },
        "dynamics_run_id": {
          "title": "Dynamics Run Id",
          "type": "string"
        },
        "as_of": {
          "title": "As Of",
          "type": "string"
        },
        "trade_date": {
          "title": "Trade Date",
          "type": "string"
        },
        "formula_version": {
          "title": "Formula Version",
          "type": "string"
        },
        "market_context": {
          "additionalProperties": true,
          "title": "Market Context",
          "type": "object"
        },
        "summary": {
          "additionalProperties": true,
          "title": "Summary",
          "type": "object"
        },
        "historical_readiness": {
          "additionalProperties": true,
          "title": "Historical Readiness",
          "type": "object"
        },
        "items": {
          "items": {
            "$ref": "#/$defs/SectorAnomalySummary"
          },
          "title": "Items",
          "type": "array"
        },
        "links": {
          "items": {
            "$ref": "#/$defs/SectorLinkageSummary"
          },
          "title": "Links",
          "type": "array"
        }
      },
      "required": [
        "schema_version",
        "dynamics_run_id",
        "as_of",
        "trade_date",
        "formula_version"
      ],
      "title": "SnapshotSectorDynamics",
      "type": "object"
    },
    "SectorLinkageSummary": {
      "additionalProperties": false,
      "properties": {
        "source_sector_id": {
          "title": "Source Sector Id",
          "type": "string"
        },
        "source_sector_name": {
          "title": "Source Sector Name",
          "type": "string"
        },
        "target_sector_id": {
          "title": "Target Sector Id",
          "type": "string"
        },
        "target_sector_name": {
          "title": "Target Sector Name",
          "type": "string"
        },
        "relation_kind": {
          "enum": [
            "hierarchy",
            "taxonomy_semantic"
          ],
          "title": "Relation Kind",
          "type": "string"
        },
        "relation": {
          "title": "Relation",
          "type": "string"
        },
        "pattern": {
          "enum": [
            "same_day_resonance",
            "same_day_divergence",
            "hierarchy_divergence",
            "structural_overlap"
          ],
          "title": "Pattern",
          "type": "string"
        },
        "linkage_score": {
          "title": "Linkage Score",
          "type": "number"
        },
        "confidence": {
          "title": "Confidence",
          "type": "number"
        },
        "stock_overlap": {
          "title": "Stock Overlap",
          "type": "number"
        },
        "independent_signal": {
          "title": "Independent Signal",
          "type": "boolean"
        },
        "rationale": {
          "default": "",
          "title": "Rationale",
          "type": "string"
        }
      },
      "required": [
        "source_sector_id",
        "source_sector_name",
        "target_sector_id",
        "target_sector_name",
        "relation_kind",
        "relation",
        "pattern",
        "linkage_score",
        "confidence",
        "stock_overlap",
        "independent_signal"
      ],
      "title": "SectorLinkageSummary",
      "type": "object"
    },
    "SectorAnomalySummary": {
      "additionalProperties": false,
      "properties": {
        "sector_id": {
          "title": "Sector Id",
          "type": "string"
        },
        "sector_name": {
          "title": "Sector Name",
          "type": "string"
        },
        "layer": {
          "title": "Layer",
          "type": "string"
        },
        "relative_direction": {
          "enum": [
            "stronger",
            "weaker",
            "neutral"
          ],
          "title": "Relative Direction",
          "type": "string"
        },
        "absolute_direction": {
          "enum": [
            "positive",
            "negative",
            "neutral"
          ],
          "title": "Absolute Direction",
          "type": "string"
        },
        "anomaly_type": {
          "enum": [
            "counter_trend",
            "relative_resilience",
            "relative_weakness",
            "broad_internal_move",
            "flow_price_divergence",
            "concentrated_move",
            "cross_section_outlier"
          ],
          "title": "Anomaly Type",
          "type": "string"
        },
        "anomaly_score": {
          "title": "Anomaly Score",
          "type": "number"
        },
        "attention_score": {
          "title": "Attention Score",
          "type": "number"
        },
        "internal_confirmation": {
          "title": "Internal Confirmation",
          "type": "number"
        },
        "linkage_score": {
          "title": "Linkage Score",
          "type": "number"
        },
        "linkage_confirmation": {
          "title": "Linkage Confirmation",
          "type": "number"
        },
        "confidence": {
          "title": "Confidence",
          "type": "number"
        },
        "sector_return": {
          "title": "Sector Return",
          "type": "number"
        },
        "market_return": {
          "title": "Market Return",
          "type": "number"
        },
        "excess_return": {
          "title": "Excess Return",
          "type": "number"
        },
        "sector_breadth": {
          "title": "Sector Breadth",
          "type": "number"
        },
        "market_breadth": {
          "title": "Market Breadth",
          "type": "number"
        },
        "breadth_gap": {
          "title": "Breadth Gap",
          "type": "number"
        },
        "effective_sample_size": {
          "title": "Effective Sample Size",
          "type": "number"
        },
        "top1_weight": {
          "title": "Top1 Weight",
          "type": "number"
        },
        "covered_stock_count": {
          "title": "Covered Stock Count",
          "type": "integer"
        },
        "explanation": {
          "default": "",
          "title": "Explanation",
          "type": "string"
        },
        "linked_sectors": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Linked Sectors",
          "type": "array"
        }
      },
      "required": [
        "sector_id",
        "sector_name",
        "layer",
        "relative_direction",
        "absolute_direction",
        "anomaly_type",
        "anomaly_score",
        "attention_score",
        "internal_confirmation",
        "linkage_score",
        "linkage_confirmation",
        "confidence",
        "sector_return",
        "market_return",
        "excess_return",
        "sector_breadth",
        "market_breadth",
        "breadth_gap",
        "effective_sample_size",
        "top1_weight",
        "covered_stock_count"
      ],
      "title": "SectorAnomalySummary",
      "type": "object"
    },
    "SectorSummary": {
      "properties": {
        "sector_id": {
          "title": "Sector Id",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        },
        "layer": {
          "title": "Layer",
          "type": "string"
        },
        "status": {
          "title": "Status",
          "type": "string"
        },
        "object_type": {
          "title": "Object Type",
          "type": "string"
        },
        "parent_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Parent Id"
        },
        "parent_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Parent Name"
        },
        "source_origin": {
          "title": "Source Origin",
          "type": "string"
        },
        "activation_weight": {
          "title": "Activation Weight",
          "type": "number"
        },
        "definition": {
          "default": "",
          "title": "Definition",
          "type": "string"
        },
        "aliases": {
          "items": {
            "type": "string"
          },
          "title": "Aliases",
          "type": "array"
        },
        "include": {
          "items": {
            "type": "string"
          },
          "title": "Include",
          "type": "array"
        },
        "exclude": {
          "items": {
            "type": "string"
          },
          "title": "Exclude",
          "type": "array"
        },
        "related_parents": {
          "items": {
            "type": "string"
          },
          "title": "Related Parents",
          "type": "array"
        },
        "mapped_sw": {
          "items": {
            "type": "string"
          },
          "title": "Mapped Sw",
          "type": "array"
        },
        "lifecycle": {
          "$ref": "#/$defs/SectorLifecycle"
        },
        "policy_heat": {
          "anyOf": [
            {
              "$ref": "#/$defs/HeatValue"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "market_attention": {
          "anyOf": [
            {
              "$ref": "#/$defs/HeatValue"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "market_trading": {
          "anyOf": [
            {
              "$ref": "#/$defs/HeatValue"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "sector_id",
        "name",
        "layer",
        "status",
        "object_type",
        "source_origin",
        "activation_weight"
      ],
      "title": "SectorSummary",
      "type": "object"
    },
    "SectorLifecycle": {
      "properties": {
        "state": {
          "default": "active",
          "enum": [
            "active",
            "dormant",
            "deprecated",
            "retired"
          ],
          "title": "State",
          "type": "string"
        },
        "current_in_snapshot": {
          "default": true,
          "title": "Current In Snapshot",
          "type": "boolean"
        },
        "first_seen_as_of": {
          "default": "",
          "title": "First Seen As Of",
          "type": "string"
        },
        "last_seen_as_of": {
          "default": "",
          "title": "Last Seen As Of",
          "type": "string"
        },
        "last_supported_as_of": {
          "default": "",
          "title": "Last Supported As Of",
          "type": "string"
        },
        "last_active_as_of": {
          "default": "",
          "title": "Last Active As Of",
          "type": "string"
        },
        "inactive_since": {
          "default": "",
          "title": "Inactive Since",
          "type": "string"
        },
        "inactive_reason": {
          "default": "",
          "title": "Inactive Reason",
          "type": "string"
        },
        "reactivated_as_of": {
          "default": "",
          "title": "Reactivated As Of",
          "type": "string"
        }
      },
      "title": "SectorLifecycle",
      "type": "object"
    },
    "HeatValue": {
      "properties": {
        "level": {
          "title": "Level",
          "type": "number"
        },
        "momentum": {
          "title": "Momentum",
          "type": "number"
        },
        "contribution_count": {
          "default": 0,
          "title": "Contribution Count",
          "type": "integer"
        }
      },
      "required": [
        "level",
        "momentum"
      ],
      "title": "HeatValue",
      "type": "object"
    },
    "SnapshotContext": {
      "additionalProperties": false,
      "properties": {
        "snapshot_id": {
          "title": "Snapshot Id",
          "type": "string"
        },
        "namespace": {
          "title": "Namespace",
          "type": "string"
        },
        "as_of": {
          "title": "As Of",
          "type": "string"
        },
        "release_id": {
          "title": "Release Id",
          "type": "string"
        },
        "taxonomy_version": {
          "title": "Taxonomy Version",
          "type": "string"
        },
        "heat_run_id": {
          "title": "Heat Run Id",
          "type": "string"
        },
        "mapping_run_id": {
          "title": "Mapping Run Id",
          "type": "string"
        },
        "etf_run_id": {
          "default": "",
          "title": "Etf Run Id",
          "type": "string"
        },
        "market_run_id": {
          "default": "",
          "title": "Market Run Id",
          "type": "string"
        },
        "market_trade_date": {
          "default": "",
          "title": "Market Trade Date",
          "type": "string"
        },
        "market_status": {
          "default": "unavailable",
          "enum": [
            "fresh",
            "carried_forward",
            "reaggregated",
            "unavailable"
          ],
          "title": "Market Status",
          "type": "string"
        },
        "market_age_days": {
          "default": 0,
          "title": "Market Age Days",
          "type": "integer"
        },
        "market_mapping_reaggregated": {
          "default": false,
          "title": "Market Mapping Reaggregated",
          "type": "boolean"
        },
        "sector_dynamics": {
          "anyOf": [
            {
              "$ref": "#/$defs/SnapshotSectorDynamics"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "published_at": {
          "title": "Published At",
          "type": "string"
        },
        "publication_mode": {
          "enum": [
            "published",
            "derived"
          ],
          "title": "Publication Mode",
          "type": "string"
        },
        "data_status": {
          "const": "complete",
          "default": "complete",
          "title": "Data Status",
          "type": "string"
        },
        "coverage": {
          "additionalProperties": {
            "type": "integer"
          },
          "title": "Coverage",
          "type": "object"
        }
      },
      "required": [
        "snapshot_id",
        "namespace",
        "as_of",
        "release_id",
        "taxonomy_version",
        "heat_run_id",
        "mapping_run_id",
        "published_at",
        "publication_mode"
      ],
      "title": "SnapshotContext",
      "type": "object"
    },
    "SectorDetail": {
      "properties": {
        "sector_id": {
          "title": "Sector Id",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        },
        "layer": {
          "title": "Layer",
          "type": "string"
        },
        "status": {
          "title": "Status",
          "type": "string"
        },
        "object_type": {
          "title": "Object Type",
          "type": "string"
        },
        "parent_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Parent Id"
        },
        "parent_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Parent Name"
        },
        "source_origin": {
          "title": "Source Origin",
          "type": "string"
        },
        "activation_weight": {
          "title": "Activation Weight",
          "type": "number"
        },
        "definition": {
          "default": "",
          "title": "Definition",
          "type": "string"
        },
        "aliases": {
          "items": {
            "type": "string"
          },
          "title": "Aliases",
          "type": "array"
        },
        "include": {
          "items": {
            "type": "string"
          },
          "title": "Include",
          "type": "array"
        },
        "exclude": {
          "items": {
            "type": "string"
          },
          "title": "Exclude",
          "type": "array"
        },
        "related_parents": {
          "items": {
            "type": "string"
          },
          "title": "Related Parents",
          "type": "array"
        },
        "mapped_sw": {
          "items": {
            "type": "string"
          },
          "title": "Mapped Sw",
          "type": "array"
        },
        "lifecycle": {
          "$ref": "#/$defs/SectorLifecycle"
        },
        "policy_heat": {
          "anyOf": [
            {
              "$ref": "#/$defs/HeatValue"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "market_attention": {
          "anyOf": [
            {
              "$ref": "#/$defs/HeatValue"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "market_trading": {
          "anyOf": [
            {
              "$ref": "#/$defs/HeatValue"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "children": {
          "items": {
            "$ref": "#/$defs/SectorSummary"
          },
          "title": "Children",
          "type": "array"
        },
        "relationships": {
          "items": {
            "$ref": "#/$defs/SectorRelationship"
          },
          "title": "Relationships",
          "type": "array"
        },
        "changes": {
          "items": {
            "$ref": "#/$defs/SectorChange"
          },
          "title": "Changes",
          "type": "array"
        },
        "successor_ids": {
          "items": {
            "type": "string"
          },
          "title": "Successor Ids",
          "type": "array"
        },
        "taxonomy_evidence_count": {
          "default": 0,
          "title": "Taxonomy Evidence Count",
          "type": "integer"
        },
        "heat_evidence_count": {
          "default": 0,
          "title": "Heat Evidence Count",
          "type": "integer"
        }
      },
      "required": [
        "sector_id",
        "name",
        "layer",
        "status",
        "object_type",
        "source_origin",
        "activation_weight"
      ],
      "title": "SectorDetail",
      "type": "object"
    },
    "SectorRelationship": {
      "properties": {
        "source_sector_id": {
          "title": "Source Sector Id",
          "type": "string"
        },
        "source_sector_name": {
          "title": "Source Sector Name",
          "type": "string"
        },
        "target_sector_id": {
          "title": "Target Sector Id",
          "type": "string"
        },
        "target_sector_name": {
          "title": "Target Sector Name",
          "type": "string"
        },
        "relation": {
          "title": "Relation",
          "type": "string"
        },
        "direction": {
          "enum": [
            "outgoing",
            "incoming"
          ],
          "title": "Direction",
          "type": "string"
        },
        "confidence": {
          "default": "",
          "title": "Confidence",
          "type": "string"
        },
        "rationale": {
          "default": "",
          "title": "Rationale",
          "type": "string"
        },
        "effective_from": {
          "default": "",
          "title": "Effective From",
          "type": "string"
        },
        "lifecycle_relation": {
          "default": false,
          "title": "Lifecycle Relation",
          "type": "boolean"
        }
      },
      "required": [
        "source_sector_id",
        "source_sector_name",
        "target_sector_id",
        "target_sector_name",
        "relation",
        "direction"
      ],
      "title": "SectorRelationship",
      "type": "object"
    },
    "SectorChange": {
      "properties": {
        "change_id": {
          "title": "Change Id",
          "type": "string"
        },
        "effective_from": {
          "title": "Effective From",
          "type": "string"
        },
        "change_type": {
          "title": "Change Type",
          "type": "string"
        },
        "before": {
          "additionalProperties": true,
          "title": "Before",
          "type": "object"
        },
        "after": {
          "additionalProperties": true,
          "title": "After",
          "type": "object"
        },
        "rationale": {
          "default": "",
          "title": "Rationale",
          "type": "string"
        }
      },
      "required": [
        "change_id",
        "effective_from",
        "change_type"
      ],
      "title": "SectorChange",
      "type": "object"
    },
    "SectorGraphNode": {
      "properties": {
        "sector_id": {
          "title": "Sector Id",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        },
        "layer": {
          "default": "",
          "title": "Layer",
          "type": "string"
        },
        "status": {
          "default": "",
          "title": "Status",
          "type": "string"
        },
        "object_type": {
          "default": "",
          "title": "Object Type",
          "type": "string"
        },
        "parent_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Parent Id"
        },
        "parent_name": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Parent Name"
        },
        "definition": {
          "default": "",
          "title": "Definition",
          "type": "string"
        },
        "current_in_snapshot": {
          "default": true,
          "title": "Current In Snapshot",
          "type": "boolean"
        },
        "lifecycle_state": {
          "default": "active",
          "title": "Lifecycle State",
          "type": "string"
        },
        "roles": {
          "items": {
            "enum": [
              "focus",
              "parent",
              "child",
              "related",
              "predecessor",
              "successor",
              "market_linked"
            ],
            "type": "string"
          },
          "title": "Roles",
          "type": "array"
        },
        "policy_heat": {
          "anyOf": [
            {
              "$ref": "#/$defs/HeatValue"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "market_attention": {
          "anyOf": [
            {
              "$ref": "#/$defs/HeatValue"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "market_trading": {
          "anyOf": [
            {
              "$ref": "#/$defs/HeatValue"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "sector_id",
        "name"
      ],
      "title": "SectorGraphNode",
      "type": "object"
    },
    "SectorGraphEdge": {
      "properties": {
        "edge_id": {
          "title": "Edge Id",
          "type": "string"
        },
        "source_sector_id": {
          "title": "Source Sector Id",
          "type": "string"
        },
        "source_sector_name": {
          "title": "Source Sector Name",
          "type": "string"
        },
        "target_sector_id": {
          "title": "Target Sector Id",
          "type": "string"
        },
        "target_sector_name": {
          "title": "Target Sector Name",
          "type": "string"
        },
        "category": {
          "enum": [
            "hierarchy",
            "industry",
            "lineage",
            "market"
          ],
          "title": "Category",
          "type": "string"
        },
        "relation": {
          "title": "Relation",
          "type": "string"
        },
        "confidence": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Confidence"
        },
        "rationale": {
          "default": "",
          "title": "Rationale",
          "type": "string"
        },
        "effective_from": {
          "default": "",
          "title": "Effective From",
          "type": "string"
        },
        "lifecycle_relation": {
          "default": false,
          "title": "Lifecycle Relation",
          "type": "boolean"
        },
        "generic_relation": {
          "default": false,
          "title": "Generic Relation",
          "type": "boolean"
        },
        "pattern": {
          "default": "",
          "title": "Pattern",
          "type": "string"
        },
        "linkage_score": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Linkage Score"
        },
        "stock_overlap": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Stock Overlap"
        },
        "independent_signal": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Independent Signal"
        },
        "market_trade_date": {
          "default": "",
          "title": "Market Trade Date",
          "type": "string"
        }
      },
      "required": [
        "edge_id",
        "source_sector_id",
        "source_sector_name",
        "target_sector_id",
        "target_sector_name",
        "category",
        "relation"
      ],
      "title": "SectorGraphEdge",
      "type": "object"
    },
    "SectorGraphSummary": {
      "properties": {
        "node_count": {
          "title": "Node Count",
          "type": "integer"
        },
        "edge_count": {
          "title": "Edge Count",
          "type": "integer"
        },
        "category_counts": {
          "additionalProperties": {
            "type": "integer"
          },
          "title": "Category Counts",
          "type": "object"
        },
        "generic_relation_count": {
          "default": 0,
          "title": "Generic Relation Count",
          "type": "integer"
        },
        "market_relation_count": {
          "default": 0,
          "title": "Market Relation Count",
          "type": "integer"
        }
      },
      "required": [
        "node_count",
        "edge_count"
      ],
      "title": "SectorGraphSummary",
      "type": "object"
    },
    "HeatSeriesPoint": {
      "properties": {
        "snapshot_id": {
          "title": "Snapshot Id",
          "type": "string"
        },
        "as_of": {
          "title": "As Of",
          "type": "string"
        },
        "effective_date": {
          "title": "Effective Date",
          "type": "string"
        },
        "taxonomy_version": {
          "title": "Taxonomy Version",
          "type": "string"
        },
        "sector_name": {
          "title": "Sector Name",
          "type": "string"
        },
        "layer": {
          "title": "Layer",
          "type": "string"
        },
        "heat_level": {
          "title": "Heat Level",
          "type": "number"
        },
        "cross_section_percentile": {
          "maximum": 1.0,
          "minimum": 0.0,
          "title": "Cross Section Percentile",
          "type": "number"
        },
        "heat_momentum": {
          "title": "Heat Momentum",
          "type": "number"
        },
        "contribution_count": {
          "title": "Contribution Count",
          "type": "integer"
        },
        "evidence_count": {
          "title": "Evidence Count",
          "type": "integer"
        },
        "direction_score": {
          "default": 0.0,
          "title": "Direction Score",
          "type": "number"
        },
        "direction_momentum": {
          "default": 0.0,
          "title": "Direction Momentum",
          "type": "number"
        },
        "direction_coverage": {
          "default": 0.0,
          "title": "Direction Coverage",
          "type": "number"
        },
        "disagreement_score": {
          "default": 0.0,
          "title": "Disagreement Score",
          "type": "number"
        }
      },
      "required": [
        "snapshot_id",
        "as_of",
        "effective_date",
        "taxonomy_version",
        "sector_name",
        "layer",
        "heat_level",
        "cross_section_percentile",
        "heat_momentum",
        "contribution_count",
        "evidence_count"
      ],
      "title": "HeatSeriesPoint",
      "type": "object"
    },
    "RealtimeCatalog": {
      "properties": {
        "release_id": {
          "title": "Release Id",
          "type": "string"
        },
        "namespace": {
          "title": "Namespace",
          "type": "string"
        },
        "version": {
          "title": "Version",
          "type": "string"
        },
        "as_of": {
          "title": "As Of",
          "type": "string"
        },
        "status": {
          "title": "Status",
          "type": "string"
        },
        "activated_at": {
          "title": "Activated At",
          "type": "string"
        },
        "sector_count": {
          "description": "当前活动板块目录节点数。",
          "title": "Sector Count",
          "type": "integer"
        }
      },
      "required": [
        "release_id",
        "namespace",
        "version",
        "as_of",
        "status",
        "activated_at",
        "sector_count"
      ],
      "title": "RealtimeCatalog",
      "type": "object"
    },
    "RealtimeCursorPagination": {
      "properties": {
        "limit": {
          "title": "Limit",
          "type": "integer"
        },
        "has_more": {
          "description": "是否仍有更早的实时材料。",
          "title": "Has More",
          "type": "boolean"
        },
        "next_cursor": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "下一页不透明游标；调用方必须原样传回。",
          "title": "Next Cursor"
        }
      },
      "required": [
        "limit",
        "has_more"
      ],
      "title": "RealtimeCursorPagination",
      "type": "object"
    },
    "RealtimeSummary": {
      "properties": {
        "material_count": {
          "title": "Material Count",
          "type": "integer"
        },
        "policy_material_count": {
          "title": "Policy Material Count",
          "type": "integer"
        },
        "media_material_count": {
          "title": "Media Material Count",
          "type": "integer"
        },
        "market_attention_material_count": {
          "title": "Market Attention Material Count",
          "type": "integer"
        },
        "sector_count": {
          "title": "Sector Count",
          "type": "integer"
        },
        "new_signal_sector_count": {
          "title": "New Signal Sector Count",
          "type": "integer"
        },
        "multi_source_sector_count": {
          "title": "Multi Source Sector Count",
          "type": "integer"
        },
        "pressure_sector_count": {
          "title": "Pressure Sector Count",
          "type": "integer"
        }
      },
      "required": [
        "material_count",
        "policy_material_count",
        "media_material_count",
        "market_attention_material_count",
        "sector_count",
        "new_signal_sector_count",
        "multi_source_sector_count",
        "pressure_sector_count"
      ],
      "title": "RealtimeSummary",
      "type": "object"
    },
    "RealtimeSectorDelta": {
      "properties": {
        "sector_id": {
          "title": "Sector Id",
          "type": "string"
        },
        "sector_name": {
          "title": "Sector Name",
          "type": "string"
        },
        "layer": {
          "title": "Layer",
          "type": "string"
        },
        "signals": {
          "items": {
            "enum": [
              "new_signal",
              "strengthening",
              "multi_source",
              "pressure",
              "mixed",
              "steady"
            ],
            "type": "string"
          },
          "title": "Signals",
          "type": "array"
        },
        "attention_score": {
          "description": "当前滚动窗口内政策、权威媒体与即时市场关注的综合强度。",
          "title": "Attention Score",
          "type": "number"
        },
        "policy_score": {
          "description": "当前滚动窗口内的政策材料强度。",
          "title": "Policy Score",
          "type": "number"
        },
        "media_score": {
          "description": "当前滚动窗口内的权威媒体材料强度。",
          "title": "Media Score",
          "type": "number"
        },
        "market_attention_score": {
          "description": "当前滚动窗口内即时财经材料形成的市场关注强度。",
          "title": "Market Attention Score",
          "type": "number"
        },
        "previous_attention_score": {
          "default": 0.0,
          "description": "前一个等长窗口的综合关注强度。",
          "title": "Previous Attention Score",
          "type": "number"
        },
        "previous_policy_score": {
          "default": 0.0,
          "description": "前一个等长窗口的政策材料强度。",
          "title": "Previous Policy Score",
          "type": "number"
        },
        "previous_media_score": {
          "default": 0.0,
          "description": "前一个等长窗口的媒体材料强度。",
          "title": "Previous Media Score",
          "type": "number"
        },
        "previous_market_attention_score": {
          "default": 0.0,
          "description": "前一个等长窗口的即时市场关注强度。",
          "title": "Previous Market Attention Score",
          "type": "number"
        },
        "attention_change": {
          "default": 0.0,
          "description": "当前综合关注强度相对前一个等长窗口的变化。",
          "title": "Attention Change",
          "type": "number"
        },
        "policy_change": {
          "default": 0.0,
          "description": "当前政策强度相对前一个等长窗口的变化。",
          "title": "Policy Change",
          "type": "number"
        },
        "media_change": {
          "default": 0.0,
          "description": "当前媒体强度相对前一个等长窗口的变化。",
          "title": "Media Change",
          "type": "number"
        },
        "market_attention_change": {
          "default": 0.0,
          "description": "当前即时市场关注强度相对前一个等长窗口的变化。",
          "title": "Market Attention Change",
          "type": "number"
        },
        "previous_material_count": {
          "default": 0,
          "title": "Previous Material Count",
          "type": "integer"
        },
        "direction_balance": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Direction Balance"
        },
        "direction_coverage": {
          "default": 0.0,
          "title": "Direction Coverage",
          "type": "number"
        },
        "material_count": {
          "title": "Material Count",
          "type": "integer"
        },
        "policy_material_count": {
          "title": "Policy Material Count",
          "type": "integer"
        },
        "media_material_count": {
          "title": "Media Material Count",
          "type": "integer"
        },
        "market_attention_material_count": {
          "title": "Market Attention Material Count",
          "type": "integer"
        },
        "source_count": {
          "title": "Source Count",
          "type": "integer"
        },
        "positive_material_count": {
          "title": "Positive Material Count",
          "type": "integer"
        },
        "negative_material_count": {
          "title": "Negative Material Count",
          "type": "integer"
        },
        "neutral_material_count": {
          "title": "Neutral Material Count",
          "type": "integer"
        },
        "latest_signal_at": {
          "title": "Latest Signal At",
          "type": "string"
        },
        "material_ids": {
          "items": {
            "type": "string"
          },
          "title": "Material Ids",
          "type": "array"
        },
        "references": {
          "items": {
            "$ref": "#/$defs/RealtimeMaterialReference"
          },
          "title": "References",
          "type": "array"
        }
      },
      "required": [
        "sector_id",
        "sector_name",
        "layer",
        "attention_score",
        "policy_score",
        "media_score",
        "market_attention_score",
        "material_count",
        "policy_material_count",
        "media_material_count",
        "market_attention_material_count",
        "source_count",
        "positive_material_count",
        "negative_material_count",
        "neutral_material_count",
        "latest_signal_at"
      ],
      "title": "RealtimeSectorDelta",
      "type": "object"
    },
    "RealtimeMaterialReference": {
      "properties": {
        "material_id": {
          "title": "Material Id",
          "type": "string"
        },
        "channel": {
          "enum": [
            "policy",
            "media",
            "market_attention"
          ],
          "title": "Channel",
          "type": "string"
        },
        "source_id": {
          "title": "Source Id",
          "type": "string"
        },
        "source_name": {
          "title": "Source Name",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "url": {
          "title": "Url",
          "type": "string"
        },
        "signal_ready_at": {
          "title": "Signal Ready At",
          "type": "string"
        },
        "evidence_id": {
          "default": "",
          "title": "Evidence Id",
          "type": "string"
        },
        "viewpoint": {
          "default": "",
          "title": "Viewpoint",
          "type": "string"
        },
        "rationale": {
          "default": "",
          "title": "Rationale",
          "type": "string"
        },
        "impact_direction": {
          "default": "unknown",
          "title": "Impact Direction",
          "type": "string"
        },
        "direction_score": {
          "default": 0.0,
          "title": "Direction Score",
          "type": "number"
        }
      },
      "required": [
        "material_id",
        "channel",
        "source_id",
        "source_name",
        "title",
        "url",
        "signal_ready_at"
      ],
      "title": "RealtimeMaterialReference",
      "type": "object"
    },
    "RealtimeMaterialItem": {
      "properties": {
        "material_id": {
          "title": "Material Id",
          "type": "string"
        },
        "material_ids": {
          "items": {
            "type": "string"
          },
          "title": "Material Ids",
          "type": "array"
        },
        "duplicate_count": {
          "default": 0,
          "title": "Duplicate Count",
          "type": "integer"
        },
        "source_id": {
          "title": "Source Id",
          "type": "string"
        },
        "source_name": {
          "title": "Source Name",
          "type": "string"
        },
        "authority": {
          "title": "Authority",
          "type": "string"
        },
        "source_tier": {
          "title": "Source Tier",
          "type": "string"
        },
        "sources": {
          "items": {
            "$ref": "#/$defs/PolicyMaterialSource"
          },
          "title": "Sources",
          "type": "array"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "url": {
          "title": "Url",
          "type": "string"
        },
        "material_date": {
          "title": "Material Date",
          "type": "string"
        },
        "doc_no": {
          "default": "",
          "title": "Doc No",
          "type": "string"
        },
        "first_seen_at": {
          "title": "First Seen At",
          "type": "string"
        },
        "signal_ready_at": {
          "default": "",
          "description": "正文、观点分析和当前板块目录映射全部完成的时间。",
          "title": "Signal Ready At",
          "type": "string"
        },
        "lifecycle_stage": {
          "default": "",
          "title": "Lifecycle Stage",
          "type": "string"
        },
        "lifecycle_status": {
          "default": "",
          "title": "Lifecycle Status",
          "type": "string"
        },
        "evidence_count": {
          "default": 0,
          "title": "Evidence Count",
          "type": "integer"
        },
        "sector_count": {
          "default": 0,
          "title": "Sector Count",
          "type": "integer"
        },
        "results": {
          "items": {
            "$ref": "#/$defs/PolicyMaterialResult"
          },
          "title": "Results",
          "type": "array"
        },
        "channel": {
          "enum": [
            "policy",
            "media",
            "market_attention"
          ],
          "title": "Channel",
          "type": "string"
        }
      },
      "required": [
        "material_id",
        "source_id",
        "source_name",
        "authority",
        "source_tier",
        "title",
        "url",
        "material_date",
        "first_seen_at",
        "channel"
      ],
      "title": "RealtimeMaterialItem",
      "type": "object"
    },
    "RealtimeWindow": {
      "properties": {
        "kind": {
          "const": "rolling",
          "default": "rolling",
          "title": "Kind",
          "type": "string"
        },
        "duration": {
          "description": "当前滚动窗口长度。",
          "enum": [
            "1h",
            "6h",
            "24h",
            "3d"
          ],
          "title": "Duration",
          "type": "string"
        },
        "timezone": {
          "default": "Asia/Shanghai",
          "title": "Timezone",
          "type": "string"
        },
        "start": {
          "description": "当前窗口起点，包含该时刻。",
          "title": "Start",
          "type": "string"
        },
        "end": {
          "description": "当前窗口终点，不包含该时刻。",
          "title": "End",
          "type": "string"
        },
        "previous_start": {
          "description": "前一个等长窗口起点。",
          "title": "Previous Start",
          "type": "string"
        },
        "previous_end": {
          "description": "前一个等长窗口终点。",
          "title": "Previous End",
          "type": "string"
        }
      },
      "required": [
        "duration",
        "start",
        "end",
        "previous_start",
        "previous_end"
      ],
      "title": "RealtimeWindow",
      "type": "object"
    },
    "RealtimeEventSummary": {
      "properties": {
        "material_count": {
          "title": "Material Count",
          "type": "integer"
        },
        "policy_material_count": {
          "title": "Policy Material Count",
          "type": "integer"
        },
        "media_material_count": {
          "title": "Media Material Count",
          "type": "integer"
        },
        "market_attention_material_count": {
          "title": "Market Attention Material Count",
          "type": "integer"
        }
      },
      "required": [
        "material_count",
        "policy_material_count",
        "media_material_count",
        "market_attention_material_count"
      ],
      "title": "RealtimeEventSummary",
      "type": "object"
    },
    "HeatItem": {
      "properties": {
        "sector_id": {
          "title": "Sector Id",
          "type": "string"
        },
        "sector_name": {
          "title": "Sector Name",
          "type": "string"
        },
        "layer": {
          "title": "Layer",
          "type": "string"
        },
        "status": {
          "title": "Status",
          "type": "string"
        },
        "view": {
          "enum": [
            "policy",
            "market_attention",
            "market_trading"
          ],
          "title": "View",
          "type": "string"
        },
        "heat_level": {
          "title": "Heat Level",
          "type": "number"
        },
        "heat_momentum": {
          "title": "Heat Momentum",
          "type": "number"
        },
        "contribution_count": {
          "title": "Contribution Count",
          "type": "integer"
        },
        "evidence_count": {
          "title": "Evidence Count",
          "type": "integer"
        },
        "by_signal": {
          "additionalProperties": {
            "type": "number"
          },
          "title": "By Signal",
          "type": "object"
        }
      },
      "required": [
        "sector_id",
        "sector_name",
        "layer",
        "status",
        "view",
        "heat_level",
        "heat_momentum",
        "contribution_count",
        "evidence_count"
      ],
      "title": "HeatItem",
      "type": "object"
    },
    "TradingSummary": {
      "properties": {
        "trade_date": {
          "title": "Trade Date",
          "type": "string"
        },
        "provider": {
          "title": "Provider",
          "type": "string"
        },
        "formula_version": {
          "title": "Formula Version",
          "type": "string"
        },
        "confirmation_score": {
          "title": "Confirmation Score",
          "type": "number"
        },
        "momentum": {
          "title": "Momentum",
          "type": "number"
        },
        "activity_score": {
          "title": "Activity Score",
          "type": "number"
        },
        "buying_pressure": {
          "title": "Buying Pressure",
          "type": "number"
        },
        "liquidity_score": {
          "title": "Liquidity Score",
          "type": "number"
        },
        "trading_intensity": {
          "default": 0.0,
          "title": "Trading Intensity",
          "type": "number"
        },
        "direction_score": {
          "default": 0.0,
          "title": "Direction Score",
          "type": "number"
        },
        "direction_coverage": {
          "default": 0.0,
          "title": "Direction Coverage",
          "type": "number"
        },
        "direction_momentum": {
          "default": 0.0,
          "title": "Direction Momentum",
          "type": "number"
        },
        "positive_score": {
          "default": 0.0,
          "title": "Positive Score",
          "type": "number"
        },
        "negative_score": {
          "default": 0.0,
          "title": "Negative Score",
          "type": "number"
        },
        "neutral_score": {
          "default": 0.0,
          "title": "Neutral Score",
          "type": "number"
        },
        "breadth_score": {
          "title": "Breadth Score",
          "type": "number"
        },
        "confidence": {
          "title": "Confidence",
          "type": "number"
        },
        "mapped_stock_count": {
          "title": "Mapped Stock Count",
          "type": "integer"
        },
        "covered_stock_count": {
          "title": "Covered Stock Count",
          "type": "integer"
        },
        "coverage_ratio": {
          "title": "Coverage Ratio",
          "type": "number"
        },
        "concentration": {
          "title": "Concentration",
          "type": "number"
        },
        "confirmed_mapped_stock_count": {
          "default": 0,
          "title": "Confirmed Mapped Stock Count",
          "type": "integer"
        },
        "candidate_mapped_stock_count": {
          "default": 0,
          "title": "Candidate Mapped Stock Count",
          "type": "integer"
        },
        "confirmed_covered_stock_count": {
          "default": 0,
          "title": "Confirmed Covered Stock Count",
          "type": "integer"
        },
        "candidate_covered_stock_count": {
          "default": 0,
          "title": "Candidate Covered Stock Count",
          "type": "integer"
        },
        "confirmed_coverage_ratio": {
          "default": 0.0,
          "title": "Confirmed Coverage Ratio",
          "type": "number"
        },
        "candidate_coverage_ratio": {
          "default": 0.0,
          "title": "Candidate Coverage Ratio",
          "type": "number"
        },
        "confirmed_sample_share": {
          "default": 0.0,
          "title": "Confirmed Sample Share",
          "type": "number"
        },
        "candidate_sample_share": {
          "default": 0.0,
          "title": "Candidate Sample Share",
          "type": "number"
        },
        "confirmed_weight_share": {
          "default": 0.0,
          "title": "Confirmed Weight Share",
          "type": "number"
        },
        "candidate_weight_share": {
          "default": 0.0,
          "title": "Candidate Weight Share",
          "type": "number"
        },
        "candidate_weight_cap": {
          "default": 0.0,
          "title": "Candidate Weight Cap",
          "type": "number"
        },
        "effective_sample_size": {
          "default": 0.0,
          "title": "Effective Sample Size",
          "type": "number"
        },
        "mapping_support": {
          "default": 0.0,
          "title": "Mapping Support",
          "type": "number"
        }
      },
      "required": [
        "trade_date",
        "provider",
        "formula_version",
        "confirmation_score",
        "momentum",
        "activity_score",
        "buying_pressure",
        "liquidity_score",
        "breadth_score",
        "confidence",
        "mapped_stock_count",
        "covered_stock_count",
        "coverage_ratio",
        "concentration"
      ],
      "title": "TradingSummary",
      "type": "object"
    },
    "TradingContributor": {
      "properties": {
        "stock_code": {
          "title": "Stock Code",
          "type": "string"
        },
        "stock_name": {
          "title": "Stock Name",
          "type": "string"
        },
        "exchange": {
          "title": "Exchange",
          "type": "string"
        },
        "board": {
          "title": "Board",
          "type": "string"
        },
        "relation_id": {
          "title": "Relation Id",
          "type": "string"
        },
        "relation_type": {
          "enum": [
            "business",
            "market"
          ],
          "title": "Relation Type",
          "type": "string"
        },
        "mapping_status": {
          "default": "",
          "title": "Mapping Status",
          "type": "string"
        },
        "mapping_weight": {
          "title": "Mapping Weight",
          "type": "number"
        },
        "aggregation_weight": {
          "title": "Aggregation Weight",
          "type": "number"
        },
        "status_weight": {
          "default": 0.0,
          "title": "Status Weight",
          "type": "number"
        },
        "relation_weight": {
          "default": 0.0,
          "title": "Relation Weight",
          "type": "number"
        },
        "effective_weight": {
          "default": 0.0,
          "title": "Effective Weight",
          "type": "number"
        },
        "impact_direction": {
          "default": "neutral",
          "enum": [
            "positive",
            "negative",
            "neutral"
          ],
          "title": "Impact Direction",
          "type": "string"
        },
        "amount": {
          "title": "Amount",
          "type": "number"
        },
        "pct_change": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Pct Change"
        },
        "activity_score": {
          "title": "Activity Score",
          "type": "number"
        },
        "buying_pressure": {
          "title": "Buying Pressure",
          "type": "number"
        },
        "liquidity_score": {
          "title": "Liquidity Score",
          "type": "number"
        },
        "trading_intensity": {
          "default": 0.0,
          "title": "Trading Intensity",
          "type": "number"
        },
        "direction_score": {
          "default": 0.0,
          "title": "Direction Score",
          "type": "number"
        },
        "direction_coverage": {
          "default": 0.0,
          "title": "Direction Coverage",
          "type": "number"
        },
        "confirmation_score": {
          "title": "Confirmation Score",
          "type": "number"
        },
        "contribution_score": {
          "title": "Contribution Score",
          "type": "number"
        },
        "directional_contribution": {
          "default": 0.0,
          "title": "Directional Contribution",
          "type": "number"
        },
        "confidence": {
          "title": "Confidence",
          "type": "number"
        }
      },
      "required": [
        "stock_code",
        "stock_name",
        "exchange",
        "board",
        "relation_id",
        "relation_type",
        "mapping_weight",
        "aggregation_weight",
        "amount",
        "activity_score",
        "buying_pressure",
        "liquidity_score",
        "confirmation_score",
        "contribution_score",
        "confidence"
      ],
      "title": "TradingContributor",
      "type": "object"
    },
    "SecurityLifecycleCoverage": {
      "properties": {
        "last_verified_at": {
          "default": "",
          "title": "Last Verified At",
          "type": "string"
        },
        "listed_exchanges": {
          "items": {
            "type": "string"
          },
          "title": "Listed Exchanges",
          "type": "array"
        },
        "delisted_exchanges": {
          "items": {
            "type": "string"
          },
          "title": "Delisted Exchanges",
          "type": "array"
        },
        "prelisting_sources": {
          "items": {
            "type": "string"
          },
          "title": "Prelisting Sources",
          "type": "array"
        },
        "degraded_sources": {
          "items": {
            "type": "string"
          },
          "title": "Degraded Sources",
          "type": "array"
        },
        "sources": {
          "items": {
            "$ref": "#/$defs/SecurityLifecycleSourceHealth"
          },
          "title": "Sources",
          "type": "array"
        }
      },
      "title": "SecurityLifecycleCoverage",
      "type": "object"
    },
    "SecurityLifecycleSourceHealth": {
      "properties": {
        "source_id": {
          "title": "Source Id",
          "type": "string"
        },
        "exchange": {
          "title": "Exchange",
          "type": "string"
        },
        "status": {
          "title": "Status",
          "type": "string"
        },
        "row_count": {
          "title": "Row Count",
          "type": "integer"
        },
        "last_success_at": {
          "default": "",
          "title": "Last Success At",
          "type": "string"
        }
      },
      "required": [
        "source_id",
        "exchange",
        "status",
        "row_count"
      ],
      "title": "SecurityLifecycleSourceHealth",
      "type": "object"
    },
    "SecurityLifecycleSectorImpact": {
      "properties": {
        "sector_id": {
          "title": "Sector Id",
          "type": "string"
        },
        "sector_name": {
          "title": "Sector Name",
          "type": "string"
        },
        "sector_layer": {
          "default": "",
          "title": "Sector Layer",
          "type": "string"
        },
        "event_count": {
          "title": "Event Count",
          "type": "integer"
        },
        "effective_count": {
          "title": "Effective Count",
          "type": "integer"
        },
        "preview_count": {
          "title": "Preview Count",
          "type": "integer"
        },
        "historical_count": {
          "title": "Historical Count",
          "type": "integer"
        },
        "stock_codes": {
          "items": {
            "type": "string"
          },
          "title": "Stock Codes",
          "type": "array"
        },
        "stock_names": {
          "items": {
            "type": "string"
          },
          "title": "Stock Names",
          "type": "array"
        }
      },
      "required": [
        "sector_id",
        "sector_name",
        "event_count",
        "effective_count",
        "preview_count",
        "historical_count"
      ],
      "title": "SecurityLifecycleSectorImpact",
      "type": "object"
    },
    "SecurityLifecycleItem": {
      "properties": {
        "stock_code": {
          "title": "Stock Code",
          "type": "string"
        },
        "stock_name": {
          "title": "Stock Name",
          "type": "string"
        },
        "company_name": {
          "default": "",
          "title": "Company Name",
          "type": "string"
        },
        "exchange": {
          "enum": [
            "SSE",
            "SZSE",
            "BSE"
          ],
          "title": "Exchange",
          "type": "string"
        },
        "board": {
          "title": "Board",
          "type": "string"
        },
        "lifecycle_status": {
          "enum": [
            "prelisted",
            "listed",
            "delisted",
            "cancelled"
          ],
          "title": "Lifecycle Status",
          "type": "string"
        },
        "lifecycle_stage": {
          "title": "Lifecycle Stage",
          "type": "string"
        },
        "status_effective_date": {
          "title": "Status Effective Date",
          "type": "string"
        },
        "planned_listing_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Planned Listing Date"
        },
        "listing_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Listing Date"
        },
        "delisting_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Delisting Date"
        },
        "first_seen_at": {
          "title": "First Seen At",
          "type": "string"
        },
        "last_seen_at": {
          "title": "Last Seen At",
          "type": "string"
        },
        "source_id": {
          "title": "Source Id",
          "type": "string"
        },
        "source_url": {
          "default": "",
          "title": "Source Url",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        },
        "evidence_count": {
          "default": 0,
          "title": "Evidence Count",
          "type": "integer"
        },
        "latest_evidence": {
          "anyOf": [
            {
              "$ref": "#/$defs/SecurityLifecycleEvidence"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "sector_count": {
          "default": 0,
          "title": "Sector Count",
          "type": "integer"
        },
        "sectors": {
          "items": {
            "$ref": "#/$defs/SecurityLifecycleSector"
          },
          "title": "Sectors",
          "type": "array"
        }
      },
      "required": [
        "stock_code",
        "stock_name",
        "exchange",
        "board",
        "lifecycle_status",
        "lifecycle_stage",
        "status_effective_date",
        "first_seen_at",
        "last_seen_at",
        "source_id",
        "reason"
      ],
      "title": "SecurityLifecycleItem",
      "type": "object"
    },
    "SecurityLifecycleEvidence": {
      "properties": {
        "evidence_id": {
          "title": "Evidence Id",
          "type": "string"
        },
        "source_id": {
          "title": "Source Id",
          "type": "string"
        },
        "evidence_type": {
          "title": "Evidence Type",
          "type": "string"
        },
        "effective_date": {
          "title": "Effective Date",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "source_url": {
          "default": "",
          "title": "Source Url",
          "type": "string"
        },
        "observed_at": {
          "title": "Observed At",
          "type": "string"
        }
      },
      "required": [
        "evidence_id",
        "source_id",
        "evidence_type",
        "effective_date",
        "title",
        "observed_at"
      ],
      "title": "SecurityLifecycleEvidence",
      "type": "object"
    },
    "SecurityLifecycleSector": {
      "properties": {
        "relation_id": {
          "title": "Relation Id",
          "type": "string"
        },
        "sector_id": {
          "title": "Sector Id",
          "type": "string"
        },
        "sector_name": {
          "title": "Sector Name",
          "type": "string"
        },
        "sector_layer": {
          "default": "",
          "title": "Sector Layer",
          "type": "string"
        },
        "relation_type": {
          "enum": [
            "business",
            "market"
          ],
          "title": "Relation Type",
          "type": "string"
        },
        "relation_status": {
          "title": "Relation Status",
          "type": "string"
        },
        "score": {
          "title": "Score",
          "type": "number"
        },
        "confidence": {
          "title": "Confidence",
          "type": "number"
        },
        "evidence_count": {
          "default": 0,
          "title": "Evidence Count",
          "type": "integer"
        },
        "mapping_state": {
          "enum": [
            "preview",
            "effective",
            "historical"
          ],
          "title": "Mapping State",
          "type": "string"
        }
      },
      "required": [
        "relation_id",
        "sector_id",
        "sector_name",
        "relation_type",
        "relation_status",
        "score",
        "confidence",
        "mapping_state"
      ],
      "title": "SecurityLifecycleSector",
      "type": "object"
    },
    "SecurityLifecycleSummary": {
      "properties": {
        "prelisted": {
          "title": "Prelisted",
          "type": "integer"
        },
        "recent_listed": {
          "title": "Recent Listed",
          "type": "integer"
        },
        "recent_departures": {
          "title": "Recent Departures",
          "type": "integer"
        }
      },
      "required": [
        "prelisted",
        "recent_listed",
        "recent_departures"
      ],
      "title": "SecurityLifecycleSummary",
      "type": "object"
    },
    "SecurityLifecycleChange": {
      "properties": {
        "history_id": {
          "title": "History Id",
          "type": "string"
        },
        "stock_code": {
          "title": "Stock Code",
          "type": "string"
        },
        "stock_name": {
          "default": "",
          "title": "Stock Name",
          "type": "string"
        },
        "exchange": {
          "default": "",
          "title": "Exchange",
          "type": "string"
        },
        "board": {
          "default": "",
          "title": "Board",
          "type": "string"
        },
        "previous_status": {
          "default": "",
          "title": "Previous Status",
          "type": "string"
        },
        "new_status": {
          "enum": [
            "prelisted",
            "listed",
            "delisted",
            "cancelled"
          ],
          "title": "New Status",
          "type": "string"
        },
        "effective_date": {
          "title": "Effective Date",
          "type": "string"
        },
        "listing_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Listing Date"
        },
        "source_id": {
          "title": "Source Id",
          "type": "string"
        },
        "source_url": {
          "default": "",
          "title": "Source Url",
          "type": "string"
        },
        "reason": {
          "title": "Reason",
          "type": "string"
        },
        "changed_at": {
          "title": "Changed At",
          "type": "string"
        }
      },
      "required": [
        "history_id",
        "stock_code",
        "new_status",
        "effective_date",
        "source_id",
        "reason",
        "changed_at"
      ],
      "title": "SecurityLifecycleChange",
      "type": "object"
    },
    "CompanySearchItem": {
      "properties": {
        "stock_code": {
          "title": "Stock Code",
          "type": "string"
        },
        "stock_name": {
          "title": "Stock Name",
          "type": "string"
        },
        "company_name": {
          "default": "",
          "title": "Company Name",
          "type": "string"
        },
        "market": {
          "const": "stock:cn",
          "default": "stock:cn",
          "title": "Market",
          "type": "string"
        },
        "exchange": {
          "enum": [
            "SSE",
            "SZSE",
            "BSE"
          ],
          "title": "Exchange",
          "type": "string"
        },
        "board": {
          "title": "Board",
          "type": "string"
        },
        "lifecycle_status": {
          "enum": [
            "prelisted",
            "listed",
            "delisted",
            "cancelled"
          ],
          "title": "Lifecycle Status",
          "type": "string"
        },
        "planned_listing_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Planned Listing Date"
        },
        "listing_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Listing Date"
        },
        "delisting_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Delisting Date"
        },
        "match_type": {
          "description": "搜索命中类型；精确匹配和前缀匹配优先。",
          "enum": [
            "exact_code",
            "exact_stock_name",
            "exact_company_name",
            "code_prefix",
            "stock_name_prefix",
            "company_name_prefix",
            "contains"
          ],
          "title": "Match Type",
          "type": "string"
        },
        "sector_count": {
          "default": 0,
          "title": "Sector Count",
          "type": "integer"
        },
        "sectors": {
          "items": {
            "$ref": "#/$defs/CompanySearchSector"
          },
          "title": "Sectors",
          "type": "array"
        }
      },
      "required": [
        "stock_code",
        "stock_name",
        "exchange",
        "board",
        "lifecycle_status",
        "match_type"
      ],
      "title": "CompanySearchItem",
      "type": "object"
    },
    "CompanySearchSector": {
      "properties": {
        "relation_id": {
          "title": "Relation Id",
          "type": "string"
        },
        "sector_id": {
          "title": "Sector Id",
          "type": "string"
        },
        "sector_name": {
          "title": "Sector Name",
          "type": "string"
        },
        "sector_layer": {
          "default": "",
          "title": "Sector Layer",
          "type": "string"
        },
        "relation_type": {
          "enum": [
            "business",
            "market"
          ],
          "title": "Relation Type",
          "type": "string"
        },
        "relation_status": {
          "title": "Relation Status",
          "type": "string"
        },
        "score": {
          "title": "Score",
          "type": "number"
        },
        "confidence": {
          "title": "Confidence",
          "type": "number"
        },
        "evidence_count": {
          "default": 0,
          "title": "Evidence Count",
          "type": "integer"
        },
        "mapping_state": {
          "enum": [
            "preview",
            "effective",
            "historical"
          ],
          "title": "Mapping State",
          "type": "string"
        }
      },
      "required": [
        "relation_id",
        "sector_id",
        "sector_name",
        "relation_type",
        "relation_status",
        "score",
        "confidence",
        "mapping_state"
      ],
      "title": "CompanySearchSector",
      "type": "object"
    },
    "CompanySectorRelation": {
      "properties": {
        "relation_id": {
          "title": "Relation Id",
          "type": "string"
        },
        "stock_code": {
          "title": "Stock Code",
          "type": "string"
        },
        "stock_name": {
          "title": "Stock Name",
          "type": "string"
        },
        "market": {
          "default": "stock:cn",
          "title": "Market",
          "type": "string"
        },
        "exchange": {
          "title": "Exchange",
          "type": "string"
        },
        "board": {
          "title": "Board",
          "type": "string"
        },
        "sector_id": {
          "title": "Sector Id",
          "type": "string"
        },
        "sector_name": {
          "title": "Sector Name",
          "type": "string"
        },
        "sector_layer": {
          "title": "Sector Layer",
          "type": "string"
        },
        "relation_type": {
          "enum": [
            "business",
            "market"
          ],
          "title": "Relation Type",
          "type": "string"
        },
        "status": {
          "title": "Status",
          "type": "string"
        },
        "score": {
          "title": "Score",
          "type": "number"
        },
        "confidence": {
          "title": "Confidence",
          "type": "number"
        },
        "first_seen": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "First Seen"
        },
        "last_confirmed": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Last Confirmed"
        },
        "valid_from": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Valid From"
        },
        "valid_to": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Valid To"
        },
        "evidence_count": {
          "default": 0,
          "title": "Evidence Count",
          "type": "integer"
        },
        "mapping_explanation": {
          "anyOf": [
            {
              "$ref": "#/$defs/MappingExplanation"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "lifecycle_status": {
          "default": "listed",
          "enum": [
            "prelisted",
            "listed",
            "delisted",
            "cancelled",
            "unknown"
          ],
          "title": "Lifecycle Status",
          "type": "string"
        },
        "listing_date": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Listing Date"
        },
        "market_data_status": {
          "default": "ready",
          "enum": [
            "ready",
            "pending",
            "missing",
            "unavailable"
          ],
          "title": "Market Data Status",
          "type": "string"
        }
      },
      "required": [
        "relation_id",
        "stock_code",
        "stock_name",
        "exchange",
        "board",
        "sector_id",
        "sector_name",
        "sector_layer",
        "relation_type",
        "status",
        "score",
        "confidence"
      ],
      "title": "CompanySectorRelation",
      "type": "object"
    },
    "MappingExplanation": {
      "properties": {
        "fact": {
          "default": "",
          "title": "Fact",
          "type": "string"
        },
        "logic": {
          "default": "",
          "title": "Logic",
          "type": "string"
        },
        "participation_summary": {
          "default": "",
          "title": "Participation Summary",
          "type": "string"
        },
        "boundary_note": {
          "default": "",
          "title": "Boundary Note",
          "type": "string"
        },
        "conclusion": {
          "default": "",
          "title": "Conclusion",
          "type": "string"
        },
        "participation_basis": {
          "default": "",
          "title": "Participation Basis",
          "type": "string"
        }
      },
      "title": "MappingExplanation",
      "type": "object"
    },
    "EtfSummary": {
      "additionalProperties": false,
      "properties": {
        "etf_key": {
          "title": "Etf Key",
          "type": "string"
        },
        "fund_code": {
          "title": "Fund Code",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        },
        "full_name": {
          "default": "",
          "title": "Full Name",
          "type": "string"
        },
        "manager": {
          "default": "",
          "title": "Manager",
          "type": "string"
        },
        "market": {
          "const": "fund:cn",
          "default": "fund:cn",
          "title": "Market",
          "type": "string"
        },
        "exchange": {
          "enum": [
            "SSE",
            "SZSE"
          ],
          "title": "Exchange",
          "type": "string"
        },
        "product_scope": {
          "enum": [
            "broad",
            "sector"
          ],
          "title": "Product Scope",
          "type": "string"
        },
        "product_status": {
          "enum": [
            "active",
            "inactive"
          ],
          "title": "Product Status",
          "type": "string"
        },
        "tracking_index_code": {
          "default": "",
          "title": "Tracking Index Code",
          "type": "string"
        },
        "tracking_index_name": {
          "default": "",
          "title": "Tracking Index Name",
          "type": "string"
        },
        "tracking_group_id": {
          "default": "",
          "title": "Tracking Group Id",
          "type": "string"
        },
        "basket_date": {
          "title": "Basket Date",
          "type": "string"
        },
        "basket_freshness_status": {
          "default": "unknown",
          "description": "本轮 ETF 篮子的核验或获取状态。",
          "enum": [
            "refreshed",
            "verified_unchanged",
            "carried_forward",
            "unknown"
          ],
          "title": "Basket Freshness Status",
          "type": "string"
        },
        "basket_age_days": {
          "default": 0,
          "description": "篮子业务日期距快照业务日期的自然日数。",
          "minimum": 0,
          "title": "Basket Age Days",
          "type": "integer"
        },
        "basket_checked_as_of": {
          "default": "",
          "description": "最近一次向交易所产品目录核验篮子日期的日期。",
          "title": "Basket Checked As Of",
          "type": "string"
        },
        "catalog_verified": {
          "default": false,
          "description": "本轮是否已经通过交易所产品目录核验。",
          "title": "Catalog Verified",
          "type": "boolean"
        },
        "content_changed": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "本轮重新获取 PCF 后，篮子内容是否发生变化。",
          "title": "Content Changed"
        },
        "source_fetched_at": {
          "default": "",
          "description": "当前使用的 PCF 原文实际获取时间。",
          "title": "Source Fetched At",
          "type": "string"
        },
        "relation_count": {
          "default": 0,
          "title": "Relation Count",
          "type": "integer"
        },
        "top_sector_id": {
          "default": "",
          "title": "Top Sector Id",
          "type": "string"
        },
        "top_sector_name": {
          "default": "",
          "title": "Top Sector Name",
          "type": "string"
        },
        "top_adjusted_exposure": {
          "default": 0.0,
          "title": "Top Adjusted Exposure",
          "type": "number"
        }
      },
      "required": [
        "etf_key",
        "fund_code",
        "name",
        "exchange",
        "product_scope",
        "product_status",
        "basket_date"
      ],
      "title": "EtfSummary",
      "type": "object"
    },
    "EtfDetail": {
      "additionalProperties": false,
      "properties": {
        "etf_key": {
          "title": "Etf Key",
          "type": "string"
        },
        "fund_code": {
          "title": "Fund Code",
          "type": "string"
        },
        "name": {
          "title": "Name",
          "type": "string"
        },
        "full_name": {
          "default": "",
          "title": "Full Name",
          "type": "string"
        },
        "manager": {
          "default": "",
          "title": "Manager",
          "type": "string"
        },
        "market": {
          "const": "fund:cn",
          "default": "fund:cn",
          "title": "Market",
          "type": "string"
        },
        "exchange": {
          "enum": [
            "SSE",
            "SZSE"
          ],
          "title": "Exchange",
          "type": "string"
        },
        "product_scope": {
          "enum": [
            "broad",
            "sector"
          ],
          "title": "Product Scope",
          "type": "string"
        },
        "product_status": {
          "enum": [
            "active",
            "inactive"
          ],
          "title": "Product Status",
          "type": "string"
        },
        "tracking_index_code": {
          "default": "",
          "title": "Tracking Index Code",
          "type": "string"
        },
        "tracking_index_name": {
          "default": "",
          "title": "Tracking Index Name",
          "type": "string"
        },
        "tracking_group_id": {
          "default": "",
          "title": "Tracking Group Id",
          "type": "string"
        },
        "basket_date": {
          "title": "Basket Date",
          "type": "string"
        },
        "basket_freshness_status": {
          "default": "unknown",
          "description": "本轮 ETF 篮子的核验或获取状态。",
          "enum": [
            "refreshed",
            "verified_unchanged",
            "carried_forward",
            "unknown"
          ],
          "title": "Basket Freshness Status",
          "type": "string"
        },
        "basket_age_days": {
          "default": 0,
          "description": "篮子业务日期距快照业务日期的自然日数。",
          "minimum": 0,
          "title": "Basket Age Days",
          "type": "integer"
        },
        "basket_checked_as_of": {
          "default": "",
          "description": "最近一次向交易所产品目录核验篮子日期的日期。",
          "title": "Basket Checked As Of",
          "type": "string"
        },
        "catalog_verified": {
          "default": false,
          "description": "本轮是否已经通过交易所产品目录核验。",
          "title": "Catalog Verified",
          "type": "boolean"
        },
        "content_changed": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "本轮重新获取 PCF 后，篮子内容是否发生变化。",
          "title": "Content Changed"
        },
        "source_fetched_at": {
          "default": "",
          "description": "当前使用的 PCF 原文实际获取时间。",
          "title": "Source Fetched At",
          "type": "string"
        },
        "relation_count": {
          "default": 0,
          "title": "Relation Count",
          "type": "integer"
        },
        "top_sector_id": {
          "default": "",
          "title": "Top Sector Id",
          "type": "string"
        },
        "top_sector_name": {
          "default": "",
          "title": "Top Sector Name",
          "type": "string"
        },
        "top_adjusted_exposure": {
          "default": 0.0,
          "title": "Top Adjusted Exposure",
          "type": "number"
        },
        "sectors": {
          "items": {
            "$ref": "#/$defs/EtfSectorRelation"
          },
          "title": "Sectors",
          "type": "array"
        }
      },
      "required": [
        "etf_key",
        "fund_code",
        "name",
        "exchange",
        "product_scope",
        "product_status",
        "basket_date"
      ],
      "title": "EtfDetail",
      "type": "object"
    },
    "EtfSectorRelation": {
      "additionalProperties": false,
      "properties": {
        "relation_id": {
          "description": "ETF 与板块关系的稳定标识。",
          "title": "Relation Id",
          "type": "string"
        },
        "etf_key": {
          "title": "Etf Key",
          "type": "string"
        },
        "fund_code": {
          "title": "Fund Code",
          "type": "string"
        },
        "etf_name": {
          "title": "Etf Name",
          "type": "string"
        },
        "exchange": {
          "enum": [
            "SSE",
            "SZSE"
          ],
          "title": "Exchange",
          "type": "string"
        },
        "product_scope": {
          "enum": [
            "broad",
            "sector"
          ],
          "title": "Product Scope",
          "type": "string"
        },
        "tracking_index_code": {
          "default": "",
          "title": "Tracking Index Code",
          "type": "string"
        },
        "tracking_index_name": {
          "default": "",
          "title": "Tracking Index Name",
          "type": "string"
        },
        "tracking_group_id": {
          "default": "",
          "title": "Tracking Group Id",
          "type": "string"
        },
        "sector_id": {
          "title": "Sector Id",
          "type": "string"
        },
        "sector_name": {
          "title": "Sector Name",
          "type": "string"
        },
        "sector_layer": {
          "title": "Sector Layer",
          "type": "string"
        },
        "mapping_type": {
          "enum": [
            "tracking_index",
            "holding_exposure",
            "dynamic_inference",
            "hierarchy_inherited",
            "hierarchy_related",
            "lineage_continuity",
            "semantic_related",
            "hierarchy_reference"
          ],
          "title": "Mapping Type",
          "type": "string"
        },
        "relation_scope": {
          "default": "direct",
          "enum": [
            "direct",
            "extended",
            "related",
            "reference"
          ],
          "title": "Relation Scope",
          "type": "string"
        },
        "source_sector_id": {
          "default": "",
          "title": "Source Sector Id",
          "type": "string"
        },
        "source_sector_name": {
          "default": "",
          "title": "Source Sector Name",
          "type": "string"
        },
        "source_sector_layer": {
          "default": "",
          "title": "Source Sector Layer",
          "type": "string"
        },
        "path": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Path",
          "type": "array"
        },
        "path_depth": {
          "default": 0,
          "title": "Path Depth",
          "type": "integer"
        },
        "path_confidence": {
          "default": 1.0,
          "title": "Path Confidence",
          "type": "number"
        },
        "specificity_score": {
          "default": 1.0,
          "title": "Specificity Score",
          "type": "number"
        },
        "semantic_score": {
          "default": 0.0,
          "title": "Semantic Score",
          "type": "number"
        },
        "direct_child_exposure": {
          "default": 0.0,
          "title": "Direct Child Exposure",
          "type": "number"
        },
        "source_adjusted_exposure": {
          "default": 0.0,
          "title": "Source Adjusted Exposure",
          "type": "number"
        },
        "reference_only": {
          "default": false,
          "title": "Reference Only",
          "type": "boolean"
        },
        "status": {
          "enum": [
            "active",
            "watched",
            "candidate",
            "expired"
          ],
          "title": "Status",
          "type": "string"
        },
        "exposure_ratio": {
          "title": "Exposure Ratio",
          "type": "number"
        },
        "adjusted_exposure": {
          "title": "Adjusted Exposure",
          "type": "number"
        },
        "confidence": {
          "title": "Confidence",
          "type": "number"
        },
        "holdings_coverage": {
          "title": "Holdings Coverage",
          "type": "number"
        },
        "component_count": {
          "title": "Component Count",
          "type": "integer"
        },
        "basket_date": {
          "title": "Basket Date",
          "type": "string"
        },
        "basket_freshness_status": {
          "default": "unknown",
          "description": "本轮 ETF 篮子的核验或获取状态。",
          "enum": [
            "refreshed",
            "verified_unchanged",
            "carried_forward",
            "unknown"
          ],
          "title": "Basket Freshness Status",
          "type": "string"
        },
        "basket_age_days": {
          "default": 0,
          "description": "篮子业务日期距快照业务日期的自然日数。",
          "minimum": 0,
          "title": "Basket Age Days",
          "type": "integer"
        },
        "basket_checked_as_of": {
          "default": "",
          "description": "最近一次向交易所产品目录核验篮子日期的日期。",
          "title": "Basket Checked As Of",
          "type": "string"
        },
        "catalog_verified": {
          "default": false,
          "description": "本轮是否已经通过交易所产品目录核验。",
          "title": "Catalog Verified",
          "type": "boolean"
        },
        "content_changed": {
          "anyOf": [
            {
              "type": "boolean"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "本轮重新获取 PCF 后，篮子内容是否发生变化。",
          "title": "Content Changed"
        },
        "source_fetched_at": {
          "default": "",
          "description": "当前使用的 PCF 原文实际获取时间。",
          "title": "Source Fetched At",
          "type": "string"
        },
        "official_pcf_url": {
          "default": "",
          "title": "Official Pcf Url",
          "type": "string"
        },
        "calculation": {
          "default": "",
          "title": "Calculation",
          "type": "string"
        },
        "top_components": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Top Components",
          "type": "array"
        }
      },
      "required": [
        "relation_id",
        "etf_key",
        "fund_code",
        "etf_name",
        "exchange",
        "product_scope",
        "sector_id",
        "sector_name",
        "sector_layer",
        "mapping_type",
        "status",
        "exposure_ratio",
        "adjusted_exposure",
        "confidence",
        "holdings_coverage",
        "component_count",
        "basket_date"
      ],
      "title": "EtfSectorRelation",
      "type": "object"
    },
    "EtfRelationEvidence": {
      "additionalProperties": false,
      "properties": {
        "evidence_type": {
          "enum": [
            "basket_composition",
            "tracking_index_identity",
            "taxonomy_path"
          ],
          "title": "Evidence Type",
          "type": "string"
        },
        "evidence_id": {
          "title": "Evidence Id",
          "type": "string"
        },
        "source_id": {
          "title": "Source Id",
          "type": "string"
        },
        "evidence_date": {
          "title": "Evidence Date",
          "type": "string"
        },
        "role": {
          "enum": [
            "holding_exposure",
            "source_sector_exposure",
            "tracking_index_match",
            "hierarchy_expansion",
            "hierarchy_related",
            "lineage_continuity",
            "semantic_reference",
            "parent_sector_reference"
          ],
          "title": "Role",
          "type": "string"
        },
        "weight": {
          "title": "Weight",
          "type": "number"
        },
        "official_pcf_url": {
          "default": "",
          "title": "Official Pcf Url",
          "type": "string"
        },
        "basket_id": {
          "default": "",
          "title": "Basket Id",
          "type": "string"
        },
        "basket_component_count": {
          "default": 0,
          "title": "Basket Component Count",
          "type": "integer"
        },
        "calculation": {
          "default": "",
          "title": "Calculation",
          "type": "string"
        },
        "top_components": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Top Components",
          "type": "array"
        },
        "release_id": {
          "default": "",
          "title": "Release Id",
          "type": "string"
        },
        "path": {
          "items": {
            "additionalProperties": true,
            "type": "object"
          },
          "title": "Path",
          "type": "array"
        },
        "path_depth": {
          "default": 0,
          "title": "Path Depth",
          "type": "integer"
        },
        "path_confidence": {
          "default": 0.0,
          "title": "Path Confidence",
          "type": "number"
        },
        "rationale": {
          "default": "",
          "title": "Rationale",
          "type": "string"
        },
        "tracking_index_code": {
          "default": "",
          "title": "Tracking Index Code",
          "type": "string"
        },
        "tracking_index_name": {
          "default": "",
          "title": "Tracking Index Name",
          "type": "string"
        },
        "sector_id": {
          "default": "",
          "title": "Sector Id",
          "type": "string"
        },
        "sector_name": {
          "default": "",
          "title": "Sector Name",
          "type": "string"
        },
        "match": {
          "additionalProperties": true,
          "title": "Match",
          "type": "object"
        }
      },
      "required": [
        "evidence_type",
        "evidence_id",
        "source_id",
        "evidence_date",
        "role",
        "weight"
      ],
      "title": "EtfRelationEvidence",
      "type": "object"
    },
    "EtfCompanySectorContribution": {
      "additionalProperties": false,
      "properties": {
        "contribution_id": {
          "description": "单条 ETF、公司与板块贡献的稳定标识。",
          "title": "Contribution Id",
          "type": "string"
        },
        "relation_id": {
          "description": "ETF 与板块关系的稳定标识。",
          "title": "Relation Id",
          "type": "string"
        },
        "etf_key": {
          "title": "Etf Key",
          "type": "string"
        },
        "basket_id": {
          "title": "Basket Id",
          "type": "string"
        },
        "basket_date": {
          "title": "Basket Date",
          "type": "string"
        },
        "stock_code": {
          "title": "Stock Code",
          "type": "string"
        },
        "stock_name": {
          "default": "",
          "title": "Stock Name",
          "type": "string"
        },
        "sector_id": {
          "title": "Sector Id",
          "type": "string"
        },
        "sector_name": {
          "title": "Sector Name",
          "type": "string"
        },
        "sector_layer": {
          "title": "Sector Layer",
          "type": "string"
        },
        "company_relation_id": {
          "description": "公司与板块关系的稳定标识。",
          "title": "Company Relation Id",
          "type": "string"
        },
        "company_relation_type": {
          "description": "公司关系类型：长期业务关系或短期市场关系。",
          "enum": [
            "business",
            "market"
          ],
          "title": "Company Relation Type",
          "type": "string"
        },
        "company_relation_status": {
          "description": "公司板块关系在当前版本中的状态。",
          "enum": [
            "active",
            "watched",
            "candidate",
            "expired"
          ],
          "title": "Company Relation Status",
          "type": "string"
        },
        "basket_weight": {
          "description": "该公司在 ETF 篮子中的原始权重。",
          "title": "Basket Weight",
          "type": "number"
        },
        "company_relation_score": {
          "description": "公司业务事实与板块定义的关系强度。",
          "title": "Company Relation Score",
          "type": "number"
        },
        "company_relation_confidence": {
          "description": "公司板块关系的证据置信度。",
          "title": "Company Relation Confidence",
          "type": "number"
        },
        "relation_status_factor": {
          "description": "公司关系状态对应的调整因子。",
          "title": "Relation Status Factor",
          "type": "number"
        },
        "relation_type_factor": {
          "description": "公司关系类型对应的调整因子。",
          "title": "Relation Type Factor",
          "type": "number"
        },
        "adjusted_contribution": {
          "description": "该公司对 ETF 板块调整暴露的最终贡献。",
          "title": "Adjusted Contribution",
          "type": "number"
        }
      },
      "required": [
        "contribution_id",
        "relation_id",
        "etf_key",
        "basket_id",
        "basket_date",
        "stock_code",
        "sector_id",
        "sector_name",
        "sector_layer",
        "company_relation_id",
        "company_relation_type",
        "company_relation_status",
        "basket_weight",
        "company_relation_score",
        "company_relation_confidence",
        "relation_status_factor",
        "relation_type_factor",
        "adjusted_contribution"
      ],
      "title": "EtfCompanySectorContribution",
      "type": "object"
    },
    "EtfRelationChangeEvent": {
      "additionalProperties": false,
      "properties": {
        "event_id": {
          "description": "ETF 板块关系变化事件的稳定标识。",
          "title": "Event Id",
          "type": "string"
        },
        "run_id": {
          "description": "产生该事件的完整数据运行标识。",
          "title": "Run Id",
          "type": "string"
        },
        "relation_id": {
          "description": "ETF 与板块关系的稳定标识。",
          "title": "Relation Id",
          "type": "string"
        },
        "as_of": {
          "title": "As Of",
          "type": "string"
        },
        "etf_key": {
          "title": "Etf Key",
          "type": "string"
        },
        "sector_id": {
          "title": "Sector Id",
          "type": "string"
        },
        "event_type": {
          "description": "关系创建、状态跨档、显著暴露变化或失效。",
          "enum": [
            "created",
            "status_changed",
            "exposure_changed",
            "expired"
          ],
          "title": "Event Type",
          "type": "string"
        },
        "previous_status": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "变化前的关系状态；首次创建时为空。",
          "title": "Previous Status"
        },
        "new_status": {
          "description": "变化后的关系状态。",
          "title": "New Status",
          "type": "string"
        },
        "previous_exposure": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "变化前的调整暴露；首次创建时为空。",
          "title": "Previous Exposure"
        },
        "new_exposure": {
          "description": "变化后的调整暴露。",
          "title": "New Exposure",
          "type": "number"
        },
        "exposure_delta": {
          "description": "调整暴露的有符号变化量。",
          "title": "Exposure Delta",
          "type": "number"
        },
        "absolute_delta": {
          "description": "调整暴露变化量的绝对值。",
          "title": "Absolute Delta",
          "type": "number"
        },
        "relative_delta": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "description": "相对前值的暴露变化比例；前值为零时为空。",
          "title": "Relative Delta"
        },
        "previous_basket_id": {
          "default": "",
          "description": "变化前使用的 ETF 篮子标识。",
          "title": "Previous Basket Id",
          "type": "string"
        },
        "new_basket_id": {
          "default": "",
          "description": "变化后使用的 ETF 篮子标识。",
          "title": "New Basket Id",
          "type": "string"
        },
        "previous_mapping_run_id": {
          "default": "",
          "description": "变化前使用的公司板块映射运行标识。",
          "title": "Previous Mapping Run Id",
          "type": "string"
        },
        "new_mapping_run_id": {
          "default": "",
          "description": "变化后使用的公司板块映射运行标识。",
          "title": "New Mapping Run Id",
          "type": "string"
        },
        "reason": {
          "description": "形成该变化事件的机器可读原因。",
          "title": "Reason",
          "type": "string"
        },
        "drivers": {
          "description": "导致关系变化的篮子、公司映射或阈值因素。",
          "items": {
            "type": "string"
          },
          "title": "Drivers",
          "type": "array"
        },
        "significant_exposure_change": {
          "default": false,
          "description": "暴露变化是否达到显著变化记录阈值。",
          "title": "Significant Exposure Change",
          "type": "boolean"
        },
        "created_at": {
          "description": "变化事件的入库时间。",
          "title": "Created At",
          "type": "string"
        }
      },
      "required": [
        "event_id",
        "run_id",
        "relation_id",
        "as_of",
        "etf_key",
        "sector_id",
        "event_type",
        "new_status",
        "new_exposure",
        "exposure_delta",
        "absolute_delta",
        "reason",
        "created_at"
      ],
      "title": "EtfRelationChangeEvent",
      "type": "object"
    },
    "EvidenceItem": {
      "properties": {
        "trace_kind": {
          "title": "Trace Kind",
          "type": "string"
        },
        "evidence_id": {
          "title": "Evidence Id",
          "type": "string"
        },
        "material_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Material Id"
        },
        "document_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Document Id"
        },
        "source_id": {
          "title": "Source Id",
          "type": "string"
        },
        "evidence_date": {
          "title": "Evidence Date",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "url": {
          "title": "Url",
          "type": "string"
        },
        "doc_no": {
          "default": "",
          "title": "Doc No",
          "type": "string"
        },
        "quote": {
          "default": "",
          "title": "Quote",
          "type": "string"
        },
        "viewpoint": {
          "default": "",
          "title": "Viewpoint",
          "type": "string"
        },
        "role": {
          "default": "",
          "title": "Role",
          "type": "string"
        },
        "confidence": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Confidence"
        },
        "score": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Score"
        },
        "score_kind": {
          "default": "",
          "title": "Score Kind",
          "type": "string"
        },
        "score_breakdown": {
          "additionalProperties": true,
          "title": "Score Breakdown",
          "type": "object"
        },
        "prompt_id": {
          "default": "",
          "title": "Prompt Id",
          "type": "string"
        },
        "prompt_version": {
          "default": "",
          "title": "Prompt Version",
          "type": "string"
        },
        "model": {
          "default": "",
          "title": "Model",
          "type": "string"
        },
        "mapping_explanation": {
          "anyOf": [
            {
              "$ref": "#/$defs/MappingExplanation"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "trace_kinds": {
          "items": {
            "type": "string"
          },
          "title": "Trace Kinds",
          "type": "array"
        },
        "roles": {
          "items": {
            "type": "string"
          },
          "title": "Roles",
          "type": "array"
        },
        "evidence_count": {
          "default": 1,
          "title": "Evidence Count",
          "type": "integer"
        },
        "points": {
          "items": {
            "$ref": "#/$defs/EvidencePoint"
          },
          "title": "Points",
          "type": "array"
        }
      },
      "required": [
        "trace_kind",
        "evidence_id",
        "source_id",
        "evidence_date",
        "title",
        "url"
      ],
      "title": "EvidenceItem",
      "type": "object"
    },
    "EvidencePoint": {
      "properties": {
        "evidence_id": {
          "title": "Evidence Id",
          "type": "string"
        },
        "viewpoint": {
          "default": "",
          "title": "Viewpoint",
          "type": "string"
        },
        "quote": {
          "default": "",
          "title": "Quote",
          "type": "string"
        },
        "trace_kinds": {
          "items": {
            "type": "string"
          },
          "title": "Trace Kinds",
          "type": "array"
        },
        "roles": {
          "items": {
            "type": "string"
          },
          "title": "Roles",
          "type": "array"
        },
        "confidence": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Confidence"
        },
        "score": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Score"
        },
        "score_kinds": {
          "items": {
            "type": "string"
          },
          "title": "Score Kinds",
          "type": "array"
        },
        "scores": {
          "items": {
            "$ref": "#/$defs/EvidenceScore"
          },
          "title": "Scores",
          "type": "array"
        },
        "prompt_id": {
          "default": "",
          "title": "Prompt Id",
          "type": "string"
        },
        "prompt_version": {
          "default": "",
          "title": "Prompt Version",
          "type": "string"
        },
        "model": {
          "default": "",
          "title": "Model",
          "type": "string"
        },
        "mapping_explanation": {
          "anyOf": [
            {
              "$ref": "#/$defs/MappingExplanation"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "evidence_id"
      ],
      "title": "EvidencePoint",
      "type": "object"
    },
    "EvidenceScore": {
      "properties": {
        "score": {
          "title": "Score",
          "type": "number"
        },
        "score_kind": {
          "default": "",
          "title": "Score Kind",
          "type": "string"
        },
        "role": {
          "default": "",
          "title": "Role",
          "type": "string"
        },
        "score_breakdown": {
          "additionalProperties": true,
          "title": "Score Breakdown",
          "type": "object"
        }
      },
      "required": [
        "score"
      ],
      "title": "EvidenceScore",
      "type": "object"
    },
    "RelationEvidenceMaterialSummary": {
      "properties": {
        "material_count": {
          "title": "Material Count",
          "type": "integer"
        },
        "fact_count": {
          "title": "Fact Count",
          "type": "integer"
        }
      },
      "required": [
        "material_count",
        "fact_count"
      ],
      "title": "RelationEvidenceMaterialSummary",
      "type": "object"
    },
    "RelationEvidenceMaterial": {
      "properties": {
        "material_key": {
          "title": "Material Key",
          "type": "string"
        },
        "material_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Material Id"
        },
        "document_id": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Document Id"
        },
        "source_id": {
          "title": "Source Id",
          "type": "string"
        },
        "evidence_date": {
          "title": "Evidence Date",
          "type": "string"
        },
        "publish_date": {
          "default": "",
          "title": "Publish Date",
          "type": "string"
        },
        "report_period": {
          "default": "",
          "title": "Report Period",
          "type": "string"
        },
        "document_type": {
          "default": "",
          "title": "Document Type",
          "type": "string"
        },
        "title": {
          "title": "Title",
          "type": "string"
        },
        "url": {
          "title": "Url",
          "type": "string"
        },
        "fact_count": {
          "title": "Fact Count",
          "type": "integer"
        },
        "facts": {
          "items": {
            "$ref": "#/$defs/RelationEvidenceFact"
          },
          "title": "Facts",
          "type": "array"
        }
      },
      "required": [
        "material_key",
        "source_id",
        "evidence_date",
        "title",
        "url",
        "fact_count"
      ],
      "title": "RelationEvidenceMaterial",
      "type": "object"
    },
    "RelationEvidenceFact": {
      "properties": {
        "evidence_id": {
          "title": "Evidence Id",
          "type": "string"
        },
        "fact_name": {
          "default": "",
          "title": "Fact Name",
          "type": "string"
        },
        "fact_summary": {
          "default": "",
          "title": "Fact Summary",
          "type": "string"
        },
        "fact_type": {
          "default": "",
          "title": "Fact Type",
          "type": "string"
        },
        "business_status": {
          "default": "",
          "title": "Business Status",
          "type": "string"
        },
        "evidence_level": {
          "default": "",
          "title": "Evidence Level",
          "type": "string"
        },
        "participation_basis": {
          "default": "",
          "title": "Participation Basis",
          "type": "string"
        },
        "participation_summary": {
          "default": "",
          "title": "Participation Summary",
          "type": "string"
        },
        "relationship_logic": {
          "default": "",
          "title": "Relationship Logic",
          "type": "string"
        },
        "mapping_conclusion": {
          "default": "",
          "title": "Mapping Conclusion",
          "type": "string"
        },
        "boundary_note": {
          "default": "",
          "title": "Boundary Note",
          "type": "string"
        },
        "viewpoint": {
          "default": "",
          "title": "Viewpoint",
          "type": "string"
        },
        "quote": {
          "default": "",
          "title": "Quote",
          "type": "string"
        },
        "role": {
          "default": "",
          "title": "Role",
          "type": "string"
        },
        "confidence": {
          "anyOf": [
            {
              "type": "string"
            },
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Confidence"
        },
        "score": {
          "anyOf": [
            {
              "type": "number"
            },
            {
              "type": "null"
            }
          ],
          "default": null,
          "title": "Score"
        },
        "score_breakdown": {
          "additionalProperties": true,
          "title": "Score Breakdown",
          "type": "object"
        },
        "mapping_explanation": {
          "anyOf": [
            {
              "$ref": "#/$defs/MappingExplanation"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        },
        "term_explanation": {
          "anyOf": [
            {
              "$ref": "#/$defs/TermExplanation"
            },
            {
              "type": "null"
            }
          ],
          "default": null
        }
      },
      "required": [
        "evidence_id"
      ],
      "title": "RelationEvidenceFact",
      "type": "object"
    },
    "TermExplanation": {
      "properties": {
        "canonical_name": {
          "title": "Canonical Name",
          "type": "string"
        },
        "category": {
          "title": "Category",
          "type": "string"
        },
        "definition": {
          "title": "Definition",
          "type": "string"
        },
        "source_title": {
          "title": "Source Title",
          "type": "string"
        },
        "source_url": {
          "title": "Source Url",
          "type": "string"
        }
      },
      "required": [
        "canonical_name",
        "category",
        "definition",
        "source_title",
        "source_url"
      ],
      "title": "TermExplanation",
      "type": "object"
    }
  },
  "capabilities": [
    {
      "id": "system.bootstrap",
      "domain": "system",
      "title": "探测服务、鉴权和能力版本",
      "summary": "Skill 的固定入口；无需鉴权即可判断认证模式并定位能力目录。",
      "intents": [
        "discover_service",
        "detect_authentication"
      ],
      "path": "/api/gendangzou/bootstrap",
      "snapshot_bound": false,
      "compact_supported": false,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/system.bootstrap",
      "parameters": [
        "client",
        "client_version",
        "locale",
        "platform"
      ],
      "response_fields": [
        "authentication",
        "discovery",
        "features",
        "announcements"
      ],
      "related_capabilities": [
        "system.capabilities"
      ],
      "freshness": "on_request",
      "pagination": false,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/system.bootstrap",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": false,
        "fetch_evidence_on_demand": true
      },
      "request": {
        "parameters": [
          {
            "name": "client",
            "in": "query",
            "required": false,
            "schema": {
              "default": "gendangzou-skill",
              "maxLength": 64,
              "minLength": 2,
              "pattern": "^[a-z0-9][a-z0-9._-]+$",
              "type": "string"
            }
          },
          {
            "name": "client_version",
            "in": "query",
            "required": false,
            "schema": {
              "default": "",
              "maxLength": 32,
              "type": "string"
            }
          },
          {
            "name": "locale",
            "in": "query",
            "required": false,
            "schema": {
              "default": "zh-CN",
              "maxLength": 16,
              "minLength": 2,
              "type": "string"
            }
          },
          {
            "name": "platform",
            "in": "query",
            "required": false,
            "schema": {
              "default": "",
              "maxLength": 32,
              "type": "string"
            }
          }
        ]
      },
      "response": {
        "model": "",
        "top_level_fields": []
      }
    },
    {
      "id": "system.capabilities",
      "domain": "system",
      "title": "查询 API 能力目录",
      "summary": "按业务域或受控意图查询精简能力索引，再按能力 ID 获取详情。",
      "intents": [
        "discover_capabilities",
        "route_task"
      ],
      "path": "/api/gendangzou/capabilities",
      "snapshot_bound": false,
      "compact_supported": false,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/system.capabilities",
      "parameters": [
        "domain",
        "intent"
      ],
      "response_fields": [
        "contract_version",
        "items",
        "available_filters"
      ],
      "related_capabilities": [
        "system.bootstrap"
      ],
      "freshness": "contract_release",
      "pagination": false,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/system.capabilities",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": false,
        "fetch_evidence_on_demand": true
      },
      "request": {
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "system",
                    "snapshot",
                    "sector",
                    "signal",
                    "material",
                    "security",
                    "company",
                    "etf",
                    "evidence"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Exact business domain filter"
            }
          },
          {
            "name": "intent",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 64,
                  "minLength": 3,
                  "pattern": "^[a-z][a-z0-9_]+$",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Exact controlled intent filter"
            }
          }
        ]
      },
      "response": {
        "model": "",
        "top_level_fields": []
      }
    },
    {
      "id": "material.policy.list",
      "domain": "material",
      "title": "查询权威政策材料",
      "summary": "查询指定自然日已完成分析的政府和监管机构材料。",
      "intents": [
        "list_policy_materials",
        "trace_policy",
        "find_policy_signal"
      ],
      "path": "/api/gendangzou/policy-materials",
      "snapshot_bound": false,
      "compact_supported": false,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/material.policy.list",
      "parameters": [
        "date",
        "status",
        "source_id",
        "q",
        "snapshot_id",
        "page",
        "page_size"
      ],
      "response_fields": [
        "business_date",
        "snapshot_id",
        "summary",
        "items"
      ],
      "related_capabilities": [
        "material.media.list",
        "evidence.sector.list"
      ],
      "freshness": "five_minute_discovery_async_processing",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/material.policy.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": false,
        "fetch_evidence_on_demand": true,
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Policy material date; defaults to the current Beijing date"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "default": "all",
              "enum": [
                "all",
                "signal",
                "no_signal"
              ],
              "type": "string"
            }
          },
          {
            "name": "source_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 2,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 100,
                  "minLength": 1,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 30,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          }
        ]
      },
      "response": {
        "model": "PolicyMaterialListResponse",
        "top_level_fields": [
          {
            "name": "business_date",
            "required": true
          },
          {
            "name": "snapshot_id",
            "required": false
          },
          {
            "name": "summary",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "business_date": {
              "title": "Business Date",
              "type": "string"
            },
            "snapshot_id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Snapshot Id"
            },
            "summary": {
              "$ref": "#/$defs/PolicyMaterialSummary"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/PolicyMaterialItem"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "business_date",
            "summary",
            "items",
            "pagination"
          ],
          "title": "PolicyMaterialListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "material.media.list",
      "domain": "material",
      "title": "查询权威媒体材料",
      "summary": "查询指定自然日已完成分析的国家级通讯社和高置信媒体材料。",
      "intents": [
        "list_media_materials",
        "trace_media",
        "find_media_signal"
      ],
      "path": "/api/gendangzou/media-materials",
      "snapshot_bound": false,
      "compact_supported": false,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/material.media.list",
      "parameters": [
        "date",
        "status",
        "source_id",
        "q",
        "snapshot_id",
        "page",
        "page_size"
      ],
      "response_fields": [
        "business_date",
        "snapshot_id",
        "summary",
        "items"
      ],
      "related_capabilities": [
        "material.policy.list",
        "evidence.sector.list"
      ],
      "freshness": "five_minute_discovery_async_processing",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/material.media.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": false,
        "fetch_evidence_on_demand": true,
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Media material date; defaults to the current Beijing date"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "default": "all",
              "enum": [
                "all",
                "signal",
                "no_signal"
              ],
              "type": "string"
            }
          },
          {
            "name": "source_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 2,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 100,
                  "minLength": 1,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 30,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          }
        ]
      },
      "response": {
        "model": "PolicyMaterialListResponse",
        "top_level_fields": [
          {
            "name": "business_date",
            "required": true
          },
          {
            "name": "snapshot_id",
            "required": false
          },
          {
            "name": "summary",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "business_date": {
              "title": "Business Date",
              "type": "string"
            },
            "snapshot_id": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Snapshot Id"
            },
            "summary": {
              "$ref": "#/$defs/PolicyMaterialSummary"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/PolicyMaterialItem"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "business_date",
            "summary",
            "items",
            "pagination"
          ],
          "title": "PolicyMaterialListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "sector.list",
      "domain": "sector",
      "title": "查询板块目录",
      "summary": "按层级、父级、状态或名称查询自有 A 股板块目录。",
      "intents": [
        "list_sectors",
        "search_sector",
        "browse_taxonomy"
      ],
      "path": "/api/gendangzou/sectors",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/sector.list",
      "parameters": [
        "layer",
        "parent_id",
        "status",
        "q",
        "include_inactive",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "sector.detail",
        "signal.heat.rank"
      ],
      "freshness": "daily_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/sector.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "layer",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "own_l1",
                    "own_l2",
                    "dynamic"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "parent_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 3,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 32,
                  "minLength": 2,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "minLength": 1,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "include_inactive",
            "in": "query",
            "required": false,
            "schema": {
              "default": false,
              "description": "Include dormant, deprecated, and retired sector entities",
              "type": "boolean"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "SectorListResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/SectorSummary"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "snapshot",
            "items",
            "pagination"
          ],
          "title": "SectorListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "sector.detail",
      "domain": "sector",
      "title": "获取板块详情",
      "summary": "读取板块定义、边界、层级、生命周期和当前三类信号。",
      "intents": [
        "analyze_sector",
        "explain_sector",
        "inspect_sector_boundary"
      ],
      "path": "/api/gendangzou/sectors/{sector_id}",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/sector.detail",
      "parameters": [
        "sector_id",
        "snapshot_id",
        "as_of",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "sector"
      ],
      "related_capabilities": [
        "sector.graph",
        "evidence.sector.list",
        "company.by_sector.list"
      ],
      "freshness": "daily_snapshot",
      "pagination": false,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/sector.detail",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context"
      },
      "request": {
        "parameters": [
          {
            "name": "sector_id",
            "in": "path",
            "required": true,
            "schema": {
              "maxLength": 128,
              "minLength": 3,
              "type": "string"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "SectorDetailResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "sector",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "sector": {
              "$ref": "#/$defs/SectorDetail"
            }
          },
          "required": [
            "snapshot",
            "sector"
          ],
          "title": "SectorDetailResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "sector.graph",
      "domain": "sector",
      "title": "查询板块局部关系图",
      "summary": "返回选中板块的一跳层级、产业、演化和市场关联。",
      "intents": [
        "get_sector_graph",
        "analyze_sector_relationships"
      ],
      "path": "/api/gendangzou/sectors/{sector_id}/graph",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/sector.graph",
      "parameters": [
        "sector_id",
        "snapshot_id",
        "as_of",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "focus_sector_id",
        "nodes",
        "edges",
        "summary"
      ],
      "related_capabilities": [
        "sector.detail",
        "signal.dynamics.list"
      ],
      "freshness": "daily_snapshot",
      "pagination": false,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/sector.graph",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context"
      },
      "request": {
        "parameters": [
          {
            "name": "sector_id",
            "in": "path",
            "required": true,
            "schema": {
              "maxLength": 128,
              "minLength": 3,
              "type": "string"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "SectorGraphResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "focus_sector_id",
            "required": true
          },
          {
            "name": "nodes",
            "required": true
          },
          {
            "name": "edges",
            "required": true
          },
          {
            "name": "summary",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "focus_sector_id": {
              "title": "Focus Sector Id",
              "type": "string"
            },
            "nodes": {
              "items": {
                "$ref": "#/$defs/SectorGraphNode"
              },
              "title": "Nodes",
              "type": "array"
            },
            "edges": {
              "items": {
                "$ref": "#/$defs/SectorGraphEdge"
              },
              "title": "Edges",
              "type": "array"
            },
            "summary": {
              "$ref": "#/$defs/SectorGraphSummary"
            }
          },
          "required": [
            "snapshot",
            "focus_sector_id",
            "nodes",
            "edges",
            "summary"
          ],
          "title": "SectorGraphResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "sector.heat_series",
      "domain": "sector",
      "title": "查询板块历史热度序列",
      "summary": "按政策、市场关注或资金确认维度查询板块历史轨迹。",
      "intents": [
        "get_sector_trajectory",
        "compare_sector_history"
      ],
      "path": "/api/gendangzou/sectors/{sector_id}/heat-series",
      "snapshot_bound": false,
      "compact_supported": false,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/sector.heat_series",
      "parameters": [
        "sector_id",
        "view",
        "start",
        "end",
        "limit"
      ],
      "response_fields": [
        "sector_id",
        "view",
        "items"
      ],
      "related_capabilities": [
        "signal.heat.rank",
        "sector.detail"
      ],
      "freshness": "daily_snapshot",
      "pagination": false,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/sector.heat_series",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": false,
        "fetch_evidence_on_demand": true
      },
      "request": {
        "parameters": [
          {
            "name": "sector_id",
            "in": "path",
            "required": true,
            "schema": {
              "maxLength": 128,
              "minLength": 3,
              "type": "string"
            }
          },
          {
            "name": "view",
            "in": "query",
            "required": false,
            "schema": {
              "default": "policy",
              "enum": [
                "policy",
                "market_attention",
                "market_trading"
              ],
              "type": "string"
            }
          },
          {
            "name": "start",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "default": 90,
              "maximum": 366,
              "minimum": 1,
              "type": "integer"
            }
          }
        ]
      },
      "response": {
        "model": "HeatSeriesResponse",
        "top_level_fields": [
          {
            "name": "sector_id",
            "required": true
          },
          {
            "name": "view",
            "required": true
          },
          {
            "name": "items",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "sector_id": {
              "title": "Sector Id",
              "type": "string"
            },
            "view": {
              "enum": [
                "policy",
                "market_attention",
                "market_trading"
              ],
              "title": "View",
              "type": "string"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/HeatSeriesPoint"
              },
              "title": "Items",
              "type": "array"
            }
          },
          "required": [
            "sector_id",
            "view",
            "items"
          ],
          "title": "HeatSeriesResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "signal.realtime.overview",
      "domain": "signal",
      "title": "查询实时材料与板块总览",
      "summary": "按独立滚动时间窗口查询政策、权威媒体和即时市场关注事件流，同时返回板块聚合与可溯源材料；日报快照不会重置该窗口。",
      "intents": [
        "find_realtime_sector_signals",
        "monitor_intraday_sector_attention",
        "monitor_realtime_market_attention",
        "trace_realtime_materials"
      ],
      "path": "/api/gendangzou/realtime",
      "snapshot_bound": false,
      "compact_supported": false,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/signal.realtime.overview",
      "parameters": [
        "window",
        "channel",
        "sector_limit",
        "material_limit"
      ],
      "response_fields": [
        "business_date",
        "generated_at",
        "window",
        "catalog",
        "summary",
        "sectors",
        "materials",
        "material_pagination"
      ],
      "related_capabilities": [
        "material.policy.list",
        "material.media.list",
        "sector.detail"
      ],
      "freshness": "five_minute_discovery_async_processing",
      "pagination": false,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/signal.realtime.overview",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": false,
        "fetch_evidence_on_demand": true
      },
      "request": {
        "parameters": [
          {
            "name": "window",
            "in": "query",
            "required": false,
            "schema": {
              "default": "24h",
              "enum": [
                "1h",
                "6h",
                "24h",
                "3d"
              ],
              "type": "string"
            }
          },
          {
            "name": "channel",
            "in": "query",
            "required": false,
            "schema": {
              "default": "all",
              "enum": [
                "all",
                "policy",
                "media",
                "market_attention"
              ],
              "type": "string"
            }
          },
          {
            "name": "sector_limit",
            "in": "query",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "material_limit",
            "in": "query",
            "required": false,
            "schema": {
              "default": 30,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          }
        ]
      },
      "response": {
        "model": "RealtimeOverviewResponse",
        "top_level_fields": [
          {
            "name": "schema_version",
            "required": false
          },
          {
            "name": "business_date",
            "required": true
          },
          {
            "name": "generated_at",
            "required": true
          },
          {
            "name": "window",
            "required": true
          },
          {
            "name": "catalog",
            "required": true
          },
          {
            "name": "summary",
            "required": true
          },
          {
            "name": "sectors",
            "required": true
          },
          {
            "name": "materials",
            "required": true
          },
          {
            "name": "material_pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "schema_version": {
              "default": "gendangzou-realtime-v3",
              "title": "Schema Version",
              "type": "string"
            },
            "business_date": {
              "title": "Business Date",
              "type": "string"
            },
            "generated_at": {
              "title": "Generated At",
              "type": "string"
            },
            "window": {
              "$ref": "#/$defs/RealtimeWindow"
            },
            "catalog": {
              "$ref": "#/$defs/RealtimeCatalog"
            },
            "summary": {
              "$ref": "#/$defs/RealtimeSummary"
            },
            "sectors": {
              "items": {
                "$ref": "#/$defs/RealtimeSectorDelta"
              },
              "title": "Sectors",
              "type": "array"
            },
            "materials": {
              "items": {
                "$ref": "#/$defs/RealtimeMaterialItem"
              },
              "title": "Materials",
              "type": "array"
            },
            "material_pagination": {
              "$ref": "#/$defs/RealtimeCursorPagination"
            }
          },
          "required": [
            "business_date",
            "generated_at",
            "window",
            "catalog",
            "summary",
            "sectors",
            "materials",
            "material_pagination"
          ],
          "title": "RealtimeOverviewResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "signal.realtime.sectors",
      "domain": "signal",
      "title": "查询实时板块窗口聚合",
      "summary": "按1小时、6小时、24小时或3天滚动窗口分别聚合政策、权威媒体和即时市场关注强度，并与前一个等长窗口比较。",
      "intents": [
        "find_realtime_sector_signals",
        "compare_realtime_sector_windows",
        "monitor_intraday_sector_attention",
        "monitor_realtime_market_attention"
      ],
      "path": "/api/gendangzou/realtime/sectors",
      "snapshot_bound": false,
      "compact_supported": false,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/signal.realtime.sectors",
      "parameters": [
        "window",
        "channel",
        "layer",
        "signal",
        "limit"
      ],
      "response_fields": [
        "business_date",
        "generated_at",
        "window",
        "catalog",
        "summary",
        "sectors"
      ],
      "related_capabilities": [
        "signal.realtime.events",
        "sector.detail",
        "evidence.sector.list"
      ],
      "freshness": "five_minute_discovery_async_processing",
      "pagination": false,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/signal.realtime.sectors",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": false,
        "fetch_evidence_on_demand": true
      },
      "request": {
        "parameters": [
          {
            "name": "window",
            "in": "query",
            "required": false,
            "schema": {
              "default": "24h",
              "enum": [
                "1h",
                "6h",
                "24h",
                "3d"
              ],
              "type": "string"
            }
          },
          {
            "name": "channel",
            "in": "query",
            "required": false,
            "schema": {
              "default": "all",
              "enum": [
                "all",
                "policy",
                "media",
                "market_attention"
              ],
              "type": "string"
            }
          },
          {
            "name": "layer",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "own_l1",
                    "own_l2",
                    "dynamic",
                    "market_dynamic"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "signal",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "new_signal",
                    "strengthening",
                    "multi_source",
                    "pressure",
                    "mixed",
                    "steady"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "default": 30,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          }
        ]
      },
      "response": {
        "model": "RealtimeSectorListResponse",
        "top_level_fields": [
          {
            "name": "schema_version",
            "required": false
          },
          {
            "name": "business_date",
            "required": true
          },
          {
            "name": "generated_at",
            "required": true
          },
          {
            "name": "window",
            "required": true
          },
          {
            "name": "catalog",
            "required": true
          },
          {
            "name": "summary",
            "required": true
          },
          {
            "name": "sectors",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "schema_version": {
              "default": "gendangzou-realtime-sectors-v2",
              "title": "Schema Version",
              "type": "string"
            },
            "business_date": {
              "title": "Business Date",
              "type": "string"
            },
            "generated_at": {
              "title": "Generated At",
              "type": "string"
            },
            "window": {
              "$ref": "#/$defs/RealtimeWindow"
            },
            "catalog": {
              "$ref": "#/$defs/RealtimeCatalog"
            },
            "summary": {
              "$ref": "#/$defs/RealtimeSummary"
            },
            "sectors": {
              "items": {
                "$ref": "#/$defs/RealtimeSectorDelta"
              },
              "title": "Sectors",
              "type": "array"
            }
          },
          "required": [
            "business_date",
            "generated_at",
            "window",
            "catalog",
            "summary",
            "sectors"
          ],
          "title": "RealtimeSectorListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "signal.realtime.events",
      "domain": "signal",
      "title": "查询连续实时材料事件",
      "summary": "按游标持续读取已完成分析的政策、权威媒体和即时财经材料，支持按板块、信源类型和滚动窗口过滤。",
      "intents": [
        "stream_realtime_materials",
        "trace_realtime_materials",
        "monitor_new_policy_and_media",
        "monitor_realtime_market_attention"
      ],
      "path": "/api/gendangzou/realtime/events",
      "snapshot_bound": false,
      "compact_supported": false,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/signal.realtime.events",
      "parameters": [
        "window",
        "channel",
        "sector_id",
        "cursor",
        "limit"
      ],
      "response_fields": [
        "business_date",
        "generated_at",
        "window",
        "catalog",
        "summary",
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "signal.realtime.sectors",
        "material.policy.list",
        "material.media.list",
        "sector.detail"
      ],
      "freshness": "five_minute_discovery_async_processing",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/signal.realtime.events",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": false,
        "fetch_evidence_on_demand": true,
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "window",
            "in": "query",
            "required": false,
            "schema": {
              "default": "24h",
              "enum": [
                "1h",
                "6h",
                "24h",
                "3d"
              ],
              "type": "string"
            }
          },
          {
            "name": "channel",
            "in": "query",
            "required": false,
            "schema": {
              "default": "all",
              "enum": [
                "all",
                "policy",
                "media",
                "market_attention"
              ],
              "type": "string"
            }
          },
          {
            "name": "sector_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 3,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 512,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "default": 30,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          }
        ]
      },
      "response": {
        "model": "RealtimeEventListResponse",
        "top_level_fields": [
          {
            "name": "schema_version",
            "required": false
          },
          {
            "name": "business_date",
            "required": true
          },
          {
            "name": "generated_at",
            "required": true
          },
          {
            "name": "window",
            "required": true
          },
          {
            "name": "catalog",
            "required": true
          },
          {
            "name": "summary",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "schema_version": {
              "default": "gendangzou-realtime-events-v2",
              "title": "Schema Version",
              "type": "string"
            },
            "business_date": {
              "title": "Business Date",
              "type": "string"
            },
            "generated_at": {
              "title": "Generated At",
              "type": "string"
            },
            "window": {
              "$ref": "#/$defs/RealtimeWindow"
            },
            "catalog": {
              "$ref": "#/$defs/RealtimeCatalog"
            },
            "summary": {
              "$ref": "#/$defs/RealtimeEventSummary"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/RealtimeMaterialItem"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/RealtimeCursorPagination"
            }
          },
          "required": [
            "business_date",
            "generated_at",
            "window",
            "catalog",
            "summary",
            "items",
            "pagination"
          ],
          "title": "RealtimeEventListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "signal.heat.rank",
      "domain": "signal",
      "title": "查询板块信号排名",
      "summary": "分别查询政策热度、市场关注度或资金确认度，不合并三类口径。",
      "intents": [
        "rank_sectors",
        "compare_signals",
        "find_hot_sectors"
      ],
      "path": "/api/gendangzou/sector-heat",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/signal.heat.rank",
      "parameters": [
        "view",
        "layer",
        "status",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "view",
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "signal.dynamics.list",
        "evidence.sector.list",
        "snapshot.latest"
      ],
      "freshness": "daily_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/signal.heat.rank",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "view",
            "in": "query",
            "required": false,
            "schema": {
              "default": "policy",
              "enum": [
                "policy",
                "market_attention",
                "market_trading"
              ],
              "type": "string"
            }
          },
          {
            "name": "layer",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "own_l1",
                    "own_l2",
                    "dynamic"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 32,
                  "minLength": 2,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "HeatListResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "view",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "view": {
              "enum": [
                "policy",
                "market_attention",
                "market_trading"
              ],
              "title": "View",
              "type": "string"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/HeatItem"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "snapshot",
            "view",
            "items",
            "pagination"
          ],
          "title": "HeatListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "signal.dynamics.list",
      "domain": "signal",
      "title": "查询板块异动与同日关联",
      "summary": "返回板块级横截面异动、内部确认和同日产业关联。",
      "intents": [
        "find_sector_anomalies",
        "analyze_sector_linkage"
      ],
      "path": "/api/gendangzou/sector-dynamics",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/signal.dynamics.list",
      "parameters": [
        "include_all",
        "direction",
        "min_score",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "items",
        "links",
        "pagination"
      ],
      "related_capabilities": [
        "signal.heat.rank",
        "sector.graph"
      ],
      "freshness": "daily_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/signal.dynamics.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "include_all",
            "in": "query",
            "required": false,
            "schema": {
              "default": false,
              "description": "Include sectors below the configured anomaly threshold",
              "type": "boolean"
            }
          },
          {
            "name": "direction",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "stronger",
                    "weaker"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "min_score",
            "in": "query",
            "required": false,
            "schema": {
              "default": 0.0,
              "maximum": 100.0,
              "minimum": 0.0,
              "type": "number"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 30,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "SectorDynamicsResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "links",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/SectorAnomalySummary"
              },
              "title": "Items",
              "type": "array"
            },
            "links": {
              "items": {
                "$ref": "#/$defs/SectorLinkageSummary"
              },
              "title": "Links",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "snapshot",
            "items",
            "links",
            "pagination"
          ],
          "title": "SectorDynamicsResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "signal.trading_contributors.list",
      "domain": "signal",
      "title": "查询板块资金贡献明细",
      "summary": "查询用于板块资金确认计算的映射公司和聚合权重。",
      "intents": [
        "inspect_market_confirmation",
        "audit_trading_signal"
      ],
      "path": "/api/gendangzou/sectors/{sector_id}/trading-contributors",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/signal.trading_contributors.list",
      "parameters": [
        "sector_id",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "sector_id",
        "summary",
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "signal.heat.rank",
        "company.by_sector.list"
      ],
      "freshness": "trading_day_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/signal.trading_contributors.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "sector_id",
            "in": "path",
            "required": true,
            "schema": {
              "maxLength": 128,
              "minLength": 3,
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "TradingContributorsResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "sector_id",
            "required": true
          },
          {
            "name": "summary",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "sector_id": {
              "title": "Sector Id",
              "type": "string"
            },
            "summary": {
              "$ref": "#/$defs/TradingSummary"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/TradingContributor"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "snapshot",
            "sector_id",
            "summary",
            "items",
            "pagination"
          ],
          "title": "TradingContributorsResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "security.lifecycle.list",
      "domain": "security",
      "title": "查询证券生命周期当前状态",
      "summary": "按北京时间日期查询待上市、近期上市及退出证券，并返回板块关联和权威来源。",
      "intents": [
        "list_prelisted_securities",
        "list_new_listings",
        "list_recent_delistings",
        "inspect_security_lifecycle"
      ],
      "path": "/api/gendangzou/securities",
      "snapshot_bound": false,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/security.lifecycle.list",
      "parameters": [
        "date",
        "scope",
        "days",
        "q",
        "exchange",
        "board",
        "sector_id",
        "snapshot_id",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "business_date",
        "snapshot",
        "scope",
        "window_days",
        "summary",
        "sector_impacts",
        "coverage",
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "security.lifecycle.changes",
        "company.detail",
        "company.sectors.list",
        "sector.detail"
      ],
      "freshness": "hourly_official_exchange_and_cninfo_catalog",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/security.lifecycle.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": false,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "date",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Lifecycle date; defaults to the current Beijing date"
            }
          },
          {
            "name": "scope",
            "in": "query",
            "required": false,
            "schema": {
              "default": "recent_listed",
              "enum": [
                "prelisted",
                "recent_listed",
                "departures"
              ],
              "type": "string"
            }
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "schema": {
              "default": 30,
              "maximum": 365,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 100,
                  "minLength": 1,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "exchange",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "SSE",
                    "SZSE",
                    "BSE"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "board",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "MAIN",
                    "STAR",
                    "CHINEXT",
                    "BSE"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "sector_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 2,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 30,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "SecurityLifecycleListResponse",
        "top_level_fields": [
          {
            "name": "business_date",
            "required": true
          },
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "scope",
            "required": true
          },
          {
            "name": "window_days",
            "required": true
          },
          {
            "name": "summary",
            "required": true
          },
          {
            "name": "sector_impacts",
            "required": false
          },
          {
            "name": "coverage",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "business_date": {
              "title": "Business Date",
              "type": "string"
            },
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "scope": {
              "enum": [
                "prelisted",
                "recent_listed",
                "departures"
              ],
              "title": "Scope",
              "type": "string"
            },
            "window_days": {
              "title": "Window Days",
              "type": "integer"
            },
            "summary": {
              "$ref": "#/$defs/SecurityLifecycleSummary"
            },
            "sector_impacts": {
              "items": {
                "$ref": "#/$defs/SecurityLifecycleSectorImpact"
              },
              "title": "Sector Impacts",
              "type": "array"
            },
            "coverage": {
              "$ref": "#/$defs/SecurityLifecycleCoverage"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/SecurityLifecycleItem"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "business_date",
            "snapshot",
            "scope",
            "window_days",
            "summary",
            "coverage",
            "items",
            "pagination"
          ],
          "title": "SecurityLifecycleListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "security.lifecycle.changes",
      "domain": "security",
      "title": "查询证券上市状态变化",
      "summary": "查询待上市、正式上市、终止上市和退市的权威状态变化。",
      "intents": [
        "list_new_listings",
        "inspect_security_lifecycle"
      ],
      "path": "/api/gendangzou/securities/changes",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/security.lifecycle.changes",
      "parameters": [
        "start",
        "end",
        "status",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "security.lifecycle.list",
        "company.detail",
        "company.sectors.list"
      ],
      "freshness": "daily_snapshot_from_hourly_official_exchange_catalog",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/security.lifecycle.changes",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "start",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "prelisted",
                    "listed",
                    "delisted",
                    "cancelled"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "SecurityLifecycleChangeListResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/SecurityLifecycleChange"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "snapshot",
            "items",
            "pagination"
          ],
          "title": "SecurityLifecycleChangeListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "company.search",
      "domain": "company",
      "title": "搜索A股公司",
      "summary": "按股票代码、股票简称或公司全称搜索沪深北A股公司，并返回证券生命周期及当前板块关系摘要。",
      "intents": [
        "search_company",
        "resolve_company_name",
        "resolve_stock_code",
        "inspect_company_mapping"
      ],
      "path": "/api/gendangzou/companies",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/company.search",
      "parameters": [
        "q",
        "lifecycle_status",
        "exchange",
        "board",
        "sector_id",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "business_date",
        "snapshot",
        "query",
        "lifecycle_status",
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "company.detail",
        "company.sectors.list",
        "security.lifecycle.list"
      ],
      "freshness": "hourly_official_exchange_catalog",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/company.search",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "schema": {
              "maxLength": 100,
              "minLength": 1,
              "type": "string"
            }
          },
          {
            "name": "lifecycle_status",
            "in": "query",
            "required": false,
            "schema": {
              "default": "current",
              "enum": [
                "current",
                "all",
                "prelisted",
                "listed",
                "delisted",
                "cancelled"
              ],
              "type": "string"
            }
          },
          {
            "name": "exchange",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "SSE",
                    "SZSE",
                    "BSE"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "board",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "MAIN",
                    "STAR",
                    "CHINEXT",
                    "BSE"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "sector_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 2,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "compact",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "CompanySearchResponse",
        "top_level_fields": [
          {
            "name": "business_date",
            "required": true
          },
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "query",
            "required": true
          },
          {
            "name": "lifecycle_status",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "business_date": {
              "title": "Business Date",
              "type": "string"
            },
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "query": {
              "description": "去除首尾空白后的实际搜索词。",
              "title": "Query",
              "type": "string"
            },
            "lifecycle_status": {
              "description": "本次搜索使用的证券生命周期范围。",
              "enum": [
                "current",
                "all",
                "prelisted",
                "listed",
                "delisted",
                "cancelled"
              ],
              "title": "Lifecycle Status",
              "type": "string"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/CompanySearchItem"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "business_date",
            "snapshot",
            "query",
            "lifecycle_status",
            "items",
            "pagination"
          ],
          "title": "CompanySearchResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "company.by_sector.list",
      "domain": "company",
      "title": "查询板块关联公司",
      "summary": "按关系类型、状态和最低关系分查询板块公司映射。",
      "intents": [
        "list_sector_companies",
        "inspect_company_mapping"
      ],
      "path": "/api/gendangzou/sectors/{sector_id}/companies",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/company.by_sector.list",
      "parameters": [
        "sector_id",
        "relation_type",
        "status",
        "min_score",
        "include_incomplete",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "items",
        "coverage",
        "pagination"
      ],
      "related_capabilities": [
        "company.search",
        "company.detail",
        "evidence.relation_materials.list"
      ],
      "freshness": "daily_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/company.by_sector.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "sector_id",
            "in": "path",
            "required": true,
            "schema": {
              "maxLength": 128,
              "minLength": 3,
              "type": "string"
            }
          },
          {
            "name": "relation_type",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "business",
                    "market"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": "active,watched"
            }
          },
          {
            "name": "min_score",
            "in": "query",
            "required": false,
            "schema": {
              "default": 0.0,
              "maximum": 1.0,
              "minimum": 0.0,
              "type": "number"
            }
          },
          {
            "name": "include_incomplete",
            "in": "query",
            "required": false,
            "schema": {
              "default": false,
              "type": "boolean"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "CompanyRelationListResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          },
          {
            "name": "coverage",
            "required": false
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/CompanySectorRelation"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            },
            "coverage": {
              "additionalProperties": {
                "type": "integer"
              },
              "title": "Coverage",
              "type": "object"
            }
          },
          "required": [
            "snapshot",
            "items",
            "pagination"
          ],
          "title": "CompanyRelationListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "company.sectors.list",
      "domain": "company",
      "title": "反查公司所属板块",
      "summary": "按股票代码查询最新有效版本中的多对多板块关系。",
      "intents": [
        "list_company_sectors",
        "inspect_company_mapping"
      ],
      "path": "/api/gendangzou/companies/{stock_code}/sectors",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/company.sectors.list",
      "parameters": [
        "stock_code",
        "relation_type",
        "status",
        "min_score",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "items",
        "coverage",
        "pagination"
      ],
      "related_capabilities": [
        "company.search",
        "company.detail",
        "evidence.company.list"
      ],
      "freshness": "daily_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/company.sectors.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "stock_code",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9]{6}$",
              "type": "string"
            }
          },
          {
            "name": "relation_type",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "business",
                    "market"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": "active,watched"
            }
          },
          {
            "name": "min_score",
            "in": "query",
            "required": false,
            "schema": {
              "default": 0.0,
              "maximum": 1.0,
              "minimum": 0.0,
              "type": "number"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "CompanyRelationListResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          },
          {
            "name": "coverage",
            "required": false
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/CompanySectorRelation"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            },
            "coverage": {
              "additionalProperties": {
                "type": "integer"
              },
              "title": "Coverage",
              "type": "object"
            }
          },
          "required": [
            "snapshot",
            "items",
            "pagination"
          ],
          "title": "CompanyRelationListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "company.detail",
      "domain": "company",
      "title": "获取公司板块概况",
      "summary": "返回公司市场标识及其当前有效、观察中和候选板块关系。",
      "intents": [
        "get_company_detail",
        "inspect_company_mapping"
      ],
      "path": "/api/gendangzou/companies/{stock_code}",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/company.detail",
      "parameters": [
        "stock_code",
        "snapshot_id",
        "as_of",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "stock_code",
        "stock_name",
        "market",
        "exchange",
        "board",
        "lifecycle_status",
        "listing_date",
        "market_data_status",
        "sectors"
      ],
      "related_capabilities": [
        "company.search",
        "company.sectors.list",
        "evidence.company.list"
      ],
      "freshness": "daily_snapshot",
      "pagination": false,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/company.detail",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context"
      },
      "request": {
        "parameters": [
          {
            "name": "stock_code",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9]{6}$",
              "type": "string"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "CompanyDetailResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "stock_code",
            "required": true
          },
          {
            "name": "stock_name",
            "required": true
          },
          {
            "name": "company_name",
            "required": false
          },
          {
            "name": "market",
            "required": true
          },
          {
            "name": "exchange",
            "required": true
          },
          {
            "name": "board",
            "required": true
          },
          {
            "name": "lifecycle_status",
            "required": false
          },
          {
            "name": "listing_date",
            "required": false
          },
          {
            "name": "market_data_status",
            "required": false
          },
          {
            "name": "sectors",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "stock_code": {
              "title": "Stock Code",
              "type": "string"
            },
            "stock_name": {
              "title": "Stock Name",
              "type": "string"
            },
            "company_name": {
              "default": "",
              "title": "Company Name",
              "type": "string"
            },
            "market": {
              "title": "Market",
              "type": "string"
            },
            "exchange": {
              "title": "Exchange",
              "type": "string"
            },
            "board": {
              "title": "Board",
              "type": "string"
            },
            "lifecycle_status": {
              "default": "listed",
              "enum": [
                "prelisted",
                "listed",
                "delisted",
                "cancelled",
                "unknown"
              ],
              "title": "Lifecycle Status",
              "type": "string"
            },
            "listing_date": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "title": "Listing Date"
            },
            "market_data_status": {
              "default": "ready",
              "enum": [
                "ready",
                "pending",
                "missing",
                "unavailable"
              ],
              "title": "Market Data Status",
              "type": "string"
            },
            "sectors": {
              "items": {
                "$ref": "#/$defs/CompanySectorRelation"
              },
              "title": "Sectors",
              "type": "array"
            }
          },
          "required": [
            "snapshot",
            "stock_code",
            "stock_name",
            "market",
            "exchange",
            "board",
            "sectors"
          ],
          "title": "CompanyDetailResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "etf.list",
      "domain": "etf",
      "title": "查询境内被动权益 ETF",
      "summary": "按代码、名称、交易所、产品范围或跟踪指数查询 ETF。",
      "intents": [
        "list_etfs",
        "search_etf",
        "compare_etfs"
      ],
      "path": "/api/gendangzou/etfs",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/etf.list",
      "parameters": [
        "q",
        "exchange",
        "product_scope",
        "tracking_index_code",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "etf.detail",
        "etf.sectors.list"
      ],
      "freshness": "daily_official_pcf_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "minLength": 1,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "exchange",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "SSE",
                    "SZSE"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "product_scope",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "broad",
                    "sector"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "tracking_index_code",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 32,
                  "minLength": 2,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "EtfListResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/EtfSummary"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "snapshot",
            "items",
            "pagination"
          ],
          "title": "EtfListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "etf.detail",
      "domain": "etf",
      "title": "获取 ETF 板块概况",
      "summary": "返回 ETF 产品元数据、跟踪指数及可追溯板块暴露。",
      "intents": [
        "get_etf_detail",
        "analyze_etf_exposure"
      ],
      "path": "/api/gendangzou/etfs/{etf_code}",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/etf.detail",
      "parameters": [
        "etf_code",
        "snapshot_id",
        "as_of",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "etf"
      ],
      "related_capabilities": [
        "etf.sectors.list",
        "etf.relation.evidence",
        "etf.relation.contributions",
        "etf.relation.changes"
      ],
      "freshness": "daily_official_pcf_snapshot",
      "pagination": false,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.detail",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context"
      },
      "request": {
        "parameters": [
          {
            "name": "etf_code",
            "in": "path",
            "required": true,
            "schema": {
              "description": "Six-digit fund code or stable SH./SZ. ETF key",
              "pattern": "^(?:(?:SH|SZ)\\.)?[0-9]{6}$",
              "type": "string"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "EtfDetailResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "etf",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "etf": {
              "$ref": "#/$defs/EtfDetail"
            }
          },
          "required": [
            "snapshot",
            "etf"
          ],
          "title": "EtfDetailResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "etf.sectors.list",
      "domain": "etf",
      "title": "反查 ETF 对应板块",
      "summary": "依据官方申赎篮子、跟踪指数、公司关系和板块路径，查询 ETF 的直接或扩展板块关系。",
      "intents": [
        "list_etf_sectors",
        "analyze_etf_exposure"
      ],
      "path": "/api/gendangzou/etfs/{etf_code}/sectors",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/etf.sectors.list",
      "parameters": [
        "etf_code",
        "status",
        "min_exposure",
        "relation_scope",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "items",
        "coverage",
        "pagination"
      ],
      "related_capabilities": [
        "etf.detail",
        "etf.relation.evidence",
        "etf.relation.contributions",
        "etf.relation.changes"
      ],
      "freshness": "daily_official_pcf_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.sectors.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "etf_code",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^(?:(?:SH|SZ)\\.)?[0-9]{6}$",
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": "active,watched,candidate"
            }
          },
          {
            "name": "min_exposure",
            "in": "query",
            "required": false,
            "schema": {
              "default": 0.0,
              "maximum": 1.0,
              "minimum": 0.0,
              "type": "number"
            }
          },
          {
            "name": "relation_scope",
            "in": "query",
            "required": false,
            "schema": {
              "default": "all",
              "description": "Filter direct, lineage-expanded, related or reference relations",
              "enum": [
                "all",
                "direct",
                "extended",
                "related",
                "reference"
              ],
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "EtfRelationListResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          },
          {
            "name": "coverage",
            "required": false
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/EtfSectorRelation"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            },
            "coverage": {
              "additionalProperties": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "number"
                  }
                ]
              },
              "title": "Coverage",
              "type": "object"
            }
          },
          "required": [
            "snapshot",
            "items",
            "pagination"
          ],
          "title": "EtfRelationListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "etf.by_sector.list",
      "domain": "etf",
      "title": "查询板块关联 ETF",
      "summary": "按板块查询直接映射、血缘扩展和上级参考 ETF，各类关系分开标识且不构成产品推荐。",
      "intents": [
        "list_sector_etfs",
        "map_sector_to_etfs",
        "compare_etfs"
      ],
      "path": "/api/gendangzou/sectors/{sector_id}/etfs",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/etf.by_sector.list",
      "parameters": [
        "sector_id",
        "product_scope",
        "status",
        "min_exposure",
        "relation_scope",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "items",
        "coverage",
        "pagination"
      ],
      "related_capabilities": [
        "sector.detail",
        "etf.detail",
        "etf.relation.evidence",
        "etf.relation.contributions"
      ],
      "freshness": "daily_official_pcf_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.by_sector.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "sector_id",
            "in": "path",
            "required": true,
            "schema": {
              "maxLength": 128,
              "minLength": 3,
              "type": "string"
            }
          },
          {
            "name": "product_scope",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "broad",
                    "sector"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": "active,watched,candidate"
            }
          },
          {
            "name": "min_exposure",
            "in": "query",
            "required": false,
            "schema": {
              "default": 0.0,
              "maximum": 1.0,
              "minimum": 0.0,
              "type": "number"
            }
          },
          {
            "name": "relation_scope",
            "in": "query",
            "required": false,
            "schema": {
              "default": "all",
              "description": "Filter direct, lineage-expanded, related or reference relations",
              "enum": [
                "all",
                "direct",
                "extended",
                "related",
                "reference"
              ],
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "EtfRelationListResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          },
          {
            "name": "coverage",
            "required": false
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/EtfSectorRelation"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            },
            "coverage": {
              "additionalProperties": {
                "anyOf": [
                  {
                    "type": "integer"
                  },
                  {
                    "type": "number"
                  }
                ]
              },
              "title": "Coverage",
              "type": "object"
            }
          },
          "required": [
            "snapshot",
            "items",
            "pagination"
          ],
          "title": "EtfRelationListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "etf.relation.evidence",
      "domain": "etf",
      "title": "查询 ETF 与板块关系依据",
      "summary": "返回官方 PCF、跟踪指数匹配、板块路径、计算公式和主要成分贡献摘要。",
      "intents": [
        "trace_etf_sector_relation",
        "audit_etf_exposure"
      ],
      "path": "/api/gendangzou/etf-sector-relations/{relation_id}/evidence",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/etf.relation.evidence",
      "parameters": [
        "relation_id",
        "snapshot_id",
        "as_of",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "relation",
        "items"
      ],
      "related_capabilities": [
        "etf.detail",
        "etf.sectors.list",
        "etf.by_sector.list",
        "etf.relation.contributions",
        "etf.relation.changes"
      ],
      "freshness": "daily_official_pcf_snapshot",
      "pagination": false,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.relation.evidence",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context"
      },
      "request": {
        "parameters": [
          {
            "name": "relation_id",
            "in": "path",
            "required": true,
            "schema": {
              "maxLength": 128,
              "minLength": 12,
              "type": "string"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "EtfRelationEvidenceResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "relation",
            "required": true
          },
          {
            "name": "items",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "relation": {
              "$ref": "#/$defs/EtfSectorRelation"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/EtfRelationEvidence"
              },
              "title": "Items",
              "type": "array"
            }
          },
          "required": [
            "snapshot",
            "relation",
            "items"
          ],
          "title": "EtfRelationEvidenceResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "etf.relation.contributions",
      "domain": "etf",
      "title": "审计 ETF、公司与板块贡献链",
      "summary": "分页返回每个篮子成分、公司板块关系及其对调整暴露的完整贡献。",
      "intents": [
        "audit_etf_exposure",
        "trace_etf_company_sector_contribution"
      ],
      "path": "/api/gendangzou/etf-sector-relations/{relation_id}/contributions",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/etf.relation.contributions",
      "parameters": [
        "relation_id",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "relation",
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "etf.relation.evidence",
        "etf.relation.changes",
        "company.sectors.list"
      ],
      "freshness": "daily_official_pcf_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.relation.contributions",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "relation_id",
            "in": "path",
            "required": true,
            "schema": {
              "maxLength": 128,
              "minLength": 12,
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "EtfRelationContributionResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "relation",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "relation": {
              "$ref": "#/$defs/EtfSectorRelation"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/EtfCompanySectorContribution"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "snapshot",
            "relation",
            "items",
            "pagination"
          ],
          "title": "EtfRelationContributionResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "etf.relation.changes",
      "domain": "etf",
      "title": "查询 ETF 板块暴露变化",
      "summary": "返回关系创建、状态跨档、显著暴露变化和失效事件，并说明变化来源。",
      "intents": [
        "inspect_etf_exposure_changes",
        "audit_etf_exposure"
      ],
      "path": "/api/gendangzou/etf-sector-relations/{relation_id}/changes",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/etf.relation.changes",
      "parameters": [
        "relation_id",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "relation_id",
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "etf.relation.evidence",
        "etf.relation.contributions",
        "etf.sectors.list"
      ],
      "freshness": "daily_official_pcf_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.relation.changes",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "relation_id",
            "in": "path",
            "required": true,
            "schema": {
              "maxLength": 128,
              "minLength": 12,
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "EtfRelationChangeResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "relation_id",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "relation_id": {
              "description": "ETF 与板块关系的稳定标识。",
              "title": "Relation Id",
              "type": "string"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/EtfRelationChangeEvent"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "snapshot",
            "relation_id",
            "items",
            "pagination"
          ],
          "title": "EtfRelationChangeResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "evidence.sector.list",
      "domain": "evidence",
      "title": "查询板块证据",
      "summary": "查询板块生成、政策热度、市场关注和资金确认的可溯源依据。",
      "intents": [
        "trace_evidence",
        "audit_sector",
        "explain_sector_signal"
      ],
      "path": "/api/gendangzou/sectors/{sector_id}/evidence",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/evidence.sector.list",
      "parameters": [
        "sector_id",
        "kind",
        "view",
        "presentation",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "sector.detail",
        "material.policy.list",
        "material.media.list"
      ],
      "freshness": "daily_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/evidence.sector.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": false,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "sector_id",
            "in": "path",
            "required": true,
            "schema": {
              "maxLength": 128,
              "minLength": 3,
              "type": "string"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "schema": {
              "default": "all",
              "enum": [
                "all",
                "heat",
                "taxonomy",
                "market",
                "trading"
              ],
              "type": "string"
            }
          },
          {
            "name": "view",
            "in": "query",
            "required": false,
            "schema": {
              "default": "all",
              "enum": [
                "all",
                "policy",
                "market_attention",
                "market_trading"
              ],
              "type": "string"
            }
          },
          {
            "name": "presentation",
            "in": "query",
            "required": false,
            "schema": {
              "default": "material",
              "enum": [
                "material",
                "trace"
              ],
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "EvidenceListResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/EvidenceItem"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "snapshot",
            "items",
            "pagination"
          ],
          "title": "EvidenceListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "evidence.relation.list",
      "domain": "evidence",
      "title": "查询公司板块关系证据",
      "summary": "按关系 ID 查询底层事实证据，用于细粒度审计。",
      "intents": [
        "trace_company_relation",
        "audit_company_mapping"
      ],
      "path": "/api/gendangzou/company-sector-relations/{relation_id}/evidence",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/evidence.relation.list",
      "parameters": [
        "relation_id",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "evidence.relation_materials.list"
      ],
      "freshness": "daily_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/evidence.relation.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": false,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "relation_id",
            "in": "path",
            "required": true,
            "schema": {
              "maxLength": 128,
              "minLength": 8,
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "EvidenceListResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/EvidenceItem"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "snapshot",
            "items",
            "pagination"
          ],
          "title": "EvidenceListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "evidence.relation_materials.list",
      "domain": "evidence",
      "title": "按材料查询公司映射证据",
      "summary": "将同一文档中的公司业务事实归并展示，是 Agent 的推荐映射审计接口。",
      "intents": [
        "trace_company_relation",
        "audit_company_mapping"
      ],
      "path": "/api/gendangzou/company-sector-relations/{relation_id}/evidence-materials",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/evidence.relation_materials.list",
      "parameters": [
        "relation_id",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "summary",
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "evidence.relation.list",
        "company.by_sector.list"
      ],
      "freshness": "daily_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/evidence.relation_materials.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": false,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "relation_id",
            "in": "path",
            "required": true,
            "schema": {
              "maxLength": 128,
              "minLength": 8,
              "type": "string"
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 20,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "RelationEvidenceMaterialListResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "summary",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "summary": {
              "$ref": "#/$defs/RelationEvidenceMaterialSummary"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/RelationEvidenceMaterial"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "snapshot",
            "summary",
            "items",
            "pagination"
          ],
          "title": "RelationEvidenceMaterialListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "evidence.company.list",
      "domain": "evidence",
      "title": "查询公司的全部板块证据",
      "summary": "按股票代码查询全部关系证据，可进一步限定板块。",
      "intents": [
        "trace_company_relations",
        "audit_company_mapping"
      ],
      "path": "/api/gendangzou/companies/{stock_code}/sector-evidence",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/evidence.company.list",
      "parameters": [
        "stock_code",
        "sector_id",
        "snapshot_id",
        "as_of",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot",
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "company.sectors.list",
        "evidence.relation_materials.list"
      ],
      "freshness": "daily_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/evidence.company.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": false,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "stock_code",
            "in": "path",
            "required": true,
            "schema": {
              "pattern": "^[0-9]{6}$",
              "type": "string"
            }
          },
          {
            "name": "sector_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 3,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "snapshot_id",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 128,
                  "minLength": 8,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "EvidenceListResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          },
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            },
            "items": {
              "items": {
                "$ref": "#/$defs/EvidenceItem"
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "snapshot",
            "items",
            "pagination"
          ],
          "title": "EvidenceListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "snapshot.list",
      "domain": "snapshot",
      "title": "查询历史完整快照",
      "summary": "按日期区间返回可复现的完整发布快照。",
      "intents": [
        "list_snapshots",
        "select_historical_date",
        "compare_history"
      ],
      "path": "/api/gendangzou/snapshots",
      "snapshot_bound": false,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/snapshot.list",
      "parameters": [
        "start",
        "end",
        "page",
        "page_size",
        "detail",
        "include"
      ],
      "response_fields": [
        "items",
        "pagination"
      ],
      "related_capabilities": [
        "snapshot.latest"
      ],
      "freshness": "daily_snapshot",
      "pagination": true,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/snapshot.list",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": false,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context",
        "recommended_page_size": 10
      },
      "request": {
        "parameters": [
          {
            "name": "start",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "end",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null
            }
          },
          {
            "name": "page",
            "in": "query",
            "required": false,
            "schema": {
              "default": 1,
              "description": "1-based page number",
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "page_size",
            "in": "query",
            "required": false,
            "schema": {
              "default": 50,
              "maximum": 100,
              "minimum": 1,
              "type": "integer"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "SnapshotListResponse",
        "top_level_fields": [
          {
            "name": "items",
            "required": true
          },
          {
            "name": "pagination",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "items": {
              "items": {
                "anyOf": [
                  {
                    "$ref": "#/$defs/SnapshotContext"
                  },
                  {
                    "$ref": "#/$defs/SnapshotReference"
                  }
                ]
              },
              "title": "Items",
              "type": "array"
            },
            "pagination": {
              "$ref": "#/$defs/Pagination"
            }
          },
          "required": [
            "items",
            "pagination"
          ],
          "title": "SnapshotListResponse",
          "type": "object"
        }
      }
    },
    {
      "id": "snapshot.latest",
      "domain": "snapshot",
      "title": "获取最新完整快照",
      "summary": "获取最新快照，或指定日期之前最近的完整快照。",
      "intents": [
        "get_latest_snapshot",
        "get_version_context"
      ],
      "path": "/api/gendangzou/snapshots/latest",
      "snapshot_bound": true,
      "compact_supported": true,
      "method": "GET",
      "detail_url": "/api/gendangzou/capabilities/snapshot.latest",
      "parameters": [
        "as_of",
        "detail",
        "include"
      ],
      "response_fields": [
        "snapshot"
      ],
      "related_capabilities": [
        "snapshot.list",
        "signal.heat.rank",
        "signal.dynamics.list"
      ],
      "freshness": "daily_snapshot",
      "pagination": false,
      "documentation_url": "https://docs.mobiusquant.ai/zh/gendangzou/capabilities/snapshot.latest",
      "agent_hints": {
        "reuse_snapshot_id_for_follow_up": true,
        "fetch_evidence_on_demand": true,
        "recommended_detail": "compact",
        "compact_scope": "snapshot_context"
      },
      "request": {
        "parameters": [
          {
            "name": "as_of",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "format": "date",
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Return the latest snapshot on or before this date"
            }
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "default": "full",
              "description": "full preserves the complete web response; compact returns the stable snapshot reference intended for agents",
              "enum": [
                "full",
                "compact"
              ],
              "type": "string"
            }
          },
          {
            "name": "include",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "maxLength": 80,
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "default": null,
              "description": "Comma-separated compact snapshot expansions: sector_dynamics,coverage"
            }
          }
        ]
      },
      "response": {
        "model": "SnapshotResponse",
        "top_level_fields": [
          {
            "name": "snapshot",
            "required": true
          }
        ],
        "schema": {
          "properties": {
            "snapshot": {
              "anyOf": [
                {
                  "$ref": "#/$defs/SnapshotContext"
                },
                {
                  "$ref": "#/$defs/SnapshotReference"
                }
              ],
              "title": "Snapshot"
            }
          },
          "required": [
            "snapshot"
          ],
          "title": "SnapshotResponse",
          "type": "object"
        }
      }
    }
  ]
}