1. 平台概述

接口自动化测试平台Interface Test Platform（ITP）是一款基于Web的自动化测试工具，主要用于接口测试、业务流程测试、测试任务管理等功能。平台提供了完整的用户权限管理、项目管理、环境配置、测试用例编写与执行、测试报告生成、bug管理等功能。完全免费。

体验网址

Docker-compose部署仅需6分钟；

项目地址：https://gitee.com/hp631012651/itp

2.1 登录平台

• 访问平台登录页面

• 输入用户名和密码

  • 用户名：至少5位字符

  • 密码：至少8位字符

• 点击登录按钮

2.2 用户注册

平台支持用户注册功能，新用户可以通过注册界面创建账户。（新注册用户拥有只读权限，需要后台管理系统开通可写权限）

V6.0之后会支持中文名注册

3. 项目管理

3.1 项目列表

在项目管理模块中，可以查看所有测试项目的基本信息，包括项目名称、负责人等。

3.2 创建项目

1. 进入项目列表页面

2. 点击"添加项目"按钮

3. 填写项目信息：

   • 项目名称（必填）

   • 项目负责人（必填）

4. 点击保存

3.3 编辑项目

1. 在项目列表中找到需要编辑的项目

2. 点击编辑按钮

3. 修改项目信息（项目名称、负责人等）

4. 点击保存

3.4 删除项目

1. 在项目列表中找到需要删除的项目

2. 点击删除按钮

3. 确认删除操作

4. 测试环境管理

每个项目可以配置多个测试环境，用于不同场景下的测试执行。

4.1 环境配置

1. 进入系统设置目录，点击”运行环境“

2. 选择"测试环境"选项卡

3. 点击"添加环境"按钮

4. 配置环境信息：

   • 环境名称

   • 主机地址/服务器域名

   • 数据库配置（可选）

   • 请求头（可选）

   • 全局变量（可选）

4.2 环境编辑与删除

• 编辑：选择环境后点击编辑按钮，修改配置信息后保存

• 删除：选择环境后点击删除按钮，确认删除操作

5. 接口测试管理

5.1 接口管理

5.1.1 添加接口

1. 进入接口管理页,项目接口管理

2. 填写接口信息：

   • 接口名称

   • 接口地址

   • 请求方法（GET/POST/PUT/DELETE等）

   • 接口类型

   • 点击【确定】

3. 一键同步swagger

5.1.2 接口列表

可以查看项目下所有接口，支持分页和搜索功能。

5.1.3 接口编辑与删除

• 编辑：选择接口后点击编辑按钮，修改接口信息后保存

• 删除：选择接口后点击删除按钮，确认删除操作

5.2 测试用例管理

5.2.1 创建测试用例

1. 进入用例管理页面

2. 选择对应接口

3. 点击"添加用例"按钮

4. 填写用例信息：

   • 用例名称

4.1完善用例信息

• • 请求头（可选）

  • 请求参数（可选）

  • 前置脚本（可选）

  • 后置脚本（可选）

  • 保存测试用例

5.2.2 用例执行

1. 选择需要执行的用例

2. 选择测试环境

3. 点击"运行"按钮

4. 查看执行结果和日志

5.2.3 用例编辑与删除

• 编辑：选择用例后点击编辑按钮，修改用例信息后保存

• 删除：选择用例后点击删除按钮，确认删除操作

6. 业务流程测试

6.1 创建测试场景

1. 进入业务流程测试页面

2. 点击"添加"按钮

3. 填写场景信息：

   • 业务流名称

   • 点击"新增步骤"

   • 保存

6.2 添加测试步骤

1. 进入场景详情页面

2. 选择需要添加的测试用例

3. 设置用例执行顺序（可拖拽）

4. 保存

6.3 执行测试场景

1. 选择需要执行的业务流

2. 选择测试环境

3. 点击"运行"按钮

4. 查看执行结果和详细报告

7. 测试任务管理

7.1 创建测试计划

1. 进入测试计划页面

2. 点击"添加"按钮

3. 配置任务信息：

   • 任务名称

   • 选择测试场景或用例

   • 保存

7.2 定时任务

平台支持配置定时任务，定期执行测试任务：

1. 进入定时任务页面

2. 点击"添加定时任务"

3. 配置定时规则（cron表达式）

4. 关联测试计划

5. 点击”创建“

8. 测试报告

8.1 查看测试报告

平台会自动生成测试执行报告，包括：

• 执行概览（成功/失败用例数）

• 详细执行日志

• 请求和响应信息

• 断言结果

分享测试报告

分享功能支持设置过期时间，保障报告的安全性：

下载测试报告

9. BUG管理

9.1 BUG提交

在测试执行过程中发现的问题可以提交到BUG管理系统：

1.接口管理界面可以提交bug

2.新增用例界面也可以提交bug

3.测试报告页面如果有失败的用例也可以提交bug

9.2 BUG跟踪

可以跟踪BUG的处理状态，包括：

• 待处理

• 处理中

• 已解决

• 已关闭

10. 权限管理

平台具有完善的权限控制机制：

• 普通用户：只能查看和执行自己有权限的项目

• 管理员：具有所有操作权限

• 只读用户：只能查看信息，不能进行修改操作

11. 文件管理

平台支持测试相关文件的上传和管理：

• 支持上传测试数据文件

• 限制文件大小（不超过300KB）

• 防止重复文件上传

• 支持文件删除

以上是接口自动化测试平台的主要操作说明，用户可以根据具体需求选择相应功能模块进行操作。

12.全局工具函数调用（插件化开发）

1.在运行环境中添加全局工具函数

2.前后置脚本中可以调用

使用global_func直接调用，

13. 参数传递

第一步，先使用"Jsonpath提取数据"

第二步，再使用"设置全局变量”key是变量名，value是赋值

第三步，使用全局变量

14.大数据可视化平台

首页-上方，点击"大数据可视化平台"，可以看到最近一周的测试执行情况

15.性能测试

1. 创建性能测试

1.1 新建测试

1. 在性能测试管理页面，点击左侧"新建测试"按钮

2. 填写测试基本信息：
- **测试名称**：输入测试名称
- **测试类型**：选择"单接口用例"或"业务流程"
- **测试对象**：根据测试类型选择对应的接口用例或业务流程
- **所属项目**：自动填充当前项目

1.2 配置性能参数

在测试详情配置页中设置以下参数：
- **用户数**：并发用户数量
- **每秒启动用户数**：控制请求发送速率
- **运行时长**：测试执行时间（支持s/m/h格式，如10s、5m、1h）

2. 运行性能测试

2.1 选择测试环境

1. 在测试配置页选择对应的测试环境
2. 确保环境配置正确，包括：
- 主机地址
- 请求头
- 全局变量等

2.2 启动测试

1. 点击"运行测试"按钮
2. 系统将在后台异步执行性能测试
3. 测试状态可在报告标签页查看

3. 查看测试报告

3.1 报告概览

测试完成后，在"报告"标签页可查看：
- **请求数**：总请求数量
- **失败数**：请求失败数量
- **成功率**：请求成功百分比
- **响应时间**：平均、中位、最大、最小响应时间
- **请求速率**：每秒请求数(req/s)
- **失败速率**：每秒失败数(fail/s)

3.2 详细统计

- **统计报告**：各接口的详细性能数据

- **响应时间分布**：不同百分位的响应时间

- **统计图表**：可视化性能趋势图

- **失败请求**：具体的失败请求详情

- **异常请求**：系统异常信息

4. 参数说明

4.1 核心配置参数

| 参数 | 说明 | 默认值 |
|------|------|--------|
| user_count| 并发用户数 | 100 |
| spawn_rate | 每秒启动用户数 | 10 |
| run_time| 运行时长 | 10m |

4.2 请求间隔计算

请求间隔时间 = 1秒 / [spawn_rate]
- `spawn_rate=10`：每0.1秒发送一个请求
- `spawn_rate=1`：每1秒发送一个请求
- `spawn_rate=0.5`：每2秒发送一个请求

4.3 性能指标解读

- **请求速率(req/s)**：每秒处理的请求数量，数值越高性能越好
- **平均响应时间**：所有请求的平均耗时，数值越低性能越好
- **成功率**：成功请求占总请求数的百分比，100%为最佳
- **90%响应时间**：90%请求的响应时间不超过该值

5. 最佳实践

5.1 测试准备

1. 确保测试环境配置正确
2. 验证接口用例或业务流程可正常执行
3. 根据系统预期设置合理的并发数和运行时长

5.2 结果分析

1. 关注请求速率是否满足业务需求
2. 检查响应时间是否在可接受范围内
3. 排查失败请求的具体原因
4. 对比不同配置下的性能表现

5.3 性能调优

1. 根据测试结果调整系统配置
2. 优化接口性能
3. 调整并发策略重新测试验证

16. 安全测试

功能概述
安全测试模块提供对Web应用程序接口的安全性检测，支持两种测试模式：

• 单接口测试：针对特定接口进行安全测试
• 全部接口测试：对项目下所有接口进行批量安全测试

模块支持分布式执行安全测试任务，并提供聚合报告和CSV报告下载功能。
操作流程
1. 创建安全测试任务

步骤1：打开安全测试管理页面
进入系统后，点击左侧菜单中的"安全测试管理"进入主界面。
步骤2：创建测试任务
点击左侧"创建安全测试"按钮
填写测试任务信息：
测试名称：为测试任务命名
测试范围：
选择"单接口测试"可针对特定接口进行测试
选择"全部接口测试"可对项目下所有接口进行测试
测试接口（仅在单接口测试时显示）：选择需要测试的具体接口
测试环境：选择测试执行环境
步骤3：保存测试任务
点击"确定"按钮完成测试任务创建。
2. 添加测试用例

在测试任务详情中，切换到"测试用例"标签页：
步骤1：添加测试用例
点击"添加测试用例"按钮，填写用例信息：
用例名称：为测试用例命名
测试类型：从以下类型中选择：
SQL注入测试
XSS攻击测试
CSRF攻击测试
文件上传安全测试
权限绕过测试
速率限制测试
命令注入测试
自定义安全测试

自定义安全测试示例：

测试载荷(payload):

[

{"mobileNo":"15888888888","password":"'", "smsCode":"","terminal":"web","terminalName":"Chrome / 120.0","scope":"logon"},

{"mobileNo":"15888888888","password":"1' OR '1'='1", "smsCode":"","terminal":"web","terminalName":"Chrome / 120.0","scope":"logon"},

{"mobileNo":"15888888888","password":"admin'--", "smsCode":"","terminal":"web","terminalName":"Chrome / 120.0","scope":"logon"},

{"mobileNo":"'; DROP TABLE users; --","password":"test", "smsCode":"","terminal":"web","terminalName":"Chrome / 120.0","scope":"logon"}

]

测试配置(config):

{

"method": "POST",

"headers": {

"Content-Type": "application/json",

"User-Agent": "SecurityScanner/1.0"

},

"vulnerability_indicators": [

"SQL syntax",

"mysql_fetch",

"ORA-",

"PostgreSQL",

"JDBC",

"ODBC",

"SQLite",

"Microsoft SQL",

"error",

"exception"

],

"success_indicators": [

"tokenValue",

"Bearer",

200

],

"timeout": 10

}

测试载荷：输入测试载荷内容，每行一个
测试配置（仅自定义测试时显示）：输入JSON格式的测试配置
是否启用：开关控制测试用例是否启用
步骤2：保存测试用例
点击"确定"按钮完成测试用例添加。
3. 执行安全测试

步骤1：选择测试任务
在左侧测试列表中点击需要执行的测试任务。
步骤2：执行测试
在测试任务详情页，点击"执行测试"按钮，确认后系统将异步执行安全测试任务。
4. 查看测试结果

单接口测试结果查看
切换到"测试结果"标签页，可查看该接口的详细测试结果：
测试用例名称
是否发现漏洞
测试耗时
执行时间
可点击查看详细结果
全部接口测试结果查看
切换到"测试结果"标签页，可查看聚合结果：
点击"全部详情"查看各接口的详细测试结果
点击"CSV报告"下载完整测试报告
5. 下载测试报告
对于全部接口测试任务，可以下载CSV格式的完整测试报告：
在"测试结果"标签页中点击"CSV报告"按钮
系统将自动生成并下载包含所有测试结果的CSV文件
报告内容包括：
测试任务基本信息
统计信息（总接口数、已测试接口数、测试用例总数、发现漏洞数）
详细的测试结果数据（接口名称、接口URL、测试用例、测试类型、发现漏洞、漏洞详情、耗时、时间等）
注意事项
执行安全测试前必须先添加测试用例
全部接口测试会测试项目下所有接口，可能耗时较长
自定义测试类型需要提供JSON格式的测试配置
测试结果支持分页查看，可调整每页显示数量
系统支持通过搜索功能快速查找测试任务
以上就是安全测试模块的主要操作流程，通过该模块可以有效检测Web接口的安全性问题。

17.消息中心

1. 概述
消息中心是智能测试平台的重要功能模块，用于集中展示和管理各类测试任务的执行结果和系统通知。用户可以通过消息中心及时了解测试任务的执行状态、查看测试报告以及管理消息的阅读状态。
2. 功能特点
多类型消息支持：支持任务完成、任务失败、性能测试完成、安全测试完成和系统消息等多种类型
项目隔离：消息按项目进行隔离，用户只能查看当前项目的消息
阅读状态管理：支持标记消息为已读/未读，统计未读消息数量
报告查看：可直接跳转到对应的测试报告页面
筛选和分页：支持按消息类型和阅读状态筛选，提供分页功能
3. 消息类型说明

4. 操作指南
4.1 查看消息列表
进入消息中心页面，系统会自动加载当前项目的消息列表
消息按时间倒序排列，最新的消息显示在最上方
未读消息会以红色标签标识，并在标题上加粗显示

4.2 筛选消息
在消息中心顶部提供筛选功能：
消息类型筛选：可按不同类型筛选消息
阅读状态筛选：可筛选已读或未读消息
查询和重置：点击"查询"按钮应用筛选条件，"重置"按钮清除筛选条件

4.3 查看测试报告
对于关联了测试报告的消息，可以点击"查看报告"按钮：
功能测试报告：跳转到 /report/{report_id} 页面
性能测试报告：跳转到 /performance 页面并携带报告ID参数
安全测试报告：跳转到 /security 页面并携带报告ID参数
点击"查看报告"按钮时，系统会自动将该消息标记为已读。

4.4 管理阅读状态
单条标记：点击消息行的"标为已读"按钮将单条消息标记为已读
全部标记：点击"全部已读"按钮将当前筛选条件下的所有消息标记为已读
4.5 刷新消息列表
点击"刷新"按钮可手动刷新消息列表，获取最新的消息数据。
5. 注意事项
项目关联：消息与项目强关联，切换项目时消息列表会自动更新
权限控制：用户只能查看自己有权限访问的项目的消息
报告关联：只有关联了测试报告的消息才会显示"查看报告"按钮
自动标记：点击"查看报告"按钮会自动将消息标记为已读
分页显示：消息列表支持分页，默认每页显示10条消息

18.驾驶舱

驾驶舱是系统的核心数据展示界面，提供了各类关键指标的可视化呈现，帮助用户快速了解项目状态。
功能模块介绍
驾驶舱主要包含以下几个功能模块：

快捷入口 - 提供常用功能的快速访问
用例统计 - 展示各类测试用例的数量及分布情况
用例编写排名 - 显示用例编写贡献者排行
平台动态 - 实时展示平台最新活动
Bug统计 - 展示Bug的状态分布情况
Bug提交排名 - 显示Bug发现者贡献排行

操作指南
快捷入口使用

驾驶舱顶部设有四个快捷入口按钮，可一键跳转至相应功能模块：
用例管理: 点击后跳转到测试用例管理页面
性能测试: 跳转到性能测试模块
安全测试: 进入安全测试功能区域
Mock服务: 访问Mock服务配置界面

查看统计数据

驾驶舱中的各类统计数据会自动加载并定期刷新，无需手动操作即可查看：

用例统计: 在环形图中直观展示接口测试、性能测试和安全测试用例的比例分布，右侧数字面板显示具体数量

Bug统计: 以环形图形式展现不同状态(Bug的数量分布，包括未处理、处理中、已处理和无效四种状态

排名信息查看

用例编写排名: 展示对当前项目贡献用例最多的前五名用户(注意只统计了接口测试用例，其他用例暂未统计)

Bug提交排名: 显示发现并提交Bug最多的前五名用户

平台动态浏览

平台动态模块会自动滚动显示最近的操作记录，包括:
用户注册信息
测试用例新增记录
Bug提交记录
鼠标悬停可暂停滚动，方便查看详情。

注意事项
所有数据均基于当前选择的项目进行统计
图表会根据窗口大小自适应调整布局
页面会监听窗口大小变化并自动重新渲染图表
数据每5分钟自动刷新一次
驾驶舱界面设计简洁明了，所有重要信息一目了然，便于项目管理者快速掌握项目整体状况。

19.平台配置

功能概述
平台配置功能允许管理员自定义系统外观和基础信息，包括登录页面欢迎语、企业信息、网站图标、背景图片和LOGO等。

访问路径
进入系统设置页面
选择"平台配置"选项卡

配置项说明
基础信息配置
登录欢迎语

作用：登录页面顶部显示的欢迎文字
要求：必填项，最大100字符
示例："欢迎使用ITP接口自动化测试平台"

注册页也可修改

企业名称
作用：显示在网站底部版权信息中
要求：必填项，最大100字符
影响：版权信息、备案信息展示
ICP备案信息
作用：网站底部显示的ICP备案信息
要求：可选项，最大100字符
备案号
作用：公安备案号
要求：可选项，最大100字符

版权信息
系统会自动生成完整的版权信息，格式为：

Copyright © [当前年份] [企业名称]. All Rights Reserved. 版本：[版本号] [ICP备案信息] 公安备案号 [备案号]

图片资源配置
自定义网页图标（favicon）
格式要求：ICO格式
尺寸建议：16x16或32x32像素
大小限制：不超过100KB
用途：浏览器标签页显示的小图标

自定义登录页背景
格式要求：JPG/PNG/GIF格式
尺寸建议：1920x1080像素
大小限制：不超过2MB
用途：修改登录页面背景图片

自定义平台LOGO
格式要求：JPG/PNG/GIF格式
尺寸建议：200x50像素
大小限制：不超过1MB
用途：系统顶部显示的标识

操作步骤
1. 查看当前配置
进入平台配置页面后，系统自动加载当前配置
页面显示所有已配置的信息和图片预览
2. 修改基础信息
在对应输入框中直接编辑内容
确保必填项已填写完整
3. 上传图片资源
点击相应上传区域
选择符合要求的图片文件
系统会自动预览上传的图片
如需更换，可重复上传操作
4. 保存配置
点击页面底部"保存配置"按钮
系统会验证所有必填项
保存成功后显示成功提示
注意事项
图片上传限制
favicon：仅支持ICO格式，大小不超过100KB
背景图：支持JPG/PNG/GIF，大小不超过2MB
LOGO：支持JPG/PNG/GIF，大小不超过1MB
文件格式验证
系统会自动验证文件类型和大小
不符合要求的文件将被拒绝上传
配置生效
保存后配置立即生效
刷新页面即可看到更新后的效果

20.AI 生成功能测试用例

一、功能概述
AI 生成功能测试用例模块通过自然语言对话的方式，帮助测试人员快速生成测试用例。系统支持会话管理、禅道需求同步、用例编辑导出等功能，让测试用例编写更加智能化、高效化。

二、界面布局说明

整个界面分为三个主要区域：
1. 左侧会话列表区（350px 宽）
顶部：搜索框，可按标题搜索会话
中间：会话列表，显示所有历史会话
底部：新建会话按钮
2. 中间 AI 对话区（可拖拽调整宽度）
顶部：AI 助手标题栏，显示当前会话名称
中部：禅道需求展示面板（可展开/收起）
主体：聊天消息区域
底部：输入框和操作按钮
3. 右侧测试用例区（自适应宽度）
顶部：用例标题栏，显示项目名称和用例数量
主体：测试用例卡片列表
右上角：操作下拉菜单（导出/保存）

三、详细操作步骤
3.1 创建新会话

使用场景：开始一个新的测试任务时
操作步骤：
点击左侧底部的"新建会话"按钮
在弹出的对话框中填写会话标题（如"登录功能测试"）
所属项目会自动填充为当前选中的项目
点击"确定"按钮
注意事项：
会话创建成功后，系统会自动发送一条欢迎消息
新会话会立即显示在左侧列表顶部
建议按"项目名 + 功能模块"的格式命名会话，方便后续查找

3.2 与 AI 对话生成用例

使用场景：需要生成特定功能的测试用例
操作步骤：
在底部输入框中输入测试需求描述
示例 1："生成一个用户登录功能的测试用例"
示例 2："为购物车结算流程设计测试用例，包括正常流程和异常情况"
按下回车键或点击"生成用例"按钮
等待 AI 处理（通常 3-5 秒）
生成的测试用例会立即显示在右侧用例区
输入技巧：
✅ 具体明确：说明功能模块、业务场景
✅ 包含边界：提及需要覆盖的正常场景和异常场景
✅ 特殊要求：如有特定格式或侧重点，可在描述中说明
不支持的请求类型：
❌ 问候语（如"你好"、"在吗"）会返回预设欢迎语
❌ 与测试无关的问题（如时间、天气）会被礼貌拒绝

3.3 查看和管理禅道需求
使用场景：需要基于禅道需求文档生成测试用例
方式一：数据库直连同步（推荐）

操作步骤：
点击 AI 对话区顶部的"同步需求"按钮
在弹出的对话框中填写以下信息：
数据库地址：禅道数据库 IP 地址
数据库端口：默认 3306
数据库用户名：禅道数据库账号
数据库密码：禅道数据库密码
数据库名称：通常为"zentao"
需求 ID：必填，多个 ID 用逗号分隔（最多 100 条）
点击"开始同步"按钮
同步成功后，点击"查看需求"按钮查看需求列表
重要提示：
⚠️ 必须填写需求 ID，不支持同步所有需求
⚠️ 单次最多同步 100 条需求，建议按版本分批同步
✅ 数据库连接信息会自动保存到本地，下次无需重复填写
方式二：上传需求文件
操作步骤：
点击输入框上方的"上传需求"按钮
选择 Excel 或 JSON 格式的需求文件
上传成功后，系统会自动解析需求内容
文件格式要求：
Excel：包含需求 ID、标题、描述等字段
JSON：符合系统定义的规范格式

3.4 使用需求作为提示词
使用场景：看到某条禅道需求，想为其生成测试用例
操作步骤：
点击"查看需求"按钮展开需求面板
找到目标需求卡片
点击卡片右下角的"用作提示词"按钮
系统会自动将该需求的内容填充到输入框
点击"生成用例"按钮
自动生成的提示词格式：

请根据以下需求生成测试用例：

需求标题：[需求标题]
需求描述：[需求内容]
需求版本：[版本号]

请为该需求编写全面的功能测试用例，包括正常场景和异常场景。

3.5 编辑测试用例

使用场景：AI 生成的用例需要人工调整优化
操作步骤：
在用例卡片上点击"编辑"按钮
在弹出的编辑对话框中修改以下内容：
用例标题：修改用例名称
优先级：选择 P0-P3
测试步骤：可添加、修改、删除步骤
预期结果：修改预期输出
用例描述：补充详细说明（可选）
标签：添加或删除标签
点击"确定"保存修改
快捷操作：
添加步骤：点击"添加步骤"按钮
删除步骤：点击步骤旁的"删除步骤"按钮
添加标签：点击"+ 添加标签"，输入后回车
删除标签：点击标签上的"×"

3.6 保存测试用例
使用场景：确认用例无误后，保存到数据库
操作步骤：
点击右上角的"操作"下拉按钮
选择"保存用例"选项
系统会批量保存当前所有未保存的用例
保存成功后，用例卡片上会显示"已保存"绿色标签
保存规则：
已保存的用例会有唯一 ID
未保存的用例显示黄色"未保存"标签
保存操作不会影响已保存的用例

3.7 导出测试用例
使用场景：需要将用例导出为 Excel 文件用于评审或归档
操作步骤：
（可选）上传自定义模板
点击"上传用例模板"按钮
选择 Excel 模板文件（.xlsx/.xls）
点击右上角的"操作"下拉按钮
选择"导出用例"选项
系统会自动下载 Excel 文件
导出格式：
标准格式：系统默认模板
自定义格式：如果上传了模板，按模板格式导出
文件名规则：测试用例_时间戳.xlsx

3.8 删除测试用例
使用场景：移除不需要或错误的用例
操作步骤：
在用例卡片上点击"删除"按钮
在确认对话框中点击"确定"
用例会从列表中移除
删除规则：
未保存的临时用例：直接从前端的删除
已保存的用例：调用后端接口从数据库删除
删除操作不可恢复，请谨慎操作

3.9 搜索历史会话

使用场景：快速找到之前的测试会话
操作步骤：
在左侧顶部的搜索框中输入关键词
系统会实时过滤会话列表
点击目标会话即可切换
搜索规则：
支持模糊匹配会话标题
不区分大小写
清空搜索框后自动恢复完整列表

3.10 切换会话
使用场景：在多个测试任务间快速切换
操作步骤：
在左侧会话列表中点击目标会话
系统会自动加载该会话的聊天记录和用例
右侧区域会同步更新
加载内容：
完整的聊天历史
所有已保存的测试用例
会话元数据（标题、项目、更新时间等）

3.11 删除会话
使用场景：清理不再需要的测试会话
操作步骤：
方式一：在会话列表中右键点击会话 → 选择"删除"
方式二：点击会话 → 在右上角操作菜单中选择"删除"
在确认对话框中点击"确定"
删除影响：
会话本身会被删除
关联的测试用例会一并删除
聊天记录会永久丢失
删除前请确保已导出重要用例

四、高级功能
4.1 拖拽调整布局

功能说明：自由调整 AI 对话区和用例区的宽度比例
操作方法：
将鼠标移动到两个区域之间的分割线上
鼠标变为左右箭头形状（col-resize）
按住鼠标左键左右拖动
松开鼠标完成调整
限制条件：
最小宽度：300px
最大宽度：容器总宽度 - 300px

4.2 上传自定义模板
功能说明：使用公司或团队的标准用例模板格式
操作步骤：
准备 Excel 模板文件，包含所需列头
点击"上传用例模板"按钮
选择文件后自动上传
上传成功后会显示模板 ID
模板要求：
支持格式：.xlsx、.xls、.json、.xmind
第一行应为列头定义
列头名称应清晰明确
使用效果：
导出时会按照上传的模板格式生成 Excel
模板信息会保存在当前会话中
不同会话可以使用不同的模板

4.3 分页浏览会话
功能说明：当会话数量较多时，支持分页查看
操作方式：
每页显示：10 条会话记录
分页器位于会话列表底部
点击页码或"上一页"/"下一页"进行切换
自动跳转规则：
删除会话后，如果当前页为空，自动跳转到上一页
搜索结果为空时，自动回到第一页

五、常见问题解答
Q1：为什么我输入的请求没有被处理？
可能原因：
没有选中会话或创建新会话
输入内容为空或只包含空格
网络异常导致请求失败
解决方法：
确保左侧已选中一个会话（高亮显示）
检查输入内容是否有效
查看浏览器控制台是否有报错信息

Q2：生成的用例不满意怎么办？
解决方案：
手动编辑：点击"编辑"按钮逐条修改
重新生成：在对话框中补充更详细的要求，再次生成
参考需求：先同步禅道需求，再使用"用作提示词"功能
优化建议：
在输入描述时提供更多上下文信息
明确指出需要覆盖的场景类型
可以指定用例的颗粒度（粗粒度/细粒度）

Q3：如何保证生成的用例质量？
最佳实践：
✅ 人工审核：AI 生成的用例必须经过人工审查
✅ 补充边界：人工添加容易遗漏的边界场景
✅ 统一格式：编辑用例时保持团队统一的格式规范
✅ 及时保存：确认无误后立即保存到数据库

六、使用技巧与建议
6.1 提高生成效率的技巧
1.结构化描述需求

好的示例：
"为电商 APP 的订单取消功能生成测试用例，包括：
- 用户主动取消（未发货状态）
- 超时自动取消（24 小时未支付）
- 商家拒绝取消（已发货状态）
- 退款金额计算（含优惠券、运费）"

2.利用历史会话
相似功能的用例可以在历史会话基础上修改
通过搜索快速定位相关会话
3.批量操作
积累一定数量用例后统一保存，减少操作次数
导出前集中编辑，提高效率

6.2 团队协作建议
会话命名规范
格式：项目名 - 模块名 - 日期
示例：ERP-采购管理 -20260327
用例标签体系
按功能模块：登录、支付、订单
按测试类型：功能测试、边界测试、异常测试
按优先级：核心流程、重要功能、一般功能
定期归档
每周导出一次用例备份
删除过期的临时会话
整理共用模板库

6.3 性能优化建议
避免大量数据
单个会话建议不超过 100 条用例
定期清理无用会话释放空间
合理使用搜索
使用精确关键词减少过滤时间
避免频繁清空/输入搜索词
网络环境
建议在稳定的内网环境使用
大文件上传时避免网络波动

七、附录
附录 A：快捷键列表

附录 B：数据字典
会话状态：
临时会话：前端创建，尚未保存到数据库
正式会话：已有数据库 ID，持久化存储
用例状态：
未保存：AI 生成后尚未入库，显示黄色标签
已保存：已存入数据库，显示绿色标签
优先级定义：
P0 - 紧急：核心功能，阻塞性问题
P1 - 高：重要功能，严重影响使用
P2 - 中：一般功能，部分影响
P3 - 低：辅助功能，轻微影响

21.授权管理

一、功能简介

授权管理用于管控 ITP 平台的授权使用期限，包含以下能力：

- **试用授权**：系统首次运行自动获得 90 天试用授权，无需任何操作；
- **激活授权**：通过激活密钥升级为正版授权，每次激活续期 365 天、730天、1095天；
- **到期提醒**：到期前 7 天开始警告，到期后提供 7 天宽限期；
- **授权转移**：更换服务器或迁移环境时，申请将授权转移到新机器；
- **安全防护**：自动检测时间篡改、硬件变更、非法迁移等异常行为。

二、授权状态说明

> 授权到期后有 **7 天宽限期**，期间平台仍可正常使用；宽限期结束后系统自动锁死。

三、查看授权信息

**入口**：左侧菜单 →「授权管理」→「系统授权」。

进入页面后可查看：

- **当前硬件 ID**：当前服务器的唯一标识，可点击「复制」；
- **注册硬件 ID**：授权绑定的服务器标识；
- **硬件匹配**：显示"已匹配"（正常）或"未匹配"（硬件发生变化）；
- **授权类型**：试用版 / 正版授权；
- **到期时间**：授权有效截止日期；
- **授权状态**：正常 / 即将到期 / 宽限期 / 已锁死；
- **转移申请状态**：如提交过授权转移，显示审批进度。

页面顶部如有红色或黄色告警条，请按提示尽快处理。

四、申请激活密钥（购买/续费）

**入口**：左侧菜单 →「授权管理」→「申请激活」。

### 4.1 操作流程

1. 展开页面顶部的「申请流程说明」了解整体流程；
2. 填写申请信息：
- **客户名称**（必填）：公司全称或个人姓名全称；
- **联系人**（必填）：对接人姓名；
- **联系电话**（必填）：支持 11 位手机号、座机号（如 010-12345678）或微信号；
- **邮箱**（选填）：用于接收发票；
- **公司名称**（选填）：开票用；
3. 选择套餐：**企业版 365 天 / 730 天 / 1095 天**，有效天数会自动带出；
4. 核对「硬件信息」区域显示的硬件 ID（系统自动带出，无需填写）；
5. 如有特殊要求，在「备注」中说明；
6. 点击 **「提交申请」**。

### 4.2 提交后的两种情况

- **在线模式**：提示"申请已提交到 MT 系统"，等待管理员审批即可；
- **离线模式**：提示"申请已保存到本地"，此时需在下方「我的申请记录」中点击该申请的 **「导出」** 按钮，下载 JSON 申请文件，并将该文件发送给管理员处理。

### 4.3 查看申请进度与密钥

页面下方「我的申请记录」展示所有申请及状态：

管理员审批通过后，点击记录中的 **「查看密钥」** 按钮，复制激活密钥，然后到「硬件信息与授权管理」页面完成激活（见第五节）。

五、激活系统

**入口**：「硬件信息与授权管理」页面 → 点击 **「输入激活密钥」**。

### 5.1 使用激活密钥激活

1. 点击「输入激活密钥」按钮，打开输入框；
2. 粘贴完整的激活密钥（格式为 `ITP-` 开头的长字符串，**必须完整，不能截断**）；
3. 点击 **「激活」**；
4. 提示"激活成功"后，授权类型变为正版授权，有效期延长 365 天。

> 已过期后激活：从当天起算 365 天；未过期时激活：在原到期时间上累加 365 天。

### 5.2 使用管理员解锁码解锁（系统锁死时）

系统锁死且暂时无法获得激活密钥时：

1. 复制页面上的「当前硬件 ID」发送给管理员；
2. 管理员生成解锁码（`UNLOCK-` 开头）发回给您；
3. 在「输入激活密钥」对话框中粘贴解锁码并确认，即可恢复系统使用；
4. 解锁后请尽快联系官方续费，避免再次锁死。

### 5.3 激活失败常见提示

六、申请授权转移（换服务器/迁移环境）

> **重要**：更换服务器、迁移环境前，**必须先在原服务器上申请授权转移**，否则直接迁移会导致系统安全锁死。

**入口**：「硬件信息与授权管理」页面 → 点击 **「申请授权转移」**。

### 6.1 操作步骤

1. 点击「申请授权转移」，填写表单：
- **客户名称**（必填）：与申请激活密钥时填写的客户名称保持一致；
- **申请人**（必填）：姓名；
- **联系方式**（必填）：11 位手机号；
- **转移原因**（必填）：更换服务器 / 云迁移 / 系统升级 / 硬件故障 / 其他；
- **详细说明**（必填）：描述转移原因和情况；
- **新硬件 ID**（选填）：如已有新服务器可提前填写，否则留空；
2. 点击 **「提交申请」**，此时授权状态变为"待转移"；
3. 等待管理员审核，可随时点击 **「同步审核状态」** 查询最新审批结果：
- **已通过**：旧服务器硬件解绑，在新服务器上重新激活即可；
- **已拒绝**：授权维持原状，可联系管理员了解原因。

### 6.2 转移完成后的操作

审批通过后，在新服务器上重新申请激活密钥并完成激活（参见第四、五节）。

七、安全注意事项（必读）

以下行为会触发系统 **安全锁死**，且 **无法通过普通激活密钥解锁**，只能联系管理员处理：

1. **修改服务器系统时间**：包括回拨或大幅调快时间；请保持服务器时间同步（NTP）；
2. **变更服务器硬件**：更换主板、网卡，或将虚拟机迁移到不同物理机；
3. **非法修改系统文件或尝试破解**；
4. **未申请转移就直接把程序复制到其他机器运行**。

**建议**：

- 服务器务必开启时间自动同步；
- 计划更换服务器或迁移环境时，**提前申请授权转移**，审核通过后再操作；
- 妥善保管激活密钥，一个密钥只能使用一次。

## 八、常见问题（FAQ）

**Q1：试用到期后还能用吗？**
可以再用 7 天（宽限期），期间页面会显示红色提醒；宽限期结束后系统锁死，请尽快续费。

**Q2：每次激活能延长多久？**
每次激活续期 365 天。未过期时在原到期日上累加，已过期则从当天起算。

**Q3：页面显示"硬件未匹配"怎么办？**
说明服务器硬件发生变化（换机、换网卡、虚拟机迁移等）。请先申请「授权转移」，审批通过后在新服务器重新激活。

**Q4：系统锁死了怎么办？**
- 若是过期锁死：输入新的激活密钥即可解锁；
- 若是安全锁死：联系管理员获取解锁码或处理；
- 紧急情况下可向管理员索取 `UNLOCK-` 解锁码临时恢复。

**Q5：离线（无外网）环境怎么激活？**
在「申请激活密钥」页提交申请后，点击申请记录的「导出」按钮下载申请文件，发送给管理员；管理员签发密钥后，在「输入激活密钥」处粘贴即可完成激活。

**Q6：激活密钥可以重复使用吗？**
不可以。每个密钥激活成功后即失效，需要续期请重新申请新密钥。

**Q7：硬件 ID 在哪里复制？**
「硬件信息与授权管理」页面的「当前硬件 ID」旁有「复制」按钮；「申请激活密钥」页面也可复制。