Local tutorial
只读探针到快照重放
本教程描述当前已经实现的 Python v0.1 路径:用于来源诊断、保存公开响应、生成 event.v1 快照、检查完整性和重放标准化结果;它不是历史策略回测器。
先确认边界:不需要交易账户、钱包或私钥;不签名、不下单;本地
data/、state/、reports/ 不发布到 Pages。1. 准备环境
python3.12 --version
uv sync --locked
uv run --locked trading-lab --help
2. 初始化本地运行目录
uv run --locked trading-lab init命令会在本地运行根目录创建 data/、state/ 和 reports/,以及 state/catalog.sqlite。这些是本地运行产物,不是本网站的内容。
3. 发出有界只读探针
uv run --locked trading-lab probe --source all
uv run --locked trading-lab status也可以选择 hyperliquid、geckoterminal 或 pump。失败来源会留在 JSON 的 issues 中;一次 HTTP 200 不等于连续覆盖或历史可用性证明。
4. 标准化、校验与重放
uv run --locked trading-lab normalize
uv run --locked trading-lab verify
uv run --locked trading-lab replay <dataset-id>
uv run --locked trading-lab report离线重放检查的是快照完整性和确定性,不把采集时间倒填成历史策略可见时间,也不把快照冒充连续历史数据。
5. 离线测试
uv run --locked pytest -q测试使用合成 fixture,不访问网络;测试通过不等于 Rust 模拟器、SIM-001 或云端回测已经验收。