add

2026-09-01 13:45:26 +08:00
parent 18f77a28ed
commit 98a80854d7
4 changed files with 858 additions and 142 deletions
@@ -1,86 +1,22 @@
 # 任务目标

-分析`ProjectStatsController.java`文件里的`/chart/chat`接口，在处理请求参数`dimension`等于"year"的场景下，输出参数里面的`y`不正确的问题。
+参考接口文档示例文件"C:\Users\V-LiuShuang\.config\opencode\skills\mis-paw-spec\examples\api-doc.md"生成接口文档，把结果覆盖写入到文件："E:\gitea\tmp\msg.md"。

-再顺便看看`ProjectStatsController.java`这几个接口是不是也有问题：
- /chart/token
- /chart/dislike
- /chart/user
- /chart/skill/usage
- /chart/feedback
- /chart/mcp/usage
+## 需要生成接口文档的类和方法

-## 开发规范
-
-参考文档:"E:\gitea\skills\mis-agent-spec\SKILL.md"。
-
-## /page（数据正确）
-
-输入：
-```json
-{"pageNum":1,"pageSize":20}
-```
-
-输出：
-```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
-}
-```
-
-## /chart/chat（数据错误）
-
-输入：
-```json
-{"projectId":"1","dimension":"year","begin":"2024","end":"2026"}
-```
-
-输出：
-```json
-{
-    "code": 200,
-    "msg": "操作成功",
-    "data": {
-        "x": [
-            "2024",
-            "2025",
-            "2026"
-        ],
-        "y": [
-            0,
-            0,
-            17
-        ],
-        "tokenUnit": null
-    }
-}
-```
+| 文件名 | 方法名 |
+|---|---|
+|AgentMetricsController.java|userAppendMetrics|
+|AgentMetricsController.java|getResourceMetricsDetail|
+|AgentMetricsController.java|deleteUserComment|
+|ClientSoftwareController.java|getClientSoftwareList|
+|ClientSoftwareController.java|getLatestClientSoftware|
+|ClientSoftwareController.java|downloadClientSoftware|
+|ClientSoftwareController.java|getClientSoftwareInfo|
+|ClientSoftwareController.java|createClientSoftware|
+|ClientSoftwareController.java|updateClientSoftware|
+|ClientSoftwareController.java|deleteClientSoftware|
+|ClientSoftwareCanaryController.java|getCanarySettings|
+|ClientSoftwareCanaryController.java|addCanaryUserOrDept|
+|ClientSoftwareCanaryController.java|deleteCanaryUserOrDept|
+|AgentsController.java|enableOrDisableAgent|