INSTALL FAQ
安裝 FAQ 與故障排除
本頁整理收到產品包後最常見的安裝問題。請先依序完成 Google Drive 下載、machine fingerprint 回傳、license.json 放入產品資料夾，再執行 install.bat。API 相關方案請勿開啟提款權限，建議先用 demo mode / 模擬盤測試。
一、安裝前先檢查
請安裝 Python 3.11，並確認 Windows 可以找到 Python。
請先完整解壓縮 .zip，不要直接在壓縮檔裡執行 install.bat。
請把 ofc 寄給你的 license.json 放在產品資料夾內，不要改檔名。
需要 API 的方案只需讀取與交易權限，請不要開啟提款權限。
二、常見安裝錯誤
出現「Python 3.11 not found」怎麼辦？
代表 Windows 找不到 Python 3.11。請先到 python.org 安裝 Python 3.11，安裝時勾選「Add python.exe to PATH」。安裝後重新開啟終端機，再檢查：
py -3.11 --version
python --version如果電腦同時有多個 Python 版本，請優先確認 `py -3.11` 可以正常執行。仍失敗時，重新安裝 Python 3.11 並勾選 PATH。
install.bat 點兩下閃退，看不到錯誤訊息
請不要直接雙擊。改成在產品資料夾空白處按右鍵，選「在終端機中開啟」，再輸入：
install.bat這樣錯誤訊息會留在畫面上。請截圖或複製最後 20 行錯誤訊息寄給 ofc。
pip install 失敗或套件安裝失敗
常見原因是網路、權限、Python 版本或 pip 太舊。請先確認 Python 3.11 正常，再嘗試：
py -3.11 -m pip install --upgrade pip如果公司、學校或防毒軟體擋住下載，請換網路或暫時允許 Python / pip 連線。
Windows 跳出「已保護您的電腦」或封鎖 install.bat
這通常是 Windows SmartScreen 或防毒軟體對未知批次檔的提醒。請確認檔案是從 ofc 提供的 Google Drive 下載，並先掃描檔案。若你信任來源，可選「其他資訊」後再執行，或把產品資料夾加入允許清單。
license.json 驗證失敗
請檢查三件事：檔名必須是 license.json、檔案要放在產品資料夾內、不要用文字編輯器修改內容。license.json 綁定 machine fingerprint，若你換電腦、重灌系統或回傳錯 fingerprint，授權會失敗。
machine fingerprint 要怎麼回傳？
先從 ofc 共用的 Google Drive 下載 get fingerprint 工具，執行後複製 machine fingerprint，使用購買時留下的 Gmail 回傳給 ofc。ofc 確認後會寄送已簽章的 license.json。
下載產品包後，找不到 install.bat
請確認 .zip 已完整解壓縮。Windows 有時會把檔案副檔名隱藏，請開啟檔案總管的「副檔名」顯示。若仍找不到，請確認你下載的是方案產品包，不是 fingerprint 工具。
桌面沒有出現 Trading 捷徑
捷徑只是方便啟動，不影響產品本身。你可以直接進產品資料夾執行 start_dashboard.bat。如果 start_dashboard.bat 可以啟動，代表產品本身已安裝成功。
打開後瀏覽器沒有自動出現頁面
請先看終端機是否有顯示 localhost 或 127.0.0.1 網址。若有，手動複製網址到瀏覽器。若沒有，請把終端機錯誤截圖寄給 ofc。
顯示 port already in use / 連接埠被占用
代表同一個 dashboard 可能已經開著，或其他程式占用同一個 port。請先關閉舊的終端機視窗與瀏覽器分頁，再重新執行 start_dashboard.bat。仍失敗時請把錯誤訊息寄給 ofc。
產品放在 OneDrive、桌面或中文路徑會有問題嗎？
大多數情況可以使用，但如果遇到奇怪的權限或路徑錯誤，建議先把產品資料夾移到簡單路徑，例如 C:\Trading\ofc，再重新執行 install.bat。路徑中避免特殊符號會比較穩。
Google Drive 下載後被瀏覽器或防毒軟體提醒
請確認檔案來源是 ofc 提供的共用連結，並先進行防毒掃描。如果檔案被瀏覽器阻擋，可嘗試重新下載或改用 Google Drive 網頁下載。不要下載來路不明的轉傳檔。
三、OKX API 與安全設定
需要填 OKX 密碼嗎？
不需要。ofc 不會要求你的 OKX 登入密碼、助記詞或提款權限。API 相關方案只需要你自行建立 API Key、Secret、Passphrase，並依方案功能填入本機 .env。
API 權限要怎麼開？
原則是最小權限：只開讀取與交易所需權限，不開提款權限。第一次使用請先保持 demo mode / 模擬盤，確認 API、帳戶模式、槓桿、風控與執行流程都正確。
.env 填錯會怎樣？
常見會出現 API 驗證失敗、passphrase 錯誤、帳戶模式不符或無法讀取帳戶資訊。請確認 API Key、Secret、Passphrase 沒有多空格，並確認 demo / real 模式與 OKX 後台一致。
demo mode 正常，real mode 不正常
請先不要急著真實執行。檢查 OKX API 權限、帳戶模式、IP 限制、交易產品權限與槓桿設定。若不確定，請回到 demo mode，並把錯誤訊息寄給 ofc。
四、回報問題時請附上
請寄到：ofc.ai.trading@gmail.com
- 購買或申請 Alpha 使用的 Gmail / Email。
- 你購買或測試的方案名稱。
- 錯誤截圖，或終端機最後 20 行錯誤訊息。
- 你目前做到哪一步：fingerprint、license、install.bat、start_dashboard.bat、API 設定或 dashboard 啟動。
- 不要寄 OKX 密碼、助記詞、提款權限或完整信用卡資料。