add

se-project-info-query.md

@@ -5,21 +5,116 @@ description: 仅在根据项目名称或者五码查询项目信息时使用。
 
 # se-project-info-query
 
-在使用本技能时，请先思考是否满足以下条件：
-
-- 用户是否提供了**项目名称**或者**五码**？如果没有的话，请向用户询问**项目名称**或**五码**。
-- 是否包含下文**工具依赖**里的所有工具，**必须包含所有工具，如果缺失的话，直接暂停运行，让用户先配置工具。**
-
-
-## 变量映射
-
-- 项目名称：`projectName`
-- 五码：`modelCode`
-
-## 工具依赖
-
-
+不要着急行动，请先思考**用户是否提供了项目信息？如果没有提供的话，请向用户询问项目名称/五码/项目别名**。
 
 ## 工作流程
 
-1. 获取
+```mermaid
+flowchart TD
+    S([开始]) --> S1[第1步：调用 debuggingProjectQuery<br/>根据 projectName 查询项目基础信息]
+
+    S1 --> C1{查询结果}
+    C1 -->|查不到| S2[第2步：调用 debuggingProjectQuery<br/>根据 modelCode 查询项目基础信息]
+    C1 -->|total > 1| S5[第5步：展示 rows 中的<br/>projectName 和 modelCode<br/>让用户选择其中 1 个]
+    C1 -->|total = 1| S6[第6步：使用响应的 projectName<br/>调用 queryProjectNameList<br/>获取 projectUuid]
+
+    S2 --> C2{查询结果}
+    C2 -->|查不到| S3[第3步：调用 debuggingProjectQuery<br/>根据 projectAlias 查询项目基础信息]
+    C2 -->|total > 1| S5
+    C2 -->|total = 1| S6
+
+    S3 --> C3{查询结果}
+    C3 -->|查不到| S4[第4步：告诉用户查不到项目信息<br/>让用户提供正确的项目信息]
+    C3 -->|total > 1| S5
+    C3 -->|total = 1| S6
+
+    S4 --> S1
+
+    S5 --> U[用户选择其中 1 个]
+    U --> S6
+    S6 --> E([结束])
+```
+
+
+## debuggingProjectQuery
+
+根据项目名称、项目别名、五码模糊检索项目基础信息。
+
+### 请求参数
+
+|参数名称|是否必传|参数描述|
+|---|---|---|
+|projectName|否|项目名称|
+|modelCode|否|五码|
+|projectAlias|否|项目别名|
+
+### 响应参数
+
+|参数名称|参数描述|
+|---|---|
+|projectName|项目名称|
+|modelCode|五码|
+|projectAlias|项目别名|
+
+#### 成功示例
+
+```json
+{
+  "total": 1,
+  "rows": [
+    {
+      "projectName": "IdeaPad 5 Pro 16ARP8",
+      "projectAlias": "LCP8",
+      "modelCode": "LT4EN"
+    }
+  ],
+  "code": 200,
+  "msg": "查询成功"
+}
+```
+
+#### 失败示例
+
+```json
+{
+  "code": 500,
+  "msg": "系统异常"
+}
+```
+
+## queryProjectNameList
+
+根据`projectName`查询`projectUuid`。
+
+### 请求参数
+
+|参数名称|是否必传|参数描述|示例|
+|---|---|---|---|
+|projectName|否|项目名称|`IdeaPad 5 Pro 16ARP8`|
+
+### 响应参数
+
+|参数名称|参数描述|示例|
+|---|---|---|
+|name|项目名称|`IdeaPad 5 Pro 16ARP8`|
+|projectUuid|项目的唯一标识|`1234567890`|
+
+#### 成功示例
+
+```
+[
+  {
+    "name": "IdeaPad 5 Pro 16ARP8",
+    "projectUuid": "1234567890"
+  }
+]
+```
+
+#### 失败示例
+
+```json
+{
+  "code": 500,
+  "msg": "系统异常"
+}
+```