盘源信息查询（onehub AI 网关链路）
根据楼盘编号（Ad_Code，如 CCB776、CLY117），通过 onehub AI 网关以 Chat Completions 格式查询盘源及其所属屋苑数据。本链路走公网网关，需要 API_KEY，适用于无法直连内网 REST 接口的场景。
本版本仅支持 2 个接口类型：GetUnitBaseByAdCode（基本信息与周边）、GetUnitMarketByAdCode（历史成交）。
基础信息
- 端点:
POST https://onehub.centanet.com/v1/chat/completions - 鉴权:
Authorization: Bearer {API_KEY}（可用环境变量AdCode_SERVER覆盖端点地址） - 请求格式: OpenAI Chat Completions JSON
- 响应格式: JSON，业务数据位于
choices[0].message.content
API_KEY 获取与使用
- 注册地址：
https://onehub.centanet.com（注册送额度） - 只从环境变量
API_KEY读取，绝不硬编码或写入任何文件 - 若
$env:API_KEY为空，先提示用户设置：$env:API_KEY = "你的密钥"，然后中止并等待用户提供
接口类型（type 参数）
| type | 用途 |
|---|---|
GetUnitBaseByAdCode |
盘源和屋苑的基本信息与周边信息 |
GetUnitMarketByAdCode |
盘源换手次数、成交均尺价、平均赚蚀比及屋苑历年成交 |
返回字段参考
业务数据位于响应 choices[0].message.content（JSON 字符串，需二次解析）。字段说明与直连 REST 链路一致。
1. GetUnitBaseByAdCode — 盘源和屋苑基本信息及周边
返回两个数据集：
DataUnitBase-盘源
| 字段说明 |
|---|
| 盘源名称、实用面积、居室数 |
| HMA_ID / HMA_CN：中原市场分区编码 / 名称 |
| cencode21 / cencode21_c：中原楼宇组群编码 / 名称 |
| Region_CN / District_CN：大区 / 18区 |
DataEstateBase-盘源所属屋苑
| 字段说明 |
|---|
| 屋苑名称、基本信息、建筑年代、期数 |
| 栋座数、房屋数、地铁站及时间 |
| 屋苑地址、物业公司、开发商、学校情况 |
| 特征标签、周边信息 |
2. GetUnitMarketByAdCode — 盘源历史成交与屋苑历史成交
DataUnitMarket-盘源
| 字段说明 |
|---|
| 换手次数、成交均尺价、平均赚蚀比 |
DataEstateMarket-盘源所属屋苑
| 字段说明 |
|---|
| 年份、成交量、成交均尺价、平均赚蚀比、中位数赚蚀比 |
调用方式
PowerShell 环境使用 Invoke-RestMethod（content 为纯 JSON 字符串，转义交给 ConvertTo-Json，不要手写反斜杠；Body 用 UTF8 字节避免中文乱码）：
$body = @{
model = "getAdCodeServer"
messages = @(@{
role = "user"
content = '{"adCode":"CLY117","type":"GetUnitBaseByAdCode"}'
})
} | ConvertTo-Json -Depth 4 -Compress
Invoke-RestMethod -Uri "https://onehub.centanet.com/v1/chat/completions" `
-Method Post `
-Headers @{ Authorization = "Bearer $env:API_KEY" } `
-ContentType "application/json" `
-Body ([Text.Encoding]::UTF8.GetBytes($body))
bash/curl 环境：
curl -s "https://onehub.centanet.com/v1/chat/completions" \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $API_KEY" \
-d '{"model":"getAdCodeServer","messages":[{"role":"user","content":"{\"adCode\":\"CLY117\",\"type":"GetUnitBaseByAdCode\"}"}]}'
响应解析
- 校验
choices[0].message.content存在，否则视为异常响应 content本身是 JSON 字符串，需二次解析后按字段整理- PowerShell 解析示例：
$resp = Invoke-RestMethod ... # 同上
$data = $resp.choices[0].message.content | ConvertFrom-Json
查询工作流
- 确认 Ad_Code：格式为3位字母+3位数字；不合法先向用户确认
- 检查 API_KEY：读取
$env:API_KEY（或 bash 的$API_KEY），为空则中止并提示用户 - 选择接口：按用户意图匹配 type；全景分析时依次调用全部 2 个 type
- 整理输出：使用下方输出模板，金额单位统一标注（万元/元），价格保留整数
输出模板
# 盘源分析报告（Ad_Code: {编号}）
## 盘源基本信息
- 名称 / 实用面积 / 居室数 / 市场分区 / 楼宇组群 / 大区 / 18区
## 屋苑信息
- 屋苑名称 / 建筑年代 / 期数 / 栋座数 / 房屋数 / 地址 / 交通 / 学校 / 物业 / 开发商 / 周边
## 市场表现
- 盘源：换手次数、成交均尺价、平均赚蚀比
- 屋苑：历年成交量、成交均尺价、平均赚蚀比、中位数赚蚀比
注意事项
- 与直连 REST 链路不同，本链路所有 type 都请求同一个端点，仅 content 中的
type不同 - 本网关版本暂不提供估价走势、放盘活动、业务员作业、成交明细等接口；如用户需要，告知可改用内网直连链路（dw-fastgpt-api skill）
- 401/403 响应通常是 API_KEY 无效或额度耗尽，提示用户检查密钥；不要重试超过 2 次
- 绝不在输出、日志或文件中暴露 API_KEY
