test-validate

name	test-validate
description	运行项目测试（涵盖 Python 后端、Vue 前端及多语言校验）

🚀 常用测试命令

后端 (Python)

推荐在已激活虚拟环境的情况下执行：

# 运行所有后端测试
pytest

# 运行特定测试文件
pytest tests/test_<name>.py -v
pytest tests/test_frontend_locales.py  # 检查前端多语言一致性
pytest tests/test_backend_locales.py   # 检查后端多语言一致性

# 运行并生成覆盖率报告
pytest --cov=src

# 运行服务器（开发模式）
python src/server/main.py --dev

前端 (Vue/Node)

必须在 web 目录下执行：

# 运行所有前端单元测试
cd web && npm run test

# 运行并生成前端覆盖率报告
cd web && npm run test:coverage

# 运行 TypeScript 类型检查
cd web && npm run type-check

📊 测试覆盖率与规范指南

在进行代码更改后，考虑是否需要测试：

更改类型	测试建议
修复 Bug	添加回归测试以防止再次发生，确保测试在修复前会失败并且在修复后会通过
新功能	单元测试 + 如果影响多个模块则添加集成测试
重构	现有测试应通过；如果行为改变则添加测试
配置/文档	通常不需要测试
新增多语言词条	必须运行 test_frontend_locales.py / test_backend_locales.py 确保各语言 Key 结构对齐

提示: 如果你在编写后端测试，请参考 .cursor/rules/testing.mdc，优先使用项目中已经提供的 dummy_avatar、mock_llm_managers 等现成的 fixtures，避免重复 mock 或消耗真实 Token。