دوز مباشرة للمحتوى الرئيسي
دروس فالذكاء الاصطناعي

بني فضاء خدمة Codex CLI كيركّز على التنفيذ باستعمال Portable Setup Kit

تعلّم كيفاش تهيّأ Portable Setup Kit ديال Codex CLI فـ Windows، تطلق سيرورة TURBO ديالو، تتأكّد من التثبيت المعامَلاتي، تستعمل أدوات الهندسة العكسية المرفقة، تزامن وكلاء الذكاء الاصطناعي المدعومين، وترجّع الملفات السابقة باستعمال التراجع المبني على إيصالات التثبيت.

حوالي 26 دقايق ديال القراية
بني فضاء خدمة Codex CLI كيركّز على التنفيذ باستعمال Portable Setup Kit

شنو كيدير كيت إعداد Codex CLI المحمول

كيت إعداد Codex CLI المحمول هو إعداد ومثبّت كيطوّرو المجتمع لـ OpenAI Codex CLI. ماشي هو Codex براسو، وماشي منتوج رسمي ديال OpenAI.

هاد الكيت كيبدّل الطريقة اللي كيتعامل بها Codex مع خدامات المستودعات. التعليمات ديالو كتركّز على تفقد مساحة العمل، واستعمال الأدوات المتاحة، وتنفيذ التغييرات المطلوبة، وتشغيل الفحوصات، وتشخيص الأعطاب، والإبلاغ على النتائج اللي تْتحققات. قابلية النقل هي غير طريقة التوصيل؛ أما المنتوج الرئيسي فهو أسلوب تشغيل كيعطي الأولوية للتنفيذ.

مهم: الوضع TURBO كيفعّل سلوك مرفوع الصلاحيات وغير تفاعلي، ومنه approval_policy = "never". استعملو غير فمساحة عمل كتّيق فيها ومن بعد ما تراجع الحزمة. الإعداد العمومي العادي كيبدا بالموافقة عند الطلب وبعزل workspace-write الأكثر أماناً.

المزايا الرئيسية

  • تعليمات كتقدّم التنفيذ: كيتوجّه Codex باش يخدم على الهدف الحقيقي، عوض ما يوقف من بعد نصائح عامة ولا خطة.
  • تشغيل TURBO بكليك وحدة: TURBO.cmd كيتحقق من مساحة العمل، وكيضبط سياسات التنفيذ المرفوع الصلاحيات، وكيورّث إعدادات النموذج الأصلية، وكيشغّل Codex.
  • تثبيت معاملات قابل للرجوع: المثبّت كيتحقق من بيانات SHA-256، وكيصايب نسخ احتياطية مؤرخة، وكيحفظ سجل العمليات، وكيولّد وصل الاسترجاع.
  • أدوات تحليل حتمية: re-toolkit المكتوب بالكامل بـ Python كيتكلف بفحص PE32 وPE32+، وتفكيك x86 وx64، والبحث بـ AOB، والمحاكاة الدقيقة، وتحليل Protobuf وTLV، وتوليد خطافات Frida، ومقارنة الاختلافات الثنائية.
  • معالجة على جوج مراحل: التخطيط البنيوي مفصول على العرض عالي الدقة، باش ينقص ظهور العناصر النائبة والمخرجات الطويلة المتدهورة.
  • صيغ متعددة للوكلاء: الحزمة كتوفّر تعليمات ولا إعدادات مسبقة لـ Codex CLI وOpenCode وClaude Code وCursor وWindsurf وتطبيق ChatGPT.
  • دعم الاستمرارية: الخطافات وأدوات السياق كيساعدو يحافظو على الحالة اللي تْتحققات فالمهام الطويلة.
  • تكامل Git قابل للعكس: المثبّت يقدر يربط core.hooksPath بحارس pre-commit المرفق، ويرجّع القيمة السابقة أثناء الاسترجاع.

المتطلبات والتحضير

المستودع كيحدّد Windows 10 و11، وPowerShell 5.1 ولا 7، وPython 3.10 ولا أحدث كمكوّنات مدعومة. Codex CLI مطلوب لسير العمل الرئيسي، مع أن المثبّت يقدر يزيد حزمة عمومية متوافقة ومثبتة الإصدار @openai/codex إلا ما كانش Codex موجود.

  1. هبّط ZIP ديال إصدار ولا دير clone للمستودع.
  2. فكّ الضغط فمجلد محلي إلا هبطتي ZIP.
  3. اختار المستودع اللي غادي يدبّر Codex.
  4. راجع السكريبتات والإعدادات المرفقة قبل ما تفعّل التنفيذ المرفوع الصلاحيات ولا غير المقيّد.
  5. دير نسخة احتياطية مستقلة لأي بيانات مهمة بزاف فمساحة العمل، حتى إلا كان المثبّت كينشئ نسخاً احتياطية معاملات.

الخيار 1: البداية بوضع TURBO

إلى بغيتي أقصر مسار للإعداد، فكّ الإصدار ودير double-click على:

TURBO.cmd

المشغّل كيتحقق من مساحة العمل، وكيضبط بروفايل التنفيذ المرفوع الصلاحيات، وكيستعمل إعدادات النموذج الأصلية ديالك، وكيفتح Codex واجد للخدمة. هاد الوضع حتى هو كيعطي موافقة مسبقة لأدوات وقت التشغيل، وكيعتبر مساحات العمل موثوقة بالكامل، وكيستعمل سلوك موافقة غير تفاعلي.

حيت هاد الإعدادات كتنقص حواجز التأكيد، خلّي وضع TURBO غير للكود اللي تراجع ولمساحات العمل اللي كتّيق فيها. إلى بغيتي تثبيت أكثر تحكماً، استعمل المسطرة اليدوية اللي لتحت.

الخيار 2: دير تثبيت يدوي للمعاملات

حلّ PowerShell فمجلد الكيت اللي فكّيتيه. سمح مؤقتاً لسكريبت التثبيت فعملية PowerShell الحالية، ومن بعد عطيو المسار المطلق لمساحة العمل المستهدفة:

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

المثال كيختار إعداد unrestricted ديال Keysmith وكيتجاوز الإضافات الاختيارية. راجع هاد الاختيارات قبل ما تستعملها فبيئتك.

أثناء التثبيت، الكيت كيتبع تسلسل معاملات:

  1. التحقق من جذر المشروع.
  2. التحقق من الحزمة المصدر بمقابل بيان SHA-256 ديالها.
  3. إنشاء نسخة احتياطية مؤرخة وسجل للعمليات.
  4. تثبيت ملفات المستخدم، والمهارات، وملفات المشروع، وأدوات السياق، وre-toolkit.
  5. تعويض المسارات المطلوبة من طرف البيئة الهدف.
  6. ضبط الثقة فالمشروع ومسار خطاف Git ديال المستودع.
  7. محاولة إعداد الإضافات الاختيارية إلا تطلبات، بلا ما يعتبر فشل الإضافة خطأ قاتل.
  8. كتابة receipt.json وlast-receipt.txt.

كل تعويض كيتسجّل قبل ما يوقع. إلا فشلت شي خطوة من بعد فالتثبيت، المثبّت كيعيد لائحة العمليات بالعكس وكيرجّع الربط السابق ديال خطاف Git.

شنو كيزيد المثبّت

  • إعدادات المستخدم ديال Codex: الملفات اللي كاينة تحت %CODEX_HOME% ولا ~/.codex، ومن بينها config.toml وAGENTS.md والتعليمات والقواعد الأولية والمهارات.
  • مهارات الوكيل على مستوى المستخدم: المهارات القابلة لإعادة الاستعمال تحت ~/.agents.
  • إعدادات المشروع: AGENTS.md وCLAUDE.md و.codex و.agents و.gitignore ومسارات العمل ديال السياق والـhooks وأدوات الهندسة العكسية.
  • إعدادات Git المحلية: core.hooksPath=.agents/git-hooks للمستودع المختار.
  • واجهة Codex CLI: تثبيت عام ديال npm، مثبت على إصدار متوافق، إلا ما كانش Codex متاح من قبل.
  • الإضافات الاختيارية: دعم Browser وVisualize وSites إلا كان متاح.

الإصدار كيستثني عن قصد بيانات الاعتماد والحالة المرتابطة بالجهاز. ما كينقلش بيانات المصادقة ولا بيانات OAuth ولا الجلسات ولا السجلات التاريخية ولا ملفات السجل ولا ذاكرة التخزين المؤقت ولا قواعد بيانات SQLite ولا ملفات تعريف الارتباط ولا مفاتيح API ولا المفاتيح الخاصة ولا بيانات تشغيل المتصفح ولا مسارات الملفات الثنائية ديال سطح المكتب ولا حالة تشغيل السياق من حاسوب آخر.

تحقّق من الحزمة والتثبيت

شغّل سكريبت التحقق من الحزمة قبل ما تعتمد على الإعداد:

.\verify.ps1

باش تتحقق من الملفات اللي تثبتات فمساحة عمل معيّنة، زِد -Installed ومسار المشروع:

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

التحقق جزء مهم من التصميم. المثبّت كيتحقق من الـmanifest قبل الكتابة وكيمنع اجتياز مسارات الـmanifest. والمستودع كيوصف حتى مجموعة Test-All.ps1 فيها تسع خطوات، كتستعمل لاختبار الإصدار.

الاستعمال الأساسي مع Codex

من بعد التثبيت، شغّل Codex فالمستودع المهيّأ عبر TURBO.cmd ولا عبر طريقة Codex CLI العادية ديالك. عطيو مهمة واضحة فالمستودع، ماشي طلب عام ديال النصيحة.

مثلاً، طلب من Codex يفحص اختبار فاشل، يطبّق التصحيح، يعاود يشغّل الفحوصات المعنية، ويلخّص الملفات اللي تبدلات. التعليمات المثبتة مصممة باش تخلي الوكيل ينتاقل من الفحص للتنفيذ والتحقق كلما كان الإجراء الموالي متاح.

يمكن تصاغ مهمة مناسبة بهاد الشكل:

فحّص الاختبارات الفاشلة فمساحة العمل هادي، حدّد السبب الجذري، طبّق أصغر إصلاح صحيح، عاود شغّل الاختبارات المتأثرة، وبلّغ بالنتيجة اللي تم التحقق منها.

الملف الشخصي مخصص باش يشجّع Codex يفحص الملفات ومخرجات الاختبارات أولاً، ويعدّل المشروع الفعلي، ويعاود المحاولات ديال الفحوصات الفاشلة، ومن بعد يقدّم نتيجة مختصرة عوض ما يرجّع درساً خاصك تنفّذو يدوياً.

استعمل مجموعة أدوات الهندسة العكسية المدمجة

مجموعة الأدوات مثبتة فـ.agents/tools/re-toolkit/ داخل المشروع. نقطة الدخول الموحدة ديالها هي cli.py. الأوامر اللي كتدعم --json مفيدة بزاف ملي كيحتاج سكريبت آخر ولا وكيل لمخرجات منظمة.

فرز ملف ثنائي أوتوماتيكياً

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

هاد الأمر كيدير اكتشاف أوتوماتيكي للصيغة وفرزاً أولياً للهدف.

فحص ملف PE

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

محلّل PE يقدر يفحص الترويسات وجداول الأقسام وملفات DLL المستوردة والرموز المصدّرة ومعلومات تحويل RVA لملفات PE32 وPE32+.

البحث على نمط AOB

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

استعمل ?? كرمز بدل ملي تقدر تختلف البايتات بين الملفات الثنائية ولا الإصدارات.

استخراج السلاسل النصية

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

هاد الأمر كيستخرج السلاسل ASCII وUTF-16LE مع الإزاحات ديالها، وكيصفّي السلاسل اللي أقصر من الحد الأدنى المختار.

تفكيك تعليمات المعالج

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

المفكّك كيدعم تحليل x86 وx64 للتعليمات الخام ولا لأقسام الملفات الثنائية.

فك ترميز حمولة Protobuf غير موثّقة

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

هاد الأمر كيدير فحصاً بلا مخطط لبيانات صيغة Protobuf السلكية. والنظام الفرعي كيتضمن حتى تفكيك إطارات TLV.

محاكاة تسلسل صغير ديال التعليمات

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

المحاكي المصغّر كيوفّر بيئة معزولة للسجلات والمكدس والذاكرة، لتحليل مستوى المعالج فالتعليمات المدعومة.

إنشاء Hook ديال Frida

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

هاد الأمر كينشئ سكريبت اعتراض ديال Frida للوحدة والرمز المختارين. ومجموعة الأدوات كتدعم حتى إنشاء سكريبتات مضادة للتنقيح.

حساب رقعة الفرق بين ملفين ثنائيين

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

كيقارن هاد الأمر ملفاً ثنائياً أصلياً مع نسخة معدّلة منه، وكيخرج معلومات الرقعة.

فحص منطقة على شكل تفريغ سداسي عشري

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

كيصيغ هاد الأمر 128 بايت ابتداءً من الإزاحة 0x100 على شكل تفريغ سداسي عشري محاذى.

شغّل المسار ذي المرحلتين

المشروع فيه مسار من جوج مراحل كيفصل بين التخطيط البنيوي والإخراج النهائي. المرحلة الأولى كتنشئ البنية والمحطات الرئيسية، والمرحلة الثانية كتنتج المخرجات كاملة. هاد الفصل مخصص باش ينقص من انهيار الانتباه والاقتطاع وبقايا العناصر النائبة الحرفية بحال ROLE_A وROLE_B.

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

هاد المسار كيناسب بزاف البرومبتات المعقدة اللي كتستافد من تحضير هيكلي واضح قبل التوليد المفصل.

كوّن أدوات الوكلاء المدعومة الأخرى

الحزمة فيها ملفات إعداد أصلية لعدد من بيئات الوكلاء، من بينها AGENTS.md لـ Codex CLI، وOPENCODE.md وopencode.json لـ OpenCode، وCLAUDE.md لـ Claude Code، و.cursorrules لـ Cursor، و.windsurfrules لـ Windsurf.

باش تهيّأ وتزامن أطر عمل الوكلاء المعتمدة على GPT وتكاملات IDE المدعومة فمساحة العمل، شغّل المكيّف الشامل:

ADAPT_ALL.cmd

وتقدر حتى تصدّر الإعدادات الجاهزة باستعمال re-toolkit:

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

المستودع فيه إعداد مستقل لتطبيق ChatGPT فـ docs/CHATGPT_APP_PRESET.md.

نصائح متقدمة

فضّل المخرجات المهيكلة للأتمتة

استعمل --json فالأوامر اللي كاتدعمو. النتائج المهيكلة ديال تحليل PE، وفحص الأنماط، والفرز التلقائي، ولا الفروقات بين الملفات الثنائية، كتكون أسهل فالحفظ والمقارنة وتمريرها لأداة أخرى.

جمع أوامر التحليل

بدا بـ auto باش تكتاشف الصيغة، ومن بعد كمّل بـ parse-pe باش تجيب بيانات الملف التنفيذي، واستعمل strings باش تلقى المؤشرات القابلة للقراءة، وطبّق pattern-scan ملي تكون عندك بصمة مرشحة للبايتات. استعمل disasm أو emulate أو gen-hook للفحص التدريجي الأعمق.

استعمل المسبار التخميني بحذر

الأدوات كتوفّر مسبار ظلّ تخميني بنموذجين، مع إيقاف فحالة الرفض وتحويل احتياطي:

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

استعمل قدرات تحليل الملفات الثنائية غير فالبرامج والبيانات اللي عندك الصلاحية تفحصها.

خلي الإيصالات محفوظة

ما تمسحش الإيصال المُنشأ إلا كان ممكن تحتاج ترجع التثبيت. الإيصال كيخزّن تسلسل العمليات اللازم لحذف الملفات اللي تثبّتات حديثاً، واسترجاع الملفات اللي تبدلات، واستعادة إعداد Git hook السابق.

فهم الإعدادات الأمنية الافتراضية

خارج سلوك TURBO اللي كتختارو بشكل صريح، النسخة العمومية كتبدأ بهاد الإعدادات القابلة للمراجعة:

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

القواعد الأولية ما فيهاش بادئات أوامر مصادق عليها مسبقاً إلا تختار وضع TURBO. استعمل الإعدادات الافتراضية العادية ملي بغيتي حدود للتأكيد وعمليات كتابة محصورة فمساحة العمل.

تراجع على التثبيت

باش ترجع آخر تثبيت مسجّل، شغّل:

.\rollback.ps1

وباش ترجع معاملة معيّنة، عطِ الإيصال ديالها بشكل صريح:

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

مستعملو Git Bash يقدرو يشغّلو الغلاف:

./ROLLBACK.sh

التراجع كيحيد الملفات اللي زادها المُثبّت، وكيرجع الملفات اللي كانت موجودة قبل التثبيت، وكيرجع أو كيلغي القيمة السابقة ديال core.hooksPath فالمستودع.

وثائق إضافية

بالنسبة للمفاهيم الأساسية ديال Codex، راجع الوثائق الرسمية ديال Codex CLI، وأساسيات الإعداد، وAGENTS.md، والقواعد، والخطّافات، والمهارات، والإضافات.

الخلاصة

حزمة Codex CLI Portable Setup Kit كتجمع فإعداد واحد قابل لإعادة الإنتاج بروفايل Codex مركز على التنفيذ، وتعليمات المشروع، وتكاملات الوكلاء، وأدوات تحليل حتمية، والتحقق، والنسخ الاحتياطية، والتراجع. بدا بالتثبيت المعاملاتي العادي ملي بغيتي ضوابط قابلة للمراجعة، وتحقق من النتيجة، وما فعّلش وضع TURBO حتى يكون السلوك ديالو المرتفع وغير التفاعلي مناسب لمساحة عمل موثوقة.