● مجتمع
instavm
⚡ فوري
CodeRunner
بواسطة instavm · instavm/coderunner
تنفيذ كود معزول بـ VM للوكلاء — Python، Playwright، نواة Jupyter مستمرة، كل ذلك في بيئة معزولة عن مضيفك.
يمنح CodeRunner كلود (والوكلاء الآخرين) بيئة رمل آمنة ومستمرة: تشغيل Python بنواة Jupyter طويلة الأمد، تجريف الويب بـ Playwright، معالجة PDF والصور. العزل على مستوى VM يعني إمكانية السماح للوكيل بتنفيذ كود غير موثوق دون تدمير جهازك. يعرض نفسه كخادم MCP للعمل في أي عميل.
لماذا تستخدمه
الميزات الأساسية
- عزل على مستوى VM — نظام الملفات والشبكة في المضيف محميان
- نواة Jupyter مستمرة — المتغيرات والاستيرادات تبقى عبر الاستدعاءات
- Playwright مدمج لتجريف الويب / أتمتة المتصفح
- مهارات جاهزة: معالجة PDF، معالجة الصور
- متاح كخادم MCP على coderunner.local:8222 — اربطه بأي عميل
عرض مباشر
كيف يبدو في الممارسة
جاهز
حالات الاستخدام
استخدامات عملية: CodeRunner
متى تستخدمه: تريد أن يكتب كلود سكريبتاً لم تراجعه بالكامل وينفذه.
الخطوات
-
تسليم المهمة
Use coderunner. Write a Python script that downloads my Strava activities CSV from <url>, parses, and computes weekly mileage. Run it in the sandbox.✓ تم النسخ
→ تم تنفيذ السكريبت؛ عُرض الخرج؛ لم يُمسّ نظام الملفات
-
التكرار
Add a chart of weekly mileage. Re-run.✓ تم النسخ
→ تم رسم الرسم البياني؛ حالة النواة محفوظة (لا داعي لإعادة الاستيراد)
-
تصدير النتائج
Save CSV + chart to ./out/ on host (this only).✓ تم النسخ
→ فقط هذا المسار كُتب؛ البيئة المعزولة لا تزال مغلقة
النتيجة: تجارب سريعة دون خطر حذف /Users بالخطأ.
المزالق
- الوصول للشبكة لا يزال مسموحاً في البيئة المعزولة — أوقف الشبكة عند تشغيل كود غير موثوق حقاً؛ وإلا يمكنه تسريب البيانات
متى تستخدمه: تريد جلسة استكشاف بيانات مدتها 30 دقيقة دون فقدان حالة النواة.
الخطوات
-
تحميل البيانات مرة واحدة
Use coderunner. Load /data/sales.csv into df. Show schema + 5 sample rows.✓ تم النسخ
→ df في النواة؛ يستمر طوال الجلسة
-
استعلامات مخصصة
Pivot by region × month, show top 5 anomalies.✓ تم النسخ
→ Pivot + صفوف مُشار إليها
-
التصدير
Save the anomalies subset to /out/anomalies.csv on host.✓ تم النسخ
→ CSV في /out/
النتيجة: تحليل بجودة Notebook عبر الدردشة مع تشغيل كود فعلي.
المزالق
- حالة النواة تتباعد في الجلسات الطويلة؛ النتائج مبنية على متغيرات قديمة — أعد تشغيل النواة بين المهام غير المترابطة؛ يمكن لكلود إصدار %reset
متى تستخدمه: الموقع يحتاج متصفحاً كاملاً؛ لا تريد تشغيل عملية Chrome على مضيفك.
الخطوات
-
بدء جلسة
Use coderunner Playwright. Open <url>, wait for the table, extract rows as JSON.✓ تم النسخ
→ JSON مُعاد؛ المتصفح بقي في البيئة المعزولة
-
تكرار المحددات
Selector missed the price column; adjust to find it.✓ تم النسخ
→ محدد محدّث؛ البيانات مكتملة
النتيجة: بيانات مستخرجة؛ لا أثر للمتصفح على المضيف.
المزالق
- الموقع يكشف الوضع بدون رأس ويحجب — التحويل إلى chromium مع خيارات التخفي التي تعرضها المهارة
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
نقل البيانات من/إلى البيئة المعزولة عبر المسارات المُركّبة فقط
Mount only /Users/me/data and /Users/me/out; everything else is read-only.✓ تم النسخ
خط أنابيب بحث → جلب → تحليل
Search via duckduckgo, scrape via coderunner Playwright, analyze in Python.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا يوجد — محلي
- الرموز لكل استدعاء
- فقط رموز الكود/الخرج
- التكلفة المالية
- مجاني
- نصيحة
- النواة المستمرة توفر الرموز مقارنة بإعادة الاستيراد؛ أعد التشغيل فقط عند خطأ الحالة
الأمان
الصلاحيات والأسرار ونطاق الأثر
الحد الأدنى من الصلاحيات: Mounted filesystem paths only Network on/off via config
تخزين بيانات الاعتماد: لا تضع الأسرار في البيئة المعزولة إلا إذا كنت موافقاً على رؤية الوكيل لها
نقل البيانات الخارجي: إذا كانت الشبكة مفعّلة، يمكن للبيئة المعزولة الوصول لأي URL — أوقفها للتشغيلات الحساسة
لا تمنح أبدًا: Mount of $HOME or / — sandbox loses its point
- البيئة المعزولة تقلل حجم الضرر لكنها ليست علاجاً شاملاً — راجع خطة الوكيل قبل التشغيل
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
install.sh يفشل على Linux
المشروع مُحسَّن أولاً لـ macOS Apple Silicon؛ دعم Linux متفاوت. راجع المشكلات للملاحظات الخاصة بالتوزيعة
حالة Playwright قديمة
شغّل kernel_reset؛ سياق المتصفح القديم قد يستمر عبر الاستدعاءات
البيئة المعزولة لا تصل للإنترنت
الشبكة معطّلة في الإعدادات؛ فعّلها إذا احتجت. وبالعكس، عزّلها عند عدم الحاجة
تبعيات مهارة PDF/صورة مفقودة
صورة الحاوية تتضمن الشائعة؛ أعد بناء الصورة لإضافة تبعيات مخصصة
البدائل
CodeRunner مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| Anthropic code execution beta | تريد تنفيذاً من جهة الخادم بدون بيئة معزولة محلية | سحابي؛ البيانات تغادر جهازك |
| Docker by hand | تريد تحكماً كاملاً في صورة الحاوية | إعداد يدوي؛ لا خادم MCP جاهز |