安装与首次启动
从首页下载最新 Windows 安装包（约 100 MB），双击运行。首次启动时 Windows SmartScreen 可能拦截一次，点 "更多信息" → "仍要运行" 即可。后续自动更新不会再触发拦截。
数据存储路径：%APPDATA%/quant-bull-v4/quant-bull.db。所有数据在本机 SQLite，从不上传。
配置交易所 API
左栏进入 API 管理，添加交易所。当前支持 OKX 和 Binance：
API Key: 你的只读 + 现货/合约交易权限的 Key
Secret: 对应的 Secret
Passphrase: 仅 OKX 需要API Key 入库前会经 AES-GCM + PBKDF2 加密，明文不会写入任何日志。建议在交易所端只勾选 读取 + 交易，不要开启提币权限。
填写激活码
购买后激活码会自动发到邮箱。打开 Settings → 激活，粘贴激活码并点击"激活"。激活码绑定当前设备，每年 2 次免费迁移。
智能网格策略
智能网格适合震荡市场，自动按比例分批建仓，触发止盈后整体平仓重启。这是 智能延长加仓间距 功能的主战场。
核心参数
orderCount— 总单数（建议 5–10）firstOrderAmount— 首单金额（USDT）bettingStrategy— 加仓倍率：equal / double / triple / fibonacciintervalType— 档间距类型：百分比 / 固定金额expandRatio— 智能延长倍率（默认 1.18）：每加仓一次，下一档间距按此倍率放大overallProfit— 整体止盈率（推荐 1–3%）
使用建议
新手推荐 5 单 + double 加仓 + 2% 基础间距 + expandRatio 1.18 + 1.5% 整体止盈 起步。先在回测里跑一段历史数据验证参数。
合约区间网格
在你判断的震荡区间内分档加仓，整体止盈/止损订单挂在交易所侧（reduceOnly stopMarket）。即使 app 崩溃或断电，仓位也会按预设平仓。
风险与熔断
合约交易高风险提示：永续合约具有杠杆特性，市场剧烈波动时仓位可能在极短时间内被强制平仓，导致全部保证金损失。请仅使用可承受全部损失的资金，并在使用前完整阅读 风险声明。
三道护栏（工程化设计）：
- FuturesReconciler（15s） — 对账幽儿仓位（交易所 0 仓 + 本地有），自动收尾
- AvgEntryCorrector（60s） — 均价漂移 > 0.1% 自动校正 + 重挂止损
- PairHealthMonitor（15s） — 张数 / 均价 / algo 单数偏差超 2 分钟自动暂停策略并通知
自动更新
软件内置 electron-updater，新版本发布后会自动检测：
- Settings → 软件更新 → 点击"检查更新"
- 检测到新版本后点"下载更新"
- 下载完成后点"重启安装"
更新过程不会丢失任何数据；策略配置、订单历史、激活码全部保留。
文档持续完善中。有问题或想看的内容，加微信群或发邮件给我们。