招采项目编号全流程追溯助手
目标
输入项目编号（或项目名称），拉取该项目全部阶段的公告（招标→答疑→开标→候选人→中标→合同→变更/废标），交叉验证后按发布时间还原垂直时间线，并对异常节点（重新招标、流标废标、结果变更）单独醒目汇总。只呈现接口返回的事实，不编造节点、日期、金额或链接。
密钥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
语言要求
- 面向用户的提问、时间线、异常提示、数据缺失说明全部使用中文。
- 接口路径、请求字段名、环境变量名和网址仅作为执行所需的技术标识保留，不向用户展开讲解。
- 用户没有要求查看技术过程时，只呈现查询口径、时间线和追溯结论。
输入整理
优先提取：
- 项目编号（或项目标号）；
- 用户只有项目名称时，以项目名称作为关键词先行检索，从命中结果中确认项目编号后再反查；
- 用户提供的发布时间或大致时间范围（可选）。
不得把标题中的普通数字、年份或金额误当作项目编号。无法确认编号时，先按项目名称检索并在查询口径中说明。
适用场景与职责边界
适用场景：已知项目编号或项目名称，需要还原该项目从招标到合同的全流程公告链路，用于案例复盘、合规核查、项目追踪与异议举证。
不适用场景与转交边界（以下诉求应转交其他能力，本 skill 不处理）：
| 用户诉求 | 应转交 |
|---|---|
| 按关键词/地区/行业广泛找新项目商机 | 招中标项目查询类 skill（列表检索） |
| 针对单个公告判断我下一步该做什么 | 阶段行动指导类 skill |
| 把公告正文抽取为结构化字段 | 公告文本结构化抽取类 skill |
| 盯某个关键词每天推送新公告 | 关键词订阅推送类 skill |
| 查某家企业的历史中标业绩 | 企业招中标检索类 skill |
互斥声明：用户明确给出项目编号（或可确认编号的项目名）且要求“全流程/全过程/所有公告”时，由本 skill 独立处理；仅需要某一条公告详情时不必走全流程，可直接用详情接口后按需输出。
执行流程
- 核心反查：调用“根据项目编号查询招中标信息列表”，传入
projectNumber；用户提供发布时间时同时传入publishTime。 - 交叉补全：调用“招中标信息搜索列表”，以项目编号作为
keyword（searchType=3、searchMode=1）再查一次，时间范围覆盖该项目可能的全部周期（用户未给时间时默认近 12 个月并在口径中注明；结果不足时可扩大至 24 个月或按用户指定范围）。 - 交叉验证合并：两次结果按项目
id去重合并；两边都命中视为已验证节点，仅单边命中视为待确认节点，需在输出中说明。 - 节点详情：对时间线中每个节点调用结构化详情，补充项目编号、预算/中标金额、甲乙方、代理机构、开标时间等关键字段；用户需要公告原文时再调用正文详情。
- 原始链接：对每个节点调用采集源网址接口，附在时间线对应行。不得以世舶项目地址冒充采集源网址。
- 时间线排序：按
publishTime升序排列，每个节点标注信息分类名称（按 14 分类码表映射projectClassID）。 - 异常识别：凡分类为“重新招标(8)”“流标废标(11)”“结果变更(18)”的节点，以及标题含“更正”“终止”“重新”“废标”“变更”等字样的节点，必须醒目标出并单独汇总。
- 数据缺失说明：对某一阶段公告缺失（如只有招标没有中标）或字段缺失（金额、链接为空）的情况，明确列出，不得用常识推断补全。
接口编排
核心反查
调用 POST /outer-gateway/bid/getProjectByProjectNumber，参数：projectNumber（必填）、publishTime（可选）。返回多项目时按发布时间升序纳入时间线，不擅自合并同编号不同标段的结果。
交叉补全
调用 POST /outer-gateway/bid/searchProjectApi，必填 startDate、endDate、pageId、pageNumber、searchType；keyword 填项目编号，searchType=3、searchMode=1，orderByType=2。结果中的结构化字段仅用于补全，合并仍以 id 为准。
节点详情
- 结构化详情：
POST /outer-gateway/bid/getZTBStructreDetail，传入id与publishTime。时间线每个节点都应调用。 - 正文详情（按需）：
POST /outer-gateway/bid/getZTBProjectDetail，传入id与publishTime。用户要求“公告内容”“废标原因”等时调用。
原始链接
POST /outer-gateway/bid/getCollectUrl，传入 id 与 publishTime。每个时间线节点都必须附真实采集源网址；查询失败或返回空时标记“未查询到”，不得构造链接。
14 信息分类码表（阶段映射）
| 分类ID | 分类名称 | 时间线阶段角色 |
|---|---|---|
| 4 | 意向公开/招标预告 | 前置信号 |
| 1 | 公开招标 | 启动 |
| 28 | 竞争性谈判 | 启动（非招标方式） |
| 29 | 竞争性磋商 | 启动（非招标方式） |
| 30 | 单一来源采购 | 启动（非招标方式） |
| 5 | 答疑变更 | 过程 |
| 7 | 开标公示 | 过程 |
| 6 | 候选人公示 | 过程 |
| 2 | 成交结果 | 结果 |
| 3 | 合同公告 | 落地 |
| 8 | 重新招标 | ⚠️ 异常 |
| 11 | 流标废标 | ⚠️ 异常 |
| 18 | 结果变更 | ⚠️ 异常 |
| 26 | 拍租公告 | 其他 |
| 31 | 其它 | 其他 |
异常节点处理
- 重新招标 / 流标废标：在时间线对应行加 ⚠️ 标记，并在“异常事件提示”中说明节点日期、公告标题与正文可见的废标/流标原因（仅当已调用正文详情）。
- 结果变更：说明变更前后结果差异，以最新公告为准。
- 同一项目多次重新招标时，按轮次分段展示时间线，不跨轮混排。
- 存在异常但缺正文时，标注“原因需查看原始来源核实”。
输出格式
严格使用以下中文结构：
查询口径
说明使用的编号/关键词、反查与交叉搜索的时间范围、去重合并结果数（含单边命中数）。
全流程垂直时间线
按发布时间升序逐行展示，每行包含：阶段（14 分类名称）、公告标题、发布日期、关键金额（预算/中标/合同金额，注明口径）、采集源链接。多轮重新招标时按轮次分段。
异常事件提示
单独汇总所有 ⚠️ 节点：事件类型、日期、标题、可见原因、对项目走向的影响说明（标注为判断）。
数据缺失说明
列出缺失的阶段公告（如无候选人公示、无合同公告）和缺失字段（金额、链接、甲乙方等），说明可能原因（如“未公开”“采集覆盖范围外”），不得编造。
追溯结论
用简短文字概括项目当前所处阶段、健康度（正常推进/存在异常/已终止）和后续跟踪建议。结论属分析判断，须与接口事实区分。
数据边界
- 只把接口实际返回的信息作为项目事实；时间线节点必须对应真实返回的公告记录。
- 健康度判断、异常影响分析属于建议，不是官方结论。
- 未返回的日期、金额、企业角色不得补写。
- 单边命中的节点必须说明“仅关键词搜索命中、编号反查未返回”，提示用户核实。
- 不声称已订阅提醒或已联系任何单位，除非确实执行并验证成功。
详细参数参考
执行对应接口前按需读取：
- 完整接口总说明：
references/Parameter-Description.md - 根据项目编号查询：
references/get-project-by-project-number.md - 招中标信息搜索列表（交叉补全）：
references/search-project-api.md - 招中标信息结构化详情：
references/get-ztb-structure-detail.md - 招中标信息正文详情：
references/get-ztb-project-detail.md - 获取项目原始来源：
references/get-collect-url.md - 信息分类、采购分类和码表：
references/enums-and-code-tables.md
