用途：面向 PolyFlup 项目的日常运维、环境配置与部署，提供后端、前端、容器及数据同步的操作命令。
主要能力与用法：Python 后端使用 uv run polyflup.py 运行机器人，uv run check_db.py 检查数据库，uv run migrate_db.py 执行迁移，依赖安装用 uv pip install -r requirements.txt。Svelte UI 进入 ui 目录后 npm install，开发用 npm run dev，构建用 npm run build，生产用 npm start。Docker 部署用 docker compose up -d --build，查看日志用 docker logs -f polyflup-bot，停止用 docker compose down。
环境变量：PROXY_PK 为必填私钥，需以 0x 开头；BET_PERCENT 为仓位大小，默认 5.0；MIN_EDGE 为最低置信度，默认 0.565；ENABLE_STOP_LOSS、ENABLE_TAKE_PROFIT、ENABLE_REVERSAL 取 YES/NO；MARKETS 为逗号分隔的交易对，如 BTC,ETH。
日志与数据库：主日志 logs/trades_2025.log 记录全部交易与监控；窗口日志为 logs/window_YYYY-MM-DD_HH-mm.log，对应 15 分钟窗口；错误日志 logs/errors.log 保存错误堆栈。可手动运行迁移并用 check_migration_status.py 查看迁移状态。生产同步工具包括 sync_db（通过 SSH 下载生产 trades.db）和 sync_logs（更新本地日志）。
限制与排障：数据库被锁时需确保只运行一个机器人实例，可检查残留进程 ps aux | grep polyflup，数据库采用 WAL 模式提升并发。XRP 市场存在已知可靠性问题，已配置 15 分钟宽限期与增强余额校验重试逻辑，可在 .env 中设置 ENABLE_ENHANCED_BALANCE_VALIDATION=YES。机器人启动时会与交易所同步持仓，结合 CLOB 订单簿与 Data API 校验并自动修复数量偏差。