Jenga Nafasi ya Kazi ya Codex CLI Inayolenga Utekelezaji kwa Kutumia Portable Setup Kit

Kile Kinachofanywa na Codex CLI Portable Setup Kit

Codex CLI Portable Setup Kit ni usanidi na kisakinishi kinachodumishwa na jamii kwa ajili ya OpenAI Codex CLI. Si Codex yenyewe, wala si bidhaa rasmi ya OpenAI.

Kifurushi hiki hubadilisha jinsi Codex inavyoshughulikia kazi za hazina za msimbo. Maagizo yake yanasisitiza kukagua eneo la kazi, kutumia zana zilizopo, kufanya mabadiliko yaliyoombwa, kuendesha ukaguzi, kuchunguza hitilafu, na kuripoti matokeo yaliyothibitishwa. Uwezo wa kubebeka ni njia ya uwasilishaji; bidhaa kuu ni mtindo huu wa uendeshaji unaotanguliza utekelezaji.

Muhimu: Hali ya TURBO huwezesha tabia iliyoinuliwa na isiyohitaji mwingiliano, ikiwemo approval_policy = "never". Itumie tu katika eneo la kazi unaloliamini na baada ya kukagua kifurushi. Usanidi wa kawaida wa umma huanza kwa idhini salama zaidi ya kuombwa inapohitajika na sandboxing ya workspace-write.

Vipengele Muhimu

• Maagizo yanayotanguliza utekelezaji: Codex inaelekezwa kuchukua hatua kwenye lengo halisi badala ya kusimama baada ya ushauri wa jumla au mpango.
• Uzinduzi wa TURBO kwa kubofya mara moja: TURBO.cmd huthibitisha eneo la kazi, husanidi sera za utekelezaji zilizo na ruhusa zilizoinuliwa, hurithi mipangilio asilia ya modeli, na kuanzisha Codex.
• Usakinishaji wa miamala: Kisakinishi huthibitisha manifesti za SHA-256, huunda nakala rudufu zenye muhuri wa muda, huweka kumbukumbu za shughuli, na hutengeneza risiti ya kurejesha hali ya awali.
• Zana bainifu za uchanganuzi: re-toolkit ya Python tupu hushughulikia ukaguzi wa PE32 na PE32+, disassembly ya x86 na x64, uchanganuzi wa AOB, micro-emulation, uchanganuzi wa Protobuf na TLV, utengenezaji wa Frida hooks, na tofauti za binary.
• Uchakataji wa hatua mbili: Upangaji wa kimuundo unatenganishwa na uwasilishaji wa uaminifu wa juu ili kupunguza mabaki ya vihisishi na matokeo marefu yenye ubora uliopungua.
• Miundo mbalimbali ya mawakala: Kifurushi hutoa maagizo au presets kwa Codex CLI, OpenCode, Claude Code, Cursor, Windsurf, na ChatGPT App.
• Msaada wa mwendelezo: Hooks na zana za muktadha husaidia kuhifadhi hali iliyothibitishwa wakati wa kazi ndefu.
• Muunganisho wa Git unaoweza kubadilishwa: Kisakinishi kinaweza kuunganisha core.hooksPath na pre-commit guard iliyofungashwa, kisha kurejesha thamani ya awali wakati wa rollback.

Mahitaji na Maandalizi

Hazina inataja Windows 10 na 11, PowerShell 5.1 au 7, na Python 3.10 au mpya zaidi kama vipengele vinavyotumika. Codex CLI inahitajika kwa mtiririko mkuu wa kazi, ingawa kisakinishi kinaweza kuongeza kifurushi cha kimataifa cha @openai/codex kilichowekewa toleo linalooana wakati Codex haipo.

1. Pakua ZIP ya toleo au clone hazina.
2. Itowe kwenye saraka ya ndani ikiwa umepakua ZIP.
3. Chagua hazina ambayo Codex itasimamia.
4. Kagua skripti na usanidi uliojumuishwa kabla ya kuwezesha utekelezaji ulioinuliwa au usio na vizuizi.
5. Hifadhi nakala rudufu ya data yoyote muhimu sana ya eneo la kazi kando, hata kama kisakinishi huunda nakala rudufu za miamala.

Chaguo la 1: Anza kwa Hali ya TURBO

Kwa njia fupi zaidi ya usanidi, toa faili za toleo kisha bofya mara mbili:

TURBO.cmd

Kianzishaji huthibitisha eneo la kazi, husanidi wasifu wa utekelezaji ulioinuliwa, hutumia mipangilio yako asilia ya modeli, na kufungua Codex ikiwa tayari kufanya kazi. Hali hii pia huidhinisha mapema zana za wakati wa utekelezaji, huweka maeneo ya kazi kuwa yanayoaminika kikamilifu, na hutumia tabia ya idhini isiyohitaji mwingiliano.

Kwa kuwa mipangilio hii hupunguza vikwazo vya uthibitishaji, hifadhi hali ya TURBO kwa msimbo uliokaguliwa na maeneo ya kazi unayoamini. Kwa usakinishaji unaodhibitiwa zaidi, tumia utaratibu wa mwongozo hapa chini.

Chaguo la 2: Fanya Usakinishaji wa Miamala kwa Mwongozo

Fungua PowerShell katika saraka ya kifurushi kilichotolewa. Ruhusu kwa muda skripti ya usakinishaji kwa mchakato wa sasa wa PowerShell, kisha toa njia kamili ya eneo la kazi lengwa:

Set-ExecutionPolicy -Scope Process Bypass
.\install.ps1 -ProjectRoot 'C:\path\to\your-workspace' -KeysmithPreset unrestricted -SkipPlugins

Mfano huu huchagua preset ya unrestricted ya Keysmith na kuruka plugins za hiari. Kagua chaguo hizi kabla ya kuzitumia katika mazingira yako.

Wakati wa usakinishaji, kifurushi hufuata mfuatano wa miamala:

1. Thibitisha mzizi wa mradi.
2. Thibitisha kifurushi chanzo dhidi ya manifesti yake ya SHA-256.
3. Unda nakala rudufu yenye muhuri wa muda na kumbukumbu ya shughuli.
4. Sakinisha faili za mtumiaji, skills, faili za mradi, zana za muktadha, na re-toolkit.
5. Badilisha njia zinazohitajika na mazingira lengwa.
6. S usanidi uaminifu wa mradi na njia ya Git hook ya hazina.
7. Jaribu usanidi wa plugin za hiari zinapoombwa bila kuchukulia kushindwa kwa plugin kuwa kosa la kusitisha.
8. Andika receipt.json na last-receipt.txt.

Kila ubadilishaji huandikwa kabla haujafanyika. Ikiwa hatua ya baadaye ya usakinishaji itashindwa, kisakinishi hucheza tena orodha ya shughuli kwa mpangilio wa kinyume na kurejesha muunganisho wa awali wa Git hook.

Kile Kinachoongezwa na Kisakinishi

• Usanidi wa mtumiaji wa Codex: Faili zilizo chini ya %CODEX_HOME% au ~/.codex, zikiwemo config.toml, AGENTS.md, maelekezo, kanuni za kuanzia na ujuzi.
• Ujuzi wa mawakala wa kiwango cha mtumiaji: Ujuzi unaoweza kutumika tena ulio chini ya ~/.agents.
• Usanidi wa mradi: AGENTS.md, CLAUDE.md, .codex, .agents, .gitignore, mtiririko wa kazi wa muktadha, hooks na zana ya kubadili uhandisi.
• Usanidi wa Git wa ndani: core.hooksPath=.agents/git-hooks kwa hazina iliyochaguliwa.
• CLI ya Codex: Usakinishaji wa kimataifa wa npm uliowekewa toleo la uoanifu wakati Codex haipatikani tayari.
• Programu-jalizi za hiari: Usaidizi wa Browser, Visualize na Sites unapopatikana.

Toleo hili halijumuishi kimakusudi vitambulisho vya siri na hali inayofungamana na mashine. Halihamishi data ya uthibitishaji, data ya OAuth, vipindi, historia, kumbukumbu, akiba, hifadhidata za SQLite, vidakuzi, funguo za API, funguo za faragha, data ya wakati wa kuendesha kivinjari, njia za binary za eneo-kazi au hali ya wakati wa kuendesha muktadha kutoka kwenye kompyuta nyingine.

Thibitisha Kifurushi na Usakinishaji

Endesha hati ya uthibitishaji wa kifurushi kabla ya kutegemea usanidi huu:

.\verify.ps1

Ili kuthibitisha faili zilizosakinishwa katika workspace fulani, ongeza -Installed na njia ya mradi:

.\verify.ps1 -Installed -ProjectRoot 'C:\path\to\your-workspace'

Uthibitishaji ni sehemu muhimu ya muundo. Kisakinishaji hukagua manifesti kabla ya kuandika na huzuia kuvuka njia za manifesti. Hazina pia inaeleza suite ya hatua tisa ya Test-All.ps1 inayotumika katika majaribio ya toleo.

Matumizi ya Msingi na Codex

Baada ya usakinishaji, anzisha Codex katika hazina iliyosanidiwa kupitia TURBO.cmd au mtiririko wako wa kawaida wa CLI ya Codex. Ipe kazi mahususi ya hazina badala ya ombi la ushauri wa jumla.

Kwa mfano, mwombe Codex ichunguze jaribio linaloshindwa, itekeleze marekebisho, irudie ukaguzi husika na ifupishe faili zilizobadilishwa. Maelekezo yaliyosakinishwa yameundwa kumsaidia wakala kuendelea kutoka ukaguzi hadi utekelezaji na uthibitishaji kila hatua inayofuata inapopatikana.

Kazi inayofaa inaweza kuandikwa hivi:

Chunguza majaribio yanayoshindwa katika workspace hii, tambua chanzo kikuu, tekeleza marekebisho madogo zaidi yaliyo sahihi, rudia majaribio yaliyoathiriwa na ripoti matokeo yaliyothibitishwa.

Wasifu huu unakusudiwa kuhimiza Codex ikague faili na matokeo ya majaribio kwanza, ihariri mradi halisi, irudie ukaguzi ulioshindwa, kisha itoe matokeo mafupi badala ya kurudisha mafunzo ya kufuata wewe mwenyewe.

Tumia Zana Iliyojengewa Ndani ya re-toolkit

Zana hii imesakinishwa katika .agents/tools/re-toolkit/ ndani ya mradi. Njia yake kuu ya kuingilia ni cli.py. Amri zinazotumia --json zinafaa hasa wakati hati au wakala mwingine anahitaji matokeo yaliyopangwa.

Fanya Triage ya Binary Kiotomatiki

python .agents/tools/re-toolkit/cli.py auto target.dll --json

Hii hufanya ugunduzi wa kiotomatiki wa umbizo na triage ya lengwa.

Kagua Faili ya PE

python .agents/tools/re-toolkit/cli.py parse-pe sample.exe --json

Kichanganuzi cha PE kinaweza kukagua vichwa, jedwali la sehemu, DLL zilizoingizwa, alama zilizohamishwa nje na maelezo ya tafsiri ya RVA kwa faili za PE32 na PE32+.

Changanua Mchoro wa AOB

python .agents/tools/re-toolkit/cli.py pattern-scan target.bin --pattern "48 89 ?? 24 ?? 55" --json

Tumia ?? kama wildcard wakati baiti zinaweza kutofautiana kati ya binary au matoleo.

Toa Mfuatano wa Herufi

python .agents/tools/re-toolkit/cli.py strings sample.exe --min-len 5 --json

Hii hutoa mifuatano ya ASCII na UTF-16LE pamoja na offset zake, huku ikichuja mifuatano mifupi kuliko kiwango cha chini kilichochaguliwa.

Tenganisha Opcodes

python .agents/tools/re-toolkit/cli.py disasm 90505831C0C3 --arch x86_64

Kichanganua disassembly kinaunga mkono uchanganuzi wa x86 na x64 wa opcodes ghafi au sehemu za binary.

Decode Payload ya Protobuf Isiyo na Nyaraka

python .agents/tools/re-toolkit/cli.py decode-protobuf 089601120474657374

Hii hufanya ukaguzi usiohitaji schema wa data ya umbizo la waya la Protobuf. Mfumo huu pia unajumuisha utenganishaji wa fremu za TLV.

Igiza Mfuatano Mdogo wa Maelekezo

python .agents/tools/re-toolkit/cli.py emulate --code B82A000000505BC3

Kiigaji kidogo hutoa sandbox iliyotengwa ya rejesta, stack na kumbukumbu kwa uchanganuzi unaoungwa mkono wa kiwango cha CPU.

Tengeneza Hook ya Frida

python .agents/tools/re-toolkit/cli.py gen-hook --symbol CryptHashData --module advapi32.dll --output hook.js

Hii hutengeneza hati ya interceptor ya Frida kwa moduli na alama iliyochaguliwa. Zana hii pia inasaidia utengenezaji wa hati za kuzuia utatuzi.

Hesabu Patch ya Tofauti ya Binary

python .agents/tools/re-toolkit/cli.py diff-patch --orig orig.bin --patched mod.bin --json

Hii hulinganisha binary asili na nakala iliyobadilishwa na kutoa maelezo ya patch.

Kagua Eneo kama Hex Dump

python .agents/tools/re-toolkit/cli.py hexdump target.bin --offset 0x100 --length 128

Hii hupanga baiti 128 zinazoanza kwenye offset 0x100 kama hex dump iliyopangiliwa.

Endesha Pipeline ya Hatua Mbili

Mradi huu unajumuisha pipeline ya hatua mbili inayotenganisha upangaji wa kimuundo na uwasilishaji wa mwisho. Hatua ya kwanza huunda muundo na vipengele vikuu, huku ya pili ikitoa matokeo kamili. Utenganishaji huu unalenga kupunguza kupungua kwa umakini, kukatwa kwa matokeo na mabaki ya vishikilia nafasi halisi kama vile ROLE_A na ROLE_B.

python .agents/tools/re-toolkit/cli.py pipeline "Your complex scenario or system architecture prompt"

Mtiririko huu unafaa zaidi kwa vidokezo changamano vinavyonufaika na maandalizi ya wazi ya muundo kabla ya uundaji wa kina.

Sanidi Zana Nyingine za Wakala Zinazotumika

Kifurushi hiki kinajumuisha faili asilia za usanidi kwa mazingira kadhaa ya mawakala, ikiwa ni pamoja na AGENTS.md kwa Codex CLI, OPENCODE.md na opencode.json kwa OpenCode, CLAUDE.md kwa Claude Code, .cursorrules kwa Cursor, na .windsurfrules kwa Windsurf.

Ili kusanidi na kusawazisha mifumo ya mawakala inayotegemea GPT na miunganisho ya IDE inayotumika katika nafasi ya kazi, endesha adapta ya jumla:

ADAPT_ALL.cmd

Pia unaweza kuhamisha mipangilio iliyotayarishwa kupitia re-toolkit:

python .agents/tools/re-toolkit/cli.py export-preset --target all

Hazina hii inajumuisha mipangilio tofauti ya ChatGPT App katika docs/CHATGPT_APP_PRESET.md.

Vidokezo vya Juu

Pendelea Matokeo Yenye Muundo kwa Uendeshaji Otomatiki

Tumia --json pale amri inapoiunga mkono. Matokeo yenye muundo kutoka kwa uchanganuzi wa PE, uchanganuzi wa mifumo, upangaji wa kiotomatiki, au tofauti za jozi ni rahisi kuhifadhi, kulinganisha, na kupitisha kwa zana nyingine.

Unganisha Amri za Uchambuzi

Anza na auto kwa ugunduzi wa umbizo, endelea na parse-pe kwa metadata ya kitekelezaji, tumia strings kutafuta viashiria vinavyosomeka, na tumia pattern-scan unapokuwa na sahihi ya baiti inayoweza kuwa lengwa. Tumia disasm, emulate, au gen-hook kwa ukaguzi wa kina zaidi hatua kwa hatua.

Tumia Uchunguzi wa Kukisia kwa Uangalifu

Zana hii inatoa uchunguzi wa kivuli wa kukisia unaotumia miundo miwili, ukiwa na kusitisha unapokataliwa na njia ya kushindwa:

python .agents/tools/re-toolkit/cli.py spec-probe "Reverse engineer target module and extract memory offsets" --target game.dll --json

Tumia uwezo wa uchanganuzi wa jozi pekee kwenye programu na data ambazo umeidhinishwa kukagua.

Hifadhi Risiti

Usifute risiti iliyotengenezwa ikiwa huenda ukahitaji kutendua usakinishaji. Risiti huhifadhi mfuatano wa shughuli unaohitajika kuondoa faili mpya zilizosakinishwa, kurejesha faili zilizobadilishwa, na kurejesha usanidi wa awali wa hook ya Git.

Elewa Mipangilio ya Kawaida ya Usalama

Nje ya tabia ya TURBO iliyochaguliwa wazi, toleo la umma huanza na mipangilio hii inayoweza kukaguliwa:

approval_policy = "on-request"
sandbox_mode = "workspace-write"

Sheria za kuanzia hazijumuishi viambishi vya amri vilivyoidhinishwa mapema isipokuwa hali ya TURBO ichaguliwe. Tumia mipangilio ya kawaida unapotaka mipaka ya uthibitishaji na uandishi unaozingatia nafasi ya kazi.

Batili Usakinishaji

Ili kurejesha usakinishaji wa hivi karibuni uliorekodiwa, endesha:

.\rollback.ps1

Ili kurejesha muamala fulani, toa risiti yake wazi:

.\rollback.ps1 -Receipt 'C:\path\to\receipt.json'

Watumiaji wa Git Bash wanaweza kutumia kifungashio:

./ROLLBACK.sh

Ubatilishaji huondoa faili zilizoongezwa na kisakinishi, hurejesha faili zilizokuwepo kabla ya usakinishaji, na hurejesha au kuondoa thamani ya awali ya core.hooksPath ya hazina.

Nyaraka Zaidi

Kwa dhana za msingi za Codex, soma nyaraka rasmi za Codex CLI, misingi ya usanidi, AGENTS.md, sheria, hooks, skills, na plugins.

Hitimisho

Codex CLI Portable Setup Kit hukusanya pamoja wasifu wa Codex unaolenga utekelezaji, maagizo ya mradi, miunganisho ya mawakala, zana za uchanganuzi zenye matokeo thabiti, uthibitishaji, nakala rudufu, na ubatilishaji katika usanidi mmoja unaoweza kuzalishwa tena. Anza na usakinishaji wa kawaida wa miamala unapotaka vidhibiti vinavyoweza kukaguliwa, thibitisha matokeo, na washa hali ya TURBO pekee wakati tabia yake iliyoinuliwa na isiyohitaji mwingiliano inafaa kwa nafasi ya kazi inayoaminika.