add

feat.md

@@ -1,66 +1,84 @@
 # 任务目标
 
-分析一下"RemoteMcpToolsServiceImpl.java"的"getMisMcpToolMetadata"方法，为什么返回的是一个Empty List。调用的入口是"MisMcpToolMetadataCtl.java"的"doGetMisMcpToolMetadata"方法，传入的mcpServerIds是包含一个数值为2084832591415877633的集合。我在数据库执行SQL：
+分析`/project/stats/chart/chat`接口在处理请求参数`dimension`等于"year"的场景下，输出参数里面的y值不正确的问题。再顺便看看下面这几个接口是不是也有问题：`/project/stats/chart/token`、`/project/stats/chart/dislike`、`/project/stats/chart/user`、`/project/stats/chart/skill/usage`、`/project/stats/chart/feedback`、`/project/stats/chart/mcp/usage`、`/project/stats/chart/skill/usage`。
-```sql
+
-select * from mcp_serve where mcp_server_uuid = 2084832591415877633;
+## 开发规范
-```
+
-得到如下结果：
+参考文档:"E:\gitea\skills\mis-agent-spec\SKILL.md"。
+
+## 入口类
+
+ProjectStatsController.java
+
+## HTTP请求的输入和输出信息
+
+请求地址：/project/stats/page
+
+请求参数：
 ```json
-[
+{"pageNum":1,"pageSize":20}
-  {
-    "mcp_server_uuid": 2084832591415877633,
-    "mcp_server_source_uuid": 2011699902312255490,
-    "name": "getappliedlist-mingyan-1785897794303",
-    "serve_aliases": "GetAppliedList-Mingyan",
-    "description": "查询GetAppliedList的数据",
-    "service_picture": 0,
-    "mcp_service_type": 3,
-    "workflow": 1,
-    "sort": null,
-    "create_by": 7,
-    "create_time": "2026-08-05 10:43:19",
-    "create_dept": 1889219366819864580,
-    "update_time": "2026-08-05 14:04:48",
-    "update_by": 7,
-    "del_flag": 0,
-    "auth_name": "",
-    "auth": "",
-    "auth_type": 0,
-    "private_flags": 0,
-    "address": null,
-    "mcp_state": 2,
-    "mcp_state_reason": null,
-    "environment": 1,
-    "mcp_file": null,
-    "mcp_param": null,
-    "usage_type": 7
-  }
-]
 ```
-继续执行SQL：
+
-```sql
+响应参数：
-select * from mcp_tools where mcp_server_uuid = 2084832591415877633; 
+```json
+{
+    "total": 2,
+    "rows": [
+        {
+            "projectId": "2",
+            "projectName": "e-biz智能体",
+            "userNum": "1",
+            "chatNum": "2",
+            "totalToken": "1.54K",
+            "inputToken": "1K",
+            "outputToken": "0.54K",
+            "kbDocNum": "0",
+            "callMcpToolCount": "0",
+            "callSkillCount": "0"
+        },
+        {
+            "projectId": "1",
+            "projectName": "认证智能体",
+            "userNum": "4",
+            "chatNum": "10",
+            "totalToken": "163.72K",
+            "inputToken": "159.88K",
+            "outputToken": "3.83K",
+            "kbDocNum": "192",
+            "callMcpToolCount": "7",
+            "callSkillCount": "0"
+        }
+    ],
+    "code": 200,
+    "msg": "查询成功",
+    "extraData": null
+}
 ```
-得到如下结果：
+
-```sql
+请求地址：/project/stats/chart/chat
-[
+
-  {
+请求参数：
-    "tools_uuid": 2084832573384683521,
+```json
-    "mcp_server_uuid": 2084832591415877633,
+{"projectId":"1","dimension":"year","begin":"2024","end":"2026"}
-    "tools_name": "GetAppliedList-Mingyan",
-    "tools_image": 0,
-    "tools_state": 2,
-    "tools_llm_description": "查询GetAppliedList的数据",
-    "tools_state_reason": null,
-    "mcp_access_mode": 1,
-    "sort": null,
-    "create_by": 7,
-    "create_time": "2026-08-05 10:43:14",
-    "create_dept": 1889219366819864580,
-    "update_time": "2026-08-05 14:04:53",
-    "update_by": 7,
-    "del_flag": 0
-  }
-]
 ```
-但是我发现doGetMisMcpToolMetadata返回的是1个空的集合，这是为什么？
+
+响应参数：
+```json
+{
+    "code": 200,
+    "msg": "操作成功",
+    "data": {
+        "x": [
+            "2024",
+            "2025",
+            "2026"
+        ],
+        "y": [
+            0,
+            0,
+            17
+        ],
+        "tokenUnit": null
+    }
+}
+```