diff --git a/xiaoqu-agent-service/AGENTS.md b/xiaoqu-agent-service/AGENTS.md
index b2898e8..5c5e2c4 100644
--- a/xiaoqu-agent-service/AGENTS.md
+++ b/xiaoqu-agent-service/AGENTS.md
@@ -19,6 +19,9 @@
 
 - 生产两个 ES 集群（cloud/local，app.es.cloud/local.*）均为 **ES 7.7.1**：elasticsearch-java 7.17 高阶客户端（ElasticsearchClient）的 vendor Content-Type（`application/vnd.elasticsearch+json; compatible-with=7`）被 406 拒绝，且其 X-Elastic-Product 响应头校验（7.14 才引入）过不了——**业务 ES 查询一律注入低阶 `esCloudRestClient`/`esLocalRestClient`（RestClient）bean**，不要注入 esCloudClient/esLocalClient（EsClientConfig 里仅为兼容保留）。
 - 低阶 `org.elasticsearch.client.Response` 构造器包私有且参数是 HttpResponse，测试里用 `mock(Response.class)` + stub `getEntity()` 构造；注意 `thenReturn(esResponse(...))` 里嵌套 when() 会触发 UnfinishedStubbingException，必须先创建好 Response 再 stub。
+- electricitymessage 索引（电量消息类）：`createTime` 是 date 类型（format strict_date_optional_time||epoch_millis），range 必须发 **epoch 毫秒**（`yyyy-MM-dd HH:mm:ss` 字符串 400）；`_source` 里 `value` 是**文本**（"28"/"100"）、`createTime` 是 ISO 文本（`2026-09-21T10:00:00.000+08:00`），读取时都要归一。老系统能跑是因为 transport 客户端把 Date 序列化成 epoch 毫秒、Jackson 把字符串 value 反序列化进 Integer 字段。
+- curl 直连 MCP 冒烟：JSON body 务必 `-d @file`（行内 `-d` 长 JSON 经网关会被截断报 "Invalid message format"）；响应是 SSE，`sed -n 's/^data://p'` 取 JSON。
+- 托管 MCP 工具（mcp__xiaoqu__*）在服务重启后 session 失效会报 AI_PROJ_MCP_SEND_OUTCOME_UNKNOWN，改走上面 curl 直连即可。
 
 ## 生产部署要点