QuantPilot 完整操作手冊
繁體中文 · 說明書更新：2026-09-28 · 手冊版次：20260928-direct1 · 適用程式／授權版本：20260927-device1。
本次只補文件，不更改交易策略。Mac 與 Windows 下載包都附本手冊及英文版；雙擊最外層的 START_HERE.html 即可選語言。手冊離線可閱讀，連結及交易程式需要網路。
01｜先知道這六件事
- 這是需要 Python 的程式包，不是免安裝的 .app 或 .exe；首次執行還會下載必要套件。
- 1600 USDT 是軟體費，不是交易本金。一份授權限一台電腦，永久使用已購版本，不代表終身更新、獲利保證或代客操作。
- 本版的自動交易只支援 BingX BTC-USDT 永續。Binance、Bybit 可新增 API 並查帳，不會由此策略自動下單。
- 模擬用虛擬資金、真實行情；不是交易所測試網。模擬結果不等於真實成交、可提領收益或未來績效。
- 「停止開倉」不等於平掉已有部位。關閉電腦會中斷本機監測；先到交易所確認持倉與保護單，不要把關閉視窗當作止損。
- 不要把 API Secret、私人授權碼、錢包助記詞或私鑰傳給維護窗口。發生不明扣款或部位異常，先在交易所檢查並限制金鑰權限。
02｜付款、驗證、下載
- 開啟付款與下載，不需要註冊帳戶或建立訂單。
- 核對收款地址及 QR Code，以 TRON（TRC20） 支付固定 1,600 USDT。手續費另付，確保實收金額完整。
- 貼上 64 位鏈上交易單號（TXID），閱讀並勾選授權／退款條款，按「驗證付款」。
- 驗證成功後，直接按「下載 Mac」或「下載 Windows」。
- 按「保存授權碼」，保管驗證成功後出現的私人 QP- 授權碼，供重新下載及啟用電腦使用。
- 完整解壓縮 ZIP，先開 START_HERE.html，再啟動程式，從模擬交易開始。
QR Code 只包含地址，不含付款金額，兩者都要自行核對。可以直接從交易所或自己的錢包付款，不再要求錢包文字簽名驗證。
03｜私人授權碼與重新下載
付款驗證成功後會顯示私人 QP- 授權碼。按「保存授權碼」，將文字檔放在私人位置；不要分享。此碼不由 Email 或維護窗口寄發，也不是錢包私鑰或交易所 Secret。
再次下載或換瀏覽器時，開啟付款頁下方「已付款，要重新下載？」，輸入保存的私人授權碼即可。前台沒有登入或訂單畫面。若遺失，先保留仍可使用的瀏覽器，聯絡 QuantPilot090@gmail.com 進行核對；單憑公開 TXID 無法重新取得私人授權碼。
TXID 是公開資料。本簡化流程只核對款項到帳，不驗證付款人身分，由首次成功核對的提交者取得授權。 不要任意分享付款單號；若遭他人搶先兌換，聯絡維護窗口人工查核，不要再付款。
04｜付款驗證核對什麼
伺服器讀取 TRON 主網最終確認資料，核對真正的 USDT、收款地址、固定實收 1,600 USDT、支援的付款時間及單號是否已兌換。付款截圖或交易所內部提領編號不能取代鏈上 TXID。
| 畫面狀態 | 要做什麼 |
|---|---|
| 尚待鏈上確認 | 等待後再按「驗證付款」，不要再付款。 |
| 連線暫時不可用／查詢太頻繁 | 稍後重試；頻率限制通常一分鐘後可再查。 |
| 少付、多付、錯幣或錯地址 | 保留 TXID 聯絡 QuantPilot090@gmail.com，不要自行拆單補款。 |
| 付款早於新版驗證功能 | 聯絡維護窗口依原流程核對，不要重複付款。 |
| 單號已兌換 | 用保存的私人授權碼「重新下載」；非本人兌換請聯絡維護窗口。 |
| 付款驗證成功 | 當頁顯示 Mac／Windows 下載按鈕，請保存私人授權碼。 |
通知在當頁顯示，目前沒有 Email、簡訊、Telegram 成功推播，也不會在關頁後背景查帳。鏈上確認不等同收款交易所已將充值開放提領；下載不會自行啟動交易。
05｜安裝前準備與 Mac 啟動
準備自己的 Mac、穩定網路、可寫入資料夾及 Python 3.11、3.12 或 3.13。本版支援範圍不包含其他 Python 版本；若電腦只有 3.14，請另裝支援版本，不要刪除系統 Python。從 Python 官方下載 安裝，避免第三方安裝包。
- 下載 macOS ZIP，完整解壓縮。第一次使用可放「文件／QuantPilot」；往後不要隨意搬移。
- 先雙擊 START_HERE.html 看手冊，再雙擊 Start-macOS.command。
- 首次建立 .venv 並安裝套件，依網速需要等待；終端機有進度不代表故障，不要連續開很多次。
- 預設瀏覽器會在伺服器就緒後開啟。正常網址通常是 http://127.0.0.1:8765/，被占用時會改用鄰近空閒埠，以終端機顯示為準。
- 保留終端機視窗，看到程式頁面後按下節啟用授權。
如果 Finder 無法雙擊，在該解壓縮資料夾開啟終端機，執行 zsh Start-macOS.command。本版沒有 Apple 簽章／公證；先確認來源及版本，不要關閉整體系統安全保護，也不要照不明網頁指令解除所有檔案檢查。無法確認時停止並聯絡維護窗口。
如果網頁顯示無法連線，先看終端機是否仍在安裝或已出現錯誤，再使用它顯示的完整網址。不要把本機 127.0.0.1 網址當成可以在手機或另一台電腦開啟的網站。
06｜Windows 安裝與啟動
本包目標為 Windows 10／11。說明不等同所有 Windows 組合的驗收保證；用戶曾回報另一台 Windows 可開啟，開發端沒有完成 Windows 實機全流程測試。
- 從 Python 官方安裝 3.11–3.13，安裝時勾選 Add python.exe to PATH。重新開啟終端機，以
py -3 --version或python --version確認可用版本。 - ZIP 右鍵「全部解壓縮」，放到自己的文件或桌面資料夾。不要直接在 ZIP、Program Files、只讀磁碟或仍同步中的雲端目錄執行。
- 雙擊 Start-Windows.cmd；若檔案總管隱藏副檔名，先打開「副檔名」顯示，避免誤開其他檔。
- 首次自動建立自己的 .venv 並安裝套件；不要把 Mac 的 .venv 複製過來。
- 瀏覽器就緒後打開本機頁面，保留命令提示字元視窗。
若出現找不到 Python，重新安裝支援版本並確認 PATH；不要下載來路不明的 python.exe。若防毒、SmartScreen 或公司政策阻擋，先向維護窗口或資訊人員核對來源，不要全面關閉防護。本機服務只需在電腦上使用，不必開放路由器埠、公開網路入站或系統管理員權限。
07｜登入程式並啟用這台電腦
圖 2：乾淨包在 Mac 的實際介面；無金鑰、無真實倉位、未啟用交易。Windows 使用同一瀏覽器介面，但啟動器及安全儲存方式不同。
- 找「使用者登入」，按「登入」。
- 網站開啟「付款與下載」。如有需要，於下方「重新下載」輸入保存的私人授權碼；核對網站代碼和桌面程式一致。
- 只有自己發起且代碼相符時，才按「確認是我的電腦」。
- 返回程式，按「查看永久授權」。
- 在已購授權旁按「啟用這台電腦」。看到已啟用才繼續。
未啟用時不能開始新增交易或操作資金。網站私人授權碼、桌面短期連線編號、交易所 API Key／Secret，是三種不同資料，不能混用。
一份授權只能綁定一台電腦；複製授權檔到另一台無效。程式只回傳電腦識別的雜湊，不回傳原始硬體序號。已啟用的已購版本不要求網站一直登入；市場資料仍需網路。桌面網站連線登入約最多一小時，重啟需重新登入雲端功能，不代表永久授權到期。更換電腦、重灌導致識別改變或遺失授權檔，聯絡 QuantPilot090@gmail.com，沒有自行解除綁定按鈕。
08｜申請 API：只開需要的權限
API 是讓程式連接你交易所帳戶的通行證，不是付款網站授權碼。純模擬行情不需要放入真實交易金鑰。想查餘額才建立唯讀金鑰；只有要自行啟用 BingX 實盤時才另外開永續交易權限。
以下是本程式用途對照，不代表替你檢查交易所帳戶是否符合資格。所在地、KYC、帳戶類型及交易所政策均以官方為準。不要用 VPN 或其他方法繞過資格限制。
| 用途 | 需要的存取 | 不需要 |
|---|---|---|
| 本機模擬 | 公開行情，不需真實 API | 交易、提領、劃轉 |
| BingX／Binance／Bybit 查帳 | 對應帳戶唯讀查詢 | 提領、交易、子帳戶管理 |
| BingX BTC-USDT 永續自動交易 | 查帳、持倉／委託查詢及永續合約交易 | 提領、現貨交易、P2P、子帳戶管理 |
| 後台驗證 | 建議另一組唯讀 API，且明確同意回傳 | 交易及資金權限 |
BingX
到 官方 API 管理，從使用者中心進入 API Management，建立專用 Key 並完成當前要求的安全驗證。官方文件說明新建 Key 預設唯讀，其他操作需額外權限。保存 API Key／Secret；不要全選權限。實盤需要的永續權限以頁面實際名稱為準。設定自己實際使用的可信任公網 IP；不要照抄別人的 IP 或為連線成功關閉 IP 保護。參考 BingX 官方 API 認證說明。
Binance
網頁進入帳戶的 API Management → Create API；本程式使用 Key／Secret，選 System-generated（HMAC），不是 RSA／Ed25519。完成驗證後保管 Secret。本版只查帳，保留 Enable Reading，不需要開現貨、合約或提領權限。手機入口可在 Binance Pro → More → API Management 找到。參考附官方畫面的 Binance API 建立教學。
Bybit
使用 官方網頁 API Management 建立 Key；官方說明 App 不提供建立 API，手機可改用網頁。選可提供 API Key／Secret 的系統產生類型，使用唯讀及必要帳戶查詢項目；此程式不執行 Bybit 交易。剛註冊的帳戶可能暫時不能建立。參考附官方畫面的 Bybit 建立教學。
交易所畫面會改版，上述官方連結提供其現行示意圖；本手冊不放真人帳戶或任何可掃描的金鑰 QR Code。Secret 若沒保存且不能再次顯示，需在交易所依流程重建，不可能靠遮罩圓點還原。先確認舊 Key 是否正服務既有持倉，再處理撤銷及替換。
09｜在程式保存與驗證 API
- 展開「01 · API 帳戶」下的「新增一組 API」。
- 選正確交易所，取一個自己辨識得出的帳戶名稱。
- 分別貼入 API Key 與 Secret Key，不能貼反、含空白或換行；不要貼進維護窗口聊天室。
- 按「保存至系統安全儲存區」。程式會開始驗證，頁面顯示已儲存組數。
- 在「已儲存的 API」選帳戶，按「驗證連線／讀取餘額」，檢查查詢時間、可用餘額與各子帳戶狀態。
- 若未來自行使用 BingX 實盤，才將對應帳戶「設為策略帳戶」。切換前程式會檢查持倉、掛單和查詢結果；已有部位或資料不足時會拒絕。
金鑰存於 Mac 鑰匙圈／Windows Credential Locker，不會回填到輸入框。「已保存」只代表本機儲存完成，不等於交易所驗證成功；唯讀驗證成功也不等於已實測下單。現貨有錢不代表永續有可用 USDT，不能把兩者相加當作下單額度。
10｜模擬交易與低／中／高方案
新下載包的本金是 0，沒有舊交易，模擬與實盤都停止。欄位預填 100000 只是建議輸入，不是已經入帳。
- 完成電腦授權後，在「02 · 模式與方案」選「模擬交易」。
- 輸入 1–1,000,000 USDT、最多兩位小數的模擬本金。
- 若有舊模擬資料，先確認需要重設；按「套用本金並清空紀錄」會備份後清除模擬持倉、結果與路徑。完成後不自動開始。
- 選低、中或高風險，再按「套用設定」。
- 確認「下一筆」預估保證金、槓桿及 TP／SL，再按「啟動模擬交易」。
- 看狀態是否執行中、行情更新時間、阻擋原因及交易紀錄；有訊號仍需全部必要檢查通過。
| 方案 | 槓桿 | 每筆保證金占餘額 | 模型門檻 | 停利 ROE | 停損 ROE | 冷卻 |
|---|---|---|---|---|---|---|
| 低 | 2 倍 | 1% | 85 分 | +10% | -5% | 15 分鐘 |
| 中 | 5 倍 | 3% | 80 分 | +15% | -5% | 10 分鐘 |
| 高 | 20 倍 | 10% | 75 分 | +25% | -4.5% | 5 分鐘 |
方案是本程式預設，不是交易所提供或保證安全的級別。共同條件包括交易品質至少 85、必要風控和成交量通過、同方向連續確認 3 次；已有持倉不再加開。判多做多、判空做空，非反向交易。分數不是勝率，也不是把所有燈點亮才下單。
例如模擬本金 100000、高方案第一筆保證金約 10000 USDT，20 倍名義倉位約 200000 USDT；保證金不是成交總額。後續隨已實現餘額調整，還要符合數量精度與最小下單規則。若新餘額改變但沒有新交易，已實現餘額不會因每次行情跳動而變動。
11｜看懂畫面、損益與指標
圖 3：隔離啟動時的真實市場介面，價格只代表擷取當下，不是獲利案例。資料不足可能顯示等待或無資料，不應被當作 0 值訊號。
| 區塊／欄位 | 如何閱讀 |
|---|---|
| 行情 K 線 | 按 1s、5s、15s、1m…1D 切週期；滑鼠十字線看開高低收及成交量。秒級線由收到的逐筆資料累積，不保證歷史每秒都有成交。 |
| 指標按鈕 | VWAP、MA、EMA、BOLL、RSI、MACD、ATR 可切換顯示；切換畫面指標不會更改策略規則。 |
| Mark／Index／Funding | 標記價、指數價、資金費率；不是所有欄位每秒更新，也不是你的實際成交價格。 |
| OI、深度、主動買賣、CVD | 未平倉量、委託深度、成交方向及其淨差；CVD 為畫面標示窗口，不是全市場終身累積。 |
| Long／Short Ratio | 本版取得不到時明示無資料，不以假數值替代。 |
| 多空條件燈 | 綠是多頭條件、紅是空頭條件；各模型權重不同，不可只數亮燈顆數比較分數。 |
| 已實現餘額 | 平倉後才結算的模擬金額。 |
| 預估淨權益 | 以目前平倉估計，加上未實現淨損益；會隨行情變動。 |
| 每筆持倉 | 方向、模型與分數、數量、保證金、名義倉位、進場價、停利停損、毛損益、估計費用及淨損益。 |
| 實盤帳戶 | 所選 API 帳戶查回的真實餘額與持倉，不等於模擬資金。 |
| 交易紀錄／日誌 | 查看開倉、平倉、錯誤時間；「已送出」不等於交易所確定完全成交。 |
ROE 約為毛損益 ÷ 保證金 × 100%。價格變動百分比與 ROE 不同：20 倍時，價格有利變動約 1.25% 對應毛 ROE +25%，不代表帳戶總餘額增加 25%。交易方向、滑價及費用都會改變實際結果。
VWAP 是成交量加權均價；MA／EMA 是均線；RSI 是相對強弱；MACD 看均線動能差；BOLL 為布林通道；ATR 反映波動幅度；OI 是未平倉量（不是 IO）。它們不是單獨可靠的買賣保證。
停利停損為未扣費 ROE。模擬淨損益扣進出場費用，未取得帳戶實際費率時使用明示估計；目前不計 40% 返現，也沒有完整模擬資金費入帳、保證金清算和所有真實市場衝擊。最佳化結果只是已收集路徑的估計，不能作為預期報酬承諾。
12｜實盤、停止開倉與資金劃轉
先確認交易所資格、最小下單額、帳戶模式、API 權限、可用 USDT、費率、持倉與保護委託。不要使用無法承受損失的資金。此手冊說明按鈕，並非建議你啟用或選擇特定槓桿。
需要自行實盤時，選已驗證 BingX 策略帳戶，切「真實交易」，選方案並「套用設定」，再次確認後才按「啟動真實自動交易」。切換模式不自動平掉舊倉，重啟也不會自動啟動實盤。最低金額與數量不是固定的「1 USDT 一定能開」，以交易所當時規則為準。
「停止開倉」只是阻止新單；程式還在執行時，既有部位維持原有管理。計畫退出時先到 BingX 確認實際持倉、掛單與 TP／SL；如需平倉由你自行決定。程式無法在斷網、休眠、關機時保證本機出場條件持續執行。
「帳戶劃轉」會真的移動所選帳戶資金，不是模擬入金；測試模擬不需要它。若自行使用，選來源／目的帳戶、金額，再核對確認視窗。無對應權限時使用交易所官方操作，不要為修復查帳錯誤而擴大權限。顯示逾時時先到交易所查看紀錄，不能直接重按而造成重複劃轉。本次手冊製作未進行任何真實交易或劃轉。
13｜雲端 API 驗證與資料回傳
本機保存金鑰、確認電腦授權、同意回傳，是三個分開的動作。付款驗證不會把交易所金鑰交出去。
- 在「使用者登入」登入；「API 驗證」選明確的一組 API。
- 閱讀「資料回傳」同意文字；建議選另一組唯讀金鑰，不要用高權限交易 Key 為查帳增加風險。
- 自行勾選後按「驗證並回傳」。
- 檢查「後台已保存」及「唯讀驗證成功／部分查詢成功／失敗」兩種不同狀態。
選定的 API Key、Secret 與必要帳戶名稱會經 HTTPS 傳至 trade-admin.richcome9898.shop，加密存放；管理員可查看驗證結果、權限、餘額。畫面不提供明文 Key，但這仍屬將憑證交由伺服器保存，不等於完全只留本機。沒有同意不會上傳；不回傳本機交易紀錄、行情或日誌。登出不會刪除已回傳資料，需要資料處理請聯絡維護窗口。
本機與 Cloudflare 出站 IP 不同，本機成功不代表雲端也能連線。不要為雲端失敗取消交易金鑰 IP 白名單；無合適固定 IP 時先保留本機用途並聯絡維護窗口。
14｜資料備份、更新與再次下載
- 使用資料放在解壓縮資料夾的 data/；金鑰在系統安全儲存區，不在一般設定文字檔。
- 模擬重設的備份位於 data/paper_archives/。不要只刪除資料庫其中一個檔案，也不要在程式寫入時搬走 data/。
- 先停止新增交易，確認真實帳戶持倉與保護，再關閉程式後備份自己的整個資料夾。備份含帳戶識別及交易資料，不能公開分享。
- 搬移資料夾會改變金鑰儲存識別，可能須重輸入 API；不要把已用過的資料夾交給其他客戶。
- 本次為手冊更新，軟體與授權版本仍是 20260927-device1。已啟用客戶只要複製新 docs/、START_HERE.html 及兩份 README 即可，不要覆蓋原 data/、授權檔或其他使用資料。
- 日後不同軟體版本的授權相容性以該次發布說明為準；不要因本次文件相容就推論所有未來版本都免費或可直接覆蓋。
- 再次下載到付款頁，於「重新下載」輸入已保存的私人授權碼，不要再次付款。下載授權不會讓第二台電腦同時使用同一份授權。
15｜常見問題排除
| 問題 | 安全處理順序 |
|---|---|
| 找不到 Python／啟動即關閉 | 檢查支援版本與 PATH，從終端機執行啟動器查看訊息；保留錯誤文字，不用系統管理員亂改權限。 |
| 套件安裝失敗 | 檢查網路、磁碟空間、公司代理設定，再執行同一啟動器；不要安裝不明修復工具。 |
| 瀏覽器無法連線 | 確認終端機仍執行；等安裝完成，使用其顯示的埠號，不要固定猜 8000。 |
| unable to open database file | 完整解壓到可寫入位置，確認空間與權限；關閉程式後先備份，不刪資料庫重試。 |
| API Invalid Key／簽名失敗 | 核對交易所、Key/Secret 配對、正式站金鑰、系統時間及 IP 限制；不要貼密鑰給維護窗口。 |
| 系統安全儲存區失敗 | 確認自己的作業系統帳戶可用，查看鑰匙圈／Credential Locker；不改用明文檔案存 Key。 |
| 已保存但沒有餘額 | 按驗證連線，查看現貨／永續個別結果；0 和查詢失敗不同。 |
| 有資金但不能開單 | 查看帳戶類別、可用資金、最小數量／金額、精度、槓桿與權限；不要單純加大槓桿。 |
| 分數達標還不開單 | 檢查品質、成交量、資料是否新鮮、價差／滑價、冷卻、連續確認、既有持倉與授權。 |
| K 線不動 | 看時間戳、連線狀態及終端機，先重新整理頁面；重啟前先確認真實持倉，不連續啟動多份。 |
| 模擬餘額不變 | 無平倉時已實現餘額不變，改看淨權益與未實現損益；也確認本金已套用且模擬啟動。 |
| 超過 TP／SL 還沒平倉 | 區分畫面指標價、可成交價、毛 ROE 與扣費結果；實盤立刻查交易所持倉及委託，不假定一定安全。 |
| 沒看到 Windows／macOS 下載 | 回付款頁用保存的私人授權碼恢復下載；未驗證成功請核對 TXID。 |
| 付款後仍等待 | 回付款頁重新按「驗證付款」核對 TXID；金額等不符時聯絡維護窗口，不重複付款。 |
| 授權被其他電腦使用 | 核對是否換電腦／重灌，聯絡維護窗口；不要手改或刪除授權綁定。 |
| 關閉頁面後沒有通知 | 本版只有站內提示，沒有 Email／簡訊推播，回付款頁驗證或恢復下載。 |
16｜售後條款與問題回報
公司 Email：QuantPilot090@gmail.com。經營者：QuantPilot科技股份有限公司；地址：101 S San Fernando St, San Jose, CA 95113, United States；電話：+1 (201) 913-4284。
本文件不取代購買契約。現行售後條款包含已購版本 12 個月錯誤修正／安全更新及指定支援、一般案件 2 個服務日內首次回覆，以及交付次日起 7 日內書面退款申請等；完整適用條件以 授權與售後條款 和購買時保存的條款為準，法定權利不受影響。維護窗口不提供代操或獲利保證。
回報時提供：程式版本、Mac／Windows 版本、發生時間與時區、做到哪一步、完整錯誤文字、已嘗試方法。付款問題另附 TXID、金額／網路；這些資料透過指定維護窗口私訊，不要公開貼出。截圖先遮住私人授權碼、API Key／Secret、錢包 QR Code、驗證碼及不相關資產資訊。不要傳整個 data/ 或系統鑰匙圈。
17｜資料來源與驗證範圍
按鈕、風險方案、費用與檔案行為依交付版原始程式核對；網頁依 2026-09-28 已部署介面。API 設定參考本手冊第 08 節的官方文件；交易所可能調整畫面和權限，遇到差異以官方說明為準。
本手冊截圖來自不含客戶憑證的隔離介面，不冒充真人付款、交易績效、Windows 原生畫面或已驗證實盤。測試採模擬付款與自動化驗證；未代客送出真實交易或匯款。Windows 部分只有既有用戶回報及靜態／自動化檢查，不宣稱完成所有電腦的實機驗收。