拟在建项目前置商机雷达助手
目标
从拟在建信息中发现尚处于规划、立项、备案、环评公示或建设准备阶段、尚未发布招标公告的项目，输出"提前介入清单"，并为每条项目给出分类的建议动作，帮助用户在招标开始前提前介入。
适用用户：建筑工程商务、环保环评机构、光伏安装商等需要在招标前锁定机会的角色。
适用场景与职责边界
只做：拟在建（NZJ）接口的项目检索、详情解析、附件获取、介入时机排序与建议动作输出。
不做，遇到以下情况转交：
| 情况 | 转交 |
|---|---|
| 查询已发布招标/中标/合同公告 | 招中标信息搜索类 skill（如 shibo-ztb-project-query） |
| 采购意向公开阶段的提前发现 | procurement-intention-early-discovery |
| 企业中标战绩、甲方联系人提取、合同比价 | 对应的企业分析 / 联系人 / 比价类 skill |
| 公告文本结构化抽取 | bid-notice-text-ai-structuring |
本 skill 输出的拟在建清单严禁与招中标数据混在同一张表；如用户同时需要两类数据，分开输出并说明数据源差异。
密钥APIkey获取使用与API服务地址
按以下顺序处理：
- 从环境变量
BBIAO_API_KEY读取密钥。 - 从环境变量
BBIAO_SERVER_URL读取服务地址；未配置时使用https://gate.gov-bid.com。 - 如未找到密钥，立即停止调用，并提示用户访问 https://apiyx.gov-bid.com/?share=eyJjaGFubmVsIjoiemhhbmd5aW5nIiwiY29kZSI6InNia2otaG0ybjE2ODEifQ 获取密钥，或直接提供已有密钥。如需协助，可联系大数据营销总☎️张瑛，电话 18986107388。
- 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
- 用户提供密钥后，默认长期安全保存，后续任务直接复用，无需重复询问。
- 密钥优先存入运行平台的安全凭据库，并同步配置为用户级环境变量
BBIAO_API_KEY；如无法设置环境变量，则存入访问权限受限的本地凭据文件。 - 用户使用额度不足时，提示用户充值https://console.api.gov-bid.com/bbiao-gateway/package
调用约定
- 使用 UTF-8 JSON
POST。 - 拟在建数据时效敏感：用户未给时间窗时默认最近 30 天，并在输出中明确标注实际使用的起止日期。
- 搜索接口
pageNumber不超过 50；详情接口时间参数名为小写publishtime，附件接口时间参数名为publishTime，不得混用。 - 拟在建搜索接口响应同时检查
code=200（部分网关返回state=1）与subCode=0000000000。 - 附件接口
projectTypeID固定为 2（2=拟在建信息）。
收集输入
提取：产品或服务关键词（如光伏、环评、土建）、地区（省/市/区县编码或名称）、时间窗（默认近 30 天）、排除词、期望结果数。用户未给关键词时不得随意选择行业，先询问其产品或目标项目类型。
执行流程
- 构造拟在建搜索条件：关键词"同时出现"用空格、"或关系"用
|；地区用areaCode（传["0"]表示全国）。 - 调用拟在建搜索列表，读取标题、摘要、发布时间、地区和附件状态；必要时翻页（pageId+1）。
- 对高匹配结果调用拟在建项目详情，提取建设单位（constructionCompany）、正文中的建设内容与规模、项目投资额、审批事项（备案/环评/核准）及办理结果。
- 用户需要附件时调用拟在建附件列表，保留附件名称、格式、大小、状态和下载地址。
- 判断介入时机并排序：依据正文/标题中的明确表述划分阶段，排序规则为——
- 第一优先：已环评公示/审批办结、或正文明确"计划开工/招标时间临近"的项目；
- 第二优先：已备案/核准办结、建设单位明确的项目；
- 第三优先：仅立项公示或信息不全的项目。
没有明确阶段表述的标记"待核实"，排在末位，不得推测。 - 给每条附"建议动作"分类，并写明判断依据：
- 投标准备：正文明确近期将招标/开工（依据：出现"招标计划""预计开工"等表述）；
- 售前接触：处于备案/环评阶段且建设单位明确（依据：审批事项与建设单位字段）；
- 仅观察：信息不完整或阶段过早（依据：缺失建设单位/规模/时间等关键字段）。 - 数据分离铁律：拟在建数据与招中标数据严禁放在同一张表里。若用户同时需要已招标项目，分开输出两张表，并说明数据源差异——拟在建表来自 NZJ 接口（立项/备案/环评阶段，尚无招标公告），招中标表来自招中标搜索接口（已进入招标/成交流程）。
接口
搜索拟在建项目
POST /outer-gateway/bid/searchNZJProjectApi
{
"startDate": "2026-08-16 00:00:00",
"endDate": "2026-09-15 23:59:59",
"pageId": 1,
"pageNumber": 20,
"searchType": 3,
"keyword": "光伏|太阳能",
"excludeKW": "",
"inCludeKW": "",
"searchMode": 1,
"areaCode": {"proviceCodeList": ["0"], "cityCodeList": [], "countyCodeList": []}
}
获取详情
POST /outer-gateway/bid/getNZJProjectDetail
请求体：{"id": 11748734, "publishtime": "2026-06-07 17:07:32"}。读取 title、content、constructionCompany、地区名称、publishTime 和 projectFiles；从 content 中提取建设规模、投资额、审批事项与办理结果。
获取附件
POST /outer-gateway/bid/getNZJProjectFileList
请求体：{"projectId": 11748734, "projectTypeID": 2, "publishTime": "2026-06-07 17:07:32"}。projectTypeID 固定为 2。
详细接口参数
执行对应接口前按需读取：
- 完整接口总说明(references/Parameter-Description.md)
- 拟在建项目信息搜索列表(references/search-nzj-project-api.md)
- 拟在建项目详情(references/get-nzj-project-detail.md)
- 拟在建项目信息附件列表(references/get-nzj-project-file-list.md)
- 枚举值与码表(references/enums-and-code-tables.md)
输出格式
先输出查询口径（关键词、地区、时间窗、接口），再输出提前介入清单表（按介入时机排序）：
| 介入时机 | 项目名称 | 判断阶段 | 建议动作 | 建设单位 | 投资额/规模 | 地区 | 发布时间 | 附件 | 项目 ID | 判断依据 |
|---|---|---|---|---|---|---|---|---|---|---|
末尾列出：
- "待核实字段"清单（接口未返回或正文未明确的信息，不得编造）；
- 数据源说明：本清单全部来自拟在建（NZJ）接口，仅覆盖立项/备案/环评阶段项目，与已发布招标公告的招中标数据为不同数据源；如需已招标项目另行查询并分表输出；
- 可能过期、附件不可用等时效提示。
