WHartTest 测试管理平台

快速开始

# 设置环境变量
export WHARTTEST_BACKEND_URL="http://your-backend:8000"
export WHARTTEST_API_KEY="your-api-key"

# 执行操作
python whart_tools.py --action <action_name> [--参数名 参数值]

可用操作

项目管理

用例管理

截图管理

截图路径约定：playwright-skill 保存的截图位于 SCREENSHOT_DIR 环境变量指定的目录。上传时只需传入文件名（无需路径），系统会自动从 SCREENSHOT_DIR 查找。

单张上传：--file_path "case_11_step1.png" 批量上传：--file_paths "step1.png,step2.png,step3.png"（最多10张，逗号分隔）

图表操作

审核状态

--review_status 可选值：

• pending_review – 待审核（默认）
• approved – 通过
• needs_optimization – 优化
• optimization_pending_review – 优化待审核
• unavailable – 不可用

--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 格式结果，便于解析处理。