Hlola Ngaphambili Ama-Classifiers Okuhweba nge-Calibrain Harness

Yini i-Calibrain Harness?

I-Calibrain Harness iwuhlelo lomthombo ovulekile lokuhlola phambili amamodeli okuhlukanisa asebenza ngesivinini esikhulu. Ixhuma imodeli esekelwayo kudatha yemakethe yama-perpetual futures, ibuze imibuzo engabhalwa ilebula kubha ngayinye evaliwe, iguqule amathuba abuyisiwe abe inani elilindelekile, futhi ngokuzikhethela yenze ukuhweba okufanele ku-Bybit testnet kuphela.

Le phrojekthi ihlanganisa amathuluzi amabili ahlobene: i-bot yokuhweba kanye ne-harness yokuhlola imodeli. Isibikezelo ngasinye siyagcinwa bese siqhathaniswa nomphumela wemakethe kamuva, kuhlanganise nezibikezelo ezingazange zikhiqize ukuhweba. Lokhu kwehlukanisa ikhwalithi yemodeli emiphumeleni yezimali, i-slippage, ukwenziwa, nemithetho yenqubomgomo.

Okubalulekile: I-Calibrain Harness isathuthukiswa ngokuqhubekayo futhi iyisofthiwe yocwaningo, hhayi iseluleko sezezimali. Umsingathi wayo wokuhweba uqondiswe ngokuqinile ku-Bybit testnet, futhi ayikho inkinobho yokushintshela ku-mainnet. Izixhumanisi, izilungiselelo ezizenzakalelayo, namasethi emibuzo kungashintsha phakathi kwama-commit.

Indlela Uhlelo Olusebenza Ngayo

Esikhundleni sokucela imodeli ukuthi iphendule ngokuthi “thenga, thengisa, noma yima,” i-harness ibuza imibuzo engabhalwa ilebula ngendlela enobuqotho kusetshenziswa idatha yentengo yakamuva. Isibonelo esisodwa ukuthi yimuphi umngcele ozothintwa kuqala ngesikhathi esinqunyiwe: i-target enhle noma i-stop embi.

1. Kuqoqwa idatha yomphakathi yemakethe ye-mainnet, izindaba, umongo we-macro, ulwazi lwe-order book, kanye nedatha yama-derivatives.
2. Umakhi wezici udala isimo esifushane esinamalebula amayunithi bese wengeza amanani ayisisekelo omlando ensimbi efanele nobubanzi obufanele.
3. U-Kairos noma u-Jev uthola isimo nemibuzo eyisikhombisa ebhalwe ngezinhlobo futhi engabhalwa ilebula.
4. Impendulo iqinisekiswa ngokuqinile. Impendulo engavumelekile igcinwa njengephutha kunokuba ihunyushwe njengesibikezelo esingesihle.
5. Amathuba emodeli ahlanganiswa namanani ayisisekelo omlando ngesendlalelo sokulinganisa.
6. Inqubomgomo ibala inani elilindelekile ku-R, isebenzise amasango okungena, bese inquma usayizi wengozi.
7. Uma ukuhweba okuzenzakalelayo kunikwe amandla, ama-oda afanele athunyelwa ku-Bybit testnet.
8. Izicelo, izimpendulo, amalebula, ama-run, kanye nokuhweba kugcinwa ku-SQLite ukuze kuhlolwe futhi kubikwe.

Izimpawu namalebula kusebenzisa idatha ye-mainnet ngoba idatha yemakethe ye-testnet ingaba eyokwenziwa noma yehluke. Noma kunjalo, ama-oda abekwa ku-testnet kuphela futhi alinganiswa ngokujula kwe-book etholakalayo kuyo.

Izici Ezibalulekile

Amamodeli Okuhlukanisa Amaningi

I-harness okwamanje isekela i-Kairos, ehlinzekwa yi-DMind nge-Minara Cloud, kanye no-Jev, ohlinzekwa yi-TypeSafe. Kokubili kusebenzisa isitayela esifanayo sezicelo se-System One, isethi yemibuzo, ukuqinisekiswa, inqubomgomo, kanye nomzila wokuhlola.

Izinqumo, izisindo zokulinganisa, ukuhlola, nemibiko kuhlala kuhlukaniswe ngemodeli. Ukushintsha imodeli ebukhoma kuqala i-run entsha futhi kuvunyelwe kuphela uma i-bot ingenayo indawo evulekile, okuvimbela imiphumela yamamodeli ahlukene ukuthi ihlanganiswe.

Itheminali Yesitayela Se-Bloomberg

Itheminali ye-Next.js ithola izibuyekezo ezibukhoma nge-WebSocket eyodwa. Ibonisa amashadi, izimpawu zemodeli, inani elilindelekile elilinganisiwe nelingakalinganiswa, izindawo, ulwazi lwe-akhawunti, i-order book nombono wokujula, amamephu emakethe, izindaba, ama-liquidation, idatha yama-derivatives, kanye ne-decision blotter equkethe zonke izicelo nezimpendulo zemodeli.

Ukulinganisa Nokuhlola Okwakhelwe Ngaphakathi

I-Calibrain Harness ihlanganisa amathuba emodeli namanani ayisisekelo aqondene nensimbi kusetshenziswa ifomula ethi w · model + (1 − w) · base rates. Isisindo siqala ku-0.5 futhi silungiswa kabusha njalo ngemizuzu engu-15 ngemva kokuba umbuzo uqoqe imiphumela okungenani engu-100 ebhalwe amalebula.

Ukuhlola kuhlanganisa amaphuzu e-Brier nawamathuba ahlelwe ngokwezinga, ikhono uma kuqhathaniswa ne-climatology namanani ayisisekelo anikeziwe, i-AUC, ukwethembeka, iphutha elilindelekile lokulinganisa, ukuhlaziywa kwe-probability integral transform, ukuhlelwa kwe-EV, ama-consistency probe, ikhwalithi yokwenziwa, kanye nemiphumela yokuhweba ye-run ngayinye.

Izilawuli Zokwenziwa Kwe-Testnet

Ukungena kusebenzisa ama-oda alinganiselwe e-IOC anomkhawulo ohlobene nentengo ye-testnet ehamba phambili. Ama-target angahlala njengama-limit anciphisa kuphela, kanti ama-stop aphathwayo aqaliswa kusetshenziswa amanani ase-mainnet angenziwa futhi avalwe ngama-oda e-IOC anciphisa kuphela anomkhawulo ku-testnet. Uhlelo luhlanganisa nama-time stop, i-backstop yentengo ye-mark, umkhawulo wokulahlekelwa wansuku zonke, imikhawulo yezindawo, imikhawulo yengozi yephothifoliyo, kanye ne-kill switch.

Izidingo Zokuqala

Ngaphambi kokufaka, lungisa okulandelayo:

• Python 3.12.
• Node.js 20 noma entsha ene-npm.
• Ukhiye we-API we-Kairos ovela ku-Minara Cloud noma ukhiye we-API we-Jev ovela ku-TypeSafe console.
• Izimpawu ze-API ze-Bybit testnet ezivela ku-Bybit testnet API management.

Ukhiye we-Bybit kufanele ube nezimvume ze-Contract zama-oda nezindawo. Unganiki imvume yokukhipha imali.

Faka i-Calibrain Harness

1. Klona I-repository

git clone https://github.com/zadescoxp/calibrain-harness.git
cd calibrain-harness

2. Dala Imvelo Ye-Python

Dala imvelo ebonakalayo ye-Python 3.12, faka ama-dependency, bese ukopisha ukucushwa okuyisibonelo:

python3.12 -m venv .venv
.venv/bin/pip install -r requirements.txt
cp .env.example .env

Faka iziqinisekiso ku-.env, noma uzifake kamuva ngomyalo we-KEYS wetheminali. Uhlelo lufunda okhiye kuleli fayela, elingalandelwa yi-git futhi okulindeleke ukuthi libe nezimvume zomnikazi kuphela. Okhiye abagcinwa ku-database futhi abathunyelwa ngokuphelele kusiphequluli.

3. Yakha I-UI Yetheminali

cd web-next
npm ci
npm run build
cd ..

Lokhu kwakha itheminali emile ku-web-next/out. Isevisi ye-Python inikezela nge-UI, i-API, ne-WebSocket, ngakho akudingeki inqubo ehlukile ye-Node.js yokukhiqiza.

4. Qala Isevisi

.venv/bin/python -m ctb.server

Vula http://127.0.0.1:8800. Iseva ibophela ngaphakathi ku-127.0.0.1 futhi yenqaba ukubhala okuvela kwezinye izizinda.

Uma i-UI ingakakhiwa, leli kheli libonisa ikhasi elifushane eliqukethe umyalo wokwakha. I-API ne-WebSocket ebukhoma ziyaqhubeka nokutholakala.

Lungiselela Imodeli Neziqinisekiso

Khetha i-Kairos noma i-Jev usebenzisa CTB_MODEL_PROVIDER ku-.env:

CTB_MODEL_PROVIDER=kairos
KAIROS_API_KEY=your_kairos_key

Ku-Jev, sebenzisa:

CTB_MODEL_PROVIDER=jev
TYPESAFE_API_KEY=your_typesafe_key
CTB_JEV_MODEL=jev-1.14.0

Imodeli ye-Jev ebhaliwe ibekwe ku-jev-1.14.0, nakuba CTB_JEV_MODEL ingayishintsha. Iziqinisekiso ze-Kairos kumele kube ngezethimba le-Minara Cloud elinikwe amandla yi-Kairos.

Faka iziqinisekiso ze-Bybit testnet usebenzisa amagama eziguquko anikezwe yi-.env.example. Ungalokothi ufake i-.env noma amafayela angaphansi kwe-data/ ku-commit.

Qala Ngemodi Yokubheka Kuphela

I-bot iqala ngaphandle kokufaka ama-oda. Kule modi, iyaqhubeka nokuqoqa idatha yemakethe, ibize imodeli ekhethiwe, irekhode izinqumo, futhi ilebule izibikezelo. Lena indlela enconyiwe yokuqala ngoba ikuvumela uqinisekise ukuxhumana futhi ufunde ukuziphatha kwemodeli ngaphandle kokuvula izikhundla ze-testnet.

1. Qala isevisi ye-Python.
2. Vula itheminali ku-127.0.0.1:8800.
3. Qinisekisa ukuthi idatha yemakethe nezinqumo zemodeli kuyavela.
4. Hlola amaphutha nokubambezeleka ezikrinini ze-LOG ne-EVAL.
5. Vumela i-AUTO-TRADE kuphela lapho ukusethwa kusebenza kahle.

Sebenzisa Itheminali

Izikrini Eziyinhloko

• MON, F1: Ibonisa uhlu lokulandelela, ishadi, omaka bemodeli, i-akhawunti, izikhundla, imephu yemakethe, incwadi yama-oda, izindaba, ama-derivatives, idatha yokugeleza, kanye nerekhodi lezinqumo.
• EVAL, F2: Ibonisa ukulinganisa, okutholakele, ukuhlelwa kwe-EV, amaphuzu emibuzo, ukuhlolwa kokuvumelana, amamethrikhi okusebenza, i-P&L, kanye nekhwalithi yokwenziwa. Imiphumela ingahlungwa ngemodeli, i-run, uphawu, isethi yemibuzo, kanye nesikhathi.
• TRADES, F3: Ibala ama-run nama-trade ngamunye, okuhlanganisa amanani okubhekisela, ama-fill, i-slippage, kanye ne-R eqondile.
• NEWS, F4: Ibonisa izihloko nezibikezelo ze-Kairos news_return. Ukubikezela ukubuyiselwa kwezindaba kutholakala kuphela nge-Kairos.
• LOG, F5: Ibonisa izehlakalo zesistimu namaphutha.

Izibonelo Zomugqa Womyalo

Cindezela u-/ ukuze uvule umugqa womyalo wetheminali. Imiyalo evamile ihlanganisa:

• BTC noma ETH ukulayisha uphawu.
• ASK noma PRB ukubuza imodeli ngokushesha futhi wenze ukuhlolwa kokuvumelana.
• 1M kuya ku-4H ukushintsha isikhathi seshadi.
• TF 5M ukusetha isikhathi sokuhweba.
• UNIV ukukhetha iqoqo lezimpawu.
• POS 10 ukusetha inani eliphezulu lezikhundla.
• KEYS ukuphatha iziqinisekiso.
• HELP ukubonisa usizo lwetheminali.

Ungashintsha phakathi kwe-Kairos ne-Jev nge-MODEL kubha yezinkinobho zemisebenzi. I-bot kumele ingabi nasikhundla ngaphambi kokushintsha.

Vumela Ukuhweba Kwe-Testnet Ngokuqaphela

Ngemva kokubheka izinqumo nokuqinisekisa ukusethwa, sebenzisa i-AUTO-TRADE kubha yomyalo ukuze uvumele ama-oda e-testnet. Imodi eqinile ihweba kuphela lapho izibikezelo ezilinganisiwe zidlula zonke izihlungi ezilungiselelwe, okuhlanganisa inani elilindelekile elincane, ikhwalithi yokusethwa, ukuvumelana kwesiqondiso, ukuvumelana kokusatshalaliswa kwembuyiselo, umehluko wendawo yokuhweba, isimo sesikhundla, kanye nezimvume zohlangothi olufushane.

Imodi yokuhlola ivaliwe ngokuzenzakalela. Ukusetha CTB_EXPLORATION=1 kuvumela isistimu ihwebe ngohlangothi olukhethwe imodeli ngengozi encishisiwe lapho izihlungi eziqinile ziyivimba. Inhloso yayo ukuqoqa idatha yangempela yokwenziwa, hhayi ukusho ukuthi inqubomgomo eqinile ithole inzuzo enhle.

Uketshezi lwe-testnet lungaba luncane kakhulu futhi lungaziphatha ngokuhlukile kune-mainnet. Ukuhlolwa kwangaphambili kwephrojekthi kwathola ukuthi ikhwalithi yokwenziwa ingaba nomthelela omkhulu ku-P&L ye-testnet. Phatha imiphumela ye-testnet njengedatha yocwaningo, hhayi njengobufakazi benzuzo yesikhathi esizayo.

Sebenzisa Iswishi Yokumisa

Inkinobho ye-KILL yetheminali ivala izikhundla ze-bot, ikhansela ama-oda, futhi imisa isistimu. Isenzo esifanayo singaqaliswa kumkhombandlela wephrojekthi:

touch KILL

Izikhundla ezivulwe ngesandla ku-testnet zivame ukuboniswa kodwa aziphathwa yi-bot. Iswishi yokumisa iyona ehlukile ebhaliwe.

Qalisa Ukuhlolwa Nezivivinyo Ezisheshayo

Qalisa ukuhlolwa kwamayunithi ngaphandle kokufinyelela kunethiwekhi:

.venv/bin/python -m pytest -q tests

Thumela isicelo esisodwa sangempela kumodeli esebenzayo bese uqinisekisa impendulo yayo:

.venv/bin/python scripts/kairos_smoke.py SOLUSDT

Khomba i-Jev ngokuqondile:

.venv/bin/python scripts/kairos_smoke.py SOLUSDT --model jev

Hlola indlela yokwenziwa kwe-testnet enosayizi omncane ngokuvula isikhundla eside, uqinisekise i-stop, bese usivala:

.venv/bin/python scripts/testnet_smoke.py SOLUSDT long

Le mibhalo yokuhlola ngokushesha yenza izicelo zangempela zangaphandle, ngakho qinisekisa uphawu olukhethiwe neziqinisekiso ngaphambi kokuyisebenzisa.

Qonda Izinketho Ezibalulekile Zokusetha

Isikhathi Sezinqumo Nezibiyelo

• CTB_DECISION_TF iba ku-5, okusho ukuthi izinqumo zenziwa kuma-bar avaliwe emizuzu emihlanu.
• CTB_HORIZON_BARS iba ku-24, okudala isikhathi samahora amabili esikhathini esizenzakalelayo.
• CTB_ATR_TF iba ku-15 ukuze kubalwe usayizi we-stop.
• CTB_SL_ATR ne-CTB_TP_ATR iba ku-1.5 no-2.5 ATR ngokulandelana.
• CTB_MIN_SL_BP ne-CTB_MAX_SL_BP zibeka ibanga le-stop phakathi kuka-40 no-300 basis points ngokuzenzakalelayo.

Amasango Enqubomgomo Aqine

• CTB_MIN_EDGE_R=0.15 ibeka i-edge encane elinganisiwe ezenzakalelayo.
• CTB_MIN_SETUP_QUALITY=1.5 ilawula umkhawulo wekhwalithi yokusethwa.
• CTB_MIN_DIRECTION_MARGIN=0.03 idinga ukuthi isiqondiso esilinganisiwe sivumelane nohlangothi oluhlongozwayo ngomkhawulo obekiwe.

Imikhawulo Yengozi

• CTB_RISK_PER_TRADE_PCT=0.5 ichaza iphesenti elihlosiwe lemali ye-equity elahleka uma i-stop ish getroffen.
• CTB_MAX_POSITIONS, CTB_MAX_SAME_SIDE, ne-CTB_MAX_OPEN_RISK_PCT zikhawulela ukuvezwa kwephothifoliyo.
• CTB_MAX_LEVERAGE=3 ne-CTB_MAX_NOTIONAL_USDT=5000 zinikeza imikhawulo eqinile ngokuzenzakalelayo.
• CTB_DAILY_LOSS_LIMIT_PCT=3 ibeka umkhawulo wokulahlekelwa wansuku zonke ozenzakalelayo.

Izindleko Nokwenziwa

• CTB_TAKER_FEE_BP=5.5 ne-CTB_SLIPPAGE_BP=2 zifakwa kumodeli yezindleko esetshenziselwa i-value elindelekile namalebula.
• CTB_MAX_ENTRY_SLIP_BP=10 ibeka umkhawulo ozenzakalelayo wentengo yokungena.
• CTB_EXIT_MODE=managed inika amandla inqubo yokuphuma ephethwe echazwe kumadokhumenti.

Shintsha iqembu elilodwa lezilungiselelo ngesikhathi bese uqala i-run entsha lapho uqhathanisa izinqubomgomo. I-run ngayinye igcina isithombe-sikhathi sokucushwa kwayo, okwenza ukuhlaziya kwakamuva kube lula.

Amathiphu Athuthukile Okuhlola

Qhathanisa Imodeli Nezisekelo Zayo

Isibikezelo esibukeka sinenzuzo asisebenzi ngokuzenzakalelayo. Hlola ukuthi imodeli iyayidlula yini i-climatology namazinga ayisisekelo omlando aqondile afakwe kokufakwayo kwayo. Isendlalelo sokulinganisa sinciphisa ithonya lemodeli lapho imiphumela enamalebula ikhombisa ukuthi yengeza ulwazi oluncane.

Hlukanisa Ikhono Lokubikezela Emiphumeleni Yokuhweba

Sebenzisa i-EVAL ukuhlola zonke izinqumo ezinalebula, hhayi ukuhweba kuphela. Amamethrikhi okubikezela alinganisa ikhono lemodeli elinamathuba, kuyilapho i-P&L ye-testnet ilinganisa imiphumela ehlanganisiwe yemodeli, inqubomgomo, izindleko, usayizi wengozi, nokwenziwa.

Cabangela Izinqumo Ezidlulanayo

Amalebula aqala nge-bar yokuqala yomzuzu owodwa ngemva kwesinqumo ngasinye, okuvimbela ukubheka ikusasa. Uma i-bar eyodwa ithinta kokubili i-target ne-stop, ilebula iyibala njenge-stop. Nokho, izinqumo ezilandelanayo zingaba nezikhathi ezidlulanayo, ngakho ukubalwa okungahluziwe kwamasampula kungalinganisa ngokweqile ukuzimela kwezibalo. I-README incoma ukulinda izinqumo ezinamakhulu amaningana anamalebula ngophawu ngalunye ngaphambi kokwenza iziphetho.

Hlola Ukuvumelana

Sebenzisa ama-repeat probe ukukala ukuzimisela okufanayo, nama-mirror probe ukuthola ukuthi ukuguqula izici zemakethe ze-bullish ne-bearish kuyishintsha ngendlela efanele yini impendulo yemodeli. Futhi hlola ukuhambisana phakathi kwe-long ne-short esikhundleni sokuthembela kumethrikhi eyodwa ezimele.

Khipha Imibiko

Kusuka ku-EVAL, sebenzisa EXPORT MINARA REPORT ukuze ubhale umbiko we-Markdown oqukethe imiphumela yokuhlola. Hlunga ngemodeli, i-run, uphawu, iqoqo lemibuzo, noma isikhathi ngaphambi kokuhumusha ukuqhathanisa.

Phatha Izimpawu Nama-run

Umyalo we-UNIV ubala ama-USDT perpetual afinyelela kwangu-100 aphezulu ngokwenzuzo yokuhweba futhi anohlu lwe-testnet. Uhlanganisa ulwazi lokujula ne-spread futhi umaka ama-book amancane kanye nama-perpetual esitoko noma ezimpahla. Ungakhetha izimpawu ezingafika ku-30, ngokuya ngesabelomali sezicelo zemodeli. Isevisi iyaziqalisa kabusha ukuze isebenzise ushintsho lwe-universe.

Isinqumo ngasinye nokuhweba ngakunye kwabelwa i-run esebenzayo. Ukuze udale i-run ngohlelo, thumela POST /api/runs/start lapho kungekho trade evulekile ye-bot. Ukuqala ama-run ahlukene kuyasiza lapho ushintsha amamodeli, imibuzo, imithetho yengozi, noma izilungiselelo zokwenziwa.

Sebenza Ku-UI

Ngemva kokudonsa izinguquko noma ukuhlela i-frontend, yakha kabusha i-static export:

cd web-next && npm run build

Layisha kabusha isiphequluli ngemva kwalokho; iseva ye-Python ayidingi ukuqalwa kabusha.

Ukuze uthuthukise nge-live reload, gcina iseva ye-Python isebenza bese uqala i-Next.js ngokuhlukile:

cd web-next && npm run dev

Vula http://localhost:3000. I-UI yokuthuthukisa ixhumana ne-API ne-WebSocket ku-127.0.0.1:8800.

Hlola uhlobo lwe-frontend nge:

cd web-next && npx tsc --noEmit

Ukuphepha Nezinqubo Zokusebenza

• Qinisekisa ukuthi i-host isalokhu iyi-api-testnet.bybit.com; iphrojekthi ayinikezi ngamabomu iswishi yokuhweba ku-mainnet.
• Qala ngemodi yokubuka kuphela bese ubuyekeza amaphutha emodeli ngaphambi kokunika amandla ama-oda e-testnet.
• Sebenzisa imininingwane ye-Bybit engenayo imvume yokukhipha imali.
• Gcina i-.env kanye nomkhombandlela we-data/ ngaphandle kwe-version control.
• Qapha umehluko wendawo yokuhweba, izilinganiso zokugcwaliswa, i-latency, i-slippage, nezizathu zokuphuma esikhundleni sokucabangela i-P&L kuphela.
• Gcina inqubo ye-kill-switch itholakala ngaphambi kokuhlola ukwenziwa.
• Qalisa izivivinyo ze-Python nokuhlolwa kohlobo lwe-frontend ngaphambi kokuthumela izinguquko.

Isiphetho

I-Calibrain Harness inikeza indlela ehlelekile yokuthola ukuthi imodeli yokuhlukanisa esheshayo yengeza yini ulwazi olulinganisekayo ezibikezelweni zemakethe yama-perpetual. Ihlanganisa imibuzo enenhloso, amazinga ayisisekelo omlando, ukulinganisa kwamathuba, ukuqinisekiswa okuqinile, ukwenziwa kwe-testnet, nokuhlola okuningiliziwe kutheminali eyodwa yasendaweni.

Qala ngokufaka isevisi, ulungiselele i-Kairos noma i-Jev, bese uqoqe izinqumo zokubuka kuphela. Uma idatha nepayiphi yokwakha imodeli sekuzinzile, hlola ukwenziwa ngokucophelela ku-testnet ye-Bybit, gcina izivivinyo zihlukene, bese uhlola imodeli ngokuqhathanisa nezisekelo zayo kusampula ebanzi, kunokuthembela ku-P&L yesikhathi esifushane.