冒险岛VIP Copy使用说明

1. 软件做什么

软件直接连接 Tradovate：由它打开一个独立的浏览器窗口，你在 Tradovate 自己的页面登录，之后软件用已认证的接口读取账户、订单和持仓，并把主账户的新订单复制到跟随账户。

2. 安装与首次启动

1. 把 PropFirmVIP-Tradovate.exe 放到一个固定文件夹。单文件 EXE 已包含运行时，无需另装 .NET 或 Node。
2. 首次运行会在 EXE 旁边创建 data 文件夹，保存连接、跟单组、日志和加密后的登录令牌。升级时把新 EXE 放回同一文件夹即可保留数据；移动 EXE 会改变默认数据位置。
3. 确认电脑装有 Microsoft Edge 或 Google Chrome，登录窗口由其中之一打开。
4. 启动后先出现「使用前核对」提醒，读完后点「关闭提醒」。勾选「下次启动不再显示」可以关闭，设置页能重新打开。

3. 第一步：连接 Tradovate

侧边栏按使用顺序分为「准备 → 配置 → 运行 → 扩展」四组。没有连接时软件会直接打开「连接」页。

1. 点「添加连接」，选择环境 Demo 或 Live。名称可以留空。
2. 点「网页登录」。软件会打开一个独立的浏览器窗口（临时配置，不加载扩展），在 Tradovate 自己的页面完成登录。
3. 登录成功后浏览器窗口自动关闭，连接状态变为「已同步」，该登录下的全部账户出现在「账户」页。
4. 「取消登录 / 退出」会清除本机保存的令牌；「重命名」和删除只影响本地记录。删除连接前须先停止相关跟单组。

4. 第二步：核对账户与资金

「账户」页列出每个账户的同步状态、账户净值、浮盈浮亏、今日盈亏、现金余额、保证金和日盈亏上限。未同步的账户默认折叠，点工具栏的「展开未同步账户」查看。

• 刷新持仓：立即重新读取持仓与订单。
• 设置起始余额：「总盈亏」= 当前现金 − 起始余额，起始余额在这里填写。
• 日盈亏上限：为单个账户设置日盈利目标和/或日亏损上限。每个券商交易日首次触及时，软件撤销该账户全部活动订单并市价平仓，然后锁定该账户当日不再开新仓（减仓和撤单仍允许）；也可选「仅提醒」模式。实盘账户保存规则时须输入完整账户名。

5. 第三步：新建跟单组

1. 打开「跟单组」页，点右上角「新建跟单组」，或按 Ctrl+N。
2. 填写组名，选择主账户。「只复制主账户」默认开启：只有主账户的新订单会被复制。
3. 点「添加跟随账户」，为每个跟随账户设置倍数并勾选「参与」。倍数 1 表示与主账户同量；0.5、2 等按规则取整。
4. 勾选「高级设置」可修改复制方式（挂单镜像 / 成交跟随）、合约映射（同合约 / E-mini↔Micro）和该组的单笔上限。
5. 点「保存跟单组」。新建的组处于停止状态，不会自动启动。

6. 跟单规则与对冲拦截

「跟单规则」页签按组保存，修改即生效于下一次启动。

7. 第四步：实盘启动与核对

1. 在跟单组页该组主账户行点「操作」→「实盘启动」，在对话框中输入完整组名确认。启动后状态行显示红点「实盘 · 运行中」，顶部状态条显示「跟单运行 N/N · 实盘」。
2. 先用小手数核对：在主账户下 1 手小合约（例如 1 手 MNQ），然后打开「订单对照」核对每一笔副本的状态、价格、数量和持仓是否符合预期。
3. 确认无误后再按正常数量交易；需要调整倍数或规则时先「停止」，修改后重新启动。用「操作 → 账户身份核对」可确认各跟随账户与券商一致。
4. 需要停止时点「停止」，或在任何页面按 Ctrl+Shift+X「全部停止」（对话框打开时同样有效）。

8. 总览与订单对照

「总览」页的五个指标卡可以点击跳转：连接、运行中的组、订单问题（未跟随或不一致）、持仓差异（实际与目标）、反向持仓（与主账户相反）。「需要处理」列出断线、反向持仓、被拒请求和计划事件；「最近活动」是日志的最新几条。

• 「跟单差异（不暂停）」日志：主账户有未复制的订单、持仓不一致或跟随账户存在外部订单时，每次运行只记一条，跟单不会因此停止。
• 「结果未知」的请求保持未知直到券商回报识别它；软件不会重发，也不阻止之后的请求。请到平台核对。
• 断开连接后表格仍可浏览，但标为缓存数据，操作按钮会被禁用。

9. 手动下单与全平

「手动下单」页按跟单组授权：先选择组，点「启用面板」并输入完整组名。面板支持买卖、数量、市价 / 限价 / 止损 / 追踪，以及对已有订单的改单与撤单。

• 全平当前组（跟单组页「操作」中）：停止新入场、撤掉活动订单、市价平掉主账户和已启用跟随账户的持仓并核实结果。超时或未知结果不会自动重试。
• 修改保护单（止损 / 止盈）需要额外确认，除非在跟单规则中关闭。
• 每个账户仍受所属组的单笔上限、身份核对和对冲拦截约束。

10. 定时计划与新闻窗口

「定时计划」「新闻日历」「计划记录」是跟单组页的页签。计划规则在组停止时保存，然后为本次运行单独「授权本次运行」；软件重启后授权失效，需要重新授权。

• 每日计划：到点后给出 30 秒可取消的倒计时，然后执行该组全平。错过的时间只记录，不补发。
• 新闻窗口：使用 Forex Factory 公共周历，只筛选高影响 USD 的 FOMC / 利率决议、非农、失业率和 CPI。窗口内拒绝增加风险的请求，保留撤单和已核实的减仓。
• 新闻前全平：可选，在窗口前一分钟发起，同样有 30 秒倒计时。关闭时仅提醒和拦截。
• 空响应、格式异常或过期的日历资料不会被当作「无事件」；停止计划不会关闭已保存的新闻窗口拦截。

11. Webhook 信号

Webhook 是独立的认证信号入口，默认关闭，只接收 POST /webhook 的 JSON。它不暴露任何桌面管理指令。

1. 点「配置账户、比例与端口」：从已发现账户中多选投递账户，为每个账户填写手数比例（0.01–100），设置监听地址和端口（默认 http://127.0.0.1:8080/webhook）。只能选择已属于某个跟单组的账户。
2. 点「生成 / 更换密钥」，把密钥填入信号来源（例如 TradingView 警报）的 token 字段或 Bearer 请求头。
3. 点「启用监听」，输入每个涉及跟单组的完整组名；先用小比例确认投递记录正确。

{"token":"DEDICATED_WEBHOOK_SECRET","id":"UNIQUE_SIGNAL_ID","timestamp":"CURRENT_ISO_8601_TIME",
 "action":"buy","symbol":"ESZ2026","quantity":1,"type":"Market"}

• 一条信号扇出到全部已选账户，每个账户数量 = 四舍五入(quantity × 比例)，取整为 0 的账户跳过并记录。
• command 可为 place（默认）、modify、cancel；改单和撤单须提供 orderId。可选 account（如 demo:12345）只投递到该账户。
• 时间最多落后 5 分钟或超前 30 秒；相同 id 的重试不会再次下单。合约必须带具体到期月份。
• 本地监听是 HTTP；公网使用需自行配置 HTTPS 转发。软件不创建隧道、不修改防火墙。不要把 Tradovate 密码或访问令牌放进 Webhook 消息。

12. Pine 策略

「Pine 策略」页在软件内直接运行 Pine Script 的 strategy() 脚本，不经过 TradingView 警报。

1. 点「新建策略」，粘贴或从文件载入脚本，填写具体到期合约（如 ESZ2026）、K 线周期、下单账户与手数比例、可选参数覆盖（每行 名称=值）和预热 K 线数。
2. 点「检查脚本与参数」确认解析通过并核对参数列表。
3. 点「启动策略」并输入涉及跟单组的完整组名。页签「模拟订单与成交」「账户镜像」「差异」「运行记录」分别显示模拟器意图、真实订单、两者差异和事件。

• K 线来自第一个已选账户登录的 Tradovate 行情流，账户须有该合约的 API 行情权限。历史 K 线只用于预热指标。
• 「挂单等待触发」：入场单连同止盈止损作为券商端括号单发出；「触发后市价进场 + OCO」：模拟成交时按市价进场并附带括号单。
• 券商拒绝或结果未知、行情断开、脚本错误、跟单组变化都会停止运行且不重发；手动停止会撤销本次运行挂着的入场单。
• 支持 v4–v6 语法与常用 ta.*、math.*、str.*、strategy.*；不支持 request.*、追踪止损出场、按权益百分比的数量和库。

13. 活动日志与诊断导出

• 「操作日志」按时间列出信息、警告和错误；「跟单映射」显示主单与各副本的对应关系。
• 「导出完整脱敏日志」生成可供反馈的文件：账户名称和编号、连接 / 组名、本机路径、凭据和余额会被替换或删除。公开前仍请自行检查。

14. 设置与更新

• 语言：跟随系统 / 中文 / English，切换后界面立即重建。
• 关于与更新：「检查更新」只在点击时读取公开更新仓库的 updates.json，发现新版本后提供「前往下载」和「更新日志」按钮；软件不会自动下载、安装或重启。

15. 安全规则速览

16. 快捷键

17. 常见问题

登录窗口打不开或页面加载失败

确认已安装 Edge 或 Chrome。软件会报告具体的加载错误；可用环境变量 BT_LOGIN_BROWSER 指定其他 Chromium 浏览器。登录窗口使用临时配置，成功、失败或取消后都会删除。

连接显示「已同步」但账户页没有某个账户

未同步的账户默认折叠，点「展开未同步账户」。Demo 和 Live 是两个独立连接，请确认登录的环境。

主账户下单了，跟随账户没有副本

按顺序检查：组是否处于运行中；该跟随账户是否勾选「参与」；订单是否超过单笔上限（日志会写「超过单笔上限，未发送」）；是否被对冲拦截或新闻窗口拒绝；订单是否在启动之前就已存在（启动前的订单不会补发）。

「结果未知」怎么处理

到 Tradovate 平台核对该订单是否存在。软件不会重发，之后的券商回报会自动把它识别为已成交、已拒绝或已撤销。

检查更新提示「没有更高的正式版本号」

更新源有几分钟的缓存，新版本发布后稍等再点一次。运行中的版本显示在侧边栏底部和「关于与更新」页签。

浮盈浮亏显示「—」

说明该账户的行情不可用：无该合约的行情权限、行情中断或每点价值无法核实。此时今日盈亏退回券商 30 秒快照，资金列会说明原因。

18. 免责声明