استعمل ChatGPT باش تخطّط وتراجع مهام البرمجة ديال Codex

شنو كيدير Codex مع ChatGPT

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

الهدف هو تستعمل اشتراك ChatGPT Plus ولا Pro الموجود فالويب فالتخطيط والمراجعة، بلا ما تصرف التوكنات المحدودة ديال API ولا Codex على هاد المراحل. المشروع ما كيحتاج حتى API key وما كيستعملش reverse proxy.

المستودع ديالك ما كيتحمّلاش كامل. ChatGPT كيطلب غير معلومات مساحة العمل اللي محتاجها عبر جسر Model Context Protocol محمي بـ OAuth وصلاحية القراءة فقط. المشروع غير رسمي ومن تطوير المجتمع، وما عندوش علاقة بـ OpenAI وماشي معتمد منها.

كيفاش خدام سير العمل

النظام كيفصل التواصل بين control plane وdata plane.

• Control plane: Codex وChatGPT كيتبادلو رسائل صغار ومنظمة ديال الحالة عبر Computer Use. سير العمل كيدوز من INIT → PLAN → EXECUTED → REVIEW → DONE. محتوى الملفات، والفروقات، والسجلات ما كيتلصقوش فهاد الرسائل.
• Data plane: ChatGPT كيقرا بيانات مساحة العمل الضرورية عبر جسر MCP بصلاحية القراءة فقط.
• التنفيذ: Codex هو المسؤول على أوامر shell، وتغييرات الملفات، وعمليات Git، والاختبارات، والإصلاحات.
• مراجعة مستقلة: ChatGPT كيفحص فرق Git الحقيقي وحالة الاختبارات المسجلة، وما كيعتمدش غير على ادعاء بأن الخدمة نجحات.

الجسر كيوفّر ثمانية أدوات بصلاحية القراءة فقط:

• workspace_info
• list_directory
• read_file
• search_workspace
• git_status
• git_diff
• test_status
• execution_summary

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

• ولوج مساحة العمل بالقراءة فقط: الجسر ما عندوش أدوات الكتابة، أو الحذف، أو shell، أو commit.
• عزل مساحة العمل: كل توكن مربوط بمساحة عمل وحدة. الفحوصات ديال المسار canonical كتحظر الهروب عبر symlink، أو المجلد الأب، أو المسارات المطلقة.
• الحماية ديال الملفات الحساسة: الملفات بحال نسخ .env، وبيانات الدخول، ومواد SSH، والمفاتيح مرفوضة افتراضياً. .env.example مسموح.
• استثناءات مخصصة: ملف .c2cignore يقدر يزيد قواعد خاصة بالمشروع.
• نقطة نهاية عامة محمية: نقطة MCP كتستعمل OAuth 2.1 مع PKCE S256، وتسجيل ديناميكي للعميل، وتدوير refresh-token، وإلغاء التوكنات.
• الربط لمرة وحدة: المتصفح كيتوصل غير بكود للاستعمال مرة وحدة، صالح لخمس دقايق، وبحد أقصى خمسة ديال المحاولات، مع تحديد المعدل وإتلاف الكود من بعد الاستعمال.
• تدبير تلقائي للنفق: المشروع كيستعمل Cloudflare Quick Tunnel للاتصال العام، مع بقاء خادم HTTP المحلي متاح غير عبر loopback.
• تحديثات تلقائية لـ Skill: Codex Skill كيفحص GitHub مرة فالنهار وكيحدّث راسو ملي كيتوفر إصدار جديد.

المتطلبات المسبقة

المشروع كيحتاج البرامج التالية:

• Node.js 20 ولا أحدث
• Git
• cloudflared للاتصال العام
• بيئة Codex قادرة على تثبيت وتشغيل Skill المرفقة
• الولوج لتطبيق ChatGPT فالويب

الإعداد التلقائي يقدر يثبت التبعيات الناقصة باستعمال Homebrew فـ macOS ولا winget فـ Windows. ممكن تحتاج توقف شوية باش تتكلف بتسجيل الدخول لـ ChatGPT ولا Cloudflare، أو CAPTCHA، أو طلب المصادقة الثنائية.

الخيار 1: خلّي Codex يثبت كلشي

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

خطوات البناء الأساسية هي:

git clone https://github.com/XiaoDuoYa/codex-with-chatgpt ~/codex-with-chatgpt
cd ~/codex-with-chatgpt
corepack pnpm install
corepack pnpm build

من بعد خاص Codex ينسخ skill/SKILL.md للمسار التالي:

~/.codex/skills/codex-with-chatgpt/SKILL.md

فالملف المنسوخ، خاصو يحدّث السطر اللي كيبدا بـ The codex-with-chatgpt checkout lives at: باش يشير للنسخة الفعلية من المستودع.

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

الخيار 2: ثبت Skill يدوياً

إلا كان المستودع محمّل ومبني من قبل، نسخ المجلد ديال skill/ للمجلد ديال Skills ديال Codex:

~/.codex/skills/codex-with-chatgpt/

ومن بعد طلب من Codex:

وجد Codex مع ChatGPT.

Codex كيتكلف بالجسر، والنفق، وعملية الربط، وإعداد الموصل. الإعداد الناجح كيعرض لائحة تحقق بحال هادي:

Codex مع ChatGPT

✓ المشروع تكتاشف
✓ بدا Workspace Bridge
✓ تدار الاتصال الآمن
✓ تّربط ChatGPT
✓ اختبار قراية الملف داز

واجد.

تأكد باللي اختبار قراية الملف داز قبل ما تبدا الخدمة الحقيقية. هاد الشي كيتحقق بأن ChatGPT يقدر يوصل لمساحة العمل الحالية عبر الجسر اللي عندو صلاحية القراءة فقط.

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

من بعد الإعداد، بقا خدام بـ Codex عادي، ولكن طلب منو بوضوح يدخل ChatGPT فالمهمة.

استعمل Codex مع ChatGPT باش تنفذ XXX.

بدّل XXX بطلب برمجي واضح. مثلاً:

ستعمل Codex مع ChatGPT باش تطبّق التحقّق من المدخلات ففورم التسجيل وتشغّل الاختبارات المعنيّة.

الطريقة المتوقعة هي:

1. Codex كيتعرّف على المشروع النشيط وكيشغّل جسر مساحة العمل.
2. ChatGPT كيتفحّص الملفات المعنيّة باستعمال أدوات MCP للقراءة فقط.
3. ChatGPT كيقدّم خطة.
4. Codex كيطبّق الخطة، كيعدّل الملفات، وكيشغّل الأوامر ولا الاختبارات.
5. ChatGPT كيقرا Git diff الفعلي وسجلات الاختبارات.
6. ChatGPT كيراجع النتيجة وكيحدّد أي خدمة متابعة ضرورية.
7. Codex كيطّبق الإصلاحات حتى توصل العملية للحالة DONE.

حيت ChatGPT ما يقدرش يكتب عبر الجسر، فأي تعديل فالمستودع كيبقى تحت تحكّم Codex فالتنفيذ.

التثبيت والأوامر ديال المطوّرين

المطوّرين اللي بغاو يبنيو المشروع ولا يفحصوه مباشرة يقدرو يستعملو pnpm:

pnpm install
pnpm build
pnpm test

عملية البناء كتنشئ dist/ وكتوفّر الملف التنفيذي ديال سطر الأوامر c2c. مجموعة الاختبارات كتستعمل Vitest، ووفقاً للحالة الموثّقة ديال المشروع كتضم 76 اختبار كيغطي أمان المسارات، وOAuth، والاقتران، وسلوك MCP من البداية للنهاية.

شغّل إعداد الجسر والنفق والاقتران كامل بهاد الأمر:

c2c setup

ومن بين أوامر التسيير الأخرى كاينين:

c2c status
c2c doctor
c2c pair
c2c unpair
c2c logs
c2c stop

• c2c status كيتحقّق من الحالة الحالية ديال الخدمة.
• c2c doctor هو الأمر الرئيسي للتشخيص.
• c2c pair وc2c unpair كيسيرو الاقتران مع ChatGPT.
• c2c logs كيفتح سجلات التشخيص.
• c2c stop كيوقّف الخدمة اللي خدامة.

فهم هيكلة المشروع

المستودع كيفصل بين مكوّنات الأمان، والنقل، ومساحة العمل، وتجربة المستخدم:

• src/bridge/ فيه خادم HTTP المحلي، واسترجاع المنفذ، وواجهة الإدارة API.
• src/mcp/ كيطبّق الأدوات الثمانية للقراءة فقط عبر Streamable HTTP بلا حالة.
• src/auth/ فيه OAuth 2.1، وPKCE، وتسجيل العملاء بشكل ديناميكي، وتدوير رموز التحديث، والإلغاء.
• src/pairing/ كيطبّق رموز اقتران لمرة وحدة وآمنة تشفيرياً، مع انتهاء الصلاحية وحدود المعدّل.
• src/workspace/ كيتكلف بحصر المسارات، وسياسة الملفات الحساسة، والبحث، والوصول إلى Git.
• src/tunnel/ كيوفّر تجريد النفق وتكامل Cloudflare Quick Tunnel.
• src/execution/ كيخزّن سجلات التنفيذ المستعملة أثناء المراجعة.
• src/process/ كيسير دورة حياة الخدمة الخلفية.
• src/cli/ كيطبّق واجهة سطر الأوامر c2c.
• skill/ فيه مهارة Codex اللي كتوفّر تجربة المستخدم الرئيسية.
• tests/ فيه اختبارات الوحدات والاختبارات التكاملية.
• docs/ فيه توثيق البنية، والبروتوكول، والأمان، واستكشاف الأخطاء وإصلاحها.

نصائح متقدّمة

استثناء ملفات إضافية

السياسة المدمجة كتحظر الأسرار الشائعة، ولكن الملفات السرية الخاصة بالمشروع تقدر تستعمل أسماء مختلفة. زِد قواعد المطابقة فـ .c2cignore باش الجسر ما يكشفش هاد المسارات عبر أدوات القراءة فقط ديالو.

استعمل حلقة المراجعة على نتائج قابلة للتحقّق

طلب الاختبارات كجزء من المهمة باش ChatGPT يقدر يفحص Git diff الفعلي وسجلات الاختبارات بجوج. بهاد الطريقة كتستافد من تصميم المراجعة المستقلة، بلا ما تعتمد غير على تصريح نجاح مكتوب من وكيل التنفيذ.

شخّص المشكل قبل ما تعاود الإعداد

إلى حبسات الخدمة، شغّل c2c status وc2c doctor فالأول. استعمل c2c logs باش تاخذ معلومات تشخيصية إضافية. عاود الاقتران باستعمال c2c unpair ومن بعد c2c pair غير ملي تكون محتاج تصفّر إعدادات الاقتران.

خلّي المهارة محدّثة

المهارة كتفحص GitHub مرة فالنهار على الإصدارات الجديدة. وتقدر حتى تطلب مباشرة من Codex يحدّث Codex مع ChatGPT فكل وقت بغيتي تطلق تحديث.

راجع توثيق الأمان

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

حدود الأمان اللي خاصك تفتكرها

الوصول للقراءة فقط كيقلّل المخاطر، ولكن ما زال كيسمح لـ ChatGPT يتلقّى، عند الطلب، الكود المصدري المسموح به وبيانات مساحة العمل الوصفية. المسارات الحساسة مرفوضة افتراضياً، والاستثناءات المخصّصة تقدر تقوّي هاد الحدّ فمستودع معيّن.

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

الخلاصة

Codex مع ChatGPT كيدير تقسيم واضح للمسؤوليات: ChatGPT كيخطّط وكيراجع، وCodex كينفّذ. جسر MCP ديالو للقراءة فقط، وحماية OAuth، وعزل مساحة العمل، وسياسة الملفات الحساسة، والمراجعة المستقلة للـ diff، كاملين مصمّمين باش يخليو هاد التعاون مضبوط وقابل للتحقّق. من بعد تثبيت المهارة والمرور من عملية الاقتران الأولى، تقدر تطلق العملية بطلب عادي من Codex وتسيرها عبر واجهة سطر الأوامر c2c.