反詐投資王

完整功能與判讀指南

這個工具不是要說服每個人交易，而是要讓交易員與一般民眾更快知道：

手上的資料能回答什麼、不能回答什麼；
目前應停手、留在紙上模擬，或最多只考慮極小額驗證；
LINE 對話與績效截圖出現了哪些可回溯的高風險訊號；
哪些欄位可能被 OCR、幣別、契約乘數或時間資料誤讀。

fit-check 評估的是「目前這份完整交易紀錄支持哪個階段」，不是人格測驗、財力審查或未來獲利保證。工具永遠不會認證你適合重押、借錢或全職交易。

0.4.1 的新手預設入口是本機圖形工作台：

anti-gambling-trader ui                 # 選瀏覽器或桌面視窗
anti-gambling-trader ui --mode browser  # 零額外執行期依賴
anti-gambling-trader ui --mode desktop  # 先 pip install -e ".[desktop,excel]"；Windows 需 WebView2

自動化啟動可加 --port 0 --no-open --ready-file ui-ready.json。--port 0 由系統挑選可用埠；ready file 只在健康檢查（桌面版則是實際視窗 loaded 事件）後，以不覆寫既有檔案的方式建立，內容不含工作階段 nonce。

兩種外殼載入完全相同的本機 HTTP UI。原始匯入檔不會被修改；分析可能使用本機暫存檔。正常完成或正常結束會清理這些暫存，但非預期失敗或強制停止可能讓系統暫存檔留在本機。要保留的紀錄與報告請主動下載；下載檔是明確建立的持久副本。下載目前紀錄 CSV 後，重新啟動工作台可在「載入先前逐筆紀錄」重新載入，繼續之前的紀錄。關閉瀏覽器分頁不會自動停止服務，請使用畫面內的「結束本次使用」或 Ctrl+C。它只在「API 資料」頁接受使用者本人直接輸入的唯讀憑證，預設僅存本次程式記憶體；不實作下單、改單、撤單或實盤解鎖。 Shioaji 工作程序會在本人可讀的專用暫存目錄執行，並把 SDK 登入權杖／合約快取與日誌路徑隔離到該目錄（日誌預設丟棄）；工作程序正常結束後回收暫存。非預期停止可能留下暫存目錄，請在確認沒有相關工作程序後再清理。

唯讀 API 資料頁的邊界

Pionex、Binance 只支援現貨；公開 K 線不用憑證。私有成交與帳戶摘要才需要本機憑證。
Shioaji 支援台股／期貨的 K 線、持倉／餘額與已實現損益讀取；原始碼安裝需 pip install -e ".[data-api]"，固定 shioaji==1.7.7。第一次帳戶與 API 申請由使用者自行完成。
provider、官方主機、路徑、HTTP 方法與 Header 都是程式固定白名單；畫面不接受 URL、host、任意 credential reference 或自訂 Header。key／secret 不進網址、日誌、狀態、錯誤與下載。
profile 只接受本工具 AntiGamblingTrader/readonly/{provider}/{profile} 命名空間；預設 default。未勾「記住」時為 session-only；Windows Credential Manager 必須明確勾選。
成功登入或成功讀取只標示「讀取可用」，不代表交易所／券商已授予全部唯讀權限。
每次工作上限 45 秒、20 頁、5,000 列與 4MiB。K 線畫面只顯示最新 400 根，但下載保留全部受限資料；空視窗只代表沒有回傳紀錄，不能推成帳戶沒有其他交易。
加密貨幣的 FIFO 只在期初庫存為 0、轉帳已對帳、邊界完整、費用資產可解讀且同毫秒順序不含糊時建立完整週期。Shioaji 的 gross／net 與費用／交易稅口徑必須由使用者確認。
帳戶頁只顯示原始幣別餘額、持倉數量與單位；不把 USDT 現金或未知成本持倉猜成總淨值。

1. 先選你手上的素材

你現在有什麼	先執行	會得到什麼
想用圖形流程	`anti-gambling-trader ui`	選瀏覽器／桌面，依既有五步完成示範、紀錄、分析、下載與紙上鷹架；需要時另開「API 資料」
公開 K 線或本人唯讀 API 資料	圖形工作台「API 資料」	Pionex／Binance／Shioaji 的來源綁定資料集、原始表格與可選已平倉分析
不知道從哪開始	`anti-gambling-trader start`	依素材顯示最短路徑
一筆剛平倉的交易	`anti-gambling-trader record`	五個短問題，安全附加到 CSV
完整、連續交易紀錄	`anti-gambling-trader fit-check my_trades.csv`	停手／紙上模擬／極小額驗證分流
想看完整統計報告	`anti-gambling-trader analyze my_trades.csv --full`	裁決、樣本外、趨勢與風險情境
LINE 匯出對話	`anti-gambling-trader scan-text --file LINE對話.txt`	序數風險、發言者、時間、原句與理由
券商或圖表截圖	`anti-gambling-trader scan-screenshot 截圖.png`	待人工覆核的候選欄位與文字線索
老師宣稱的勝率	`anti-gambling-trader guru-check --win-rate 0.9 --trades 20`	在明示虛無假設下的機率檢驗
沒有自己的資料	`anti-gambling-trader demo`	明確標示的內建範例，不是你的成績

核心分析、文字掃描與 OCR 都可由本機 CLI 執行；圖片 OCR 是選配功能，不安裝也可用 scan-screenshot --text "已複製的 OCR 文字"。若把檔案或輸出交給雲端 AI，請先遮蔽姓名、帳號、LINE ID；生成的專案圖表可能載入外部 CDN，但 0.4.1 工作台證據圖表與匯出 SVG 完全本機、沒有 CDN。券商/API 路徑會明確對外連線。

2. 「是否適合交易」到底怎麼判斷

fit-check 先跑與完整分析相同的統計與資料品質檢查，再濃縮成下面五個內部階段。對使用者而言，它們只會落在「停手、紙上模擬、極小額驗證」三種行動。

內部階段	觸發條件	使用者應做什麼
`stop_real_money`	樣本期望值不為正，或整體裁決要求勸退	停止加碼、借錢、重押與跟單，先檢查方法
`paper_only`	少於 30 筆已平倉交易	固定規則，以紙上模擬累積完整連續紀錄
`paper_until_oos`	樣本內有訊號，但樣本外未確認延續	凍結規則，用後續未看過的交易驗證
`paper_until_risk_data`	樣本外有訊號，但幣別、名目本金、乘數、時間或回撤基準不可靠	補齊風險資料，仍不可設定真錢部位
`tiny_live_validation`	樣本內與樣本外都通過，且報酬率、回撤與幣別基準可靠	最多考慮可全部損失的極小額驗證；不是重押許可

要進入最後一階段，後段必須是真正「規則凍結後才看到」的新資料。若先看完整段歷史再調規則，後段就不是樣本外資料，結論會偏樂觀。

3. 新手如何記一筆交易

anti-gambling-trader record --out my_trades.csv

互動流程有五個主要問題：

標的代號；
方向；
已扣手續費、稅與滑價的已實現淨損益；
真實平倉日期／時間；
當時的進場理由。

若第 3 題不知道淨損益，工具才會追加詢問進場價、出場價與數量。請遵守：

一筆只記一筆已平倉交易，未平倉損益不要混入；
direct P&L 必須寫結算幣別，例如 -1250 TWD，或另帶 --currency TWD；
direct P&L 必須是淨額，工具不會再估一次費用；
用價差推算時必須明示做多／做空，台股數量填「股」而不是「張」；
舊交易要填真實平倉時間，不要接受今天的預設值；
策略欄填進場當下的理由，不要看到結果後美化；
贏單、虧單都連續記，不挑單、不刪單。

最簡 direct-P&L 紀錄可以計算金額期望值，但通常缺少可信部位基準，所以報酬率與回撤百分比會停用，fit-check 最高只到紙上模擬。要考慮極小額驗證，仍需補齊進場價、數量、正確契約乘數、帳戶結算幣別與完整平倉時間。

4. 資料不完整時，工具如何 fail closed

「Fail closed」表示寧可明示無法計算，也不使用猜測值產生看似精確的結論。

資料問題	工具不會做的事
缺少、無效或全部相同的平倉時間	不用檔案列順序冒充時間；不宣稱完成樣本外驗證
混用有時區與無時區時間	不安全排序，也不做樣本外切分
不同或不明的損益幣別	不把 USD、TWD、USDT 等金額直接相加或比較
模糊的 gross/net 損益欄	不把未確認已扣成本的金額冒充淨損益
未知期貨／選擇權契約乘數	不使用乘數 1 猜名目本金、報酬率或回撤百分比
direct P&L 沒有可信進場基準	只保留金額統計，不產生虛假的報酬率
direct P&L 方向未知	保留該筆淨損益，但不拿它推測做多／做空偏好
OCR 正負號、單位或多個候選衝突	不自動帶入，要求逐欄人工確認
有資料列被拒絕	保留拒絕筆數與有限原因；整份資料只做描述，不認證正優勢
完整時間戳交易精確重複	不靜默去重；保留原列並停止正優勢與樣本外認證，等來源核對

缺漏資料不一定會整筆刪除：例如可信的 direct net P&L 仍可進入金額統計；只是依賴時間、方向、名目本金或幣別的指標會誠實標成不可用。

5. 樣本外驗證的必要條件

工具使用單一時序 holdout，而不是多折 walk-forward：

先通過資料完整性閘門：沒有被拒資料列，也沒有未釐清的精確重複交易；
依真實平倉時間排序，前段約 70%、後段約 30%，兩段至少各 10 筆；
不拆開同一平倉時間的交易群；找不到有效切點就拒絕驗證；
整份紀錄必須有可比較的同一損益幣別；
前段必須是正期望，且 t 檢定與置中 bootstrap 都顯著；
後段也必須是正期望且雙檢定顯著；
後段期望值相對前段的衰減必須小於 50%；
規則必須在看到後段結果以前就凍結。

任一條不成立，都不能轉述成「優勢已通過樣本外驗證」。後段帳面為正但不顯著，只能說尚未排除運氣。

圖表、分位數與資金警戒線怎麼讀

工作台的累積線是已平倉交易的已實現淨損益，基線為 0；它不是帳戶總權益，不含未平倉浮動損益、入金或出金。只有時序可靠時才畫，並在核心 holdout 可用時標出實際切點。損益分布另列 R7 的 P05、Q1、中位數、Q3、P95、最小、最大與平均；這些都是目前交易樣本的描述，不是母體確定值。

前後段卡片直接沿用核心的單一時序切分與原始 headline／interpretation。它比較的是完成交易在時間上的穩定度，不是載入市場 K 線後把策略規則重新跑一次。從外部回測器匯出的交易紀錄可以分析，但工作台不執行任意上傳 Python，也不會把回溯切分寫成前瞻驗證。即使樣本內／外被分開，也不能證明策略設計者當時沒有看過後段。

資金情境必須另外填入：

門檻選項	輸入 10 的意思
剩餘本金比例（預設）	警戒線 = 起始資金 × 10%
剩餘固定金額	警戒線 = 10 個已確認結算幣別單位
虧損本金比例	警戒線 = 起始資金 × (1 − 10%)

模型從同一幣別的歷史單筆淨損益有放回抽樣，E(k+1)=E(k)+抽到的損益；不複利、不調整部位、不使用即時市場資料。只有 E < 警戒線 才算命中，起始時點也會檢查；命中後停止並把實際穿越後的資金持有到期末，所以可能是負值，不會被夾到門檻。畫面只報「本次 N 條路徑中有幾條曾跌破」；這是情境頻率，不是未來機率。扇形是每一步的 P05／Q1／中位數／ Q3／P95 分布，也不是單一路徑或信賴保證。少於 10 筆拒算，10–29 筆顯示強警告；完整性未通過或幣別不可靠時也拒算。

圖表與資金情境不會改寫核心階段、推導策略規則或允許實盤。自動化準備區只分開列出：既有研究證據、可下載的 paper 鷹架，以及仍未驗證／未提供的策略規則、即時資料與執行。

6. LINE 對話詐騙辨識邏輯

scan-text 是可解釋的規則掃描，不是司法鑑定或經標註資料校準的詐騙分類器。

它會：

解析常見 LINE 匯出標頭，保留日期、時間、發言者與原句；
正規化簡繁體與常見遮字／插空格寫法；
檢查保證獲利、VIP／帶單導流、假績效、異常入金、出金受阻、先繳費才能出金、私人或指定收款處、急迫／稀缺／權威／社會證明等訊號；
將同一發言者、同一天、10 分鐘內拆開傳送的話組合判讀；即使中間有人插話也可回到原發言者，但最多組合 6 則、600 字；
永不跨發言者或跨日期拼接證據；
將否定、反詐警語與求證語境綁在實際命中的子句，不讓前一句「不要相信」洗掉後一句真正的私人匯款指令；
保留被否定的命中供查核，但不拿它計入風險。

結果只分「極高／高／中／低／資訊不足」，不是詐騙機率。低風險不等於安全；工具也不能驗證對方真實身分、平台合法性、帳戶所有權或是否構成犯罪。若對方已要求匯款、下載遠端控制 App，或先繳稅金／解凍金才能出金，應先停止付款並撥 165 查證。

7. 交易截圖與點位覆核

圖片模式需要選配套件與本機 Tesseract：

python -m pip install -e ".[screenshot]"
anti-gambling-trader scan-screenshot 券商截圖.png --json review.json

沒有 OCR 環境時：

anti-gambling-trader scan-screenshot --text "手機複製出的圖片文字"

每次只能提供圖片、--text-file、--text 其中一種來源。工具可能提出標的、方向、進出場價、數量、時間、已實現損益、損益幣別、停損與停利候選值；但任何結果都需人工覆核，--json 也是「待覆核資料」，不是可直接分析的交易紀錄。

逐欄檢查清單：

標的是哪個市場與商品，不要只看被截斷的代號；
LONG 出現在商品名稱時，不代表做多；買進成交也不一定是空單的進場；
數量必須確認是股、張、口、幣或 contract，無單位不自動填；
已實現與未實現損益不可混用；百分比損益不可當金額；
損益正負號、小數點與幣別必須對原圖；文字標籤與正負號衝突時不採用；
停損／停利要確認是價格、百分比或金額；
多個高信心候選互相衝突時，不選任何一個；
截圖可能被裁切、修圖或只挑贏單，單張圖不能驗證績效。

8. 交易技術辨識的邊界

截圖中的突破、均線、RSI、MACD、停損與停利只會標成「畫面文字線索」。它們不能證明：

使用者真的依該規則進場；
規則定義完整且可重現；
訊號在當時沒有使用未來資料；
策略扣除成本後具正期望；
這套技術適合未來交易。

要分析交易技術，請在每次進場時記下可重現的 tag/策略/進場理由，累積完整連續紀錄。逐策略結果只提供描述統計，用來找「樣本中哪一招較差、值得停止檢查」；因多重比較問題，它不會替個別技術頒發「具優勢」認證。

9. 交易程式與真錢安全閘

圖形工作台產生的 ZIP 與一般 CLI 進階腳架要分清楚：GUI 只產生固定 broker=paper、stage=None、live flags 為 false 的學習鷹架，而且不會執行它。紙上專案產生器沒有金鑰欄、券商連線或 live unlock；「API 資料」頁的唯讀憑證不會被帶進 ZIP。分析結果即使到 tiny_live_validation 也不改變這條邊界。

scaffold 產出的專案預設使用 PaperBroker。即使使用真實券商範本，也必須同時滿足：

分析設定明示 allow_live_trading=true；
階段必須是 tiny_live_validation；
使用者閱讀風險聲明並完成既有雙重確認；
本機程式仍明確開啟 live 常數。

缺少設定、設定解析失敗、階段不符或任何確認不足，都應 fail closed。工具不代填 API 金鑰、不代解除閘門，也不替使用者送出真錢訂單。此外，生成的 main.py 是歷史／示範 K 線 replay；即使前述閘門全通過，偵測到 live broker 仍會退出，避免把歷史訊號一次送成多張真單。真實驗證必須另寫只處理最新已完成 K 線的 runner。

PaperBroker 只做立即成交，沒有掛單佇列：買進限價低於現價、賣出限價高於現價時會拒單且不改動交易狀態；可立即成交的限價單以現價成交，不超過買進上限或低於賣出下限。scaffold 只寫入不存在的專案根目錄或既有空白非連結目錄；已有自訂檔案的非空專案一律拒絕，不提供覆蓋選項。報告輸出同樣會拒絕來源別名、輸出互撞與既有檔。

Pionex 派網現貨 API

anti-gambling-trader scaffold --name pionex_bot --broker pionex \
  --market crypto --symbols "BTC_USDT" --from-analysis my_trades.csv

Pionex 範本依官方 API 文件與官方現貨 OpenAPI 實作簽章、餘額、行情、限價單、市價賣單、查單與撤單骨架。使用時要注意：

官方現貨規格只列 https://api.pionex.com 正式站，沒有列 sandbox／testnet；紙上驗證必須使用本機 PaperBroker，不能以真實 API 小額下單冒充模擬。
先建立只有讀取權限且綁定 IP 白名單的 API key；不要把 key 或 secret 提交到 git。
Pionex 的市價買單要求報價幣金額 amount，但共用 Order.quantity 是標的數量。範本刻意拒絕市價買單，避免把 0.001 BTC 誤送成 0.001 USDT 或反過來。
client_tag 保留給策略理由（可為中文、可重複），不會拿去冒充券商委託 ID；可另填唯一 client_order_id，省略時範本會產生。網路逾時後先用該 ID 查單，不能直接重送。
現貨 balance API 不提供平均成本或真實未實現損益；範本不把它包裝成已驗證績效。成本未知的既有持倉會被標記，生成策略只會 hold，不會拿示範行情自動停損／停利。
撤單後會重新查詢 order 與 fills；「撤單請求被接受」不等於沒有部分成交。
官方限制為 IP 共用 10 weight／秒，私有端點另受帳戶 10 weight／秒限制；收到 HTTP 429 後範本不自動重試，至少冷卻 60 秒。

這仍是待使用者自行接線與驗證的程式腳架，不代表 Pionex、策略或帳戶已通過適合度判定。

10. 建議的新手驗收流程

# 1. 看入口
anti-gambling-trader start

# 2. 記錄每一筆已平倉交易
anti-gambling-trader record --out my_trades.csv

# 3. 累積後先做保守分流
anti-gambling-trader fit-check my_trades.csv

# 4. 再看完整報告
anti-gambling-trader analyze my_trades.csv --full

在做任何真錢決定前，確認：沒有挑單、至少 30 筆、時間與幣別完整、成本已扣、契約乘數正確、規則在樣本外以前已凍結，且你能承受全部驗證資金損失而不影響生活。只要其中一項不確定，就留在紙上模擬。

本工具提供統計分析與教育用途，不構成投資建議。過去績效不代表未來；疑似詐騙時，先停止匯款、保存證據，台灣請撥 165 或向警方查證。

維護者:好棒棒反詐協會 - 免費顧問阿軒割割(社群化名,非立案法人)|內容由 AI 輔助撰寫並經多模型交叉審查(見稽核紀錄)|審閱日期:2026-07|本頁非投資建議,疑似詐騙請撥 165

This site is open source. Improve this page.