Deepseek API+Python 测试用例一键生成与导出 V1.0.4 （接口文档生成接口测试用例保姆级教程）

Deepseek API+Python 测试用例一键生成与导出 V1.0.4

接口文档生成接口测试用例保姆级教程

随着测试需求的复杂性增加，测试用例的设计和生成变得愈发重要。Deepseek API+Python 测试用例生成工具在 V1.0.4 中进行了全方位的优化和功能扩展，特别是对接口测试用例设计的支持和接口文档的智能解析处理。本文将详细介绍 V1.0.4 版本的新增功能、优化点以及其实现方式，帮助测试工程师高效完成接口测试用例的生成和导出。

1. 提示词未对齐问题优化

在 V1.0.4 版本中，解决了提示词未对齐的问题，将所有提示词内容进行了逻辑优化和文本对齐，确保生成的提示词内容更清晰、更专业，便于测试工程师直接使用。
在这里插入图片描述

优化后的提示词结构化清晰，支持功能测试用例和接口测试用例的选择，并针对不同场景提供专属的提示词模板。此外，新增了接口测试用例的专属提示词模板，详见下文。

2. 新增接口测试用例提示词模板

2.1 功能模式选择接口测试用例

在 V1.0.4 中，当用户选择“接口测试用例”模式时，点击“更新提示词”，系统会自动生成专属的接口测试用例提示词。以下是详细的提示词内容模板：
在这里插入图片描述

你是一位资深的接口测试工程师，精通各种接口测试方法和技巧。你的任务是根据提供的接口定义文档，生成全面、有效的接口测试用例。  
请严格按照以下要求执行：  1.  **理解接口定义**：  
*   仔细阅读并理解提供的接口定义文档，包括接口名称、描述、请求方法、URL、请求参数、请求头、响应状态码、响应体等信息。  
*   识别接口的功能、输入、输出和潜在的业务逻辑。  2.  **测试用例设计**：  
*   **全面性**： 针对接口的各种场景设计测试用例，包括正常情况、边界情况、异常情况、错误情况等。  
*   **有效性**： 确保每个测试用例都能够有效地验证接口的功能和性能。  
*   **覆盖率**： 尽量覆盖接口的所有功能点和可能的输入组合。  
*   **可读性**： 测试用例描述清晰简洁，易于理解和执行。  3.  **测试用例类型**： 至少包含以下类型的测试用例：  
*   **功能测试**： 验证接口是否能够按照预期实现其功能。  
*   **数据验证**： 验证接口对输入数据的校验是否正确。  
*   **安全性测试**： 验证接口是否存在安全漏洞。  
*   **性能测试**： 验证接口的性能是否满足要求。  
*   **错误处理**： 验证接口在出现错误时是否能够正确处理。  4.  **输出格式**：  
*   以 JSON 格式输出测试用例，每个测试用例包含以下字段：  *   `case_id`: 测试用例的唯一标识符  *   `case_name`: 测试用例的名称  *   `priority`: 测试用例的优先级  *   `pre_condition`: 执行测试用例的前提条件  *   `steps`:  测试步骤  *   `expected_result`: 预期结果  *   `test_data`: 测试数据  *   `test_type`: 测试类型  
*   提供至少 3 个测试用例。  5.  **示例**：  
```json
{"case_id": "TC_001","case_name": "验证用户ID为有效值时，接口返回正确的用户信息","priority": "High","pre_condition": "用户已注册","steps": ["发送 GET 请求到 /users/123","检查响应状态码是否为 200","检查响应体是否包含用户ID、用户名、邮箱等信息"],"expected_result": "接口返回用户ID为123的用户信息，包括用户名、邮箱等","test_data": {"user_id": 123},"test_type": "Functional"
}

2.2 模板优化意义

新增的接口测试用例提示词模板结构更加严谨，内容全面，能够指导测试工程师设计出高覆盖率、高质量的接口测试用例。

3. 优化 Excel 文档处理功能

3.1 Excel 文档解析为 Markdown 格式

新增了对 .xlsx 格式接口文档的智能处理功能。工具会自动解析 Excel 文件内容，并将其转换为 Markdown 格式，便于在 PyQt5 的 QTextEdit() 内容预览框中展示。文档通用性适配还未证实，在使用中遇到问题可反馈沟通。

在这里插入图片描述

实现代码

以下是实现 Excel 转 Markdown 的核心代码：

elif file_path.endswith('.xlsx'):try:df = pd.read_excel(file_path)# 将 DataFrame 转换为 Markdown 格式excel_content = df.to_markdown(index=False)return excel_contentexcept Exception as e:QMessageBox.critical(self, "错误", f"无法读取Excel文件: {str(e)}")

依赖安装

在使用 df.to_markdown() 方法时，需安装 tabulate 库：

pip install tabulate

功能效果

解析后的内容以 Markdown 表格的形式展示在 QTextEdit() 预览框中。
用户可以直接检查接口文档内容，并将其传递给阿里云百炼 Deepseek-R1 大模型进行接口测试用例生成。

推理结果会展示在生成结果框中：

在这里插入图片描述
支持导出为json及excel格式。

4. 支持阿里云百炼 Deepseek-R1 接口测试用例生成

4.1 阿里云百炼 API 说明

工具支持通过阿里云百炼 Deepseek-R1 的 API，实现接口测试用例的自动生成。用户可以参考以下文章申请 API Key：
如何申请阿里云百炼 Deepseek-R1 API Key

需替换api-key：

在这里插入图片描述

4.2 接口用例生成流程

用户上传 .xlsx 格式接口文档。
工具将文档内容解析为 Markdown 格式，并预览。
用户点击“生成测试用例”按钮，工具会调用阿里云百炼 Deepseek-R1 接口生成高覆盖率的接口测试用例。

5. 优化大模型数据分块功能

5.1 数据分块功能

为了解决大模型生成数据不完整的问题，工具新增了数据分块功能。在传递大数据量时，将其分块处理，避免超出大模型的处理限制。

实现代码

以下是数据分块功能的代码实现：

def chunk_data(self, data, chunk_size):print("开始分块")"""将数据分割成指定大小的块"""return [data[i:i + chunk_size] for i in range(0, len(data), chunk_size)]

功能意义

数据分块可有效避免生成内容中断或遗漏的问题。
分块适配功能还在进一步优化中，未来将全面支持不同类型的数据分块。

6. 总结

Deepseek API+Python 测试用例生成工具 V1.0.4 完成了一系列重要优化和功能扩展：

解决提示词未对齐问题，提升用户体验。
新增接口测试用例提示词模板，为接口测试提供全面指导。
优化 Excel 文档解析，支持将接口文档转换为 Markdown 格式并在 PyQt5 中展示。
整合阿里云百炼 Deepseek-R1，实现接口测试用例的智能生成。
新增数据分块功能，解决大模型生成数据不完整问题。

通过这些优化，工具不仅能够帮助测试工程师快速生成高质量的测试用例，还能适配更复杂的测试场景，极大提升测试效率。赶快使用 V1.0.4，体验全新的测试用例生成之旅！

Deepseek API+Python 测试用例一键生成与导出 V1.0.4 （接口文档生成接口测试用例保姆级教程）