免费开源交易统计工具 anti-gambling-trader-tw 终极指南：15分钟判断你是在投资还是在赌博

anti-gambling-trader-tw（反詐投資王）是一款免费开源的投资反诈与交易统计工具：把台股、美股或加密货币的交易记录丢进去，它用期望值、显著性检定与样本外验证，用统计证据判断你的盈利更像可重复的优势，还是运气＋幸存者偏差（赌博）。全程在你自己的电脑上本地运行，不上传任何服务器。

它自称是一个"诚实到不讨喜"的工具——不会告诉你"你会赚钱"，不适合长期投资的，它会直接劝退你。

这个工具能帮你做什么

• 📊 交易统计：自动计算胜率、盈亏比、期望值、最大回撤、夏普/索提诺值
• 🎲 优势 vs 运气：t 检定 + Bootstrap 显著性检验 + 样本外验证，揭穿过度拟合
• 🔍 揪出送钱的那一招：按策略标签（突破/抄底/听明牌）逐一体检，反事实分析"停掉最差那一招会怎样"
• 🛡️ 反诈检测：诈骗话术扫描、假绩效鉴识、"假老师"宣称验证
• ⚙️ 自动化交易脚架：默认 PaperBroker 纸面模拟，另提供 13 种真实券商/交易所模板

最快上手：5 步完成你的第一份交易统计报告

完全没用过终端机的朋友，可先看从装 Python 到出报告手把手教程：docs/quickstart.md

第一步：安装 Python

从 python.org/downloads 下载安装（Windows 安装时务必勾选 Add Python to PATH），要求 Python 3.10+。

第二步：克隆仓库

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

第三步：安装本体

pip install -e .

核心引擎是纯 Python 标准库，零外部依赖。可选依赖：openpyxl（读 Excel）、.[screenshot]（截图 OCR）、backtrader（跑回测）。

第四步：先看内置演示

还没有自己的数据？一行命令立刻看效果：

anti-gambling-trader demo            # "赌博型" 交易范例
anti-gambling-trader demo --edge     # "有优势" 对照范例

仓库自带三套示例数据：core/examples/tw_stock_gambling.csv（台股赌博型）、core/examples/us_stock_edge.csv（美股优势型）、core/examples/crypto_luck.json（加密运气型）。

第五步：分析你自己的交易

# 没有表格？五个短问题逐笔记录
anti-gambling-trader record

# 快速分流：我现在适合停手、纸上模拟还是极小额验证
anti-gambling-trader fit-check my_trades.csv

# 完整统计报告
anti-gambling-trader analyze my_trades.csv

表格栏名中英皆可、自动识别，最简只需"代号 + 已扣全部成本的净损益 + 结算币别"。强烈建议填 tag（策略标签），这样工具才能告诉你"哪一招在送钱"。字段格式详见 docs/user-guide.md。

五种裁决等级：你的盈利是优势还是运气

统计裁决引擎（源码见 core/verdict/judge.py）会把你的账户归入五个等级之一：

等级	含义	劝退
🟥 gambling	样本期望值为负——方法不变，长期统计预期就是亏损	✅ 强烈劝退
🟧 insufficient	样本太少，无法区分本事与运气	✅ 劝阻重注
🟨 luck_suspected	账面赚钱，但统计上像运气	✅ 高度存疑
🟨 fragile_edge	有统计信号但结构脆弱、风险高	✅ 谨慎
🟩 statistical_edge	正期望值通过显著性检验（样本外验证另行报告）	❌ 不劝退（仍非保证）

判定逻辑三步走：

1. 期望值——真实期望值为负，长期就是输（数学定义）
2. 显著性检验——t 检定 + 中心化 Bootstrap 重抽，双双 p < 0.05 才算"不是运气"
3. 样本外验证——按真实平仓时间做单一切点，前后两段都须显著正期望，后段衰减小于 50%

数据不完整时，工具会 fail closed（宁可不算也不猜）：缺时间不做样本外切分、不同币别不直接相加、未知期货乘数不用 1 猜名义本金。方法论全文见 docs/methodology.md。

反诈工具箱：4 个命令拆穿假群、假老师

反诈核心模块在 core/antiscam/，配合 docs/anti-scam.md 的反诈指南使用：

# 1. 互动式自我检测（12 题问答）
anti-gambling-trader scam-check

# 2. 贴上群聊对话 / LINE 导出文件，扫描诈骗话术
anti-gambling-trader scan-text "老师带单保证获利，快加VIP客服"

# 3. 检验老师宣称："胜率90%、月回报20%" 纯靠运气出现的概率
anti-gambling-trader guru-check --win-rate 0.9 --trades 10 --monthly-return 0.2

# 4. 用数学算出"连赢10次的神人"有多容易靠运气出现
anti-gambling-trader survivorship

# 5. 鉴识对方宣称的报酬序列（过度平滑、高得可疑的夏普）
anti-gambling-trader forensics --file 老师的月回报.txt

工具刻意不给"87% 是诈骗"这种未校准的假百分比，只输出可解释的序数风险等级。疑似诈骗时，官方管道永远优先：台湾可拨打 165 反诈骗专线。

进阶：生成你自己的自动化交易程序

除了分析，它还能用交互式脚架生成一套可执行的自动交易项目（源码见 core/scaffold/generator.py）：

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

# 生成项目（建议先嵌入你的交易分析裁决）
python -m core.cli scaffold --name my_bot --broker binance --chart lightweight \
    --market crypto --symbols "BTCUSDT,ETHUSDT" --from-analysis my_trades.csv

可选券商共 14 种：默认 PaperBroker 纸面模拟（完整可用、不碰真钱），以及 Shioaji、元大、富邦、KGI、群益/统一/元富期货类、IBKR、Alpaca、Tradier、Binance、Pionex、OKX、Bybit、ccxt 等真实券商/交易所模板（清单见 core/broker/registry_tw.py）。

四层安全设计保护你的钱：

1. 默认纸面模拟，不碰真钱
2. 阶段联动——只有样本外延续且分流结果为 tiny_live_validation 才可能解锁实盘配置
3. 运行时多重硬闸——缺字段、类型错误一律 fail closed
4. 历史 replay 不碰真钱——内置 120 根历史 K 线只准纸面执行

⚠️ 真实交易须自行接妥券商 API 并明确解锁安全闸门，责任自负。把未验证的赌博自动化，只会亏得更快。

新手常见问题

Q：它会告诉我"买什么会涨"吗？ A：不会，而且这恰恰是重点。任何宣称报明牌、保证获利的，都该高度怀疑是诈骗。

Q：我的交易数据会被上传吗？ A：交易分析不会。核心、文字扫描、OCR 全部在本机执行。

Q：只记 2 笔交易就能分析吗？ A：能，但会得到诚实的"样本不足"——统计上 2 笔数据本就不能下任何结论。建议累计 30 笔以上。

Q：投资群组是诈骗吗？胜率 90% 可信吗？出金要先缴税正常吗？ A：21 题问答见 docs/faq.md，每题先给直接答案再给统计依据。

写在最后

anti-gambling-trader-tw 的可信度不来自头衔，而来自公开的源码、可复现的实验（experiments/，固定 seed）与 351 个自动化测试。15 分钟后，你会用数学——而不是感觉——回答那个问题：你是在投资，还是在赌博？ 答案若是后者，它宁愿劝退你，也不赚你的钱。

免责声明：本工具为统计分析与教育用途，输出不构成投资建议。投资有风险，盈亏自负。