自动驾驶接入

先拿齐老虎的三样东西

在老虎开放平台（quant.itigerup.com）注册开发者，拿到：tiger_id、RSA 私钥文件、模拟账户号（17 位以上纯数字的那个）。

先用模拟账户。老虎模拟盘就能下组合单，整条链路先在模拟账户跑顺；真实账户在快速上手里另选，首单必须二次确认。

在自动驾驶主页「快速上手」一键生成配置

自动驾驶主页 → 快速上手：券商点老虎国际、选 Mac 或 Windows、选模拟账户，看一眼参数（每条几张、每天最多几单、保证金预算、卖方与保护的让价），点「新建密钥并下载配置文件」——本站密钥已经写进配置文件，不用再复制粘贴。

密钥只住在配置文件里，不进 AI 对话。配置文件里老虎那三样是占位符，AI 会在你电脑上问你补全；不要发进任何聊天软件、不要截图外传——外流就回主页吊销。

三样东西交给你自己的 AI

同一页再点「复制老虎专属指令」「下载客户端脚本」。把配置文件、专属指令、客户端脚本一起交给你自己的 AI（Codex、Claude、DeepSeek、Kimi、豆包、workbuddy 都行），让它在你电脑上装老虎连接库、补全三样、跑起来——终端里那几条命令示意图里有，AI 会替你敲。

报错先交给你的 AI，交流进你券商的专属群。每台电脑的系统、Python、券商网关都不一样，把报错原样贴给你的 AI，让它一路改到跑通为止——它看得见你的电脑，我们看不见。用法和经验，到老虎的自动驾驶小分队里交流。

先演练，读懂它在说什么

客户端默认演练：按配置里的间隔检查新数据（网站生成的配置是每 20 秒，官方默认 10 秒），只打印不下单；每条做了什么、为什么跳过，屏幕和本地账本里都有。

美股盘外基本只有「已过期」的数据——空表不是坏了，是市场没开。挂着看两三个交易日再进下一步。

开模拟：二次确认页就是你的驾驶舱

加 --approval 启动，浏览器自动打开本机确认页（127.0.0.1:8642）：顶栏一个开关切「二次确认 / 全自动」，全自动时方向盘亮蓝灯；「今日参数」一行摘要点开可改每条张数、每天上限、保证金预算、卖方与保护的让价；新信号进队列会提醒你（Mac 弹系统通知，Windows 是终端里响一声），你按 OSM 中间价确认或跳过。

挂中间价，不成交自动让价，让到要价线为止——别追价。默认 3 分钟没成交，撤单让 $0.1 重挂；再过 3 分钟最后一档改挂当时的最新中间价（中间价没往下走就不再让），永不低于要价线（确认页「今日参数」可改）；要停一切就建一个急停文件。挂不上单是机制在替你把关，不是坏了。

上路之后：保护、记录页、自动更新

保护够便宜时，程序只给在这台电脑上成交过的卖方买保护：先核对本机成交记录，再问券商持仓里那两条腿还在不在，两条都过才下单；开盘头 5 分钟不买，当天到期的仓位 14:30 以后不买，移仓或对冲接过来的仓位不会买重。确认页「查看全部记录」进记录页：收到的每一条信号都在，没下单的写着原因，动作名和网站上的卡名一样，同一只股票有好几组时带「第 N 组」；按标的、状态、日期筛选，可导出 CSV。原样用官方脚本会自动升级（启动时查一次，运行中每 5 分钟查一次，有单在挂时先不换）。脚本一改就不再自动升级：v3.92 起的官方脚本发现自己被改过，不会覆盖，只把新版另存在旁边；更早的版本、或防覆盖那段被删掉的，仍会被新版整份覆盖。这时把「当前生效的规则」https://osmtrade.com/api/v1/client-rules 发给你的 AI，让它逐条核对合并。所以能不改就别改：张数、上限、让价、各管理开关都在确认页「今日参数」里调。

止盈、止损、移仓、到期结算、反向对冲、买方减仓都已经接进自动驾驶：在本机确认页「今日参数」里各有开关（止盈、止损、到期结算、反向对冲默认开，移仓默认关）。反向对冲会在你账户里新开一组卖方仓位、占保证金，不想要就关掉第 09 项。移仓前程序先算钱，购买力不够就不开始。成交之后网站上那张卡自己记成「自动」，不用回去点。

装好并登录 OpenD（较新版本）

moomoo/富途的开放接口靠一个装在你电脑上的网关 OpenD：去开放平台下载并登录（首次要在手机 App 确认设备）。moomoo 与富途同一套体系，账号在哪边就下哪边的 OpenD。

OpenD 与 SDK 都要 10.10 及以上。组合单（place_combo_order）是较新版本才有的；旧版会下不了组合单。装好后 pip install futu-api 或 moomoo-api，同样要 10.10+。登录后它监听本机端口（富途 11111 / moomoo 11112）——这就是你的券商凭证，只住在你电脑里。

在自动驾驶主页建密钥、下脚本、拿配置

自动驾驶主页（导航「自动」）：「快速上手」里券商点富途证券或 moomoo、选电脑与账户、看一眼参数 → 新建密钥并下载配置文件（密钥自动写入）→ 复制专属指令、下载客户端脚本，三样交给你自己的 AI 让它在你电脑上跑通。和老虎用的是同一个官方脚本，一个脚本三家券商通用。

配置文件里 broker 填 futu 或 moomoo、opend_port 填对（富途 11111 / moomoo 11112），把你的 acc_id 填进 futu_acc_id。不确定就把配置和「复制给 AI 的指令」一起交给你的 AI 补全——但券商凭证与密钥始终只填进本地配置文件，不进 AI 对话。

先演练，看运行状态三盏灯

在终端运行脚本（默认演练，只打印不下单）。确认页顶部「运行状态」面板：OSM 数据 / 券商 SDK / 券商连接三盏灯，绿了才算真连上 OpenD，红了会写明原因（OpenD 没启动、端口不通、SDK 版本旧）。

组合单要实盘 + 二次确认（重要）

关键差异：富途/moomoo 的模拟盘不支持组合期权单（会返回「模拟交易不支持组合期权」）——这是券商平台的规定，不是程序问题。所以模拟阶段只用来验证连接、拉信号、演练；真正下组合单必须用实盘。

别在模拟盘试组合单——一定撞墙。实盘还要先「解锁交易」：在 OpenD 窗口里输入交易密码解锁一次（OpenD 重启后要再解），程序不存密码；没解锁时券商会回「没有解锁交易」，记为券商拒绝、单子不会发出去。常驻电脑可选在 config.json 填 futu_trade_pwd_md5（交易密码的 MD5，Mac 终端里 echo -n 交易密码 | md5）让程序自动解锁。实盘下单请保持「二次确认」模式：每一单进本机队列、你亲手点头才提交，实盘也安全。两条腿永远作为一张组合单一起下（禁止拆腿）。这和老虎不同（老虎模拟盘就能下组合单，可以先模拟完整跑通）。

打开 TWS / IB Gateway 的接口

IBKR 的个人接口跑在你电脑上的 TWS 或 IB Gateway 里：设置 → API → Settings，勾选「Enable ActiveX and Socket Clients」，取消勾选「Read-Only API」（默认常勾着，不取消就只能读不能下单），只信任 127.0.0.1。端口：模拟 TWS 7497 / Gateway 4002，实盘 TWS 7496 / Gateway 4001。

先用模拟账户（DU 开头）。程序读到的账户号必须是 DU 开头的模拟账户；实盘（U 开头）要独立开关加当次明确授权，模拟授权绝不等于实盘授权。

快速上手选盈透 IBKR，拿三样东西

自动驾驶主页 → 快速上手：券商点盈透 IBKR，选电脑与账户，点「新建密钥并下载配置文件」（配置里已带本机网关地址与端口，账户留空让程序自取）；再点「复制盈透 IBKR 专属指令」和「下载客户端脚本」（官方脚本，原样用、不要改）；官方 IBKR 接口文件在 https://osmtrade.com/downloads/brokers/ibkr.py，装法在同一目录的 README_ibkr.md。

两把钥匙只进你电脑的配置文件，不进 AI 对话。本站密钥已写在配置文件里；IBKR 不需要密钥，靠本机网关登录态。

装上官方 IBKR 接口文件

把三样东西交给你的 AI，让它照说明 README_ibkr.md 一节一节装。官方脚本和官方接口文件都原样用、不要改：接口文件放在 ~/.osm-follow/brokers/ibkr.py，config.json 里 broker 写 ibkr，装完跑 adapter-check（IBKR 的 SDK 要新 Python：用 ~/.osm-follow/venv 这个虚拟环境里的 python 跑，adapter-check 会打印整套命令）。Windows 直接装，不用装 WSL，说明开头有一节专讲 Windows 的写法。两条腿是一张组合单，禁止拆腿；收钱还是付钱，要在模拟盘亲眼核一次。

报错先交给你的 AI，交流进你券商的专属群。报错和 adapter-check 的结果原样贴给它，照说明第八节对；还不通就把说明第七节列的东西发到「支持」页，我们改了重新发，你换一个文件就行。主程序照常自动更新，接口文件不用动。我们自己没有 IBKR 真实账户，上实盘前按说明第五、六节在你的账户上自检。10 月 5 日起只支持「官方主程序 + 官方接口文件」；还在跑自己改的 IBKR 程序的，按说明最后一节换过来，换之前先停掉旧程序。用法和经验，到 IBKR 的自动驾驶小分队里交流。

按关卡验收，别信「没报错」

adapter-check 全部通过 → 演练 → 美股收盘后在模拟账户跑 adapter-check --paper-order（挂一张成交不了的单再撤掉；它验不出收钱还是付钱，会把应当的方向和券商那边这张单并排打出来，亲眼核对）→ 模拟账户拿到真实订单号，都过了才算跑通。模拟盘的组合单没有真实撮合，挂着不成交、让价两次也不成交是模拟盘特性，别据此调参。放到后台长期跑时，后台服务要设 OSM_AUTORESTART=1，网关冻住、接口卡住才会自动重启。实盘请保持二次确认；保护窗口只给你程序自己记录到成交、且持仓里两条腿还在的卖方买。

要停一切就建一个急停文件；连不上网关时程序会写明原因，把那一行贴给你的 AI。

三样东西凑齐

自动驾驶主页 → 快速上手：券商点「其他券商」，新建密钥并下载配置文件、复制通用指令、下载客户端脚本（官方脚本，原样用、不要改）；再备好你券商的开放接口文档——齐了 AI 就能开工。

两把钥匙只进你电脑的配置文件，不进 AI 对话。发进对话等于把钥匙交给第三方。

交给你自己的 AI 写券商接口文件

把三样东西粘给 Codex、Claude、DeepSeek、Kimi、豆包、workbuddy 任何一个能在你电脑上干活的 AI。官方脚本原样用、不要改，让 AI 照通用指令先把配置文件放进 ~/.osm-follow/（broker 改成你券商的名字，例 webull），再写一个券商接口文件放在 ~/.osm-follow/brokers/<券商名>.py，写完跑 python3 osm_follow.py adapter-check。主程序照常自动更新，接口文件不用每一版都改。

报错先交给你的 AI，交流进你券商的专属群。报错和 adapter-check 的结果原样贴给它，让它改到全部通过为止；约定在「当前生效的规则」https://osmtrade.com/api/v1/client-rules 第九节，示例在 https://osmtrade.com/downloads/brokers/example_adapter.py。用法和经验，到你券商的自动驾驶小分队里交流（嘉信有专属群）。

按关卡验收，别信「没报错」

adapter-check 全部通过 → 演练 → 美股收盘后在模拟账户跑 adapter-check --paper-order（挂一张成交不了的单再撤掉）→ 模拟账户拿到真实订单号，都过了才算跑通。放到后台长期跑时，后台服务要设 OSM_AUTORESTART=1，卡住才会自动重启。

券商不支持原子组合单的（例如长桥）接不进接口文件：程序会停止自动下单、把结构展示给你手动执行——这是安全规矩，不是缺陷。