doc/skills
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

delete

Browse Source
This commit is contained in:
V-LiuShuang committed 2026-10-09 15:58:43 +08:00
1 parent e4b6343ef3
commit 91b2262d5d
11 files changed
-950
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

se-task-exec-spec/SKILL.md
-42
View File
@@ -1,42 +0,0 @@
---
name: se-task-exec-spec
description: 该技能仅用于下发测试任务，比如执行Stress测试、Driver更新、Preload测试时使用。
---
# se-task-exec-spec
请先记住**上下文变量**，出现在`<MisUserProfile>`里的每一个标签，示例：
```xml
<MisUserProfile>
<username>
<description>我的用户名</description>
<value>zhangsan</value>
</username>
<userId>
<description>我的用户ID</description>
<value>123456</value>
</userId>
<date>
<description>今天的日期</description>
<value>2026-09-25</value>
</date>
<employeeNo>
<description>我的工号</description>
<value>ABC000</value>
</employeeNo>
<email>
<description>我的邮箱</description>
<value>zhangsan@lcfuturecenter.com</value>
</email>
</MisUserProfile>
```
变量名就是标签名，例如`<username>`，变量的含义在`<description>`中阐释，变量的数值位于`<value>`标签。
在[能力索引](#能力索引)的文档里一般会通过以下表述**读取变量**："上下文变量中我的用户名"、"上下文变量中今天的日期"。
## 能力索引
- [Stress测试](./references/exec_task_stress_doc.md)
- [Driver更新](./references/exec_task_update_driver_doc.md)
- [Preload测试](./references/exec_task_preload_doc.md)
se-task-exec-spec/example/task_preload_request.json
-86
View File
@@ -1,86 +0,0 @@
{
"model":{
"children":[
{
"testModelNodeUuid":"d9ebb007dfb9b9c43645811a76d669a1",
"testModelUuid":"efa4eb0d153492ab162c4066f4ed4741",
"testModelVersionUuid":"e9b2735e91214103bc3c39f54fe9c99e",
"parentTestModelNodeUuid":"0",
"nodeCycle":1,
"nodeIgnore":"0",
"nodeSequenceTypeKey":1,
"nodeSequenceNumber":1,
"nodeTimeoutTime":0,
"nodeFailureActionKey":3,
"triggerRetryTimes":0,
"testModelName":"AutoPreload",
"triggerRetryOnePass":"0",
"deviceConfigAcquisition":"0",
"activityStatusKey":1,
"delayTime":"0",
"gmtCreate":"2022-02-25 00:00:00",
"topTestModelUuid":"efa4eb0d153492ab162c4066f4ed4741",
"topTestModelVersionUuid":"e9b2735e91214103bc3c39f54fe9c99e",
"testModelLevelKey":1,
"softwareToolParam":"{downloadUrl}",
"inputLock":0,
"resultCheckMode":0,
"outputRedirect":1,
"testModelVersionCode":"0.0.1.1",
"lastTestModelVersionCode":"0.0.1.1",
"updateFlag":false,
"testSoftwareToolTypeKey":"[[10]]",
"performEntity":1,
"deviceTypeKey":"1",
"testModelDescription":"MBV Auto Preload",
"testSoftwareToolName":"AutoPreload",
"testSoftwareToolUuid":"1419909026921086977",
"testSoftwareToolVersionNo":"1.0.0.14",
"testModelTypeKey":1,
"configFileRequiredFlag":0,
"duplicateFlag":0,
"porlistAssociatedFlag":0,
"graphicShowFlag":0,
"id":"{id}",
"level":0,
"isCheck":true,
"isConfig":false
}
]
},
"base":{
"functionTypeOne":3,
"testTaskName":"AutoPreload{date}",
"testTaskTypeKey":1,
"functionTypeTwo":106,
"functionTypeThree":237,
"projectUuid":"",
"cascaderValue":[3,106,237,1066],
"functionTypeFour":1066,
"extend":{
"testCaseForm":{
"mbPn":"",
"modelName":"",
"bu":"",
"projectPhaseCode":""
},
"functionTypeOne":3,
"testTaskName":"AutoPreload{date}",
"testTaskTypeKey":1,
"functionTypeTwo":106,
"functionTypeThree":237,
"projectUuid":"",
"cascaderValue":[3,106,237,1066],
"functionTypeFour":1066,
"projectName":""
},
"testTaskIssueTypeCode":1
},
"rule":{
"testTaskUnitBindingRuleKey":6,
"bindingRulePriority":1,
"entityPrimaryKeyList":[{"key":"{testUnitUuid}","value":"{testUnitName}"}]
},
"testTaskIssueTypeCode":1,
"other":{"isClear":false,"type":2}
}
se-task-exec-spec/example/task_stress_non_project_request.json
-169
View File
@@ -1,169 +0,0 @@
{
"model": {
"children": [
{
"testModelNodeUuid": "325e759a512988b94eb0d34e9693403c",
"testModelUuid": "4b3bfe32c86b872663ac59fd1503fd81",
"testModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b",
"parentTestModelNodeUuid": "0",
"nodeCycle": 1,
"nodeIgnore": "0",
"nodeSequenceTypeKey": 1,
"nodeSequenceNumber": 1,
"nodeTimeoutTime": 0,
"nodeFailureActionKey": 3,
"triggerRetryTimes": 0,
"testModelName": "Stress_BurnIn_480Min",
"triggerRetryOnePass": "0",
"deviceConfigAcquisition": "0",
"activityStatusKey": 1,
"delayTime": "0",
"gmtCreate": "2022-09-14 00:00:00",
"topTestModelUuid": "4b3bfe32c86b872663ac59fd1503fd81",
"topTestModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b",
"children": [
{
"testModelNodeUuid": "203f4128668aec0264376db4fa24a450",
"testModelUuid": "5850c5278463420bb5a6e219771c1bff",
"testModelVersionUuid": "6686d7c339614c1a8a1c00e8bb0f40d1",
"parentTestModelNodeUuid": "325e759a512988b94eb0d34e9693403c",
"nodeCycle": 1,
"nodeIgnore": "0",
"nodeSequenceTypeKey": 1,
"nodeSequenceNumber": 1,
"nodeTimeoutTime": 0,
"nodeFailureActionKey": 3,
"triggerRetryTimes": 0,
"testModelName": "BurnInInstaller",
"triggerRetryOnePass": "0",
"deviceConfigAcquisition": "0",
"activityStatusKey": 1,
"delayTime": "0",
"gmtCreate": "2022-09-14 00:00:00",
"topTestModelUuid": "4b3bfe32c86b872663ac59fd1503fd81",
"topTestModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b",
"testModelLevelKey": 1,
"softwareToolParam": "/V 9.1.1007.0",
"inputLock": 0,
"resultCheckMode": 0,
"outputRedirect": 1,
"testModelVersionCode": "0.0.0.4",
"lastTestModelVersionCode": "0.0.0.6",
"updateFlag": false,
"testSoftwareToolTypeKey": "[[4,42]]",
"performEntity": 1,
"deviceTypeKey": "1",
"testModelDescription": "安装BurnIn并注册",
"testSoftwareToolName": "BurnInInstaller",
"testSoftwareToolUuid": "66c3206aee894c469769861f8f5577dc",
"testSoftwareToolVersionNo": "1.0.0.1",
"testModelTypeKey": 1,
"configFileRequiredFlag": 0,
"duplicateFlag": 0,
"porlistAssociatedFlag": 0,
"graphicShowFlag": 0,
"level": 1,
"isCheck": false,
"isConfig": false
},
{
"testModelNodeUuid": "93bae141c211641b02e47e5b8eb4b636",
"testModelUuid": "af57d8e7cc544f5491e282817479525b",
"testModelVersionUuid": "5824552e38f84074ac69bd08d85eea0a",
"parentTestModelNodeUuid": "325e759a512988b94eb0d34e9693403c",
"nodeCycle": 1,
"nodeIgnore": "0",
"nodeSequenceTypeKey": 1,
"nodeSequenceNumber": 2,
"nodeTimeoutTime": 0,
"nodeFailureActionKey": 3,
"triggerRetryTimes": 0,
"testModelName": "BurnInTestAutoStress",
"triggerRetryOnePass": "0",
"deviceConfigAcquisition": "0",
"activityStatusKey": 1,
"delayTime": "0",
"gmtCreate": "2022-09-14 00:00:00",
"topTestModelUuid": "4b3bfe32c86b872663ac59fd1503fd81",
"topTestModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b",
"testModelLevelKey": 1,
"softwareToolParam": "TestTime=\"480\"",
"inputLock": 0,
"resultCheckMode": 0,
"outputRedirect": 1,
"testModelVersionCode": "0.0.0.5",
"lastTestModelVersionCode": "0.0.0.5",
"updateFlag": false,
"testSoftwareToolTypeKey": "[[1,12]]",
"performEntity": 1,
"deviceTypeKey": "1",
"testModelDescription": "BurnIn Test For Stress",
"testSoftwareToolName": "BurnInTestStress",
"testSoftwareToolUuid": "d02a1171ae50477a9a13913bfca6c0d8",
"testSoftwareToolVersionNo": "1.20.0.6",
"testModelTypeKey": 1,
"configFileRequiredFlag": 0,
"duplicateFlag": 0,
"porlistAssociatedFlag": 0,
"graphicShowFlag": 0,
"level": 1,
"isCheck": false,
"isConfig": false
}
],
"testModelLevelKey": 3,
"inputLock": 0,
"resultCheckMode": 0,
"outputRedirect": 1,
"testModelVersionCode": "0.0.0.4",
"lastTestModelVersionCode": "0.0.0.4",
"updateFlag": false,
"performEntity": 0,
"deviceTypeKey": "1",
"testModelDescription": "Stress Burnin 8H Test for PA",
"testModelTypeKey": 2,
"configFileRequiredFlag": 0,
"duplicateFlag": 0,
"porlistAssociatedFlag": 0,
"graphicShowFlag": 0,
"id": "{id}",
"level": 0,
"isCheck": true
}
]
},
"base": {
"functionTypeOne": 3,
"testTaskName": "Stress_BurnIn_480Min{date}",
"testTaskTypeKey": 1,
"functionTypeTwo": 106,
"functionTypeThree": 238,
"projectUuid": "",
"cascaderValue": [3,106,238],
"extend": {
"testCaseForm": {
"mbPn": "",
"modelName": "",
"bu": "",
"projectPhaseCode": "",
"testCaseName": []
},
"functionTypeOne": 3,
"testTaskName": "Stress_BurnIn_480Min{date}",
"testTaskTypeKey": 1,
"functionTypeTwo": 106,
"functionTypeThree": 238,
"projectUuid": "",
"cascaderValue": [3,106,238],
"projectName": ""
},
"testTaskIssueTypeCode": 1
},
"rule": {
"testTaskUnitBindingRuleKey": 6,
"bindingRulePriority": 1,
"entityPrimaryKeyList": [{"key": "{testUnitUuid}","value": "{testUnitName}"}]
},
"testTaskIssueTypeCode": 1,
"other": {"isClear": false,"type": 2}
}
se-task-exec-spec/example/task_stress_use_project_request.json
-170
View File
@@ -1,170 +0,0 @@
{
"model": {
"children": [
{
"testModelNodeUuid": "325e759a512988b94eb0d34e9693403c",
"testModelUuid": "4b3bfe32c86b872663ac59fd1503fd81",
"testModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b",
"parentTestModelNodeUuid": "0",
"nodeCycle": 1,
"nodeIgnore": "0",
"nodeSequenceTypeKey": 1,
"nodeSequenceNumber": 1,
"nodeTimeoutTime": 0,
"nodeFailureActionKey": 3,
"triggerRetryTimes": 0,
"testModelName": "Stress_BurnIn_480Min",
"triggerRetryOnePass": "0",
"deviceConfigAcquisition": "0",
"activityStatusKey": 1,
"delayTime": "0",
"gmtCreate": "2022-09-14 00:00:00",
"topTestModelUuid": "4b3bfe32c86b872663ac59fd1503fd81",
"topTestModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b",
"children": [
{
"testModelNodeUuid": "203f4128668aec0264376db4fa24a450",
"testModelUuid": "5850c5278463420bb5a6e219771c1bff",
"testModelVersionUuid": "6686d7c339614c1a8a1c00e8bb0f40d1",
"parentTestModelNodeUuid": "325e759a512988b94eb0d34e9693403c",
"nodeCycle": 1,
"nodeIgnore": "0",
"nodeSequenceTypeKey": 1,
"nodeSequenceNumber": 1,
"nodeTimeoutTime": 0,
"nodeFailureActionKey": 3,
"triggerRetryTimes": 0,
"testModelName": "BurnInInstaller",
"triggerRetryOnePass": "0",
"deviceConfigAcquisition": "0",
"activityStatusKey": 1,
"delayTime": "0",
"gmtCreate": "2022-09-14 00:00:00",
"topTestModelUuid": "4b3bfe32c86b872663ac59fd1503fd81",
"topTestModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b",
"testModelLevelKey": 1,
"softwareToolParam": "/V 9.1.1007.0",
"inputLock": 0,
"resultCheckMode": 0,
"outputRedirect": 1,
"testModelVersionCode": "0.0.0.4",
"lastTestModelVersionCode": "0.0.0.6",
"updateFlag": false,
"testSoftwareToolTypeKey": "[[4,42]]",
"performEntity": 1,
"deviceTypeKey": "1",
"testModelDescription": "安装BurnIn并注册",
"testSoftwareToolName": "BurnInInstaller",
"testSoftwareToolUuid": "66c3206aee894c469769861f8f5577dc",
"testSoftwareToolVersionNo": "1.0.0.1",
"testModelTypeKey": 1,
"configFileRequiredFlag": 0,
"duplicateFlag": 0,
"porlistAssociatedFlag": 0,
"graphicShowFlag": 0,
"level": 1,
"isCheck": false,
"isConfig": false
},
{
"testModelNodeUuid": "93bae141c211641b02e47e5b8eb4b636",
"testModelUuid": "af57d8e7cc544f5491e282817479525b",
"testModelVersionUuid": "5824552e38f84074ac69bd08d85eea0a",
"parentTestModelNodeUuid": "325e759a512988b94eb0d34e9693403c",
"nodeCycle": 1,
"nodeIgnore": "0",
"nodeSequenceTypeKey": 1,
"nodeSequenceNumber": 2,
"nodeTimeoutTime": 0,
"nodeFailureActionKey": 3,
"triggerRetryTimes": 0,
"testModelName": "BurnInTestAutoStress",
"triggerRetryOnePass": "0",
"deviceConfigAcquisition": "0",
"activityStatusKey": 1,
"delayTime": "0",
"gmtCreate": "2022-09-14 00:00:00",
"topTestModelUuid": "4b3bfe32c86b872663ac59fd1503fd81",
"topTestModelVersionUuid": "d65130dd57816d3e1484a8822a3c2f2b",
"testModelLevelKey": 1,
"softwareToolParam": "TestTime=\"480\"",
"inputLock": 0,
"resultCheckMode": 0,
"outputRedirect": 1,
"testModelVersionCode": "0.0.0.5",
"lastTestModelVersionCode": "0.0.0.5",
"updateFlag": false,
"testSoftwareToolTypeKey": "[[1,12]]",
"performEntity": 1,
"deviceTypeKey": "1",
"testModelDescription": "BurnIn Test For Stress",
"testSoftwareToolName": "BurnInTestStress",
"testSoftwareToolUuid": "d02a1171ae50477a9a13913bfca6c0d8",
"testSoftwareToolVersionNo": "1.20.0.6",
"testModelTypeKey": 1,
"configFileRequiredFlag": 0,
"duplicateFlag": 0,
"porlistAssociatedFlag": 0,
"graphicShowFlag": 0,
"level": 1,
"isCheck": false,
"isConfig": false
}
],
"testModelLevelKey": 3,
"inputLock": 0,
"resultCheckMode": 0,
"outputRedirect": 1,
"testModelVersionCode": "0.0.0.4",
"lastTestModelVersionCode": "0.0.0.4",
"updateFlag": false,
"performEntity": 0,
"deviceTypeKey": "1",
"testModelDescription": "Stress Burnin 8H Test for PA",
"testModelTypeKey": 2,
"configFileRequiredFlag": 0,
"duplicateFlag": 0,
"porlistAssociatedFlag": 0,
"graphicShowFlag": 0,
"id": "{id}",
"level": 0,
"isCheck": true
}
]
},
"base": {
"functionTypeOne": 3,
"testTaskName": "Stress_BurnIn_480Min{date}",
"testTaskTypeKey": 1,
"functionTypeTwo": 106,
"functionTypeThree": 238,
"projectUuid": "000c798c09d537f4f25f5b29046aebd1",
"cascaderValue": [3,106,238],
"extend": {
"testCaseForm": {
"mbPn": "",
"modelName": "",
"bu": "",
"projectPhaseCode": "",
"testCaseName": []
},
"functionTypeOne": 3,
"testTaskName": "Stress_BurnIn_480Min{date}",
"testTaskTypeKey": 1,
"functionTypeTwo": 106,
"functionTypeThree": 238,
"projectUuid": "{projectUuid}",
"cascaderValue": [3,106,238],
"projectName": "{projectName}"
},
"testTaskIssueTypeCode": 1
},
"rule": {
"testTaskUnitBindingRuleKey": 6,
"bindingRulePriority": 1,
"entityPrimaryKeyList": [{"key": "{testUnitUuid}","value": "{testUnitName}"}]
},
"testTaskIssueTypeCode": 1,
"testCaseAssociationVersionUuidList": [],
"other": {"isClear": false,"type": 2}
}
se-task-exec-spec/example/task_update_driver_request.json
-106
View File
@@ -1,106 +0,0 @@
{
"model": {
"children": [
{
"testModelNodeUuid": "fdafe63e6fe1a390fb30bd9f437328b1",
"testModelUuid": "46a7b0303a23df1ef6240b95b67d1b83",
"testModelVersionUuid": "07a7afe541314e8dba335681584369e3",
"parentTestModelNodeUuid": "0",
"nodeCycle": 1,
"nodeIgnore": "0",
"nodeSequenceTypeKey": 1,
"nodeSequenceNumber": 1,
"nodeTimeoutTime": 0,
"nodeFailureActionKey": 3,
"triggerRetryTimes": 0,
"testModelName": "DriverInstallTool_Driver",
"triggerRetryOnePass": "0",
"deviceConfigAcquisition": "0",
"activityStatusKey": 1,
"delayTime": "0",
"gmtCreate": "2021-09-29 00:00:00",
"topTestModelUuid": "46a7b0303a23df1ef6240b95b67d1b83",
"topTestModelVersionUuid": "07a7afe541314e8dba335681584369e3",
"documentName": "",
"children": [],
"recordNode": [],
"testModelLevelKey": 1,
"inputLock": 0,
"resultCheckMode": 0,
"outputRedirect": 1,
"testModelVersionCode": "0.0.0.2",
"lastTestModelVersionCode": "0.0.0.2",
"updateFlag": false,
"testSoftwareToolTypeKey": "[[4,42]]",
"performEntity": 1,
"deviceTypeKey": "1",
"testModelDescription": "Device Driver Installation Tool.",
"testSoftwareToolName": "DriverInstallTool",
"testSoftwareToolUuid": "3bde357b79f00187736bc2480fbe9a3d",
"testSoftwareToolVersionNo": "1.0.0.0",
"testModelTypeKey": 1,
"configFileRequiredFlag": 0,
"documentCopyDTOList": [
{
"documentName": "{fileName}",
"fileExtensionKey": "{fileExtensionKey}",
"documentVersionNo": "",
"documentVersionUuid": "",
"fileType": "{fileExtName}",
"controller": {},
"progressPercent": 100,
"fileUrl": "{fileUrl}",
"fileUuid": "{fileUuid}"
}
],
"duplicateFlag": 0,
"porlistAssociatedFlag": 0,
"graphicShowFlag": 0,
"id": "{id}",
"level": 0,
"isCheck": true,
"documentValue": "{fileUuid}",
"fileUrl": "{fileUrl}",
"isConfig": false
}
]
},
"base": {
"functionTypeOne": 3,
"testTaskName": "DriverInstallTool_Driver{date}",
"testTaskTypeKey": 1,
"functionTypeTwo": 106,
"functionTypeThree": 237,
"projectUuid": "",
"cascaderValue": [3,106,237,1066],
"functionTypeFour": 1066,
"extend": {
"testCaseForm": {
"mbPn": "",
"modelName": "",
"bu": "",
"projectPhaseCode": "",
"testCaseName": []
},
"functionTypeOne": 3,
"testTaskName": "DriverInstallTool_Driver{date}",
"testTaskTypeKey": 1,
"functionTypeTwo": 106,
"functionTypeThree": 237,
"projectUuid": "",
"cascaderValue": [3,106,237,1066],
"functionTypeFour": 1066,
"projectName": "",
"testCaseData": []
},
"testTaskIssueTypeCode": 1
},
"rule": {
"testTaskUnitBindingRuleKey": 6,
"bindingRulePriority": 1,
"entityPrimaryKeyList": [{"key": "{testUnitUuid}","value": "{testUnitName}"}]
},
"testTaskIssueTypeCode": 1,
"testCaseAssociationVersionUuidList": [],
"other": {"isClear": false,"type": 2}
}
se-task-exec-spec/references/create_task_doc.md
-40
View File
@@ -1,40 +0,0 @@
# 下发任务的工具使用说明
调用`creatOrSendTask`工具下发任务，请求参数取值规则：
- `requestBodyJson`：由调用侧提供。
- `misUserName`：取**上下文变量**中**我的用户名**。
- `fs`：没有特殊要求使用默认值false即可。
工具调用结果的处理：
- 调用成功，把响应结果展示给用户，用户需要记住`testTaskUuid`和`testTaskCode`。
- 调用失败，把响应结果展示给用户，友好的告知用户，下发任务工具调用失败，请您稍后再试。
**特别重要的事项：调用失败了，请不要重试，主动重试可能会带来糟糕的结果，除非用户主动要求。**
## 成功示例
```json
{
"code": "0",
"msg": "任务下发已提交，正在生成中",
"data": {
"testTaskUuid": "1234567890",
"offLineTestUnit": "",
"unWorkingTestUnit": "",
"testTaskCode": "TT20260923000001"
},
"ok": true
}
```
## 失败示例
```json
{
"code": "500",
"msg": "系统异常",
"ok": false
}
```
se-task-exec-spec/references/exec_task_preload_doc.md
-58
View File
@@ -1,58 +0,0 @@
# 执行Preload测试文档
按照步骤一步一步的执行：
1. 如果用户没有提供项目信息，询问用户项目名称，不支持五码或者别名，建议输入项目完整名称。
2. 将用户提供的项目名称，作为`generatePreloadUpdateLink`工具的`project`参数发起调用，若遇到失败，则告诉用户失败原因并终止流程。
成功示例：
```json
{
"downloadUrl": "string",
"project": "string",
"osVer": "string",
"os": "string",
"preloadVersion": "string",
"locationName": "string"
}
```
失败示例：
```json
{
"success": false,
"msg": "string"
}
```
参数说明：
| 参数名称 | 含义 |
| --- | --- |
| `downloadUrl` | 生成的 preload 更新下载链接 |
| `project` | 项目名称 |
| `osVer` | OS版本 |
| `os` | OS目录名 |
| `preloadVersion` | 实际使用的 Preload VER |
| `locationName` | 实际使用的 Location |
| `success` | 当值为false的时候，意味着失败，成功时不返回`success`字段 |
| `msg` | 当`success`字段值为fasle时，该字段作为失败原因 |
3. 阅读[查测试机的文档](./query_test_device_doc.md)获取`testUnitUuid`和`testUnitName`。
4. 使用[请求模板文件](../example/task_preload_request.json)，**一字不改地生成**1个JSON字符串，再根据[变量表](#变量表)执行变量替换。
## 变量表
JSON字符串中变量的格式示例：{id}，根据取值规则查找并替换。
|变量名称|取值规则|
|---|---|
|id|随机生成1个由小写字母、数字组成的7位长度字符串（示例：2b43cb39）|
|date|从**上下文变量**取今天的日期|
|testUnitUuid|调用工具获得的测试机ID|
|testUnitName|调用工具获得的测试机名称|
|downloadUrl|调用工具获得的`downloadUrl`|
se-task-exec-spec/references/exec_task_stress_doc.md
-29
View File
@@ -1,29 +0,0 @@
# 执行Stress任务文档
按照步骤一步一步的执行：
1. 如果用户没有提供项目信息，从第2步开始执行。如果用户提供了项目信息，阅读[查项目信息文档](./query_project_info_doc.md)，一步一步地获取`projectName`和`projectUuid`。
2. 阅读[查测试机的文档](./query_test_device_doc.md)获取`testUnitUuid`和`testUnitName`。
3. 根据相应的[请求模板文件](#请求模板文件)，**一字不改地生成**1个JSON字符串，再根据[变量表](#变量表)执行变量替换。
4. 阅读[下发任务文档](./create_task_doc.md)，上一步生成的JSON字符串就是`requestBodyJson`参数。
## 请求模板文件
- [无项目下发](../example/task_stress_non_project_request.json)
- [根据项目下发](../example/task_stress_use_project_request.json)
## 变量表
JSON字符串中变量的格式示例：{id}，根据取值规则查找并替换。
|变量名称|取值规则|
|---|---|
|id|随机生成1个由小写字母、数字组成的7位长度字符串（示例：2b43cb39）|
|projectName|调用工具获得的项目名称|
|projectUuid|调用工具获得的项目ID|
|date|从**上下文变量**取今天的日期|
|testUnitUuid|调用工具获得的测试机ID|
|testUnitName|调用工具获得的测试机名称|
se-task-exec-spec/references/exec_task_update_driver_doc.md
-73
View File
@@ -1,73 +0,0 @@
# 更新驱动文档
按照步骤一步一步的执行：
1. 阅读[查项目信息文档](./query_project_info_doc.md)，一步一步地获取`projectName`和`projectUuid`。
2. 根据上一步获取到的`projectUuid`，调用`queryDriverListNamesByProject`工具查询项目下的驱动列表。
成功示例：
```json
[
{
"driverListVersionUuid": "string",
"driverListName": "string"
}
]
```
- 参数`driverListVersionUuid`是驱动的版本号ID。
- 参数`driverListName`是驱动名称。
使用markdown表格输出给用户，让用户选择驱动，示例格式：
| 序号 | 驱动名称 | 版本号ID |
| --- | --- | --- |
| 1 | BIOS | 1234567890 |
| 2 | CPU | 456678098 |
失败示例：
```json
[]
```
代表没有数据，告知用户未查询到驱动列表，流程终止。
3. 根据用户选择的`driverListVersionUuid`，调用`queryDriverListVersion`查询驱动下载地址，记住返回值里面的`internalVersion`和`packageFileUrl`参数。如果没有获取到数据，告诉用户获取驱动下载地址失败，流程终止。
4. 用上一步获取到的`packageFileUrl`填充`prepareTaskFile`工具的`fileUrl`参数发起调用。**该工具是一个文件上传的工具，可能耗时较长**。
成功示例：
```json
{
"fileUuid": "8f2a1c9e4b7d4a1f9c3e5b6a7d8e9f01",
"fileUrl": "http://10.159.41.130:8080/mbvClient/downloadFile?objectName=document/20260922/xxx.zip&bucketName=document",
"fileName": "xxx.zip",
"fileExtensionKey": 3
}
```
5. 阅读[查测试机的文档](./query_test_device_doc.md)获取`testUnitUuid`和`testUnitName`。
6. 使用[请求模板文件](../example/task_update_driver_request.json)，**一字不改地生成**1个JSON字符串，再根据[变量表](#变量表)执行变量替换。
7. 阅读[下发任务文档](./create_task_doc.md)，上一步生成的JSON字符串就是`requestBodyJson`参数。
## 变量表
JSON字符串中变量的格式示例：{id}，根据取值规则查找并替换。
|变量名称|取值规则|
|---|---|
|id|随机生成1个由小写字母、数字组成的7位长度字符串（示例：2b43cb39）|
|date|从**上下文变量**取今天的日期|
|fileName|调用`prepareTaskFile`工具返回的`fileName`|
|fileExtName|使用`fileName`的文件扩展名，例如："txt"|
|fileExtensionKey|调用`prepareTaskFile`工具返回的`fileExtensionKey`|
|fileUrl|调用`prepareTaskFile`工具返回的`fileUrl`|
|fileUuid|调用`prepareTaskFile`工具返回的`fileUuid`|
|testUnitUuid|调用工具获得的测试机ID|
|testUnitName|调用工具获得的测试机名称|
se-task-exec-spec/references/query_project_info_doc.md
-47
View File
@@ -1,47 +0,0 @@
# 查项目信息文档
请先思考**上下文中是否包含项目信息？如果没有的话，请向用户询问项目名称/五码/项目别名**。
## 口语和变量的映射关系
|口语|变量名称|
|---|---|
|项目名称|projectName|
|五码|modelCode|
|项目别名|projectAlias|
|项目ID|projectUuid|
## 工作流程
1. 先[查项目基础信息](#查项目基础信息)，收集**项目名称**。
2. 再用项目名称[查项目名称和项目ID](#查项目名称和项目ID)。
## 查项目基础信息
调用`debuggingProjectQuery`根据**项目名称**检索，查不到根据**五码**检索，仍然查不到根据**项目别名**检索。根据返回结果中的`rows`判定查询结果，有3种情况：
- 返回1条，查询成功。
- 返回0条或多条，**向用户询问更具体的项目信息，重新查询。**
- 返回错误信息，参考[错误信息处理](#错误信息处理)。
## 查项目名称和项目ID
调用`queryProjectNameList`工具，使用**项目名称**检索，响应结果是一个JSON数组，有4种情况：
- 返回1条结果，查询成功。
- 返回多条，把查询结果展示给用户，让用户选1条。
- 返回0条结果，视为查询失败，告知用户查不到项目名称和项目ID。
- 返回错误信息，参考[错误信息处理](#错误信息处理)。
## 错误信息处理
调用`debuggingProjectQuery`或`queryProjectNameList`工具遇到错误的响应示例：
```json
{
"code": 500,
"msg": "系统异常"
}
```
应对策略：友好的告知用户，因工具调用失败，请您稍后再试。**不要自行主动重试，除非用户主动要求。**
se-task-exec-spec/references/query_test_device_doc.md
-130
View File
@@ -1,130 +0,0 @@
# 查测试机的文档
调用`queryTestUnitListByProjectName`工具，按照[请求参数说明](#请求参数说明)，并结合[工具调用的4种情况](#工具调用的4种情况)处理查询。
## 请求参数说明
|参数名称|是否必传|取值规则|
|---|---|---|
|`misUserName`|是|取**上下文变量**中**我的用户名**|
|`size`|是|固定数值，传20|
|`workingStatusKey`|是|固定传1，只查空闲的|
|`onlineStatusKey`|是|固定传2，只查在线的|
|`lockStatus`|是|固定传2，只查未锁定的|
工具中的其他参数，**调用侧没有要求，一律不传。**
## 工具调用的4种情况
- 返回了1条，根据[展示给用户的格式](#展示给用户的格式)，让用户确认是否要用这台测试机，得到用户的肯定答复后，调用测再继续执行，若用户拒绝，调用测的流程到此结束。
- 返回了多条，根据[展示给用户的格式](#展示给用户的格式)，让用户选1台测试机，调用侧继续执行。
- 返回了0条，告知用户您当前没有可以测试机使用，请先申请测试机，调用测的流程到此结束。
- 查询异常，把错误信息展示给用户，友好的告诉用户，查询测试机失败了，调用侧的流程到此结束。
## 展示给用户的格式
|序号|机器ID|机器名称|在线状态|闲忙状态|锁定状态|
|---|---|---|---|---|---|
|1|123|测试机123|在线|使用中|已锁定|
|2|456|测试机456|离线|闲置中|未锁定|
## 响应参数说明
|参数名称|参数描述|
|---|---|
|testUnitGroupUuid|机器分组ID|
|testUnitUuid|机器ID|
|testUnitName|机器名称|
|onlineStatus|在线状态（枚举值：1=离线，2=在线）|
|workingStatusKey|闲忙状态（枚举值：1=闲置中，2=使用中）|
|lockStatus|锁定状态（枚举值：1=已锁定，2=未锁定）|
|ipAddress|IP地址|
|projectCode|项目编号|
|projectName|项目名称|
|projectPhase|项目阶段|
|programName|项目集名称|
|modelName|五码|
|groupName|分组名称|
|mo|工单|
|fgPn|SKU|
|skuShortName|SKU别名|
|skuExtensionNo|SKU编号|
|testUnitTypeKey|测试机类型键或物料组|
|matterDescription|物料描述|
|userCode|当前使用人用户ID|
|userName|当前使用人用户名称|
|ownerCode|机器管理员用户ID|
|ownerName|机器管理员用户名称|
|shippingSn|出货流水号或机器SSN|
|mbPn|主板料号|
|mbSn|主板流水号|
|fgSn|整机流水号|
|gerberVersion|主板Gerber版本|
## 响应参数示例
### 查询成功
```json
{
"records": [
{
"projectCode": "PRJ2024001",
"projectName": "Project Alpha",
"projectPhase": "EVT",
"programName": "Alpha Program",
"modelName": "LM12345",
"groupName": "Group-A",
"mo": "MO2024010001",
"fgPn": "FG-SKU-001",
"skuShortName": "SKU-A",
"skuExtensionNo": "EXT001",
"testUnitTypeKey": 1,
"matterDescription": "主板物料",
"workingStatusKey": 2,
"tokenStatus": 1,
"lockStatus": 1,
"isStore": 0,
"gmtCreate": "2024-09-20 10:30:00",
"userCode": 10086,
"userName": "张三",
"borrowStatus": 1,
"ownerCode": "ADMIN001",
"ownerName": "李四",
"shippingSn": "SN20240920001",
"mbPn": "MB-PN-001",
"gerberVersion": "V1.2",
"testUnitUuid": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
"testUnitSource": "1",
"onlineStatus": 2,
"mbSn": "MBSN20240001",
"fgSn": "FGSN20240001",
"comments": "测试机备注",
"testUnitGroupUuid": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
"testUnitName": "测试机-01",
"groupLeaderName": "王五",
"groupLeaderCode": "GL001",
"ipAddress": "192.168.1.100",
"ipAddressBridge": "10.0.0.100",
"vncParam": "vnc://192.168.1.100:5900",
"lcfcUuid": "lcfc-uuid-001",
"mbUuid": "mb-uuid-001"
}
],
"total": 50,
"size": 10,
"current": 1,
"optimizeCountSql": true,
"searchCount": true,
"pages": 5
}
```
### 查询异常
```json
{
"code": 500,
"msg": "系统异常"
}
```