anti-gambling-trader-tw 自动化交易脚手架:PaperBroker 默认模拟与四重安全门,不花一分钱测试你的策略

原创2026-10-17 20:10:591,649 阅读

anti-gambling-trader-tw 自动化交易脚手架:PaperBroker 默认模拟与四重安全门,不花一分钱测试你的策略

🧾 anti-gambling-trader-tw 是一个免费开源的投资反诈、交易统计与自动化交易程序开发工具。它的 scaffold(脚手架)命令可以一条指令生成一套完整可执行的个人自动化交易程序项目:默认启用 PaperBroker 纸上模拟,并内建四重安全门——你在测试策略时,全程不碰真钱。

下面带你从零走完这条安全路径:生成项目 → 填策略 → 纸上跑通 → 理解安全门 → 再决定要不要接真实券商。

一、自动化交易脚手架是什么:一条指令生成整套可运行程序

很多新手写交易程序时,要自己搭目录、接行情、写下单接口、画图表,繁琐且容易出错。anti-gambling-trader-tw 的脚手架(core/scaffold/generator.py)会替你生成一整套自包含项目,装好依赖后 python main.py 就能直接跑纸上模拟:

生成文件 职责
main.py 主程序,默认纸面模拟;真实下单总开关 ALLOW_LIVE_TRADING 默认关闭
strategy.py 你的交易规则(进出场条件待你填写,含默认停损/停利逻辑)
broker_lib.py 自包含券商库(交易接口 + PaperBroker,零外部依赖)
broker_setup.py 券商选择器,默认返回 PaperBroker
brokers/ 真实券商接入框架(待填 API key 与实现)
charting.py 图表模块(四选一的开源图表库)
data_feed.py 行情数据源(回测/即时统一接口,内置可复现的演示 K 线)
config.example.yaml 配置模板(含风控参数与安全门字段)
requirements.txt / .gitignore 依赖清单;自动排除 config.yaml、.env 等敏感文件

两个值得注意的设计细节:

  • 自包含:broker_lib.py 由脚手架直接把本体的券商接口与 PaperBroker 源码合并进你的项目(core/scaffold/generator.py),项目放到任何目录都能独立运行,不会出现 ModuleNotFoundError。
  • 输入校验:项目名与标的代号在生成前会经过严格正则校验,拒绝引号、路径分隔、.. 等危险字符,杜绝路径穿越与代码注入(core/scaffold/generator.py)。

二、三步快速上手:安装、生成、运行纸上模拟

1️⃣ 克隆并安装本工具

git clone https://gitcode.com/gh_mirrors/an/anti-gambling-trader-tw
cd anti-gambling-trader-tw
pip install -e .

核心引擎是纯 Python 标准库,零外部依赖;要求 Python 3.10+。

2️⃣ 查看可选项并生成项目

# 看看有哪些券商 / 图表可选
anti-gambling-trader brokers
anti-gambling-trader charts

# 生成项目(建议带 --from-analysis,把交易纪录的统计裁决嵌入项目)
anti-gambling-trader scaffold --name my_bot --broker paper \
    --chart lightweight --market crypto --symbols "BTCUSDT,ETHUSDT" \
    --from-analysis my_trades.csv

--from-analysis 会先用 core/cli.py 的分析流程读取你的交易纪录,把「裁决等级」和「新手阶段分流」结果写进生成项目的配置与 README。如果分析判定你的策略更像赌博,生成项目的 main.py 会默认禁用真实下单,并在项目 README 里写上一段劝退提醒——这是保护你,不是限制你。

3️⃣ 跑起来(默认纸上模拟,不碰真钱)

cd my_bot
pip install -r requirements.txt
python main.py        # 用 PaperBroker 跑一遍 120 根演示 K 线,并产出图表

跑完会输出绩效摘要(最终权益、成交笔数),并生成 chart.html 图表。接下来你要做的只有一件事:打开 strategy.py,把进出场规则填进去。

💡 脚手架的提醒很直白:如果你连「明确、可量化的进出场规则」都写不出来,那说明你的交易可能凭感觉,而不是有方法。

三、PaperBroker 纸上模拟:像真撮合一样,但花不了钱

PaperBroker(core/broker/paper.py)不是摆设,而是一个完整可用的模拟券商:

  • 真实撮合逻辑:市价单按滑点成交、限价单按限价成交;资金不足会拒单;默认只支持做多,卖出超过持仓直接拒单。
  • 仓位核算严谨:买入加仓走加权平均成本,反向超量翻仓时以新成交价建立新仓位——停损/停利不会被旧均价带偏。
  • 成本可配置:在 config.yaml 里调整起始资金、手续费率与滑点:
paper:
  starting_cash: 1000000   # 起始资金
  fee_rate: 0.001          # 每笔手续费率
  slippage: 0.0005         # 市价单滑点率

risk:
  max_position_pct: 0.2    # 单一标的最多动 20% 资金
  stop_loss_pct: 0.05      # 停损 5%
  take_profit_pct: 0.15    # 停利 15%
  • 想模拟做空? 需要显式传入 allow_short=True,且它会明确告知你:这是不含借券费、融资利息、保证金的简化模型,估值偏乐观,不可当真实做空绩效预期。
  • 留痕可分析:每笔模拟成交都记录在 fills 里,方便事后复盘。

一句话:先用它把整套程序跑到满意为止,再考虑接真实券商。

四、四重安全门详解:为什么真实下单被默认封死

anti-gambling-trader-tw 对「真钱」的保守程度是刻意为之。生成项目的模板(core/scaffold/templates.py)里写死了四道闸门:

# 安全门 内容 失败时行为
1 默认纸上模拟 生成项目默认用 PaperBroker,完整模拟撮合但不碰真钱 —
2 完整阶段联动 只有完整分析(含样本外验证、币别与回撤基准)分流到 tiny_live_validation 阶段时,配置才可能同时写入 stage_code: tiny_live_validation 与 allow_live_trading: true 其他任何阶段一律封锁
3 Runtime 多重硬闸 运行时重新校验:ALLOW_LIVE_TRADING 常量、risk.i_have_read_disclaimer: true、anti_gambling.allow_live_trading 必须为布尔 true、stage_code 必须精确匹配,全部通过才调用券商双重复确认 缺字段、类型错误、YAML 损坏一律 fail closed
4 历史 replay 不碰真钱 内置 main.py 只重放 120 根历史/演示 K 线,一旦侦测到 live broker 会硬性退出,避免把历史信号一次送成多张真单 直接终止程序

第 3 道闸门还要求你手动在 main.py 里把 ALLOW_LIVE_TRADING 从 False 改成 True——这种「摩擦力」是刻意设计的,逼你在动真钱前停下来想清楚。

即使四道门全过,也只代表程序允许你做极小额验证,不代表策略适合重押或全职交易。

五、14 种券商选项与 4 种图表库

执行 anti-gambling-trader brokers 可查看完整清单(注册表见 core/broker/registry.py、core/broker/registry_tw.py)。所有生成项目一律默认 PaperBroker,真实券商模板需要你自行接线与验证:

市场 可选 key
全市场 paper(纸上模拟,默认,完整可用)
台股 / 台期 shioaji(永丰)、yuanta(元大 SPARK)、fubon(富邦)、kgi(凯基,含美股)、tw_futures(期货类)
美股 / 全球 ibkr(Interactive Brokers)、alpaca、tradier
加密货币 binance、okx、bybit、pionex、ccxt(一个接口接 100+ 交易所)

图表库四选一:lightweight(TradingView 风格)、plotly、mplfinance、echarts,可先跑 anti-gambling-trader chart-preview 生成预览页用浏览器对比挑选。

六、纸上模拟稳定后,如何安全切换到真实交易?

⚠️ 高风险提示:真实金融交易必须自行操作并负全部责任。把未经验证的策略自动化,只会赔得更快。

按生成项目 README 的要求,完整路径是:

  1. 用 scaffold --from-analysis <完整交易纪录> 重新生成,只有阶段为 tiny_live_validation 时,配置模板才可能写入正确的 stage 与允许旗标;
  2. 复制 config.example.yaml 为 config.yaml,阅读免责声明后才把 risk.i_have_read_disclaimer 设为 true(不要手动猜改 stage_code / allow_live_trading);
  3. 把 main.py 的 ALLOW_LIVE_TRADING 改为 True;
  4. 在 brokers/ 下填写 API key 并完成券商框架的 TODO,在 broker_setup.py 里把 build_broker() 改回真实券商实例;
  5. 另写一个只处理最新一根已完成 K 线的 live runner,并接上可验证为即时且无前视的行情来源——因为内置 main.py 是历史重放,接 live broker 会直接退出。

每一步少做一分,安全门就保持封锁一分。

七、写在最后

anti-gambling-trader-tw 的定位是一个诚实到不讨喜的工具:它不会告诉你「你会赚钱」,而是先用统计检验你的策略是不是运气,再用脚手架帮你零成本地把策略跑起来。

本工具为统计分析与教育用途,输出不构成任何投资建议。投资有风险,盈亏自负;过去绩效不代表未来表现。

登录后查看全文
anti-gambling-trader-tw