产业研究报告

概述

产业经济学博士视角的产业研究：十年图谱编制经历的产业研究专家苏衡，口径归一+环节结构+集聚格局+断链判定。数据由产业智驾数据中枢实时返回。单次调用 ¥49.9（微信支付）。

何时调用本技能

• "XX 产业全国格局怎么样，哪里在集聚"
• "XX 产业现在进入是窗口期还是过热"
• "把 XX 产业的链拆开看看"（口径归一到标准产业名）

触发词（Agent 匹配用，命中即调用本技能）：产业研究、行业研究、产业链分析、产业集聚、环节拆解、产业格局、产业报告、赛道研究、产业链图谱、RCA 集聚、全国布局。

不适用：区域维度的缺口与打法用 zs-region-diagnosis / zs-investment-strategy。

调用前收集

1. 产业名（必填，口语说法也可以，会自动归一）
2. 具体研究问题（可选）

支付能力自检（可选快路径，用户无需安装任何东西）

• 收到 402 账单后，检查本环境是否已具备微信支付能力插件（weixinpay，

提供 weixinpay_pay 等支付工具）

• 有 → 走 X402 快路径：将 WeixinPay-Required 的值作为 paymentCode 交给

weixinpay_pay，按平台流程向用户申请支付授权；不自行实现付款或签名

• 没有 → 不要提示用户安装插件、不要结束服务，直接走下方「调用协议」

第一步中的扫码兜底路径，用户体验同样完整

网络异常自助排查（连接超时/失败时引导用户执行）

调用出现超时（如 WinError 10060）、连接被拒时，服务端大概率正常，多为用户本地网络策略拦截（实测两大主因：安全软件按进程拦截出站连接、Agent 所在 IDE 的内置代理层）。按序引导用户自查并反馈结果：

1. 让用户用浏览器打开 https://career.idmap.cn/api/skillpay/health

—— 能看到 JSON 说明服务正常，问题在用户本机网络策略

1. 检查安全软件（腾讯电脑管家/360/火绒等）的「上网防护/网络连接

管理」是否按进程拦截了 Agent 或 IDE（实测腾讯电脑管家默认可拦截非白名单进程出站）：将 Agent/IDE 进程加入信任或白名单，或暂时退出安全软件后重试

1. 检查系统代理/VPN：关闭后重试，或将 *.idmap.cn 加入直连规则；

使用 Trae、WorkBuddy 等 IDE 内置 Agent 的用户，还需在 IDE 设置界面将网络代理切换为「不使用代理/直连」并重启 IDE——内置代理层可能拦截技能出站请求，仅改本地配置文件会被 IDE 进程回写覆盖，必须在设置界面修改

1. 以上均正常仍失败时，更换网络（如手机热点）再试，以区分本机

网络与运营商链路问题

超时后的安全重试：已拿到订单号（out_trade_no）后超时，重试必须携带同一订单号取结果；尚未拿到订单号即超时，重新发起第一步是安全的——未支付订单不扣款，15 分钟后自动过期。

调用协议（SkillHub X402 微信支付两段式）

第一步：发起请求（未支付时返回 402 账单）

POST https://career.idmap.cn/api/skillpay/zs-industry-research
Content-Type: application/json

{ "industry": "<产业名>", "question": "<具体研究问题，可选>" }

• 返回 402：body data 含 out_trade_no（订单号）、pay_qr_url

（本订单收款二维码图片，15 分钟内有效）、code_url（微信 Native 支付链接）；响应头 WeixinPay-Required 为 X402 支付凭证 paymentCode

• 环境有微信支付能力插件 → 快路径：将 paymentCode 交给 weixinpay_pay

按平台流程申请支付授权；不自行实现付款或签名

• 环境没有该插件 → 扫码兜底（默认，用户零安装）：在回复中原样嵌入

![微信扫码支付](<pay_qr_url>) 让用户微信扫码；环境不渲染图片时，把 pay_qr_url 链接交给用户在浏览器打开后扫码；同时说明"支付完成后我会自动取出结果"

• 支付完成后进入第二步

第二步：携带订单号取结果（同一订单，不重复下单）

POST https://career.idmap.cn/api/skillpay/zs-industry-research
Content-Type: application/json

{ "out_trade_no": "<第一步返回的订单号>" }

• 已支付：200，data.report_markdown 为完整报告
• 尚未支付：返回 402（data 同样带 pay_qr_url，可重新展示）。

扫码场景每 5 秒携带同一 out_trade_no 轮询一次，最多 3 分钟；超过账单有效期（15 分钟）则去掉 out_trade_no 重新发起（未支付订单不会扣款）

• 500（报告生成失败）：同 out_trade_no 原样重试，订单已支付

不会重复扣费

• 503：支付通道未配置，如实告知用户

结果交付

data.report_markdown 是最终交付物（产业口径确认→环节结构总览→全国集聚格局→断链/薄弱环节→研究结论），原样呈现全文；口径归一结果（命中或回退依据）如实呈现。

报告末尾或含「近期同类动态（据公开信息）」附加段，有则一并原样呈现。

边界与红线

• 报告数字均来自数据中枢当次返回
• RCA 判断保留">2.5 优势集聚、1 上下平盘"的口径说明
• 一次调用服务一个产业