欢迎使用 KBot PRO！它更像一个“量化交易工位”：分区管理 + 风控中枢 + 回测验证 + 扫描/候选池 + 轮次/报表复盘。下面按“从 0 到可运行”的顺序带你快速上手 🙂

🧭 0. 先理解分区（非常重要）

• 自选交易区 (Manual)：你手动挑币、手动调参，适合主力策略与重点币种。
• 智能托管区 (Auto)：适合用“预算/风控”自动管理一批币，减少手工操作。
• 双向对冲区 (Dual)：强制对冲模式展示（多空并存），适合震荡或套保思路。
• 空投刷量区 (Alpha)：刷量/空投专用指标与状态展示，与常规马丁侧重点不同。
• 全球资产区 (Global)：聚合展示与全局风险判断的入口（以权益与暴露为核心）。

✅ 1. 快速开始（5 步跑起来）

1. 进入 系统设置：配置交易所 API（Gate.io / Binance 等）与市场类型（现货/合约）。
2. 进入 系统设置 → 风控/资金规划：先设置 每币预算、最大同时运行交易对、最大总暴露比例。
3. 回到 控制台：选择当前分区 → 点击 + 添加交易对（或从市场扫描一键加入候选池）。
4. 打开单币 策略设置：选择模板（保守/稳健/激进）后再微调（首单、补单、止盈、止损、对冲等）。
5. 确认无误后点击顶部 ▶ 启动系统（建议先在模拟/小资金环境观察 1-2 天）。

📊 2. 控制台（你每天盯的核心屏）

• 状态徽章：展示运行/待机与实例信息，鼠标悬停可看到设置摘要。
• 全局控制：一键启动/停止 + 快速添加交易对 + 打开策略设置。
• 安全条 (Safety Bar)：聚合风控状态：Risk Off、自动风控阈值、运行币数、总暴露/权益比、最大回撤等。
• 交易卡片：每币独立状态（价格、仓位、ROI、补单次数、对冲模式、预算/分区），停机时也会尽量展示“配置态”。
• 系统日志：展示最近 50 条关键事件（启动、扫描、风控触发、错误等）。

🧯 3. 风控中枢（真正决定你活多久）

• Global Risk Off：全局防守开关，打开后应禁止新增风险敞口，只做“收缩/止损/清仓”动作。
• 自动 Risk Off：按回撤阈值自动进入防守模式，适合“防黑天鹅”。
• 最大运行交易对：控制并发，避免一个行情把你拖进“多点爆雷”。
• 最大总暴露比例：用“总持仓成本 / 总权益”约束杠杆与仓位膨胀。
• 每币预算：资金规划基石，配合“按预算自动限制最大币数/仓位”更稳定。

🔎 4. 市场扫描 + 候选池（让系统自己找机会）

• 市场扫描：用于发现可交易标的（波动率、涨跌幅等），避免“盯盘找币”的体力活。
• 候选池：扫描结果进入候选池，系统可按规则择机激活；预算不足时会提示无法扩容。
• 建议：候选池用于“广撒网”，Manual 用于“精打磨”。两者分工清晰会很舒服。

🧾 5. 交易轮次 / 报表 / 收益分析（复盘就是第二条命）

• 交易轮次：以“开仓→完全平仓”为一轮，适合评估策略在不同波动区间的表现。
• 交易报表：把执行记录从“感觉”变成“事实”，重点看手续费侵蚀与极端轮次。
• 收益分析：支持 AI 复盘摘要（当你配置了 AI Provider 时），用于快速发现风险形态。

🧪 6. 回测系统（上线前必做）

• 先回测再实盘：先锁定交易对 + 周期 + 资金量，再套用三档模板对比稳定性。
• 关注极端值：最大回撤、最长套牢时间、手续费占比，比“总收益”更关键。
• 对冲模式：震荡市可能更平滑，但要注意手续费与资金占用。

🧠 7. 量化大师给你的运行建议

• 先管风险再谈收益：把最大并发、总暴露、自动 Risk Off 先设好，再去优化策略参数。
• 不要全市场一起开：候选池再大也要让“可运行币数”受预算约束，宁可少而稳。
• 只改一件事：每次只调一个关键参数（比如补单倍数/止盈/止损），跑 1-2 天再看轮次数据。
• 把日志当仪表盘：出现“预算受限/权限不足/下单失败”先解决基础设施问题，别硬扛。

🧩 8. 常见问题（先看这里省时间）

• 页面提示预算受限：通常是权益为 0 或每币预算过大，检查交易所 API 权限与账户余额读取。
• 看起来“很卡”：优先减少运行币数，控制并发；系统已做轮询与行情抓取降载，但过多币种仍会压测交易所限频。
• 设置保存后不生效：保存后刷新页面；若是 Docker 部署，确认 settings/users 挂载目录可写且不会被外部任务覆盖。
• 401 未登录：重新登录即可；若频繁出现，检查浏览器是否阻止本地存储或跨域。