Gold_Morgan Quant V3 用户操作手册

依次检查：

1. TWS 是否已经启动并登录。
2. TWS：Global Configuration → API → Settings，确认 Socket Clients 已允许。
3. Quant HOST：同一台电脑通常使用 127.0.0.1。
4. PORT 必须与 TWS Socket Port 一致。常见：Live 7496，Paper 7497；如自行修改过，以 TWS 实际设置为准。
5. 如果同一个 TWS 已连接其他 API 程序，检查 Client ID 是否冲突。

1. 先看 TWS 本身是否有该股票实时价格；如果 TWS 本身就是延迟或无行情，Quant 无法生成实时数据。
2. 确认已经订阅对应的 IBKR Market Data。
3. 新加入 Quant 的股票需要时间加载 Historical Bars、Realtime Data、EMA 和 Volume Data，短暂显示 N/A 属正常现象。

1. 等待历史 K 线加载完整。
2. 确认 TWS Market Data 正常。
3. 不要频繁删除并重新添加同一股票。

EMA 需要足够数量的历史 Bar 才能计算。

先看底部 ORDERS，不要连续重复点击。

1. TRADING 是否为 READY。
2. TWS 是否 Connected。
3. 当前交易时段是否允许该订单。
4. Limit Price 是否距离市场价格过远。
5. 是否存在 Broker Reject。
6. System Messages 是否有错误。

检查当前是否处于 RTH（09:30–16:00 NY）。盘前 / 盘后部分功能会使用 Protected Limit，而不是无保护的 Market Order。

如果 Pro Trade 显示 ORDERS BLOCKED，说明当前模块禁止下单。

先确认当前是 RTH 还是 Extended Hours。

• 正常盘中：Quant 可以使用真正的 STP。
• 盘前 / 盘后：可能显示 LOCAL STP，由 Quant 本地监控价格，达到 Trigger 后再提交保护 Limit Order。

最终以 IBKR Broker Position 为实际账户仓位。

1. 检查 TWS Portfolio。
2. 检查 Quant POSITIONS。
3. 检查是否从 TWS、手机、Client Portal 或其他 API 程序手工交易过。
4. 如两边不一致，不要继续盲目下单，先恢复 Broker Position Truth。

重点看 Status。通常真正需要处理的是 Submitted、PreSubmitted、PendingSubmit、ARMED / Local Stop。

Filled、Cancelled、Inactive 不属于当前 Working Order。

1. TWS 是否 Connected。
2. Broker Position 是否已经同步。
3. 是否存在 Position Freshness 问题。
4. 当前交易时段是否允许退出。
5. 是否已经存在 Working Sell Order。

1. 主界面 SCAN 是否勾选。
2. Scan Settings 是否过于严格：Minimum / Maximum Price、Min Gain %、Min USD Volume、USD Volume / Min。
3. 当前市场是否活跃。
4. IBKR Scanner / Market Data 是否正常。

扫描条件很严格时，0 个结果并不代表 Scanner 故障。

1. 股票是否已经进入本次 Quant Runtime。
2. 是否已经收到实时价格。
3. 是否已经形成有效 1m Bar。

WAITING FOR LIVE 1m BARS 表示正在等待足够的实时 1 分钟数据，不一定是错误。

打开 Global Settings → License，检查 LICENSED 和 Last Online Check。

1. 确认电脑联网。
2. 点击 VERIFY ONLINE。
3. 点击 REFRESH LOCAL。

仍失败时，请提供 Machine Code、License 页面截图和错误信息。

先检查当前 License 是否拥有对应 Entitlement，例如 Linked Account、Pro Trader、Scanner、AUTO Strategy、Telegram、AI。

按钮不可用不一定是软件故障，也可能是当前会员级别没有该模块权限。

1. Linked License 是否有效。
2. ROLE 是否为 LINKED。
3. Invite Code 是否正确。
4. Invite Code 是否已被其他账户使用。
5. Primary 是否在线。
6. Pusher Network 是否 CONNECTED。

成功绑定后，STATUS 不应继续显示 UNBOUND。

Primary 端：

1. SEND LINKED ORDERS 是否开启。
2. Pusher NETWORK 是否 CONNECTED。
3. Primary 是否真正产生符合条件的 QuantManual 成交。

Linked 端：

4. Binding 是否 ACTIVE。
5. Linked License 是否有效。
6. Network 是否 Connected。
7. 消息是否超过 MAX DELAY SEC。
8. 当前交易时段是否允许 Linked 执行。

1. ENABLE TELEGRAM 是否开启。
2. Bot Token 是否正确，TEST BOT 是否成功。
3. Bot 是否已加入目标群，Group 是否 Enabled。
4. Message Routing 是否设置，对应 Category 是否 Enabled。
5. 打开 HEALTH / DIAG，检查是否 HEALTHY，以及 Failed 是否为 0。

1. S1 Enabled。
2. Watch 已启动。
3. Market Data 有效。
4. Price / EMA20 / EMA60 满足条件。
5. Volume 条件满足。
6. Previous 1m Turnover 满足。
7. From LOD % 满足。
8. Min Score 满足。
9. 未超过 New Position Cutoff。
10. 未达到 Max Open Positions。
11. Risk 为 PASS。

最终以 Watch 表中的 Entry / Score / Final / Risk 为准。

WATCH ≠ AUTO。Watch 可以正常计算信号，但 AUTO OFF 或 Broker Execution Locked 时不会自动向 IBKR 下单。

检查 ENABLE AUTO 以及顶部 AUTO / Broker Execution 状态。

先看 Valid。如果有效成分股没有达到 Minimum Valid Components，S2 会阻止交易。

再检查每只成分股是否有 Trade Price、EMA Fast、EMA Slow 和足够新鲜的 Market Data。

INVALID 或 Trade price unavailable 表示该股票当前不能参与 Breadth Vote。

1. Instance Enabled。
2. Valid 数量满足。
3. Bull / Bear Threshold 满足。
4. Minimum Breadth Spread 满足。
5. Confirmation Cycles 已完成。
6. Direction 已真正 Confirmed。
7. 当前时间位于允许 Entry 的时段。
8. S2 AUTO 为 ON。
9. 当前 Position 满足 FLAT FIRST。
10. Risk / Broker Truth 正常。

这是正常设计。Strategy 2 使用 FLAT FIRST：

持有 SOXL → Bear Signal Confirmed → 先 SELL SOXL → Broker 确认 FLAT → 才允许 BUY SOXS。

反方向同理，不会直接同时持有两个相反方向的 S2 仓位。

先看顶部是否显示 ORDERS BLOCKED。

1. LAST / BID / ASK 是否有效。
2. AGE 是否正常。
3. TWS 是否 Connected。
4. 当前 Market Session 是否允许。
5. QTY 是否正确。
6. Broker Position 是否正常。

不要在 Bid / Ask 为 “-” 时使用 BUY ASK、BUY BID、SELL ASK、SELL BID。

Reprice 只对当前存在的有效 Working Order 有意义。如果订单已经 Filled 或 Cancelled，就没有订单可以 Reprice。

如果系统认为仍存在 AUTO-owned Position 或未结束的 Auto Lifecycle，部分 Strategy 设置会受到保护。

先确认真实账户：

• Broker Position = 0
• No Working Orders

如果 Broker 已经完全 Flat、没有有效订单，但 Quant 仍显示旧 AUTO 状态，则属于状态恢复 / 清理问题，不应通过重复下单解决。

不要继续自动交易。先确认 Broker Position、Working Orders、TWS Connection、Market Data 和当前策略仓位。

1. 保持 TWS 正常。
2. 重新连接 Quant。
3. 等待 Positions 恢复。
4. 等待 Orders 恢复。
5. 等待 Market Data 恢复。
6. 确认 Quant Healthy。
7. 最后再开启 Watch / AUTO。

不要一连接成功就立即开启自动交易。

先不要手工删除程序目录，重新启动 Quant。

App-only 自动升级会执行 Version Check → Download → Size / SHA256 Check → Replace → Restart → Health Check → 必要时 Rollback。

用户数据、SQLite、License、设置等不属于 App-only 自动升级替换范围。

1. 确认 License / Account 状态。
2. 确认下载链接是否仍在有效期。
3. 确认 Stable / windows-x64 Release 已发布。
4. 如果链接生成时间较久，重新登录 Account Portal 后再次点击 Download 获取新链接。