---
title: 板块与公司映射
description: 动态多对多公司关系、关系类型、状态、关系分、置信度和可溯源业务事实。
pageClass: gendangzou-doc
---

# 板块与公司映射

## 公司搜索

先用 `company.search` 将自然语言中的公司名称解析为稳定股票代码：

```http
GET /api/gendangzou/companies?q=长鑫科技
GET /api/gendangzou/companies?q=688981
```

`q` 同时匹配股票代码、股票简称和公司全称。默认返回已上市和待上市公司，可使用
`lifecycle_status`、`exchange`、`board` 或 `sector_id` 过滤。公司身份和生命周期来自
沪深北交易所名册，板块摘要来自响应中标明的完整快照。取得 `stock_code` 后再查询
`company.detail`、`company.sectors.list` 或公司证据能力。

## 数据模型

板块与上市公司是动态多对多关系：

```text
公司 -> 公司业务事实 -> 公司板块关系 -> 板块
```

同一公司可以属于多个板块，一个板块也可以关联多家公司。板块目录发生演化、公司业务
变化或新公告进入资料池时，关系可以新增、升降级或进入观察状态。

## 关系类型

- `business`：财报、公告、问询回复、投资者关系记录等材料能够证明公司自身业务与
  板块定义相关。
- `market`：权威媒体或财经报道提供了时效性市场关系，但尚不足以单独证明稳定主营业务。

市场关系可以补充动态变化，不能覆盖更强的公司正式披露事实。

## 关系状态

默认查询 `active,watched`：

- `active`：当前证据支持稳定展示。
- `watched`：存在一定关系，但证据强度、持续性或业务实质仍需观察。

调用方不应把观察中关系与确定关系等量展示。需要内部不完整项时才使用
`include_incomplete=true`。

## 关系分和置信度

两者回答不同问题：

| 指标 | 回答的问题 |
| --- | --- |
| 关系分 | 公司业务事实与板块定义、边界和价值链位置匹配得有多强 |
| 置信度 | 支撑材料是否权威、直接、完整、一致且仍然有效 |

高置信度不必然意味着高关系分。例如，一份权威公告准确提到公司提供相关投行业务，
材料本身可信，但它并不能证明公司经营该产业，关系分应较低。

## 推荐审计路径

从板块查公司：

```text
company.by_sector.list
  -> relation_id
  -> evidence.relation_materials.list
```

从公司查板块：

```text
company.search
  -> company.sectors.list
  -> relation_id
  -> evidence.relation_materials.list
```

归并材料响应应提供简短映射说明，结构为：

1. 材料事实：公司实际做了什么。
2. 映射逻辑：该事实位于板块价值链什么位置，是否属于主营或可验证能力。
3. 结论：当前关系类型、状态和限制。

只有“命中板块关键词”而没有业务实质的材料，不足以建立高质量映射。

## 股票代码

`stock_code` 使用六位 A 股代码字符串并保留前导零，例如：

```text
000001
688981
```

不要把股票代码转换为整数。

## 资金贡献与关联公司

板块关联公司数和资金贡献公司数可能不同。资金聚合还要求：

- 关系状态和关系权重满足资金计算规则。
- 对应交易日存在有效行情。
- 停牌、缺失值和异常值已经按运行口径处理。

因此，“对板块资金有贡献”一定来自可用映射关系，但“属于板块”不保证当天进入资金
聚合。调用 `signal.trading_contributors.list` 可以查看实际参与计算的公司及权重。