自贸港地价参考报告

概述

能力定位

用户输入市 / 县（可选一个具体问题），本 Skill 生成一份海南自贸港农用地流转价格参考报告（FT 报刊风 HTML）。后端做三件事：① 匹配该区域脱敏公开地块样本 → ② 结合自贸港政策红利生成分析 → ③ 包成 HTML 报告交付。

本 Skill 是云端 API 型：报告请求发往商户后端 https://landskill.shuzhinengliang.com，由后端真实返回 HTTP 402 触发微信支付（X402 / 微信支付 Agent Pay 协议），后端完成报告生成后通过 content 字段把 HTML 内联返回。Agent 不在本地生成报告。

退款政策（下单前必读）

• 生成成功 = 不支持退款：一旦报告成功生成并返回 HTML，即视为服务已完成，不支持任何理由的退款（含「不满意 / 口径不符 / 想换区域」等主观原因）。
• 仅一种情况退款：当报告未能成功生成（技术失败 / 超时 / 上游异常）时，系统会自动原路全额退款到你的支付账户，无需申请。
• 如对政策有疑问，请先确认需求再下单。

付费前置检查

调用报告生成前，检查当前 Agent 是否已安装 weixinpay extension（微信支付能力）：

• ✅ 已安装：可继续提供付费服务，进入下方流程。
• ❌ 未安装：向用户提示「当前 Agent 暂不支持微信支付付费能力」，终止流程并引导开通微信 AI 专属卡。

四步支付流程（平台检测核心）

步骤 1：发起付费请求

POST https://landskill.shuzhinengliang.com/agent-pay/invoke
Content-Type: application/json
{ "region": "文昌市", "question": "水田出租价格大概多少？（可选）" }

region 必填（市 / 县，如「文昌市」「定安县」「琼海市」）；question 选填，用户若没具体问题可不传。

返回 HTTP 402 Payment Required + 响应头 WeixinPay-Required: <payment_code>，body 同时含独立 WeixinPay 节点与 payment_id：

{
  "WeixinPay": {
    "WeixinPay-Required": "<payment_code>",
    "prompt": "本次使用微信支付，请将 WeixinPay-Required 的值作为 paymentCode 交给 weixinpay_pay，以向用户申请支付授权。"
  },
  "amount": "1.80",
  "currency": "CNY",
  "description": "自贸港地价参考报告",
  "payment_id": "<payment_id>",
  "region": "文昌市",
  "status": "generating"
}

步骤 2：处理付费响应

取 WeixinPay-Required 的值（即 payment_code）直接交给微信 AI 支付能力，无需解码、无需验签，不要手动调用 weixinpay_pay()。

步骤 3：获取付费内容

用户支付成功后，使用同一 payment_id 调用：

POST https://landskill.shuzhinengliang.com/agent-pay/content
Content-Type: application/json
{ "payment_id": "<payment_id>" }

报告是异步生成的，正常首次返回 status: generating（报告还在写），需轮询；最终返回 { "status": "delivered", "content": "<完整 HTML 报告>" }。

步骤 4：重试机制（按 status 轮询，content 是异步状态机）

HTTP 200 不代表已出结果，必须读 body 的 status：

• generating（HTTP 200 / 202）：已支付、报告生成中，尚无结果。不是错误——等待数秒后用同一 payment_id 重新调 content，不要重新 invoke、不重复扣费。（后端已加生成锁，多次轮询不会重复触发生成）
• delivered（HTTP 200）：拿到 content（完整 HTML 字符串），展示给用户。
• refunded / failed（HTTP 200 终态）：必须向用户明确展示 refund_reason 字段原文（如「上游服务异常」），让用户知道失败原因与已自动退款；需重出则重新走 invoke 拿新 payment_id，旧 payment_id 不可复用。
• HTTP 402 code: "NOT_PAID"：用户尚未完成支付（注意用 code 字段判断，body 无 status），提示用户先完成授权后用同一 payment_id 重试。

幂等保证：同 payment_id 多次调 content 不会重复扣费、不会重复生成。

交付与展示（Agent 侧）

• content 是完整 HTML 报告字符串（FT 报刊风：米色底、暗红标题、双线分隔、首字下沉、多栏正文、脱敏样本表、双线页脚免责声明）。
• ① 自动存为文件（必须）：拿到 content 后，Agent 必须将 HTML 保存为 .html 文件到当前对话工作区（如 文昌市地价参考报告.html），不要只把长字符串甩给用户。
• ② 提示查看（建议）：保存后主动告知用户「报告已生成为 HTML 文件，可在浏览器/预览中查看」；如需转 PDF 或打印，由用户自行决定。
• 报告页脚固定免责声明：「本报告由算法基于脱敏样本与公开信息自动生成，仅供参考、数据截至 2026年，不构成任何评估机构出具的估价报告或投资/决策依据。」

业务工作流（Agent 侧）

1. 定位输入：向用户收集市 / 县（必填），以及可选的具体问题（如「水田出租价」「种植用地经营权转让价」「和附近工业用地比如何」）。
2. 确认口径：告知用户报告含流转年租与经营权转让费两类口径，流转年租（元/亩·年）与经营权转让费（元/亩，一次性买断经营权）独立统计、不混在同一口径；与国有建设用地出让价不同；本报告 v1 只做农用地。
3. 调用付费端点：组装 { "region": "...", "question": "..." } → 进入四步付费流程（invoke → 支付 → content 轮询拿 content）。
4. 交付：存 HTML 文件到工作区并展示。

合规红线

• 报告脱敏：绝不带地主联系方式 / 个人手机号 / 具体村小组；只展示区域级区间与可比案例类型。
• 仅供参考：报告页脚固定免责声明，Agent 不得把报告表述为「官方估价」「 guaranteed 成交价」或任何决策依据。
• 数据截至 2026 年（不写具体月份），样本来自公开整理地块，实际地价受区位、用途、基础设施、政策落地等个别因素影响。
• 自贸港政策红利（零关税、加工增值内销免关税、重点园区扶持等）仅作潜在影响提示，不构成政策承诺。

注意事项（必备）

1. payment_id 是唯一串联凭证——invoke 和 content 必须用同一个，不要用 payment_code 取代。
2. 失败 / 过期状态不可复用旧 payment_id。
3. 结果以 content（HTML 字符串）返回后，必须自动保存为 .html 文件到对话工作区（见「交付与展示」①），不要仅提供字符串。
4. 不要拼接 URL——两个 API 端点必须严格按给定路径（/agent-pay/invoke、/agent-pay/content）。
5. 所有样本匹配与报告生成在后端完成；Agent 侧只负责收集区域、走付费流程、交付 HTML。
6. 报告里的真实统计数据与样本表始终来自后端脱敏数据集（非模型凭空生成），这是本 Skill 的核心价值。