عن المشروع

Cloudflare Computer هو مشروع مفتوح المصدر في مرحلة المعاينة (ترخيص MIT) يمنح الوكلاء البرمجيين حاسوبًا دائمًا: نظام ملفات افتراضي تُخزَّن حالته المرجعية في SQLite داخل كائن دائم من Cloudflare، بالإضافة إلى سطح تنفيذ واحد قابل للتبديل يُعرض عبر workspace.runtime. تتوفر ثلاثة واجهات تنفيذ حاليًا. واجهة الحاوية (Container) تُسقط حالة SQLite إلى حاوية معزولة كتركيب FUSE حقيقي: شيطان جانبي يُسمى computerd يركّب الحالة كنظام ملفات ويزامن التغييرات عبر قناة capnweb RPC، مما يوفر بيئة لينكس كاملة مع ثنائيات حقيقية ووصول شبكي حقيقي. واجهة shell العزل (Isolate) تشغّل just-bash داخل عامل ديناميكي وتصل إلى مساحة العمل المرجعية عبر Workers RPC، فلا توجد مخزن ثانوي أو دورة مزامنة. واجهة JavaScript العزل (Isolate) تُقيّم وحدة ECMAScript في عامل ديناميكي جديد مع مدخلات ونتائج منظمة، واستيرادات نسبية دائمة، ومكتبات مُهيأة، وnode:fs/promises مدعومة بمساحة العمل، ووحدتا ws:git وws:artifacts موثوق بهما. يمكن لمساحة العمل تسجيل واجهات متعددة تحت معرّفات مستقرة. workspace.runtime.exec(source, { backend }) هو نقطة الدخول الوحيدة للتنفيذ، والواجهة المختارة تحدد ما إذا كان المصدر أمر shell أو وحدة ES. تتصل الواجهات بشكل كسول عند أول استخدام، ويمكن بناء مساحة عمل دون أي واجهة، معرّضة نظام الملفات وحده. المشروع موسوم صراحةً بـ PREVIEW ONLY: الواجهات البرمجية غير مستقرة، والتصميم عرضة للتغيير، وهو غير مناسب للاستخدام الإنتاجي. المواصفات في docs/ استباقية ويجب قراءتها كنية لا بوصف للكود الحالي. المستودع هو مستودع أحادي صغير. الحزم تشمل @cloudflare/dofs (نظام ملفات افتراضي مدعوم بـ SQLite داخل كائن دائم، ومكونات بروتوكول المزامنة، وموفّر @platformatic/vfs لـ Node)، و@cloudflare/computer-rpc (أنواع capnweb السلكية ومساعدات خادم/عميل مشتركة)، و@cloudflare/computerd (تركيب FUSE بالإضافة إلى شيطان RPC عبر HTTP/WebSocket يعمل داخل حاوية العزل)، و@cloudflare/computer (الحزمة العلوية التي يستهلكها كائنات الدائمة). سياق صورة Docker خاصة يُصدر ثنائي computerd linux-x64 مُسبق البناء، مع كون الصورة لا الحزمة npm هي منتج الإصدار. مجلد examples يحتوي على عمّال قابلين للتشغيل يوضحون السطح العام: مثال حاوية بنقاط نهاية HTTP للكتابة/القراءة/التنفيذ؛ متغيرات worker-shell وworker-javascript لا تحتاجان حاوية؛ مثال egress يُظهر سياسات egress معدومة وكاملة ومخصصة عبر الواجهات؛ مثال MCP يعرض أداة Code Mode مدعومة بمساحة عمل دائمة وعامل shell وحاسوب لينكس كامل؛ مثال rlm حيث يقرأ JavaScript المُولَّد سياقًا طويلًا من مساحة العمل ويستدعي عمّال نماذج محدودة ويقلّص نتائجهم المنظمة بالكود؛ أمثلة think وthink-compare-runtimes حيث يستخدم وكيل @cloudflare/think مساحة العمل كمجلد عمله، بما في ذلك واجهة ويب تشغّل مهمة الوكيل نفسها ضد واجهات الحاوية والعمّال جنبًا إلى جنب؛ شروحات خطوة بخطوة تكتب بطاقة وصفة markdown وتشغّل pandoc في الحاوية لإنتاج PDF؛ مثال artifacts يولّد مشروع عامل في مساحة العمل وينشره إلى Cloudflare Artifacts كمستودع جاهز للنسخ؛ ومثال assets يحوّل طلبًا إلى صورة عبر Workers AI ويعيد رابطًا قابلًا للمشاركة. ينشر المستودع معايير أداء نظام الملفات في docs/19_performance.md، حيث يذكر المشروع أن تركيب computerd عبر FUSE يتفوق على القرص الحقيقي في العمل كثيف البيانات الوصفية ويتخلف عنه في الإدخال/الإخراج التسلسلي الكبير، مع تعليمات إعادة الإنتاج ومقارنات مرفقة. المساهمة تقتصر على تقارير الأخطاء واقتراحات الإصلاح وطلبات الميزات واقتراحات التصميم عبر القضايا والنقاشات؛ الطلبات السحبية غير المرحّب بها غير مقبولة. أنواع Env في الأمثلة تُولَّد عبر wrangler types بدلًا من التزامها بالمستودع.