测试和质量检查

语言：简体中文 · English

本页说明 Alpha 模块自带测试脚本的入口和检查范围。它位于 quant-platform 仓库中，根目录统一测试入口见全仓测试说明。

安装开发依赖

uv sync --locked --all-groups

统一入口

scripts/alpha-research/dev/run_tests.sh <mode> [args...]

模式	实际范围
all	完整 pytest 测试集
fast	all 的兼容别名
unit	all 的兼容别名
coverage	完整测试集和 alpha_research Python 源码覆盖率报告
lint	Ruff 代码检查
format	Ruff 格式检查
format-all	format 的兼容别名
typecheck	ty 配置范围
typecheck-release	typecheck 的兼容别名
maintainability	维护性指标和当前预算

fast 和 unit 都会运行完整测试集。

常用命令

scripts/alpha-research/dev/run_tests.sh all
scripts/alpha-research/dev/run_tests.sh coverage
scripts/alpha-research/dev/run_tests.sh lint
scripts/alpha-research/dev/run_tests.sh format
scripts/alpha-research/dev/run_tests.sh typecheck
scripts/alpha-research/dev/run_tests.sh typecheck-release
scripts/alpha-research/dev/run_tests.sh maintainability

覆盖率使用 pytest-cov，目前不设最低覆盖率门槛。Python 覆盖率报告不包含 Rust 扩展。

依赖安全检查

根目录公开 CI 使用 pip-audit 检查锁定依赖。本地可按全仓测试说明运行同一检查。

定点测试示例：

uv run --extra dev python -m pytest tests/alpha/test_signal_artifact.py -q
uv run --extra dev python -m pytest tests/alpha/test_cpcv.py -q

研究后端测试范围

tests/alpha/test_research_backends.py 当前覆盖框架中立接口、NativeDatasetBackend、 NativeTrainerBackend、NullExperimentRecorder，以及产物元数据不携带运行时模型对象的 约束。

标准 dev 依赖没有安装 Qlib。Qlib 后端通过 qlib extra 安装后可运行 QlibTrainerBackend 的确定性训练与预测测试（见 tests/alpha/test_backends_qlib.py）。 接入条件和验证要求见 研究后端与 Qlib 状态。

推送前检查

在 research-workspace 受管检出中，顶层共享 pre-push 会按照工作区清单运行本仓库的导入检查、Ruff、格式检查、ty 和完整测试集。

单独克隆本仓库时不会继承共享钩子。推送前应手动运行上方列出的 lint、format、typecheck、all 和 maintainability。

typecheck-release 与 typecheck 使用相同的 ty 配置。两个入口都会加入五个源码根目录，避免内部相对导入因项目布局产生误报。[tool.ty.src] 已合并原发布检查范围，迁移后没有缩小类型检查覆盖。

测试重点

当前测试应重点保护：

• 特征数据集和特征证据
• 模型训练与评估
• walk-forward、CPCV 和 PBO
• 信号产物字段与元数据
• 模型专用目标持仓规则
• 包导入和跨仓库依赖隔离
• 维护性指标

修复缺陷时先添加复现测试。新增能力至少覆盖正常路径和一个异常或边界路径。

自动化状态

GitHub Actions 的根目录公开 CI 在 PR 和主分支推送时运行全仓 Ruff、格式、严格 ty、pytest 和依赖漏洞检查。本地完整质量门禁与公开 CI 使用本地构造数据执行离线测试。本页脚本提供统一入口，便于单独运行覆盖率、类型和维护性检查。标准 dev 依赖不包含 Qlib，可选 Qlib 后端需要安装 qlib extra 后单独验证。真实数据平台的分钟源目录测试通过 market-data extra 单独运行。