板块与公司映射

公司搜索

先用 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. 结论：当前关系类型、状态和限制。

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

公司研究档案

公司板块关系回答“公司为什么属于这个板块”，公司研究档案回答“公开材料能够证明这家 公司存在哪些事实”。两套数据相互关联，但不共用评分，也不能互相替代。

先查询板块公司的研究覆盖：

company.research.by_sector.list
  -> available=true
  -> company.research.detail
  -> company.research.facts.list
  -> company.research.fact_evidence.list

available=true 只表示已有通过质量门控并正式发布的研究档案。available=false 表示 所选日期没有可公开读取的研究版本；接口不会返回排队、处理中、失败或模型调用信息。

研究档案按五类组织：

分类	主要事实范围
国资穿透	企业身份、股东权益、实际控制、治理与股东行为
政策支持	政策资质、财政及公共支持、政府与公共部门交易
融资与债务	债务融资、偿债能力、担保授信、关联资金与或有风险
募资与资本用途	募集资金用途、权益资本事件、并购重组与资产转让
业务与项目	主营业务、产业位置、重大项目、资产和产能

事实列表保留事实日期、陈述性质、置信度、独立材料数和引文数。继续查询 company.research.fact_evidence.list 可取得归并后的原始材料、页码、链接和原文引文。 调用方应展示事实及其证据，不把分类数量合成为公司投资评分。

股票代码

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

000001
688981

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

资金贡献与关联公司

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

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

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