反詐投資王（Anti-Gambling Trader）
新手先用圖形工作台（安裝後約 5 分鐘）
0.4.1 提供同一套本機介面的兩種開法，由你選擇：
- 本機瀏覽器版：只用 Python 標準函式庫，畫面開在預設瀏覽器。
- 桌面視窗版：同一個網址、同一套服務，包在原生桌面 WebView 視窗中。
從原始碼安裝瀏覽器版：
pip install -e .
anti-gambling-trader ui # 跳出「瀏覽器／桌面」選擇器
anti-gambling-trader ui --mode browser # 直接開本機瀏覽器版
Windows 也可雙擊 start-ui.cmd。它會優先使用專案的 .venv，不會自行安裝套件。
桌面視窗與 Excel 支援需另外安裝；Windows 還需要 Microsoft Edge WebView2 Runtime：
pip install -e ".[desktop,excel]"
anti-gambling-trader ui --mode desktop
若要從原始碼讀取 Shioaji 台股／期貨資料，另外安裝固定版本 SDK：
pip install -e ".[data-api]" # shioaji==1.7.7；公開 Pionex／Binance K 線不需要此選配
若桌面元件不可用，請改用 --mode browser。兩種模式都只監聽
127.0.0.1，匯入流程是「試樣本 → 匯入或手動記錄 → 看完整性、核心階段與
交易證據圖表 → 視需要從「API 資料」讀取公開行情或本人唯讀資料 → 下載報告 → 產生紙上專案」。
內建樣本永遠標示為示範，不是你的績效。
0.4.1 的瀏覽器與桌面視窗共用同一組本機 SVG 圖表：累積已實現淨損益／回撤、
單筆損益直方圖與 R7 分位數、實際前後段 holdout 卡片，以及另行啟動的資金警戒線情境。
資金情境不猜本金；必須自行填入大於 0 的起始資金、確認紀錄中的單一結算幣別，並明確選擇
「剩餘本金比例」「剩餘固定金額」或「虧損本金比例」。這些圖表不會改寫核心階段或解鎖實盤。
手動紀錄與分析可能使用本機暫存檔；原始檔不會被修改。正常完成或正常結束時會清理這些
暫存，但非預期失敗或強制停止可能讓系統暫存檔留在本機。要保留的 CSV／報告請主動下載；
下載檔是你明確建立的持久副本。下載目前紀錄 CSV 後，重新啟動工作台可在「載入先前逐筆紀錄」
重新載入，繼續之前的紀錄。瀏覽器只關分頁不會停止本機服務；請按畫面上的「結束本次使用」，
或回終端機按 Ctrl+C。
自動驗收可使用 --no-open --ready-file ui-ready.json；ready JSON 只含本機網址、
PID、模式、執行個體 ID 與就緒狀態，不含工作階段 nonce，而且既有檔案不會被覆蓋。
Windows 使用者可從 v0.4.1 發行頁
下載 AntiGamblingTrader-windows-x64.zip。
維護者若要在 Windows 從已安裝的 desktop、excel 與 data-api 相依套件建立 onedir 與 ZIP，可執行
python scripts/build_windows_ui.py --output dist。這只是建置指令；本頁不宣稱或連結
尚未經可攜驗證的發行執行檔。
真實下單未提供。 GUI 只在「API 資料」頁接受使用者直接輸入的唯讀憑證；預設只留在
本次程式記憶體，明確勾選後才存入 Windows Credential Manager。憑證不進網址、狀態、錯誤或下載。
程式只讀取行情、成交、已實現損益與帳戶摘要，不實作下單、改單或撤單。即使核心階段為
tiny_live_validation，畫面仍維持「實盤未提供」。下載的交易專案固定為
PaperBroker、stage=None、live flags 關閉，只是待你填策略的學習鷹架。
GitHub Pages 文件站只是使用說明，不是雲端分析服務，也不會在網頁上接收交易資料。
你在懷疑「投資群組是不是詐騙」「老師帶單可不可信」「我的交易到底是實力還是運氣」嗎？
這是一個免費開源的交易統計、投資反詐與自動化交易開發工具：把交易紀錄
（台股／美股／加密貨幣）丟進來，
它用期望值、顯著性檢定與樣本外驗證，給你統計證據判斷獲利更像可重複的優勢，
還是運氣＋倖存者偏差（賭博）；並內建詐騙話術掃描、假績效鑑識與假老師檢驗。
它也能把交易邏輯轉成可回測策略，並產生可接券商 API 的自動化交易程式專案。
直接在終端機執行本專案的本機 CLI 時，交易紀錄由本機讀取與分析，程式本身不會把
紀錄上傳。若你把檔案、截圖或工具輸出交給 Claude Code／其他雲端 AI，內容可能依
該供應商政策傳送與保存；分享前請遮蔽姓名、帳號、LINE ID 與可識別資訊。參考
Claude Code 官方資料使用說明。此外，部分生成
圖表可能載入外部 CDN；0.4.1 工作台的證據圖表、API K 線 SVG 與匯出不使用 CDN。使用
券商/API 路徑則會明確連線到相應外部服務。
一個誠實到不討喜的工具。它不會告訴你「你會賺錢」——
不適合長期投資的，它會直接勸退你。
👉 急著找答案？先看 常見問題 FAQ：投資群組是詐騙嗎、
勝率 90% 可信嗎、出金要先繳稅正常嗎、被騙了怎麼辦。
🤖 不只分析，也能建立自動化交易程式。 scaffold 會產生自包含的策略、
風控、券商介面、資料源與圖表專案，提供 PaperBroker 與 13 種真實券商／交易所範本。
紙上模擬可直接執行；自行實作真實自動交易時，必須接妥券商 API、即時行情 runner，
並沿用四層安全檢查。預設生成的歷史 runner 不會送出真單；只有使用者自行填入金鑰、
完成 live runner 並明確解鎖後，live adapter 才可能送單。
English TL;DR — An honest, open-source (MIT) trading-performance analyzer for
Taiwan securities and derivatives, US stocks, crypto and forex. It uses expectancy, significance tests (t-test +
centered bootstrap) and out-of-sample validation to tell whether your P&L is a
repeatable edge or survivorship-biased luck — and it will actively discourage you
if it's the latter. Includes scam-language scanning, fake-performance forensics
and a guru-claim probability checker. The statistical core uses the Python standard library,
and trade-record analysis stays local.
It can also generate backtestable strategy skeletons and automated-trading projects with
paper trading by default and explicit safety gates for any user-built live connection.
👶 完全沒用過電腦命令？從這裡開始
如果你沒裝過 Python、沒用過終端機、也沒用過 AI，請看
新手快速上手指南 docs/quickstart.md ——
它從「怎麼裝 Python、怎麼打開終端機」開始，一步一步帶你上手。安裝後先打：
anti-gambling-trader start
畫面會依「完整紀錄、單筆交易、交易截圖，還是 LINE 對話」列出最短命令。
沒有試算表也能用 record 的五個短問題記一筆交易。
🛡 這個工具的反詐使命
台灣到處都是假飆股群、假二群、假 VIP 群、假名師、假績效截圖、保證獲利話術、
詐騙幣與假投資平台。它們絕大多數靠同一招：用倖存者偏差與精選截圖，
讓你誤以為有穩賺的捷徑。
這個工具叫「反詐投資王」不是叫假的 —— 它存在的真正原因，就是用統計與數學
檢驗這些承諾。詐騙最怕的，就是你冷靜地把它的承諾丟進數學裡檢驗。
# 貼上群組對話，掃描詐騙話術（不給假百分比，只給風險等級）
anti-gambling-trader scan-text "老師帶單保證獲利，快加VIP客服"
# 檢驗老師的宣稱：「勝率90%、月報酬20%」純靠運氣出現的機率是多少？
anti-gambling-trader guru-check --win-rate 0.9 --trades 10 --monthly-return 0.2
# 用數學算出「連贏10次的神人」有多容易靠運氣出現
anti-gambling-trader survivorship
# 鑑識老師/平台宣稱的報酬序列是否有可疑徵兆（過度平滑、高得可疑的夏普）
anti-gambling-trader forensics --file 老師的月報酬.txt
# 互動式自我檢測
anti-gambling-trader scam-check
詳見 完整功能與判讀指南、
反詐指南 與 FAQ。
🆘 懷疑自己正在被詐騙？ 立刻停止匯款，撥打 165 反詐騙專線，
或上 165 全民防騙網。查證合法業者：
金管會證期局；證券期貨爭議求助：
投保中心。（官方連結查核日期：2026-07）
本工具是統計輔助，不是司法鑑定；官方管道永遠優先。
支援 台股 / 台股 ETF / 台指期與選擇權 / 美股 / 加密貨幣 / 外匯，
匯入 CSV / JSON / Excel 的交易紀錄，自動：
- 計算 勝率、盈虧比、期望值、獲利因子、最大回撤、夏普 / 索提諾值
- 用 統計顯著性檢定（t 檢定 + Bootstrap） 判斷「這是優勢還是運氣」
- 用 樣本外驗證 揭穿過度配適與倖存者偏差
- 掃描 賭博特徵警訊（賺小賠大、獲利過度集中、長連虧、純當沖…）
- 逐策略體檢：對你的每一招（突破 / 抄底 / 聽明牌…）呈現描述統計，揪出哪一招在送錢
（刻意不對個別策略做優勢認證 —— 多重比較未校正會把運氣誤認成優勢，詳見方法論）
- 反事實分析：算出「停掉最差那一招，整體會變怎樣」
- 轉正數字：告訴你「勝率要到幾 % / 盈虧比要拉到多少，期望值才會轉正」
- 反詐偵測：把「聽老師 / 跟單」的交易單獨抽出算期望值 —— 用你自己的數字檢驗跟單到底賺不賺
- 風險情境模擬：用你的損益分布模擬未來，看有多少比例的路徑會爆倉
- 時間趨勢：月／季描述統計，以及固定早期與近期切點的單一優勢衰減檢定
- LINE 對話掃描：理解 LINE 匯出標頭與跨訊息話術，顯示發言者、時間、原句與理由
- 交易截圖覆核：OCR 擷取進出場點位、數量、時間、損益、停損/停利；低信心不自動填
- 交易技術線索：辨識突破、均線、RSI、MACD 等畫面文字，但不把線索冒充成策略優勢
- 新手階段分流：用完整交易紀錄判斷目前只適合停手、紙上模擬或極小額驗證
- HTML 報告 + 分享圖卡：可存檔、可截圖傳給家人的白紙黑字數據
- 反推你的交易邏輯，產生 可回測的策略骨架（backtrader / vectorbt / 通用）
- 自動化交易程式腳架：產生自包含的策略、風控、券商介面、資料源與圖表專案；
PaperBroker 可直接執行，另有 13 種真實券商／交易所範本供使用者自行接線與驗證
- 若判定不適合長期投資，明確勸退
支援市場：台股、台股 ETF、台指期 / 選擇權（含契約乘數）、美股、加密貨幣、外匯。
為什麼做這個
絕大多數散戶虧錢，是因為把「運氣好」誤當成「有本事」——
而詐騙集團正是利用這個認知弱點，用假群組、假名師、假截圖收割你。
一段帳面獲利，在統計上經常和「純運氣」無法區分。這個工具的唯一目的，
就是在你賠掉更多錢、或被詐騙收割之前，用數學說真話。
安裝
核心引擎是純 Python 標準函式庫，零外部依賴。
This is the beginning of the README. Read the rest at the original. Read the full README ↗
