dekun
9.0 KiB
9.0 KiB
比特骆驼自动化对冲系统 — 更新说明
每次发版 / 合并重要改动后，在本文档顶部追加一条（日期新→旧）。
关联审计结论写在同条「审计」小节。
2026-07-27 — 交易记录：开仓/平仓时间与持仓周期
变更
- 交易记录列表与明细展示：开仓时间、平仓时间、持仓周期（上海时区）。
- 持仓周期按目标平仓计时：净盈利达标（含默认 15U）出场为准。
- 只平永续 / 期权残留：平仓时间与周期以永续平仓时刻为准，不含期权拖到到期。
- 只平永续时写入
close_at_ms；残留期权到期结算不再覆盖该策略平仓时间。
2026-07-27 — 安卓竖屏：全屏后系统锁定
变更
- 说明：安卓 Chrome 普通标签页 不允许网页直接锁方向，必须先全屏再
orientation.lock（你以前能锁的，多半是 App/WebView/已装桌面，或点过全屏）。 - 安卓首次点击 / 「点击锁定竖屏」：进入全屏并系统锁竖屏。
- 已「添加到主屏幕」的应用走 manifest
orientation: portrait，一般无需全屏。 - 补充 X5/UC 竖屏 meta；锁失败时仍强制竖屏布局。
2026-07-27 — 手机端真·竖屏（禁横屏布局）
变更
- 去掉「请竖屏使用」遮罩：那只是提示，不是锁定。
- 能锁系统方向时（常见：安卓安装到主屏幕的 PWA）调用
orientation.lock。 - 锁不住时（多数浏览器页 / iOS）：设备横放也不进入横屏 UI，界面仍按竖屏坐标系渲染。
- Manifest：
orientation改为portrait-primary。
2026-07-27 — 手机端竖屏锁定
变更
- PWA：
manifest.webmanifest的orientation改为portrait（安装到主屏幕后系统侧竖屏）。 - 浏览器：手机横屏时全屏提示「请竖屏使用」；支持时尝试
screen.orientation.lock。
2026-07-27 — 手机端期权卡 / 交易记录排版
变更
- 期权持仓卡：合约名与到期倒计时改为上下排，避免长
inst_id被挤成竖排字。 - 交易记录：列表项上下堆叠（组号/状态一行，净盈亏/平仓原因一行），明细成交行窄屏同样竖排。
2026-07-27 — 手机端监控布局
变更
- 底部导航：窄屏隐藏顶栏菜单，改用底栏「监控 / 记录 / 统计 / 设置」（含安全区）。
- 监控首页卡：一屏看状态（启动/暂停/已停）、盘口、阶段、净盈利 vs 目标、到期倒计时、最近错误。
- 操作区：启动 / 暂停 / 紧急全平触摸友好；紧急全平通栏；桌面布局不变。
2026-07-26 — 企业微信通知 + 暂停盯目标
变更
- 企业微信：独立模块
backend/app/notify/wecom.py；系统设置「运行模式」可配 Webhook / 开关 / 测试推送。 - 推送事件：开仓、平仓、策略启动、暂停、故障（同类 5 分钟去重）。Markdown + 标识
OPEN/CLOSE/START/PAUSE/FAULT。 - 标题盘口：模拟盘 →「模拟盘」；实盘 →「实盘·OKX」或「实盘·币安」。
- 暂停策略：仍执行目标平仓 + 到期平仓，不新开仓（策略说明已同步）。
2026-07-26 — 一键部署环境检测 / 卸载删目录
变更
- 一键部署 / 更新：检测 Python3+venv、Node/npm、PM2；已有则跳过，缺失才 apt/npm 安装。
- 一键卸载：备份
.env与数据库后，直接删除/opt/eth_hedge_sim（并清理历史.removed/.old残留）；不卸载系统级 Python/Node/PM2。
2026-07-26 — 自动备份 / 下载 / 上传恢复
变更
- 自动备份：默认开启，间隔 24h，保留 14 份；落盘目录优先
/root/eth_hedge_backups（可用BACKUP_DIR覆盖）。内容含hedge.db+.env。 - 系统设置 → 备份恢复：立即备份、服务器列表下载、上传 zip 恢复（确认串
RESTORE）。 - 新服务器迁移：新机部署后上传旧机备份即可覆盖库与环境变量；恢复后进程退出由 PM2 拉起。有持仓时禁止恢复。
测试
pytest：含test_backup等全量
2026-07-26 — LIVE 达标含估平仓费；手动/紧急全平进休息
变更
- LIVE 达标口径：盯盘净利继续扣预估平仓手续费（与策略说明 / SIM 一致）；实盘索引改为「含估平仓费」。
- 组间休息：手动全平成功后调用
enter_rest_after_close()；紧急全平成功路径同样进入休息（与自动全平共用）。
测试
pytest全量
2026-07-26 — LIVE 对账 / 手动开仓 UI / Token 自动换发
变更
- 开仓幂等与对账：
opening占槽；LIVE 开仓前核对交易所永续（双侧）；启动写 mismatch 日志。 - 平仓张数：OKX/币安平永续优先读交易所持仓，失败才回退本地账本。
- 杠杆：LIVE 开永续前
set_leverage（失败仅告警）。 - 自动运行禁手动开仓：
running=1时/api/sim/open-group返回 409；计划页按钮禁用。 - 手动开仓显示：策略设置「节奏」→「显示手动开仓」，默认不显示；关闭时 API 亦拒绝手动开/手动全平。紧急全平始终可用且为红色。
- 启动态：策略运行中主按钮文案为「启动中」，绿色样式。
- Token 自动换发：HMAC Bearer（非 Flask）。新增
POST /api/auth/refresh；前端登录后定时/切回前台/临近过期静默换发。默认口令未改。
审计（本包改后）
| 项 | 状态 |
|---|---|
| 交易所↔本地对账 / 开仓幂等 | 已修 |
| 平仓张数读交易所 | 已修 |
| set_leverage | 已修（失败告警） |
| 自动运行仍可手动开仓 | 已修（API + UI） |
| 手动开/全平默认露出 | 已修（默认隐藏 + 设置开关） |
| 紧急全平样式 / 启动中文案 | 已修 |
| Token 长期不轮换 | 已修（refresh + 前端自动换发） |
| 对账只查单侧漏 short | 已修（flat 时 long+short） |
| 放弃期权残留 / 模式切换仅本地 | 未做（非本包；紧急全平/人工核对） |
测试
pytest：52 passed
2026-07-26 — 审计修复包（安全 / 下单 / 平仓）
变更
- LIVE 永续合约号：开平仓统一用
load_runtime_settings()/ 组内perp_inst_id，修复 UI 切币安后仍用 envETH-USDT-SWAP的问题。 - 到期平仓：期权先走交易所真实平仓（失败且仓位已空才本地结算），并在永续失败前写入
option_closed_perp_pending。 - 成交完整性：OKX/币安仅接受完全成交；账本数量按交易所
accFillSz/executedQty回写。 ctVal：查不到合约面值时直接失败，禁止静默默认0.01。- 放弃期权路径：优先交易所卖期权；仅深虚且卖不出时才残留归档。
- LIVE 重启：启动时若为 LIVE，自动暂停策略，须人工再点启动。
- 安全：登录限流；切 LIVE 须服务端校验确认串
LIVE；生产关闭/docs；改密后抬升 token 版本作废旧票；.env写入后尽量chmod 600；CORS 改为同源优先。 - 出场：LIVE 净利加入保守平仓手续费缓冲，减少「刚达标但扣费后不够」的提前出场。
审计（本包改后复审）
| 项 | 状态 |
|---|---|
| 永续符号 env/DB 不一致 | 已修（symbols.resolve_perp_inst_id + 开平仓全路径） |
| 到期只本地结算期权 | 已修（先交易所卖；失败才本地结算） |
| 到期永续失败无 pending | 已修（统一 _mark_option_closed_perp_pending） |
| partially_filled 当完成 | 已修（OKX 仅 filled；币安仅 FILLED） |
| 放弃路径不卖期权 | 已缓解（先 close_group 双腿；失败且深虚才残留） |
| 开仓崩溃双开 | 部分：LIVE 启动强制 running=0；仍缺交易所对账 |
| ctVal 静默默认 | 已修（查不到直接报错） |
| LIVE 出场不计平仓费 | 已修（保守 est_close_fees） |
| 登录无限流 / LIVE 可 API 绕过确认 | 已修（限流 + confirm_live_phrase=LIVE） |
/docs 公开 / CORS * / mask 泄露后缀 |
已修 |
| 改密后旧 token | 已修（AUTH_TOKEN_VERSION） |
| 默认口令 / 公网 TLS | 未改默认口令（部署须改 .env）；TLS 仍靠反代 |
| 杠杆 set_leverage | 未做 |
| 平仓张数读交易所持仓 | 未做 |
残留风险（下次优先）
- 启动时交易所↔本地仓位对账与开仓幂等键
- 平仓前查询交易所实际持仓张数
- 开仓前
set_leverage - 可选：拒绝默认
AUTH_*启动（硬开关）
测试
pytest：46 passed（含test_symbols、脱敏用例更新）