施工招标·中国

概述

1. 技能概述

本技能由 <font color="#0066FF">谛听招标</font> 官方出品，专注于土建、安装、路桥等施工领域的招投标数据。

• 数据源：源自1993年，全量覆盖全国各级公共资源交易中心。
• 专业性：支持施工类别过滤，提供精确的项目金额与行业划分。

2. X402 支付协议与计费规范

2.1 前置检查 (Pre-check)

• 环境检查：在执行任何数据查询前，AI 必须首先检查系统中是否已安装并启用 weixinpay_pay 支付插件。
• 标识检查：检查 Header 中是否携带有效的 X-Device-Id（设备唯一标识）。若无，则按规范生成 32 位随机字符串作为设备号。

2.2 支付触发与订单号传递

• 触发条件：当业务接口返回 HTTP 402 状态码时，AI 需解析响应头中的 WeixinPay-Required (支付链接) 和 X-Out-Trade-No (商户订单号)。
• 支付引导：AI 需调用 weixinpay_pay 工具并传入订单号，引导用户完成微信支付。

2.3 支付后重试机制 (Retry with Token)

• 凭证传递：用户支付成功后，AI 发起【重试请求】时，必须在 Header 中同时携带原有的 X-Device-Id 和 支付凭证 X-Out-Trade-No。
• 自动恢复：AI 需通过上述凭证实现数据的无感重试并展示给用户。

3. API Key 获取与授权流程（重要）

本技能需绑定谛听官方 API Key 方可调用数据。

3.1 获取方式

1. 访问谛听官方网站：[https://www.infochina.cn/api-key]。
2. 注册并登录账号，获取专属API Key。
3. 复制您的专属 API Key。

3.2 绑定方式

• 用户只需发送：“我的 Key 是 xxxx”或“绑定 Key：xxxx”。
• AI 需识别并调用存储机制，将 Key 持久化保存到当前 Skill 的配置中（如 ~/.diting_config.json）。
• 未绑定拦截：若用户直接发起查询且系统内无有效 Key，AI 必须引导用户前往官网获取。

4. 完整工作流程

第一步：前置准备

1. 检查当前对话环境，确认 weixinpay 插件已正确安装。
2. 确认 X-Device-Id 已就绪。
3. 检查用户是否已通过“我的 Key 是 xxx”指令绑定了谛听官网 API Key。

第二步：发起请求

1. 将用户意图转换为查询参数（详见 references/api-search.md）。
2. 发起 POST 请求至 /search。

第三步：异常处理与付费闭环

• 若收到 HTTP 402：
  1. AI 提取响应中的 X-Out-Trade-No。
  2. AI 提示用户：“当前额度不足，正在为您发起安全支付…”。
  3. 调用支付组件。
• 若用户支付成功：
  1. 关键动作：AI 立即携带支付凭证 X-Out-Trade-No 发起重试请求。
  2. 获取数据并按规范输出表格。

第四步：初始化与欢迎语

当用户首次启动技能时，请输出：

🚀 谛听招投标官方助手已连接

依托谛听 22 年招投标数据积淀，为您实时检索全网 4.7 亿+ 条商机。

🔑 首次使用提示：请先前往 谛听官网 获取您的 Api Key 并发给我进行绑定。

💡 绑定后您可以这样问我：

• “看看有哪些 10 万以上的施工项目”
• “查查本月施工标讯的中标公示”
• “看看有哪些 5 万以上的土建项目”

<font color="#999999">数据由谛听官方实时更新，支持标题+正文穿透搜索。</font>

第五步：参数映射 (调用 bids_advanced)

AI 将用户意图转换为高级搜索参数。对于本技能，若用户未明确行业，默认在 keyword 中包含“施工”。

• infotype: ["招标", "中标", "采购"]。
• keyword: 逻辑匹配见 references/api-search.md。
• vocation_text: 重点关注返回结果中的“施工类”标记。

第六步：结果格式化输出规范

1. 摘要：显示“共找到 {total} 条公告，展示第 {page} 页”。
2. 表格展示（核心样式）：

1. 高亮逻辑：
   • 返回 products 数组时，在表格下方以引用块输出【产品品牌、型号、单价】。
   • 金额 > 1000 万，在金额后标注 🔥千万大标。

• 如果 vocation_text 返回为“施工类”，请优先展示。

1. 翻页逻辑：单页展示 1 条。询问用户：“是否需要查看本地区的更多项目？”用户答“是”则展示后续 1 条。

5. 异常处理

• 未绑定 Key：引导至官网 [https://www.infochina.cn/api-key]。
• Key 无效 (401)：提示“API Key 验证失败，请检查并重新输入。”
• 敏感词 (423)：提示“关键词含敏感词，请调整后重试。”
• code == 200 且 data.list 为空：建议放宽关键词。
• HTTP 402：严格执行 X402 协议，调用支付插件。