# scripts

数据同步 / 运维 / 自检脚本。

## 自检脚本（改完对应部分就跑一遍）

| 脚本 | 检查什么 | 用法 |
|------|----------|------|
| `verify_strategy_workspace.py` | 策略库 / 回测 / 归档链路的端到端契约（含按 kind 逐类验证归档页） | `python3 scripts/verify_strategy_workspace.py`（`--skip-job` 跳过真实回测） |
| `verify_backtest_page_contract.py` | 回测页与后端字段契约（净值点数、个股曲线数、收益口径） | `python3 scripts/verify_backtest_page_contract.py` |
| `verify_ui_alignment.py` | **UI 对齐与控件一致性**：同排控件等高、尺寸归一、点击目标、标签与无障碍名、圆角/字号一致、无横向溢出、提示不裁切 | `python3 scripts/verify_ui_alignment.py`（`--dump` 打印几何明细，`--width 375` 只测小屏） |
| `qlib_verify.py` | pyqlib 安装与数据落盘基线 | `cd backend && uv run python ../scripts/qlib_verify.py` |

`verify_ui_alignment.py` 用**系统 Chrome + 原生 CDP**（仅标准库实现，不依赖 playwright），
独占随机端口与临时 profile，不会干扰你正在用的浏览器。

## 数据 / 运维

| 脚本 | 用途 |
|------|------|
| `run_dividend_case.py` | 复现高股息案例（全市场股息率 TopN、每 m 月择股） |
| `migrate_sqlite_to_mysql.py` | 历史 SQLite 数据迁移到本机 MariaDB |
| `grant_local_mysql_user.sql` / `mysql_recover_and_grants.sh` | 本机 MariaDB 账号与权限 |
| `dev.sh` | 一键起后端 + 前端（开发用） |