官方文档的返回示例把 confidence 写成 0.99572587013245，实测是 0~100 的整数。写成 confidence > 0.8 的判断永远不会命中，用 > 80。

易源合一是单句无状态的，请求参数只有 text 和 args_list，没有会话 ID、没有上下文参数。多轮对话的状态必须你自己维护。

客服机器人最常见的三类查询是「今天天气怎么样」「我的快递到哪了」「最近有什么新闻」，易源合一这三个意图实测都支持。

args_list 是一个列表参数，里面可以放图片 URL，也可以放 base64 字符串，两种都实测通得过。

两段式调用（先 3054-2 判意图，再决定要不要调 3054-1）不会省钱，实测每次最多多花 5.5 厘。

一次响应里有三个 ret_code 和一个 showapi_res_code，层级不同，判断顺序错了会把失败当成功。

官方文档只给了一个 weather 的示例，没给完整意图清单。这篇用 15 条真实中文语句跑了 3054-2，把识别出来的 intent 编码整理成表。

一个端点 https://route.showapi.com/3054-1?appKey=YOUR_APPKEY 收一句话，同时返回「识别出的意图」「已整理好的答复文本」「底层接口的原始数据」。

易源合一指南总目录：3054 三个接入点与 12 篇实测笔记

自建抓取、免费接口与商业接口三条路线的中立对比，含本接口的硬边界。

实测计费口径、缓存键设计与 Redis 实现。

week / month / semiyear / year 四档的同行对照实测与日期分布。

白名单与黑名单的语法、上限与同参数对照实测结果。

从查询词压缩到结果过滤、上下文注入的三步设计，含完整可运行代码。

三层错误结构对照表，含参数错误与鉴权错误的真实响应原文。

references 数组 13 个字段逐个说明，含文档未列、实测每条都返回的 markdown_content。