Isifundo se-ccodex-sleep-state: Lawula i-Codex ngokubonakalayo, lungisa i-proxy futhi uxazulule izinkinga zokuxhumana

Isifinyezo sephrojekthi

ccodex-sleep-state iyithuluzi lendawo elibhalwe nge-Go, elihloselwe ukuthuthukisa izinkinga ezingavela ngesikhathi sokusebenzisa i-Codex, njengokushintsha kwekhwalithi yezimpendulo, ukuvinjelwa kwezicelo, ukwehluleka kokuxhumeka nokungqubuzana kokucushwa. Lihlanganisa ukuphathwa kokuxhumeka, izindlela zokuphuma zommeleli, ukuqoqwa kwe-turn-state, ukuphathwa kokucushwa nokuxilongwa kwamaphutha kube isevisi eyodwa yasendaweni nephaneli yewebhu, ngaleyo ndlela kuncishiswe isidingo sokuhlela amafayela okucushwa ngesandla.

Kubalulekile ukucacisa kusenesikhathi: leli thuluzialikhulisi isabelo se-akhawunti, futhi alikwazi ukuqinisekisa ukuthi ikhwalithi yemodeli izobuyela esimweni sangaphambilini ngemva kokushintsha indlela yokuphuma. Libhekana nokuxhumeka, ukucushwa kanye ne-X-Codex-Turn-State ezimpendulweni, ukuze imiphumela yokuqoqwa, isimo sokufakwa, indlela yezicelo nezimbangela zamaphutha kube lula ukukuhlola.

Le phrojekthi isenguqulo yokuhlola esesidlangalaleni. Izici zingahluka phakathi kwama-Release ahlukene; landela amanothi okukhishwa enguqulo oyilandile. Ukuphumelela kokuhlolwa kwamanye amamodeli noma kwezinye izinqubo zokucindezela akusho ukuthi zonke izimo sezamukelwe.

Izici eziyinhloko

• Iphaneli yewebhu yasendaweni: Buka ukuthi i-Codex isiphathwa yini, ukuthi izicelo zidlula kusevisi yini, isimo seseshini nenani lezicelo.
• Ukuqoqwa nokufakwa kwe-turn-state: Thumela izicelo ezimfushane ezindaweni zokuphuma ezingaba khona, uhlole i-state ekuphenduleni, bese uyisebenzisa ezicelweni ezilandelayo ngokwemithetho.
• Izindlela eziningi zokuqinisekisa: Phatha ngokwehlukana ukungena ngemvume kwe-ChatGPT esemthethweni, i-OpenAI API key esemthethweni, kanye ne-Responses relay noma i-CCS API key.
• Ukuhlukaniswa kwamamodeli: Sekela gpt-6-astra, gpt-5.6-sol kanye gpt-5.6-terra; i-state ihlukaniswa nge-akhawunti, imininingwane yokuqinisekisa nemodeli, futhi ayixutshwa phakathi kwamamodeli.
• Abameleli nokubhaliselwe: Sekela i-HTTP, HTTPS, SOCKS5, kanye nokubhaliselwe kwe-Clash/Mihomo YAML, ama-URI asemigqeni ehlukene nama-URI e-Base64.
• Ukuvikelwa kokucushwa: Yenza ikhophi yasenqolobaneni yokucushwa kwe-Codex ngaphambi kokuyiphatha, bese izama ukuyibuyisela lapho isevisi imiswa; uma ukucushwa konakala, ungavula iphaneli yokulungisa.
• Amakhono okuxilonga: Landa ukuxilongwa okususwe imininingwane ebucayi, noma sebenzisa umyalo we-doctor ukuqoqa ulwazi lokuthola amaphutha.

Ukulungiselela ngaphambi kokufaka

Qinisekisa kuqala ukuthi i-Codex ingasetshenziswa ngokujwayelekile ngaphandle kokudlula kuleli thuluzi. Ama-akhawunti asemthethweni kufanele aqede ukungena ngemvume; uma usebenzisa isevisi ye-relay, qala ngokumisa i-API key yakho.

Uma usebenzisa i-CCS noma i-CC Switch ngesikhathi esifanayo, khetha kuqala umhlinzeki, i-upstream kanye nokucushwa kokuqinisekisa okudingayo kuzo, bese uphuma ku-Codex futhi umise okwesikhashana ukushintshwa kokucushwa. I-ccodex-sleep-state ayiphathi isizindalwazi sama-akhawunti e-CCS; ifunda kuphela umhlinzeki okhethwe manje ku-Codex futhi ixhumanise okwesikhashana indawo yokungena kusevisi yasendaweni.

Khetha iphakheji yokufaka efanele

1. Vula ikhasi lama-Releases lephrojekthi.
2. Ikhompyutha ejwayelekile ye-Windows khetha windows-amd64.
3. Idivayisi ye-Windows ARM khetha windows-arm64.
4. I-Mac enechip ye-Apple khetha darwin-arm64.
5. I-Mac ene-Intel khetha darwin-amd64.
6. Ngemva kokulanda, khipha lonke iphakheji; ungasebenzisi ifayela elilodwa ngokuqondile ngaphakathi kwefayela elicindezelwe.

Ukuqalisa nokusungula

Ukusebenzisa iskripthi sokuqala

Abasebenzisi be-Windows bacindezela kabili start.cmd, abasebenzisi be-macOS bacindezele kabili start.command. Ngemva kokuqala kwesevisi, isiphequluli ngokuvamile sivula ngokuzenzakalelayo iphaneli yokuphatha yasendaweni futhi singene ngqo eseshinini yamanje, ngaphandle kwesidingo sokukopisha kusenesikhathi iphasiwedi yokuphatha.

Uhlelo luzokwakha ukucushwa kwesevisi okungekho, lwenze ikhophi yasenqolobaneni bese luxhumanisa i-Codex. Lapho iphaneli ibonisa ukuthi isiphathwa, kufaneleuqale kabusha i-Codex futhi udale iseshini entsha, bese uthumela umlayezo omfushane wokuhlola. Amaseshini amadala awashintshi ngokushesha, ngakho ungagcini ngokuhlola eseshinini endala.

Ukuqalisa ngomugqa womyalo

Uma iphakheji yokukhishwa ingenazo izikripthi zokuqala, sebenzisa setup enkombeni yohlelo. Umyalo we-Windows:

.\ccodex-sleep-state.exe setup

Umyalo we-macOS:

./ccodex-sleep-state setup

setup izokwakha ukucushwa okungekho, iqale isevisi futhi ivule iphaneli; ngeke isethe kabusha okubhaliselwe noma izilungiselelo zommeleli ezigciniwe. Uma inguqulo endala ingawusekeli lo myalo, thuthukela ku-Release entsha kuqala.

Uma isiphequluli singavuleki ngokuzenzakalelayo, vakashela ikheli lokuphatha ngokwakho ngokulandela okukhiphayo kwetheminali. Ikheli elizenzakalelayo ngu-http://127.0.0.1:17841/admin/, bese unamathisela iphasiwedi yokuphatha yalesi sikhathi eboniswa etheminali.

Uhlelo lokuqalisa ngokwalo aluthumeli izicelo zemodeli, kodwa ukuqoqwa kwe-state ngemva kokuxhumanisa i-Codex kungase kudle isabelo sangempela. Gcina iwindi letheminali livuliwe ngesikhathi isevisi isebenza.

Ukuqeda ukuxhuma kokuqala

1. Endaweni ethi “Qala ukusebenzisa” kuphaneli, qinisekisa ukuthi isimo sokucushwa sibonisa ukuthi sekuphathwa.
2. Uma kungatholakali ummeleli, vula “Okubhaliselwe nabameleli”, ufake ikheli lendawo le-HTTP, HTTPS noma SOCKS5, noma ungenise okubhaliselwe okukude nefayela lokubhaliselwe lasendaweni.
3. “Kuzilungiselelo zokuxhumeka”, qinisekisa imithetho yemodeli ne-akhawunti.
4. Uma kudingeka, vula noma uvale ukufakwa ku-“turn-state injection”.
5. Qala kabusha i-Codex bese udala iseshini entsha ngokuphelele.
6. Thumela umlayezo omfushane, bese ubuyela kuphaneli uhlole inani lezicelo, iseshini nokuxilongwa kokuqoqwa.

Ekusebenzeni kokuqala, uma kungakaze kubekwe ngokusobala isu lokubuyela emuva, setup isebenzisa ngokuzenzakalelayo “dlulisela ngokujwayelekile uma i-state ingatholakali”. Uma ngaphambilini wakhetha ngokusobala imodi eqinile, lokho kukhetha kuzogcinwa.

“Xhuma i-Codex ngokuchofoza okukodwa” ekhasini lasekhaya isetshenziswa kakhulu ukuhlola kabusha nokulungisa ukuxhumeka; akudingeki uyichofoze njalo ngemva kokuqala. Abameleli, okubhaliselwe, amamodeli kanye namaswishi okufaka akhona nakho kuzogcinwa.

Ukuqonda i-turn-state, 292 kanye no-332

Ithuluzi ligxila ku-X-Codex-Turn-State ekuphenduleni okuvela ku-upstream. Lithumela izicelo ezimfushane ezindaweni zokuphuma ezingaba khona, lihlole ukwakheka kwe-state, isikhathi nenani lamabhulokhi abethelwe, bese ligcina amanani ahambisana nemithetho yamanje esekelwe kokuhlangenwe nakho; izicelo ezilandelayo zizophatha lelo nani futhi zisebenzise indawo yokuphuma ehambisana nalo.

• Imithetho yama-akhawunti omuntu siqu: ukwakheka okwamukelwa yiphrojekthi kungamabhulokhi angu-10, ngokuvamile izinhlamvu ezingu-292; amabhulokhi angu-11 noma izinhlamvu ezingu-312 ngeke kuthathwe njengamanani afanelekile.
• Imithetho ye-Team noma ye-Business: ukwakheka okwamukelwa yiphrojekthi kungamabhulokhi angu-12, ngokuvamile izinhlamvu ezingu-332; amabhulokhi angu-13 noma izinhlamvu ezingu-356 ngeke kuthathwe njengamanani afanelekile.

Lezi zilinganiso zobudeakaziwona amamethrikhi ekhwalithi ashicilelwe ngokusemthethweni yi-OpenAI. Ukuhambisana nobude akufakazeli ukuthi imodeli isesimweni okuthiwa “inamandla aphelele”, futhi ukungahambisani nakho akufakazeli ngokwakho ukuthi ummeleli wonakele noma ikhwalithi yemodeli yehlile.

Ukuhlonza okuzenzakalelayo kubheka inkomba yephakheji esicelweni samanje, kunokuba kuhlulele i-akhawunti njenge-Team ngobude kuphela. Uma inkomba ingacaci, iphaneli izochaza umthetho osetshenzisiwe; ungaphinda ucacise mathupha ukuthi yi-Personal noma yi-Team.

Khetha imodi eqinile noma ukubuyela ekudluliseni okujwayelekile

Imodi eqinile

Imodi eqinile ayisebenzisi i-state engafanele. Uma ukuqoqwa kwehluleka, isicelo sizobuyisa isizathu esicacile. Uma umsebenzisi ekhethe ngokusobala strict, ukusebenzisa setup kamuva ngeke kushintshe ngokuzenzakalelayo lokho kukhetha.

Ukubuyela ekudluliseni okujwayelekile

Lokhu kubuyela emuva kumisa ukufaka uma ingekho i-state etholakalayo, kodwa kusasebenzisa indawo yokuphuma ekhethiwe ukudlulisa izicelo ezisemthethweni. Isicelo esisemthethweni sidluliselwa kanye kuphela kakhulu, futhi ulwazi lwesimo luzocacisa ukuthi kulokhu akuzange kufakwe i-state; ngeke kwenziwe sengathi ukuqoqwa kuphumelele.

Le modi ayisho ukuthi ukuvinjelwa kwezicelo kususiwe. Uma kuvela 401, 403 noma 429, isevisi isazolandela imithetho yokumisa; izicelo ezisemthethweni zokukhiqiza esezithunyelwe ku-upstream ngeke ziphindwe ngokuzenzakalelayo ngemva kokushintsha indawo yokuphuma.

Ukumisa abameleli nokubhaliselwe

Uma isevisi isebenza, gcina iwindi letheminali livuliwe. Lapho ufuna ukuphuma, cindezela Ctrl+C etheminali, linda ukubuyiselwa kokucushwa kuqede, bese uqala kabusha i-Codex.

Ukuvala isiphequluli, ukuvala ukufakwa kwe-state nokumisa isevisi kuyimisebenzi emithathu ehlukene: ukuvala isiphequluli akumisi isevisi yangemuva; ukuvala ukufakwa kusengavumela izicelo ukuthi zidluliselwe; ukuqeda inqubo yesevisi kuphela okuqalisa inqubo yokumisa nokubuyisela ukucushwa.

Ukuxazulula izinkinga okuvamile

Iphaneli ithi “Ayiphathwa”

Ukuqala kwesevisi akusho ukuthi i-Codex isixhunyiwe. Landela izeluleko zokucushwa ezikuphaneli futhi uqinisekise ukuthi awusebenzisi imodi yokufunda kuphela ethi --no-config.

I-Codex iyaphendula, kodwa iphaneli ayinazo izicelo

Qala kabusha i-Codex bese udala iseshini entsha. Uma kungakabikho rekhodi, hlola ukuthi i-Codex ayisebenzisi yini elinye ifayela lokucushwa, i-profile, iphrojekthi noma ukweqa kwezinga lomsebenzi, noma ukuthi ayikho yini enye i-instance esebenza ngesikhathi esifanayo.

Kuvele i-codex_config_changed noma i-409

Vula “Hlola futhi ulungise ukucushwa”, ubuke umehluko, ugcine kuqala ukucushwa kwamanje kwe-CCS, bese uphinde uthathe ukulawula.

Kuvele i-state_unavailable noma i-503 yasendaweni

Hlola imithetho ye-akhawunti, ukuxilongwa kokuqoqwa nesikhathi sokupholisa. Uma udinga ukubuyela ekusebenziseni kuqala, khetha ngokusobala ukubuyela ekudluliseni okujwayelekile, noma uvale ukufakwa okwesikhashana.

Kuvele i-state_shape_changed

Lokhu kusho ukuthi ukwakheka kwe-state akuhambisani nomthetho wamanje. Isicelo esisemthethweni kungenzeka sesidle isabelo, futhi isevisi ngeke isiphinde ngokuzenzakalelayo. Hlola imithetho ye-akhawunti, i-upstream kanye nezinguquko zakamuva, kunokuba uguqule nje umthetho wobude.

Kuvele i-415

Inguqulo entsha isekela ama-encoding ezicelo e-gzip ne-zstd zeklayenti elisemthethweni. Qinisekisa ukuthi awusebenzisi inguqulo endala, bese ubheka ukuxilongwa okususiwe imininingwane ebucayi.

Kuvele i-502, 503 noma ukuphela kwesikhathi

Hlola indawo yokuphuma yommeleli nesimo sesevisi ye-upstream. Inkinga yenethiwekhi ayixazululeki ngokushintsha ubude be-state.

Kuvele i-401, 403 noma 429

Hlola ngokwehlukana isimo sokungena ngemvume, izimvume zokufinyelela noma ulinde ukuthi ukuvinjelwa kwezicelo kuphele. Iphrojekthi ngeke igweme lezi zimo zokumisa ngokushintsha i-IP njalo.

Ifayela lokucushwa lonakele

Uma i-JSON yesevisi yonakele, setup izovula iphaneli yokulungisa efundeka kuphela. Qinisekisa ikhophi yasenqolobaneni ngaphambi kokwakha kabusha bese uqala futhi. Uma i-TOML ye-Codex yonakele, gcina ikhophi yasenqolobaneni kuqala, bese usebenzisa inqubo ecacile yokwakha kabusha noma uvumele i-CCS iyikhiqize kabusha; ungazami ukuqagela i-API key efayeleni elonakele.

Ukusebenzisa i-doctor ukuqoqa ukuxilongwa

Ngaphambi kokunikeza abalondolozi, amalungu eqembu noma i-AI Agent ulwazi lokuxazulula inkinga, abasebenzisi be-Windows bangasebenzisa:

.\ccodex-sleep-state.exe doctor

Abasebenzisi be-macOS baqalise:

./ccodex-sleep-state doctor

Lapho kubikwa inkinga, ngokuvamile kwanele ukunikeza isistimu yokusebenza, inguqulo ye-Codex, inguqulo yethuluzi, umlayezo wephutha, kanye nokuxilonga okudingekayo okususwe imininingwane ebucayi. Ungathumeli i-auth.json, iphasiwedi yokuphatha, isixhumanisi esigcwele sokubhalisa, imininingwane yokungena ku-akhawunti, noma yonke inkomba yedatha.

Amaqhinga Okusebenzisa Athuthukile

Qinisekisa Inkomba Yangempela Yokumisa

Uma kusethwe i-CODEX_HOME, ithuluzi lizolandela leyo ndawo. Liphinde lisekele i-CCODEX_STATE_HOME kanye ne---data-dir. Uma ungaqiniseki ukuthi yikuphi ukulungiselelwa okusetshenziswayo njengamanje, sebenzisa:

ccodex-sleep-state paths

Ungaqageli indawo yokulungiselela yamanje ngokusekelwe egameni lenkomba kuphela.

Qonda Izindleko Zokuqoqwa Nokupholisa

Ukuqoqwa kwe-state kusebenzisa isabelo sangempela. Ngokuzenzakalelayo, umzuliswano ngamunye uzama okungafika kokungu-6 kokuphuma okungase kusetshenziswe, ukuhlola okukodwa kuthatha imizuzwana engafika kwengu-20, futhi phakathi kwemizuliswano emibili yokuqoqwa kufanele kube okungenani imizuzwana engu-180. Izicelo ezijwayelekile zokukhiqiza azidlalelwa ngokuzenzakalelayo, ngakho ungakubheki ukuqoqwa noma ukushintsha indawo yokuphuma njengokuzama kabusha okungenazindleko.

Hlukanisa Ngemodeli Nangokwe-Akhawunti

Ungaphinde usebenzise i-state phakathi kwe-Astra, i-Sol ne-Terra. Ngemva kokushintsha imodeli ezenzakalelayo, qalisa kabusha i-Codex noma udale iseshini entsha. Ukuthi imodeli ingasetshenziswa ngempela kusancike ezimvumeni ze-akhawunti nokuthi umhlinzeki wokuqala uyayinikeza yini leyo modeli.

Hlola Ngokucophelela Ukusekelwa Kokucindezela

Amarekhodi ephrojekthi abonisa ukuthi ukucindezela okukude kwe-Sol yangempela yenguqulo entsha ye-V2 kanye nokuqhubeka nokuphendula ngemva kokucindezela kuphumelele; ukuxhumana okuqondile kwakudala kwe-V1 nomhlinzeki wokuqala kubuyise i-404. Ukuhlanganisa ngaphambi kokuthumela kwaqeda kuphela ukuhlolwa kweklayenti lendawo elilingisa isevisi; ekuhlolweni kwangempela okwengeziwe kwake kwavela nokwehluleka kokudluliselwa kwendawo yokuphuma, ngakho akufanele kuthathwe ngokuthi zonke izindlela zokucindezela sezisebenza ngokuphelele.

Imikhawulo Ebalulekile Nemingcele Yokuphepha

• Amamodeli asekelwayo njengamanje yi-gpt-6-astra, gpt-5.6-sol kanye ne-gpt-5.6-terra kuphela.
• Okwamanje kusetshenziswa i-Responses HTTP ne-SSE; i-WebSocket ayisekelwa, futhi akukho kuguqulwa kwamaphrothokholi angahleliwe okunikezwayo.
• Ithuluzi ngeke livulele i-akhawunti imvume yemodeli, futhi ngeke lishintshe imodeli buthule.
• Alishintshi ummeleli wesistimu, alivuseleli ukungena kwe-Codex, futhi alisebenzisi amakhadi okusetha kabusha.
• Ukuthi isevisi yokudlulisa iyakwazi ukuxhuma akusho ukuthi indlela ye-turn-state iyasebenza kuleyo sevisi yokudlulisa.
• Amanani okuqinisekisa kanye ne-state egcwele akubhalwa kumalogi ajwayelekile; iphrojekthi ayinayo i-telemetry, futhi ngeke ilayishe amalogi kumbhali.
• Ukulungiselelwa kommeleli wendawo kanye nezipele zokubuyisela kusengaba nolwazi olubucayi, ngakho kufanele uzigcine ngokuphepha.

Ulwazi Lonjiniyela

Iphrojekthi ibhalwe nge-Go, futhi ikhasi lokuphatha elingaguquki lifakwe ngaphakathi kwe-binary; akudingeki kuqalwe isevisi yangaphambili ehlukile. Isakhiwo esiyinhloko sekhodi sihlanganisa:

• cmd/ccodex-sleep-state: imiyalo, indawo yokungena yokuchofoza kanye nokuxilonga.
• internal/codexconfig: ukuhlaziya abahlinzeki, ukuthatha ukulawula kokulungiselelwa, ukuhlola incazelo kanye nokulungisa okungabuyiselwa.
• internal/gateway: ukuhlukanisa amamodeli nama-akhawunti, ukuqoqwa, ukucindezela kanye nokudlulisa okusakazwayo.
• internal/turnstate: imithetho yokupakisha i-state, inani lamanje kanye nenani eliyisipele.
• internal/proxyroute: ukuhlaziya okubhaliselwe kanye nokuxhumeka okuphumayo.
• internal/service: isibonelo esisodwa, iphaneli lewebhu, ukushintsha ukulungiselelwa ngesikhathi sokusebenza kanye nokuxilonga izicelo.

Iphrojekthi isebenzisa ilayisensi ye-GPL-3.0, futhi ingxenye yommeleli iphinde isebenzise i-Mihomo. Le phrojekthi ayihlobene ne-OpenAI, i-Mihomo noma i-GPT-Load.

Isifinyezo

Inani eliyinhloko le-ccodex-sleep-state akusona isithembiso sokususa ukukhawulelwa noma ukubuyisela ikhwalithi yemodeli, kodwa ukwenza ukuxhumeka kwe-Codex, izindawo zokuphuma zommeleli, i-turn-state, izipele zokulungiselelwa kanye nokuxilongwa kwamaphutha kubonakale, kuhlolwe futhi kubuyiselwe. Lapho uyisebenzisa okokuqala, kunconywa ukuthi uqale uqinisekise ukuthi i-Codex yokuqala iyasebenza, bese usebenzisa i-setup, uqinisekise ukuthathwa kokulawula ngephaneli, uqale kabusha i-Codex bese udala iseshini entsha. Uma kuvela inkinga, qala ubheke ukuxilongwa kwephaneli bese usebenzisa i-doctor; ungashintshi ukulungiselelwa ngokungacabangi noma udalule imininingwane yokungena ebucayi.