From 31122e25f117e751d52e33c05a5ab1e191a9fa08 Mon Sep 17 00:00:00 2001 From: wangheng Date: Wed, 23 Sep 2026 13:46:08 +0800 Subject: [PATCH] =?UTF-8?q?fix(mcp):=20=E7=94=A8=E7=BA=B8=E7=BB=9F?= =?UTF-8?q?=E8=AE=A1=E7=B1=BB=E5=B7=A5=E5=85=B7=E5=88=86=E7=B1=BB=E7=BB=9F?= =?UTF-8?q?=E4=B8=80=E8=B0=83=E6=95=B4=E4=B8=BA=20customer?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- xiaoqu-agent-service/doc/agent-mcp-tools-reference.md | 6 +++--- .../me/iiv/agent/mcp/tool/DistrictPaperStatisticsTools.java | 2 +- .../java/me/iiv/agent/mcp/tool/HardwareStatisticsTools.java | 2 +- .../iiv/agent/mcp/tool/PaperPerCapitaStatisticsTools.java | 2 +- 4 files changed, 6 insertions(+), 6 deletions(-) diff --git a/xiaoqu-agent-service/doc/agent-mcp-tools-reference.md b/xiaoqu-agent-service/doc/agent-mcp-tools-reference.md index 356fc16..4f14e14 100644 --- a/xiaoqu-agent-service/doc/agent-mcp-tools-reference.md +++ b/xiaoqu-agent-service/doc/agent-mcp-tools-reference.md @@ -759,7 +759,7 @@ 客户用纸统计，1:1 复刻老系统 `POST /MonthlyStatistics/getMonthlyStatisticsMap`（MonthlyStatisticsController）， 分主体统计（DB）与换纸卷数（ES）两部分。 -- 分类：hardware ｜ 类型：读 +- 分类：customer ｜ 类型：读 - 主体数据来源：m0 `monthly_statistics`（XXL-Job 预聚合的站点日汇总，每站点每厕位/厕每天一行）， `statistics_time` 范围 [startDate 00:00:00, endDate 23:59:59]，可选 `buildingId/floor/toiletId/deviceType` 精确过滤。 - 入参：`districtId`（必填正整数）、`startDate`/`endDate`（必填 yyyy-MM-dd，startDate≤endDate≤今天）、 @@ -823,7 +823,7 @@ 查询站点人均用纸统计，覆盖老 `StatisticsReportController` 的五个接口。 -- 分类：district ｜ 类型：读 +- 分类：customer ｜ 类型：读 - 数据来源：m0 `monthly_statistics` 日汇总表，固定 `soft_delete=0`、指定站点及日期范围；不查 ES。 - 入参：`districtId`、`startDate`、`endDate`、`groupBy`（gender/floor/floorGender），以及可选 `daily`、`deviceType`、`idStrList`。`floorGender+daily=true` 会报参数错误。 @@ -846,7 +846,7 @@ 查询站点设备日均用纸统计，覆盖老 `StatisticsReportController` 的五个硬件统计接口。 -- 分类：hardware ｜ 类型：读 +- 分类：customer ｜ 类型：读 - 数据来源：m0 `monthly_statistics`，固定 `soft_delete=0`、指定站点和日期范围，在数据库中完成聚合；不查 ES。 - 入参：`districtId`、`startDate`、`endDate`、`view`，以及可选的 `deviceType`、`buildingIds`、 `floors`、`toiletIds`。位置列表内部使用 IN，三个位置维度之间使用 AND。 diff --git a/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/DistrictPaperStatisticsTools.java b/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/DistrictPaperStatisticsTools.java index aea5e1a..088a0b2 100644 --- a/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/DistrictPaperStatisticsTools.java +++ b/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/DistrictPaperStatisticsTools.java @@ -70,7 +70,7 @@ public class DistrictPaperStatisticsTools implements ToolObject { this.paperUseLogEsGateway = paperUseLogEsGateway; } - @XqTool(category = "hardware", kind = "read") + @XqTool(category = "customer", kind = "read") @Tool(name = "district.paper.statistics.query", description = "客户用纸统计：按站点和日期范围统计各性别分组的用纸长度（米）、" + "使用人次、台日合计与换纸卷数，并给出按日明细。主体数据来自 m0 monthly_statistics 日汇总表；" + "换纸卷数来自 ES paperuselog（热索引近 90 天，更早走冷索引 paperuselog_all；" diff --git a/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/HardwareStatisticsTools.java b/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/HardwareStatisticsTools.java index 5ec3e73..665ac58 100644 --- a/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/HardwareStatisticsTools.java +++ b/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/HardwareStatisticsTools.java @@ -59,7 +59,7 @@ public class HardwareStatisticsTools implements ToolObject { this.redisTemplate = redisTemplate; } - @XqTool(category = "hardware", kind = "read") + @XqTool(category = "customer", kind = "read") @Tool(name = "district.paper.device_average.query", description = "查询站点设备日均用纸量。" + "view 仅支持 gender、daily_gender、floor、daily_floor、floor_gender；" + "返回统一 rows，每行包含日期、楼层、卫生间类型、用纸米数、统计记录数和设备日均值。" diff --git a/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/PaperPerCapitaStatisticsTools.java b/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/PaperPerCapitaStatisticsTools.java index c660932..e9f4167 100644 --- a/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/PaperPerCapitaStatisticsTools.java +++ b/xiaoqu-agent-service/src/main/java/me/iiv/agent/mcp/tool/PaperPerCapitaStatisticsTools.java @@ -55,7 +55,7 @@ public class PaperPerCapitaStatisticsTools implements ToolObject { this.redisTemplate = redisTemplate; } - @XqTool(category = "district", kind = "read") + @XqTool(category = "customer", kind = "read") @Tool(name = "district.paper.percapita.query", description = "查询站点人均用纸统计。" + "用 groupBy=gender/floor/floorGender 选择性别、楼层或楼层与卫生间类型分组；" + "daily=true 时再按日分组，仅支持 gender 和 floor。"