WHartTest 测试管理平台
快速开始
设置环境变量
export WHARTTEST_BACKEND_URL="http://your-backend:8000" export WHARTTEST_API_KEY="your-api-key"
执行操作
python whart_tools.py --action <action_name> [--参数名 参数值]
可用操作
项目管理
Action 描述 参数
get_projects
获取所有项目列表 无
get_modules
获取项目下的模块列表 --project_id
用例管理
Action 描述 参数
get_levels
获取用例等级列表 无
get_testcases
获取模块下的用例列表 --project_id , --module_id
get_testcase_detail
获取用例详情 --project_id , --case_id
add_testcase
新增测试用例 --project_id , --module_id , --name , --level , --precondition , --steps , --notes , --review_status , --test_type
edit_testcase
编辑测试用例 --project_id , --case_id , --name , --level , --module_id , --precondition , --steps , --notes , --review_status , --test_type , --is_optimization
截图管理
Action 描述 参数
upload_screenshot
上传单张截图 --project_id , --case_id , --file_path , --title , --description , --step_number , --page_url
upload_screenshots
批量上传截图 --project_id , --case_id , --file_paths (逗号分隔), --title , --description , --step_number , --page_url
截图路径约定：playwright-skill 保存的截图位于 SCREENSHOT_DIR 环境变量指定的目录。上传时只需传入文件名（无需路径），系统会自动从 SCREENSHOT_DIR 查找。
单张上传：--file_path "case_11_step1.png"
批量上传：--file_paths "step1.png,step2.png,step3.png" （最多10张，逗号分隔）
图表操作
Action 描述 参数
create_diagram
创建drawio图表 --xml , --page_name
edit_diagram
编辑drawio图表 --operations (JSON格式)
审核状态
--review_status 可选值：
-
pending_review
-
待审核（默认）
-
approved
-
通过
-
needs_optimization
-
优化
-
optimization_pending_review
-
优化待审核
-
unavailable
-
不可用
测试类型
--test_type 可选值：
-
smoke
-
冒烟测试
-
functional
-
功能测试（默认）
-
boundary
-
边界测试
-
exception
-
异常测试
-
permission
-
权限测试
-
security
-
安全测试
-
compatibility
-
兼容性测试
--is_optimization 标志（布尔型，无需传值）：在 edit_testcase 时带上此标志，会自动将状态设为 optimization_pending_review （优化待审核），用于AI优化后的用例提交。一次调用即可完成编辑+状态更新。
-
✅ 正确用法：python whart_tools.py --action edit_testcase --project_id 1 --case_id 51 ... --is_optimization
-
❌ 错误用法：--is_optimization true （不要传值）
使用示例
获取项目列表
python whart_tools.py --action get_projects
获取项目1的模块
python whart_tools.py --action get_modules --project_id 1
获取用例列表
python whart_tools.py --action get_testcases --project_id 1 --module_id 5
新增用例
python whart_tools.py --action add_testcase
--project_id 1
--module_id 5
--name "登录功能测试"
--level P0
--precondition "用户已注册"
--steps '[{"step_number":1,"description":"输入用户名","expected_result":"用户名显示"}]'
--notes "冒烟测试"
上传单张截图
python whart_tools.py --action upload_screenshot
--project_id 1
--case_id 10
--file_path "step1.png"
--title "登录页面截图"
--step_number 1
批量上传截图
python whart_tools.py --action upload_screenshots
--project_id 1
--case_id 10
--file_paths "step1.png,step2.png,step3.png"
--title "登录测试截图"
输出格式
所有操作返回 JSON 格式结果，便于解析处理。