---
title: "获取板块详情"
description: "读取板块定义、边界、层级、生命周期和当前三类信号。"
pageClass: gendangzou-doc
---

# 获取板块详情

`sector.detail`

读取板块定义、边界、层级、生命周期和当前三类信号。

## 调用契约

| 项目 | 值 |
| --- | --- |
| Method | `GET` |
| Path | `/api/gendangzou/sectors/{sector_id}` |
| 业务域 | `sector` |
| 数据更新 | 随完整数据版本发布 |

受控意图：`analyze_sector`、`explain_sector`、`inspect_sector_boundary`

## 请求参数

| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
| --- | --- | --- | --- | --- |
| `sector_id` | path | string | 是 | 最短 3 字符；最长 128 字符 |
| `snapshot_id` | query | string | 否 | 最短 8 字符；最长 128 字符 |
| `as_of` | query | string | 否 | 返回此日期或此前最近的完整快照；格式 `date` |
| `detail` | query | string | 否 | full 保留完整 Web 响应；compact 返回供 Agent 使用的稳定快照引用；默认 `full`；可选 `full`、`compact` |
| `include` | query | string | 否 | 逗号分隔的精简版本扩展：sector_dynamics、coverage；最长 80 字符 |

## 最小调用

```bash
curl --fail --silent --show-error \
  -H "Authorization: Bearer $MOBIUSQUANT_TOKEN" \
  "https://api.mobiusquant.ai/api/gendangzou/sectors/<sector_id>?detail=compact"
```

将路径中的 `<...>` 替换为实际资源 ID。

## 响应

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `snapshot` | `SnapshotContext / SnapshotReference` | 是 | 本次查询实际使用的数据版本。 |
| `sector` | `SectorDetail` | 是 | 板块详情。 |

### `SectorDetail`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `sector_id` | `string` | 是 | 板块稳定标识。 |
| `name` | `string` | 是 | 对象名称。 |
| `layer` | `string` | 是 | 板块层级。 |
| `status` | `string` | 是 | 对象或关系的当前状态。 |
| `object_type` | `string` | 是 | 板块对象类型。 |
| `parent_id` | `string / null` | 否 | 直接上级板块标识。 |
| `parent_name` | `string / null` | 否 | 直接上级板块名称。 |
| `source_origin` | `string` | 是 | 板块定义的来源类型。 |
| `activation_weight` | `number` | 是 | 板块当前激活权重。 |
| `definition` | `string` | 否 | 板块定义。 |
| `aliases` | `array<string>` | 否 | 板块历史名称和常用别名。 |
| `include` | `array<string>` | 否 | 纳入板块定义的业务边界。 |
| `exclude` | `array<string>` | 否 | 明确不属于该板块的业务边界。 |
| `related_parents` | `array<string>` | 否 | - |
| `mapped_sw` | `array<string>` | 否 | - |
| `lifecycle` | `SectorLifecycle` | 否 | 板块生命周期状态和关键日期。 |
| `policy_heat` | `HeatValue / null` | 否 | 板块的政策热度。 |
| `market_attention` | `HeatValue / null` | 否 | 板块的即时市场关注度。 |
| `market_trading` | `HeatValue / null` | 否 | 板块的资金确认度。 |
| `children` | `array<SectorSummary>` | 否 | 板块的直接下级节点。 |
| `relationships` | `array<SectorRelationship>` | 否 | 该板块的一跳层级、产业和演化关系。 |
| `changes` | `array<SectorChange>` | 否 | 该板块的历史变更记录。 |
| `successor_ids` | `array<string>` | 否 | - |
| `taxonomy_evidence_count` | `integer` | 否 | - |
| `heat_evidence_count` | `integer` | 否 | - |

### `SectorLifecycle`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `state` | `string` | 否 | - |
| `current_in_snapshot` | `boolean` | 否 | 该板块是否存在于本次数据版本。 |
| `first_seen_as_of` | `string` | 否 | - |
| `last_seen_as_of` | `string` | 否 | - |
| `last_supported_as_of` | `string` | 否 | - |
| `last_active_as_of` | `string` | 否 | - |
| `inactive_since` | `string` | 否 | - |
| `inactive_reason` | `string` | 否 | - |
| `reactivated_as_of` | `string` | 否 | - |

### `HeatValue`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `level` | `number` | 是 | - |
| `momentum` | `number` | 是 | 相对上一可比版本的变化量。 |
| `contribution_count` | `integer` | 否 | 进入当前热度计算的贡献项数量。 |

### `SectorSummary`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `sector_id` | `string` | 是 | 板块稳定标识。 |
| `name` | `string` | 是 | 对象名称。 |
| `layer` | `string` | 是 | 板块层级。 |
| `status` | `string` | 是 | 对象或关系的当前状态。 |
| `object_type` | `string` | 是 | 板块对象类型。 |
| `parent_id` | `string / null` | 否 | 直接上级板块标识。 |
| `parent_name` | `string / null` | 否 | 直接上级板块名称。 |
| `source_origin` | `string` | 是 | 板块定义的来源类型。 |
| `activation_weight` | `number` | 是 | 板块当前激活权重。 |
| `definition` | `string` | 否 | 板块定义。 |
| `aliases` | `array<string>` | 否 | 板块历史名称和常用别名。 |
| `include` | `array<string>` | 否 | 纳入板块定义的业务边界。 |
| `exclude` | `array<string>` | 否 | 明确不属于该板块的业务边界。 |
| `related_parents` | `array<string>` | 否 | - |
| `mapped_sw` | `array<string>` | 否 | - |
| `lifecycle` | `SectorLifecycle` | 否 | 板块生命周期状态和关键日期。 |
| `policy_heat` | `HeatValue / null` | 否 | 板块的政策热度。 |
| `market_attention` | `HeatValue / null` | 否 | 板块的即时市场关注度。 |
| `market_trading` | `HeatValue / null` | 否 | 板块的资金确认度。 |

### `SectorRelationship`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `source_sector_id` | `string` | 是 | - |
| `source_sector_name` | `string` | 是 | - |
| `target_sector_id` | `string` | 是 | - |
| `target_sector_name` | `string` | 是 | - |
| `relation` | `string` | 是 | 板块节点之间的关系类型。 |
| `direction` | `string` | 是 | - |
| `confidence` | `string` | 否 | 结果置信度；不能与关系分或热度分互换。 |
| `rationale` | `string` | 否 | 当前判断或关系的依据。 |
| `effective_from` | `string` | 否 | - |
| `lifecycle_relation` | `boolean` | 否 | - |

### `SectorChange`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `change_id` | `string` | 是 | - |
| `effective_from` | `string` | 是 | - |
| `change_type` | `string` | 是 | - |
| `before` | `object` | 否 | - |
| `after` | `object` | 否 | - |
| `rationale` | `string` | 否 | 当前判断或关系的依据。 |

## 调用要点

- Agent 建议使用 `detail=compact` 控制上下文体积。
- 需要解释结论时，再调用关联证据能力。

## 关联能力

- [`sector.graph`](/zh/gendangzou/capabilities/sector.graph)
- [`evidence.sector.list`](/zh/gendangzou/capabilities/evidence.sector.list)
- [`company.by_sector.list`](/zh/gendangzou/capabilities/company.by_sector.list)

## 机器可读契约

- [完整能力清单](/zh/gendangzou/agent-manifest.json)
- [在线能力详情](https://api.mobiusquant.ai/api/gendangzou/capabilities/sector.detail)