板块与公司映射

公司搜索

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

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 或公司证据能力。

数据模型

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

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

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

关系类型

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

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

关系状态

默认查询 active,watched：

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

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

关系分和置信度

两者回答不同问题：

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

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

推荐审计路径

从板块查公司：

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

从公司查板块：

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

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

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

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

股票代码

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

000001
688981

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

资金贡献与关联公司

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

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

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