yolobox

• يتم تثبيت دليل مشروعك في مساره الفعلي، مثل /Users/you/project
• يتمتع الوكيل بصلاحيات كاملة وصلاحية sudo داخل الحاوية
• لا يتم تثبيت دليل منزلك إلا إذا اخترت ذلك صراحةً
• تحافظ وحدات التخزين الدائمة على الأدوات والإعدادات والجلسات عبر عمليات التشغيل
• يحصل Claude وCodex وKimi Code على إرشادات yolobox مدمجة لفهم بيئة الحماية التي يعملون فيها

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

بدء سريع

ثم من أي مشروع:

اختصارات الذكاء الاصطناعي الأخرى تعمل بنفس الطريقة:

عيّن default_harness = "codex" لجعل yolobox المجرد يطلق Codex. استخدم yolobox shell عندما تريد قشرة يدوية، وyolobox run <cmd...> عندما تريد أمرًا واحدًا داخل بيئة الحماية.

تفاصيل التثبيت والتشغيل الكاملة موجودة في التثبيت والإعداد. أمثلة الأوامر موجودة في الأوامر.

ماذا يوجد في الصندوق؟

تأتي الصورة الأساسية مع واجهات CLI للذكاء الاصطناعي، وNode.js، وPython، وGo، وBun، وأدوات البناء، وGit، وGitHub CLI، وripgrep، وfd، وfzf، وjq، وvim، وRTK، والأجزاء العملية المعتادة.

تحتاج شيئًا آخر؟ الوكيل لديه صلاحية sudo.

داخل yolobox، يتم تغليف واجهات CLI المدعومة للذكاء الاصطناعي لتخطي مطالبات الإذن. لا تأكيدات، لا حواجز حماية. فقط ذكاء اصطناعي نقي غير مفلتر، كما قصدت الطبيعة.

للقائمة الكاملة للأدوات، وجدول أغلفة وضع YOLO، وملاحظات RTK، وسياسة حداثة حزم npm، وسلوك ترقية CLI المدمجة، راجع ماذا يوجد في الصندوق.

تخصيص المشروع

إذا كان مشروع واحد يحتاج أدوات أو متغيرات بيئة إضافية، أضف إعداد مشروع صغير بدلاً من تفرع الصورة الأساسية بأكملها:

ثم شغّل بشكل طبيعي:

يمكن للتخصيص على مستوى المشروع أيضًا إضافة جزء Dockerfile فوق الصورة الأساسية. أول تشغيل يبني صورة مشتقة؛ عمليات التشغيل اللاحقة تعيد استخدامها حتى تتغير الصورة الأساسية أو مدخلات التخصيص.

استخدم مسارات الحاوية لقيم env لأنها تُمرر مباشرة إلى العملية داخل yolobox. قيم env تُمرر إلى وقت التشغيل حرفيًا؛ لا يتم تفسير أي شيء فيها.

لتسليم بيئة الحماية قيمة مختلفة عن تلك التي يستخدمها المضيف تحت نفس الاسم — رمز للقراءة فقط بدلاً من رمزك الحقيقي — قم بإنشاء اسم مستعار له مع env_from_host (أو --env-from-host KEY=HOST_VAR):

الاسم المستعار يملك هذا المتغير: فهو يمنع التمرير التلقائي و--gh-token لنفس المفتاح، ويرفض yolobox البدء إذا كان متغير المضيف غير معيّن، لذا لا يمكن للرمز الذي يستبدله أن يتسرب بالصدفة أبدًا.

راجع الإعداد لإعدادات env الخاصة بالمشروع، والتخصيص على مستوى المشروع لتثبيت الحزم، وأجزاء Dockerfile، وسلوك إعادة البناء، وسلوك الترقية، والصور المخصصة بالكامل.

سير العمل الشائع

--claude-config يزامن تدريجيًا إعدادات Claude الدائمة ويقوم بتركيب مباشر لـ~/.claude/projects على المضيف للقراءة/الكتابة بحيث يبقى سجل استئناف الجلسات محدثًا. --no-claude-auth يبقي تسجيل دخول الصندوق مستقلاً، لكنه لا يجعل ذلك التركيب لتاريخ المشروع للقراءة فقط.

إعداد RTK التلقائي يترك القياس عن بُعد معطلاً ما لم تختر تفعيله تفاعليًا من داخل الصندوق باستخدام rtk telemetry enable.

المراجع التفصيلية موجودة عمدًا في موقع الوثائق:

• الأوامر: الاختصارات، أوامر الصيانة، fork، والأمثلة
• الإعداد: الإعداد العام، إعداد المشروع، التعليمات المنسوخة، تمرير env، وبيانات السياق
• الأعلام: كل علم، ملاحظة التوافق، وتفاصيل تمرير وقت التشغيل
• الوصفات: الوكلاء المتوازيون وتوجيه تطبيقات الويب

الفلسفة: إنه صندوق الذكاء الاصطناعي، وليس صندوقك

yolobox مصمم لوكلاء الذكاء الاصطناعي، وليس للبشر. أنت تطلق الذكاء الاصطناعي وتتركه يعمل.

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

نموذج الأمان

yolobox حماية من الحوادث، وليس نظرية سحرية ضد الهروب من الحاوية.

يساعد في حماية دليل منزلك، ومفاتيح SSH، وملفات النقاط، والمشاريع غير ذات الصلة، ومعظم حالة نظام ملفات المضيف من أوامر التدمير المتهورة. لا يحمي دليل المشروع الذي ثبّته، أو الأسرار التي مررتها صراحةً، أو إجراءات المضيف التي ربطتها صراحةً، أو نواة المضيف من ثغرات الهروب أثناء التشغيل.

لصندوق أكثر إحكامًا، ادمج أعلامًا مثل:

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

التطوير

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

الترخيص

MIT