# 脚本目录

本目录当前主要放两类脚本：
- 自动化测试编排脚本
- 本地数据集构建/分析脚本

旧的 `scripts/test_api_sync.py` 与 `API_SYNC_GUIDE.md` 已不存在，不再作为当前入口。

## 当前常用入口

### 自动化测试
- `scripts/auto_test_init.py`
	- 初始化 auto-test 运行环境，负责清理状态、恢复测试数据、拉起后端。
- `scripts/auto_test_clear.py`
	- 清理 auto-test 运行环境。
- `scripts/run_auto_test.py`
	- 运行指定 domain 的多轮自动回归并输出报告。
- `scripts/run_auto_test_all_domains.py`
	- 聚合运行多个 domain 的自动回归。
- `scripts/run_large_scale_auto_test.py`
	- 大规模自动回归入口。

### 数据集与分析
- `scripts/build_filtered_datasource_for_projects.py`
	- 从完整 datasource 中抽取指定项目，生成可复现的精简 JSONL 数据集。
- `scripts/analyze_state_signatures.py`
	- 分析状态签名与差异。

## 推荐命令

这些命令目前可直接使用：

```bash
python scripts/build_filtered_datasource_for_projects.py --help
python scripts/run_auto_test.py --help
```

## 进一步说明

- 自动化测试总览：`docs/testing_guide.md`
- 大规模自动回归方法：`docs/auto_test_spec/agent_auto_test_method.md`
