إدارة Codeberg برمجياً بالكامل

تُمكّن مهارة Codeberg وكيلَ الذكاء الاصطناعي الخاص بك من التفاعل مع مستودعات Codeberg (المبنية على Gitea) بنفس مستوى العمق الذي يتمتع به المطور البشري. بينما تُحسَّن معظم أدوات الذكاء الاصطناعي حصراً لـ GitHub، توفر هذه المهارة جسراً متخصصاً لنظام Forgejo/Gitea البيئي، مما يتيح عمليات Git المتطورة مباشرةً عبر Gitea REST API v1.

تحكم متقدم في المستودعات

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

• إدارة SHA تلقائياً: تمنع تعارضات الدمج عبر جلب وإدارة SHA الكائنات تلقائياً عند تحديث الملفات.
• الالتزامات الدُفعية المعقدة: تُنفّذ سير عمل Git Trees API المكوّن من 5 خطوات لدفع ملفات متعددة في التزام ذري واحد.
• تنسيق الإصدارات: إنشاء الإصدارات وإدارة الوسوم ورفع الأصول الثنائية برمجياً.
• توجيه الطلبات الذكي: يتميز ببنية تُعطي الأولوية للوكيل الوسيط للحفاظ على رموز API على جهازك المحلي لأقصى قدر من الأمان.

لماذا هي أفضل من الاستخدام المباشر للنماذج؟

كثيراً ما يُفضي الاستخدام المباشر لـ API عبر النماذج إلى أخطاء في ترميز Base64 وتنسيق المسارات وإدارة الحالة. توفر هذه المهارة للوكيل إطار تنفيذ موثوقاً، مما يضمن إجراء نقل الملفات وإدارة الفروع والبحث في المستودعات وفق المعايير المحددة لـ Gitea. وتتضمن منطق احتياطي تلقائي ومعالجة رموز محلية لا تستطيع سياقات LLM القياسية محاكاتها.

حساب واحد أو حسابات متعددة

صُمِّمت المهارة عمداً للحساب الواحد للحد من التعرض للمخاطر. إذا تمت مشاركة ملف المهارة أو تسريبه، فلن يكون سوى حساب واحد في خطر.

• حساب واحد: أدخل رمز API مباشرةً في إعدادات المهارة. لا حاجة لوكيل وسيط، يعمل فور التثبيت.
• حسابات متعددة: قم بتهيئة حسابات إضافية في Tunnel-Proxy (https://codeberg.org/Vokuar/Tunnel-Proxy). يبقى رمز كل حساب على جهازك ولا يلمس ملف المهارة أبداً. يتولى الوكيل الوسيط التوجيه بين الحسابات تلقائياً.

إعداد الوكيل الوسيط (موصى به)

شغّل Tunnel-Proxy محلياً وأنشئ نفقاً له عبر ngrok حتى يتمكن Claude من الوصول إليه من أي مكان. تتوفر تعليمات الإعداد الكاملة لـ Windows وmacOS وLinux وTermux بما في ذلك التشغيل التلقائي على:

https://codeberg.org/Vokuar/Tunnel-Proxy

يُعرَّف سر الوكيل الوسيط بـ PROXY_SECRET بالقرب من أعلى proxy.py. عيّن القيمة ذاتها في إعدادات المهارة تحت PROXY_SECRET.

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

السماح بالنطاقات في إعدادات Claude

تحجب بيئة Claude الطلبات الصادرة افتراضياً. تحتاج إلى إضافة أي نطاق يحتاج Claude للوصول إليه إلى القائمة البيضاء.

1. افتح Claude > Settings > Capabilities
2. تأكد من تفعيل Cloud code execution and file creation
3. تحت Domain allowlist، أضف codeberg.org
4. إذا كنت تستخدم الوكيل الوسيط، أضف أيضاً نطاق ngrok الخاص بك، مثل your-domain.ngrok-free.dev
5. انقر على Add بعد كل إضافة

نطاقات الرمز الموصى بها

عند إنشاء رمز Codeberg API الخاص بك، سمّه بشيء وصفي مثل Claude Local Proxy. يُعدّ كلٌّ من repository وuser إلزاميَّين. أما الباقي فاختياري بحسب العمليات التي تحتاجها.

• repository: قراءة وكتابة (الملفات، الفروع، الالتزامات، الإصدارات، الوسوم) — إلزامي
• user: قراءة وكتابة (قائمة المستودعات، الهوية، إنشاء المستودعات عبر API) — إلزامي
• issue: قراءة وكتابة (المشكلات، التعليقات، التسميات، المعالم) — اختياري
• notification: قراءة وكتابة (الإشعارات والاشتراكات) — اختياري
• misc: قراءة (بيانات Gitea الوصفية ومفاتيح التوقيع) — اختياري
• activitypub: قراءة وكتابة — اختياري
• organization: بدون وصول
• package: بدون وصول

الأدوات والأطر المدعومة

• المنصة: Codeberg.org وأي نسخة Gitea/Forgejo مستضافة ذاتياً
• API: Gitea REST API v1
• المصادقة: رمز وصول شخصي مباشر (حساب واحد) أو سر الوكيل مع توجيه الرموز لكل حساب (حسابات متعددة عبر Tunnel-Proxy)
• البيانات: دعم كامل لـ JSON مع معالجة محتوى Base64