死球做市系统 · 安装说明(5 分钟上手)
==========================================

【这是什么】
只做 Polymarket 开球前(死球)体育市场的做市机器人:
- 农民模式:挂单在流动性奖励带外缘,目标吃奖池、尽量不成交
- 默认"影子模式":连真实行情,但挂单全是虚拟的 —— 不碰真钱、不需要账户,零风险

【安装步骤】
1. 安装 Python 3.10 以上版本(python.org 下载,安装时勾选 "Add to PATH")
2. 解压本压缩包到任意文件夹
3. 在文件夹里打开命令行(地址栏输入 cmd 回车),执行:
       pip install -r requirements.txt
4. 双击「启动面板.bat」→ 浏览器自动打开 http://127.0.0.1:8788
5. 点「▶ 启动」开始跑影子盘。所有参数在面板上可调,保存即热生效

【必要条件】
- 网络需能访问 polymarket.com 的接口(国内一般需要相应网络环境)
- 电脑保持开机,机器人才持续运行

【安全须知】
- 默认影子模式绝不下真单。真实交易(live 模式)需要你自己的钱包私钥
  + 环境变量双重确认才能开启,建议先跑够两周影子盘并看懂数据再考虑
- config.yaml 内所有参数都有中文注释;新手先别动,默认值是回测调优过的
- 本系统为研究性质,不构成投资建议;使用产生的一切风险自负

【文件速览】
main.py 主循环 / panel.py 网页面板 / scanner.py 选场 / quoting.py 报价
risk.py 风控熔断 / executor.py 影子+实盘执行 / ledger.py 毒流量统计
backtest*.py + optimize.py 回测与寻优工具 / config.yaml 全部旋钮

研究背景与数据结论:https://deadball-lab.pages.dev
