初始化

docs/AI_INTEGRATION_GUIDE.md

@@ -253,7 +253,57 @@ AI 默认不要使用 `date`，除非调用平台只能传固定后台日期格
 | `method_not_allowed` | 请求方法错误 | 统计接口必须使用 POST |
 | `server_error` | 服务端或后台接口异常 | 根据 message 排查 |
 
-## 10. AI 调用约束
+## 10. 返回数据解读规则
+
+AI 必须严格按照接口返回的 JSON 数据解读，不允许编造、放大、补全或推测不存在的数据。
+
+例如接口返回：
+
+```json
+{
+  "success": true,
+  "data": {
+    "orderCount": 100,
+    "activeMerchantCount": 5,
+    "successOrderCount": 47,
+    "totalOrderAmount": 882.89,
+    "totalRealPay": 662.39,
+    "_debug_query": {
+      "time": "2026/06/18-2026/06/24"
+    }
+  }
+}
+```
+
+AI 只能解读为：
+
+- 查询时间范围：`2026/06/18-2026/06/24`
+- 当前接口返回订单数：`100`
+- 活跃商户数：`5`
+- 成功订单数：`47`
+- 订单总金额：`882.89`
+- 实付总金额：`662.39`
+
+AI 可以基于已返回字段做简单计算，但必须说明是“根据当前返回数据计算”：
+
+- 成功率：`47 / 100 = 47%`
+- 实付占比：`662.39 / 882.89 ≈ 75.03%`
+- 平均订单金额：`882.89 / 100 ≈ 8.83`
+- 平均实付金额：`662.39 / 100 ≈ 6.62`
+
+AI 禁止输出以下内容，除非接口明确返回：
+
+- 禁止把 `100` 改写成 `3850`
+- 禁止编造 `3427` 个成功订单
+- 禁止编造 `186` 家商户
+- 禁止编造 `日均订单 550 单`
+- 禁止编造 `日均流水 38.5 万元`
+- 禁止编造“整体交易状况良好”等过度结论
+- 禁止把未返回的后台总数当作事实
+
+注意：当前接口内部请求后台订单列表时使用 `page=1`、`limit=100`。因此 `orderCount=100` 表示当前接口本次返回并参与统计的订单数量，不应擅自推断为后台完整总订单量，除非接口后续明确返回总数。
+
+## 11. AI 调用约束
 
 AI 必须遵守以下规则：
 
@@ -267,8 +317,11 @@ AI 必须遵守以下规则：
 8. 不要把后台系统 token 暴露给用户。
 9. 不要直接调用后台订单接口，只调用本项目 HTTP API。
 10. 如果用户问题不包含时间，默认使用 `timePreset=today`。
+11. 解读结果时只能使用接口返回的字段，不允许编造不存在的订单数、金额、商户数、日均值或趋势结论。
+12. 如果要计算成功率、平均值、占比，必须基于接口返回字段计算，并说明“根据当前返回数据计算”。
+13. 如果接口返回 `_debug_query.time`，可以把它作为本次查询时间范围。
 
-## 11. PowerShell 调用示例
+## 12. PowerShell 调用示例
 
 订单汇总：
 
@@ -300,8 +353,8 @@ Invoke-RestMethod `
   -Body '{"timePreset":"this_month","sortBy":"totalRealPay","limit":10}'
 ```
 
-## 12. 推荐给 AI 的简短系统提示词
+## 13. 推荐给 AI 的简短系统提示词
 
 ```text
-你需要通过 Merchant AI HTTP API 分析订单数据。统计接口只能使用 POST。不要直接请求后台订单接口，不要暴露 token。用户提到时间时，优先转换为 timePreset：今天=today，昨天=yesterday，最近7天=last_7_days，最近30天=last_30_days，本周=this_week，上周=last_week，本月=this_month，上月=last_month。只有明确起止日期时使用 custom，并传 startDate/endDate，格式 YYYY-MM-DD。不要把“今天”“昨天”“本月”等自然语言直接作为参数传给接口。如果用户没说时间，默认 timePreset=today。
+你需要通过 Merchant AI HTTP API 分析订单数据。统计接口只能使用 POST。不要直接请求后台订单接口，不要暴露 token。用户提到时间时，优先转换为 timePreset：今天=today，昨天=yesterday，最近7天=last_7_days，最近30天=last_30_days，本周=this_week，上周=last_week，本月=this_month，上月=last_month。只有明确起止日期时使用 custom，并传 startDate/endDate，格式 YYYY-MM-DD。不要把“今天”“昨天”“本月”等自然语言直接作为参数传给接口。如果用户没说时间，默认 timePreset=today。解读接口返回时，必须只使用 JSON 中真实存在的字段和数值，不允许编造订单数、成功订单数、商户数、金额、日均值、趋势或业务结论。可以基于返回字段做简单计算，但必须说明“根据当前返回数据计算”。如果返回 _debug_query.time，可以作为查询时间范围。当前接口 page=1、limit=100，orderCount 表示本次返回并参与统计的订单数量，不要擅自推断后台完整总量。
 ```