Mafunzo ya ccodex-sleep-state: Simamia Codex kwa mwonekano, sanidi proksi na tatua matatizo ya muunganisho

Muhtasari wa mradi

ccodex-sleep-state ni zana ya ndani iliyoandikwa kwa Go, yenye lengo la kuboresha matatizo ya mabadiliko ya ubora wa majibu, vikwazo vya matumizi, kushindwa kwa muunganisho na migongano ya usanidi yanayoweza kutokea wakati wa kutumia Codex. Inakusanya usimamizi wa miunganisho, njia za proksi, ukusanyaji wa turn-state, udhibiti wa usanidi na utambuzi wa hitilafu katika huduma moja ya ndani na paneli ya wavuti, hivyo kupunguza hitaji la kuhariri faili za usanidi kwa mkono.

Kwanza ni muhimu kuelewa: zana hii haiongezi kikomo cha akaunti, wala haiwezi kuhakikisha kwamba ubora wa modeli utarejea baada ya kubadilisha njia ya kutoka. Inashughulikia miunganisho, usanidi na X-Codex-Turn-State katika majibu, ili ukusanyaji, hali ya kuingiza, njia ya ombi na sababu za hitilafu ziwe rahisi kukagua.

Mradi bado uko katika toleo la majaribio la umma. Vipengele vinaweza kutofautiana kati ya matoleo ya Release; fuata maelezo ya toleo ulilopakua. Usichukulie kuwa kufaulu kwa jaribio la modeli fulani au mtiririko uliobanwa kunamaanisha kwamba hali zote zimekubaliwa.

Vipengele vikuu

• Paneli ya wavuti ya ndani: Tazama kama Codex imedhibitiwa, kama maombi yanapitia huduma, hali ya kikao na idadi ya maombi.
• Ukusanyaji na uingizaji wa turn-state: Tuma maombi mafupi kutoka njia zinazowezekana za kutoka, kagua state katika majibu, na uitumie kwa kanuni katika maombi yanayofuata.
• Mbinu mbalimbali za uthibitishaji: Shughulikia kando kuingia kwa ChatGPT rasmi, API key rasmi ya OpenAI, pamoja na API key ya Responses ya huduma ya kati au CCS.
• Utenganishaji wa modeli: Inaauni gpt-6-astra, gpt-5.6-sol na gpt-5.6-terra; state hutenganishwa kwa akaunti, kitambulisho na modeli, na haitumiki kwa pamoja kati ya modeli.
• Proksi na usajili: Inaauni HTTP, HTTPS, SOCKS5, pamoja na usajili wa Clash/Mihomo YAML, URI za mstari mmoja na URI za Base64.
• Ulinzi wa usanidi: Hifadhi nakala ya usanidi wa Codex kabla ya kuidhibiti, na jaribu kuirejesha huduma inapositishwa; usanidi ukiharibika, unaweza kuingia kwenye paneli ya kurekebisha.
• Utambuzi: Unaweza kupakua taarifa za utambuzi zilizofichwa, au kuendesha amri ya doctor kukusanya taarifa za utatuzi.

Maandalizi kabla ya kusakinisha

Kwanza thibitisha kwamba Codex inaweza kufanya kazi kawaida bila kupitia zana hii. Akaunti rasmi lazima ikamilishe kuingia kwanza; unapotumia huduma ya kati, sanidi API key yako kwanza.

Ukitumia CCS au CC Switch kwa wakati mmoja, chagua provider, chanzo cha juu na usanidi wa uthibitishaji unaohitaji katika matumizi haya, kisha toka kwenye Codex na usitishe kwa muda usanidi wa kubadilisha. ccodex-sleep-state haidhibiti hifadhidata ya akaunti ya CCS; husoma tu provider iliyochaguliwa sasa na Codex, kisha kwa muda huunganisha lango na huduma ya ndani.

Chagua kifurushi sahihi cha usakinishaji

1. Fungua ukurasa wa Releases wa mradi.
2. Kwa kompyuta ya kawaida ya Windows, chagua windows-amd64.
3. Kwa kifaa cha Windows ARM, chagua windows-arm64.
4. Kwa Mac yenye chipu ya Apple, chagua darwin-arm64.
5. Kwa Mac yenye Intel, chagua darwin-amd64.
6. Baada ya kupakua, fungua kifurushi kizima; usiendeshe faili moja moja moja kwa moja kutoka kwenye kumbukumbu iliyobanwa.

Kuanzisha na kusanidi awali

Kutumia hati ya kuanzisha

Watumiaji wa Windows wabofye mara mbili start.cmd, na watumiaji wa macOS wabofye mara mbili start.command. Huduma ikishaorodheshwa, kivinjari kwa kawaida kitafungua paneli ya ndani ya usimamizi kiotomatiki na kuingia moja kwa moja kwenye kikao cha sasa, bila kuhitaji kunakili nenosiri la usimamizi mapema.

Programu itaunda usanidi wa huduma unaokosekana, ihifadhi nakala na kuidhibiti Codex. Paneli ikionyesha kwamba udhibiti umekamilika, anzisha upya Codex na uunde kikao kipya, kisha tuma ujumbe mfupi wa majaribio. Kikao cha zamani hakibadilishwi moja kwa moja, kwa hiyo usiendelee kujaribu katika kikao cha awali pekee.

Kutumia mstari wa amri kuanzisha

Kifurushi cha Release kisipokuwa na hati ya kuanzisha, tekeleza setup kwenye saraka ya programu. Amri ya Windows ni:

.\ccodex-sleep-state.exe setup

Amri ya macOS ni:

./ccodex-sleep-state setup

setup itaunda usanidi unaokosekana, ianzishe huduma na kufungua paneli; haitafuta usajili na mipangilio ya proksi iliyohifadhiwa. Toleo la zamani lisilounga mkono amri hii linapaswa kusasishwa hadi Release mpya zaidi.

Kivinjari kisipofunguka kiotomatiki, tembelea mwenyewe anwani ya usimamizi iliyoonyeshwa kwenye kituo. Anwani chaguo-msingi ni http://127.0.0.1:17841/admin/, kisha bandika nenosiri la usimamizi la wakati huu lililoonyeshwa kwenye kituo.

Programu ya kuanzisha yenyewe haitumi maombi ya modeli, lakini ukusanyaji wa state baada ya Codex kuunganishwa unaweza kutumia kikomo halisi. Wakati huduma inaendesha, dirisha la kituo linapaswa kubaki wazi.

Kukamilisha muunganisho wa kwanza

1. Fungua eneo la “Anza kutumia” kwenye paneli na uthibitishe kwamba hali ya usanidi inaonyesha kuwa udhibiti umekamilika.
2. Proksi isipotambuliwa, fungua “Usajili na proksi”, jaza anwani ya ndani ya HTTP, HTTPS au SOCKS5, au leta usajili wa mbali na faili ya usajili ya ndani.
3. Katika “Mipangilio ya muunganisho”, thibitisha kanuni za modeli na akaunti.
4. Washa au zima uingizaji katika “Uingizaji wa turn-state” kulingana na mahitaji.
5. Anzisha upya Codex na uunde kikao kipya kabisa.
6. Tuma ujumbe mfupi, kisha rudi kwenye paneli kukagua idadi ya maombi, kikao na utambuzi wa ukusanyaji.

Kwa uendeshaji wa kwanza bila kuweka wazi mkakati wa dharura, setup hutumia “sambaza kawaida state isipokusanywa” kwa chaguo-msingi. Ikiwa hali kali ilichaguliwa hapo awali, chaguo hilo litaendelea kuhifadhiwa.

“Unganisha Codex kwa kubofya mara moja” kwenye ukurasa wa mwanzo hutumika hasa kukagua na kurekebisha muunganisho upya; si lazima kubofya kila huduma inapoanzishwa. Proksi, usajili, modeli na swichi ya uingizaji iliyopo pia itahifadhiwa.

Kuelewa turn-state, 292 na 332

Zana hii huzingatia X-Codex-Turn-State katika majibu kutoka chanzo cha juu. Hutuma maombi mafupi kutoka njia zinazowezekana za kutoka, hukagua ufungaji wa state, muda na idadi ya vizuizi vilivyosimbwa, kisha huhifadhi thamani inayolingana na kanuni za sasa; maombi yanayofuata hubeba thamani hiyo na kutumia njia ya kutoka inayohusiana nayo.

• Kanuni za akaunti binafsi: Muundo unaokubaliwa kwa uzoefu na mradi ni vizuizi 10, kwa kawaida herufi 292; vizuizi 11 au herufi 312 havitachukuliwa kuwa thamani zinazokidhi masharti.
• Kanuni za Team au Business: Muundo unaokubaliwa kwa uzoefu na mradi ni vizuizi 12, kwa kawaida herufi 332; vizuizi 13 au herufi 356 havitachukuliwa kuwa thamani zinazokidhi masharti.

Urefu huu sio viashiria vya ubora vilivyochapishwa rasmi na OpenAI. Kulingana na urefu hakuthibitishi kwamba modeli iko katika hali ya “nguvu kamili”, na kutokulingana na urefu hakuthibitishi peke yake kwamba proksi imeharibika au ubora wa modeli umeshuka.

Utambuzi wa kiotomatiki hutegemea kidokezo cha mpango katika ombi la sasa, na hautambui akaunti ya Team kwa urefu pekee. Kidokezo kisipokuwa wazi, paneli itaeleza kanuni iliyotumiwa; pia unaweza kuchagua mwenyewe Binafsi au Team.

Chagua hali kali au usambazaji wa kawaida wa dharura

Hali kali

Hali kali haitumii state isiyokidhi masharti. Ukusanyaji ukishindwa, ombi litarudisha sababu iliyo wazi. Mtumiaji akishachagua wazi strict, uendeshaji unaofuata wa setup hautabadilisha chaguo hilo kiotomatiki.

Usambazaji wa kawaida wa dharura

Usambazaji wa kawaida wa dharura husitisha uingizaji wakati hakuna state inayopatikana, lakini bado hutumia njia iliyochaguliwa ya kutoka kusambaza ombi rasmi. Ombi rasmi litasambazwa mara moja pekee; taarifa ya hali itaonyesha wazi kwamba hakuna uingizaji uliofanyika, bila kujifanya kwamba ukusanyaji ulifanikiwa.

Hali hii haimaanishi kuondoa vikwazo vya matumizi. Ikipatikana 401, 403 au 429, huduma bado itafuata kanuni za kusitisha; ombi rasmi la uzalishaji lililotumwa kwa chanzo cha juu halitatumwa tena kiotomatiki baada ya kubadilisha njia ya kutoka.

Kusanidi proksi na usajili

Ikiwa programu ya proksi tayari imesakinishwa, jaza anwani ya ndani ya HTTP, HTTPS au SOCKS5 kwenye ukurasa wa “Usajili na proksi”. Muunganisho wa kwanza wa kiotomatiki utakagua tu milango ya kawaida ya SOCKS5 kwenye 127.0.0.1; hautachanganua mtandao wa ndani wala kusoma hifadhidata ya akaunti ya programu ya proksi.

Mradi pia unaauni usajili wa Clash/Mihomo YAML, URI za mstari mmoja na URI za Base64. Vitokezi vilivyojengewa ndani vinaunga mkono AnyTLS, SS, SSR, VMess, VLESS, Trojan, Hysteria, Hysteria2 na TUIC, lakini haviingizwi TUN, DNS au kanuni za mfumo kutoka kwenye usajili.

Unaweza kujaribu muunganisho, kubainisha njia ya kutoka au kurejesha uteuzi wa kiotomatiki kwenye ukurasa wa “Uelekezaji”. Kumbuka kwamba kufaulu kwa jaribio la muunganisho kunamaanisha tu kwamba njia ya mtandao inapatikana; hakumaanishi kwamba state inayokidhi masharti imekusanywa.

Kutumia pamoja na CCS na huduma za kati

Kwa kuingia kwa ChatGPT rasmi, zana inaweza kukusanya na kuingiza state, na pia inaruhusu kuzima uingizaji. Kwa API key rasmi ya OpenAI, maombi husambazwa kupitia mkondo wa API na haitachukuliwa kuwa kuingia kwa usajili wa ChatGPT.

Kwa Responses ya huduma ya kati au API key ya CCS, zana huhifadhi chanzo cha juu na njia ya awali ya uthibitishaji ya API key, haitumi vitambulisho rasmi vya kuingia kwa huduma ya kati, na haiingizi state rasmi.

CCS ikibadilisha kwa kweli provider, chanzo cha juu au njia ya uthibitishaji, huduma itasitisha usambazaji ili kuzuia kutuma vitambulisho kwenye lengwa lisilo sahihi. Mpangilio unaopendekezwa wa kubadilisha ni:

1. Sitisha ccodex-sleep-state.
2. Badilisha usanidi katika CCS.
3. Anzisha tena ccodex-sleep-state.
4. Anzisha upya Codex na uunde kikao kipya.

Ukitokea mgongano wa usanidi, usifute faili za miamala wala kuhariri TOML bila mpango. Ingia kwenye “Kagua na kurekebisha usanidi”, hakiki mabadiliko kwanza, hifadhi ikiwezekana usanidi wa sasa wa CCS, kisha dhibiti tena.

Kusimamisha huduma na kurejesha usanidi

Wakati huduma inaendesha, dirisha la kituo linapaswa kubaki wazi. Unapotaka kutoka, bonyeza Ctrl+C kwenye kituo, subiri urejeshaji wa usanidi ukamilike, kisha anzisha upya Codex.

Kufunga kivinjari, kuzima uingizaji wa state na kusimamisha huduma ni vitendo vitatu tofauti: kufunga kivinjari hakusitishi huduma ya nyuma; kuzima uingizaji bado kunaweza kuendelea kusambaza maombi; ni kumaliza mchakato wa huduma pekee kunakoanzisha mchakato wa kusitisha na kurejesha usanidi.

Utatuzi wa matatizo ya kawaida

Paneli inaonyesha “Haijadhibitiwa”

Kuanzisha huduma hakumaanishi kwamba Codex imekamilisha kuunganishwa. Fuata vidokezo vya usanidi kwenye paneli na uthibitishe kwamba hutumii hali ya kusoma tu ya --no-config.

Codex inajibu, lakini paneli haina maombi

Anzisha upya Codex na uunde kikao kipya kwanza. Ikiwa bado hakuna rekodi, kagua kama Codex inatumia usanidi, profile, mradi au ubatilishaji wa kiwango cha kazi tofauti, au kama mfano mwingine unaendesha kwa wakati mmoja.

Inaonekana codex_config_changed au 409

Fungua “Kagua na kurekebisha usanidi”, hakiki tofauti, hifadhi ikiwezekana usanidi wa sasa wa CCS, kisha dhibiti tena.

Inaonekana state_unavailable au 503 ya ndani

Kagua kanuni za akaunti, utambuzi wa ukusanyaji na muda wa kusubiri. Ikiwa unahitaji kurejesha matumizi kwanza, chagua wazi usambazaji wa kawaida wa dharura au zima uingizaji kwa muda.

Inaonekana state_shape_changed

Hii inamaanisha kwamba muundo wa state haulingani na kanuni za sasa. Ombi rasmi huenda tayari limetumia kikomo, na huduma haitalituma tena kiotomatiki. Kagua kanuni za akaunti, chanzo cha juu na mabadiliko ya hivi karibuni badala ya kubadilisha tu kanuni za urefu.

Inaonekana 415

Toleo jipya linaunga mkono usimbaji wa maombi wa gzip na zstd wa mteja rasmi. Thibitisha kwamba toleo la zamani haliendeshi, kisha tazama utambuzi uliofichwa.

Inaonekana 502, 503 au muda kuisha

Kagua njia ya kutoka ya proksi na hali ya huduma ya chanzo cha juu. Hitilafu ya mtandao haiwezi kutatuliwa kwa kubadilisha urefu wa state.

Inaonekana 401, 403 au 429

Kagua hali ya kuingia, ruhusa ya ufikiaji au subiri vikwazo vya matumizi virejee kawaida. Mradi hautabadilisha IP mara kwa mara ili kukwepa masharti haya ya kusitisha.

Faili ya usanidi imeharibika

JSON ya huduma ikiharibika, setup itafungua paneli ya kurekebisha ya kusoma tu. Thibitisha nakala rudufu kabla ya kuunda upya na kuanzisha tena. TOML ya Codex ikiharibika, hifadhi nakala kwanza, kisha tumia mchakato ulio wazi wa kuunda upya au uruhusu CCS kuunda tena; usijaribu kukisia API key kutoka kwenye faili iliyoharibika.

Kutumia doctor kukusanya utambuzi

Kabla ya kumpa mtunzaji, mwanakikundi au AI Agent taarifa za utatuzi, watumiaji wa Windows wanaweza kuendesha:

.\ccodex-sleep-state.exe doctor

Watumiaji wa macOS waendeshe:

./ccodex-sleep-state doctor

Wakati wa kutoa mrejesho, kwa kawaida toa tu mfumo wa uendeshaji, toleo la Codex, toleo la zana, ujumbe wa kosa na uchunguzi muhimu uliosafishwa. Usitume auth.json, nenosiri la usimamizi, kiungo kamili cha usajili, kitambulisho cha akaunti au saraka nzima ya data.

Mbinu za Juu za Matumizi

Kuthibitisha Saraka Halisi ya Usanidi

Ikiwa umeweka CODEX_HOME, zana itatumia eneo hilo. Pia inatumia CCODEX_STATE_HOME na --data-dir. Ikiwa huna uhakika ni usanidi upi unaotumika sasa, endesha:

ccodex-sleep-state paths

Usikisie eneo la usanidi wa sasa kwa kutegemea jina la saraka pekee.

Kuelewa Gharama za Ukusanyaji na Muda wa Kusubiri

Ukusanyaji wa state hutumia kikomo halisi. Kwa chaguomsingi, kila mzunguko hujaribu hadi njia 6 mbadala, uchunguzi mmoja huchukua hadi sekunde 20, na lazima kuwe na angalau sekunde 180 kati ya mizunguko miwili ya ukusanyaji. Maombi ya kawaida ya kuzalisha hayachezwi tena kiotomatiki, hivyo usichukulie ukusanyaji au kubadilisha njia kama jaribio lisilo na gharama.

Kutenga kwa Modeli na Akaunti

Usitumie tena state kati ya Astra, Sol na Terra. Baada ya kubadilisha modeli chaguomsingi, anzisha upya Codex au fungua kipindi kipya. Uwezo wa modeli kuitwa bado unategemea ruhusa za akaunti na upatikanaji wa modeli hiyo kutoka kwa huduma ya juu.

Kutathmini Usaidizi wa Ukandamizaji kwa Tahadhari

Rekodi za mradi zinaonyesha kuwa ukandamizaji wa mbali wa Sol halisi wa toleo jipya la V2, pamoja na kuendelea kujibu baada ya ukandamizaji, umefanikiwa; huduma ya juu ya muunganisho wa moja kwa moja ya V1 ya zamani ilirejesha 404. Daraja la kabla ya kutuma limekamilisha tu jaribio la mteja wa ndani wa kuiga, na wakati wa uthibitishaji halisi wa ziada kulikuwa pia na hitilafu ya uwasilishaji wa njia, hivyo haiwezi kusemwa kuwa aina zote za ukandamizaji zimefanya kazi kikamilifu.

Vikwazo Muhimu na Mipaka ya Usalama

• Modeli zinazotumika kwa sasa ni gpt-6-astra, gpt-5.6-sol na gpt-5.6-terra pekee.
• Kwa sasa hutumia Responses HTTP na SSE; haitumii WebSocket wala kutoa ubadilishaji wa itifaki holela.
• Zana haiwafungulii akaunti ruhusa za modeli, wala haibadilishi modeli kimyakimya.
• Haibadilishi proksi ya mfumo, haihuishi kuingia kwa Codex, wala haitumii kadi ya kuweka upya.
• Huduma ya kati kuweza kuunganishwa haimaanishi kuwa mbinu ya turn-state itafanya kazi kwa huduma hiyo.
• Thamani za uthibitishaji na state kamili haziandikwi kwenye kumbukumbu za kawaida; mradi hauna telemetry wala kupakia kumbukumbu kwa mwandishi.
• Usanidi wa proksi ya ndani na nakala rudufu za urejeshaji bado zinaweza kuwa na taarifa nyeti; zihifadhi kwa uangalifu.

Taarifa za Msanidi

Mradi umeandikwa kwa Go, na ukurasa wa usimamizi tuli umejumuishwa kwenye jozi ya programu, hivyo hauhitaji kuanzisha huduma ya mbele kando. Muundo mkuu wa msimbo unajumuisha:

• cmd/ccodex-sleep-state: amri, kiingilio cha hatua moja na uchunguzi.
• internal/codexconfig: uchanganuzi wa provider, uchukuaji wa usanidi, ukaguzi wa maana na marekebisho yanayoweza kurejeshwa.
• internal/gateway: utengaji wa modeli na akaunti, ukusanyaji, ukandamizaji na uwasilishaji wa mtiririko.
• internal/turnstate: sheria za kufunga state, thamani ya sasa na thamani mbadala.
• internal/proxyroute: uchanganuzi wa usajili na miunganisho ya kutoka.
• internal/service: hali moja, paneli ya wavuti, ubadilishaji moto wa usanidi na uchunguzi wa maombi.

Mradi umetolewa chini ya leseni ya GPL-3.0, na sehemu ya proksi imetumia tena Mihomo. Mradi huu hauhusiani na OpenAI, Mihomo wala GPT-Load.

Muhtasari

Thamani kuu ya ccodex-sleep-state si kuahidi kuondoa udhibiti wa kasi au kurejesha ubora wa modeli, bali kufanya ufikiaji wa Codex, njia za proksi, turn-state, nakala rudufu za usanidi na uchunguzi wa makosa viweze kuonekana, kukaguliwa na kurejeshwa. Unapotumia mara ya kwanza, inashauriwa kwanza kuthibitisha kuwa Codex ya awali inafanya kazi, kisha uendeshe setup, uthibitishe uchukuaji kupitia paneli, uanzishe Codex upya na ufungue kipindi kipya. Ukikumbana na tatizo, kwanza angalia uchunguzi wa paneli na uendeshe doctor; usibadilishe usanidi bila kufikiri wala kufichua vitambulisho nyeti.