انتقل إلى المحتوى
الرئيسية / Kit / Exec
ExecHoody Exec

ملفاتك هي APIs. تعليق واحد يغيّر كل شيء.

اكتب دالة TypeScript — تصبح فوراً نقطة نهاية HTTP حية. أضف تعليقاً واحداً للتحكم في المصادقة والـ CORS ومهلة الانتظار وأوضاع الذكاء الاصطناعي.

exec / hello.ts

// @mode serverless

// @cors reflective

// @token my-secret-key

return { message: 'Hello!', time: Date.now() };

# حي على:

https://proj-cont-exec-1.us1.containers.hoody.com/hello

نقطة نهاية HTTP فورية — بلا ضبط
home / kit / exec / modes
أوضاع التنفيذ

وضعان. تعليق واحد.

كل سكريبت يختار وضعاً. Worker للتطبيقات الحية ذات الحالة. Serverless للتنفيذ المعزول المؤقت.

وضع Worker

// @mode worker
  • V8 isolate مستمر — يبقى دافئاً للأبد
  • حالة مشتركة عبر جميع الطلبات
  • WebSocket مدعوم
  • بلا بداية باردة بعد الطلب الأول

وضع Serverless

// @mode serverless // @concurrent 10
  • V8 isolate جديد لكل طلب
  • عزل كامل، بلا تسرب حالة
  • تزامن قابل للضبط عبر @concurrent
  • مثالي للـ Webhooks وحركة المرور المتقطعة
home / kit / exec / magic-carousel
التعليقات السحرية

كل سلوك. سطر واحد.

ضع تعليقاً في أعلى ملفك. بلا تغييرات في الكود، بلا ملفات ضبط، بلا Middleware. غيّر كيفية عمل الملف.

التنفيذ
// @mode worker

وضع التنفيذ

اختر بين VM Worker مستمر أو Serverless isolate جديد لكل طلب. يحدد الحالة ودعم WebSocket وسلوك البداية الباردة.

الشبكة
// @cors reflective

التحكم في CORS

عاكس أصل الطلب بـ 'reflective'، أو افتح جميع الأصول بـ '*'، أو اقفل على عنوان URL محدد. بلا Middleware.

الحدود
// @timeout 30000

مهلة الطلب

اضبط المهلة بالميلي ثانية. الافتراضي 30 ثانية. استخدم 0 أو 'unlimited' للسكريبتات الطويلة.

الحدود
// @concurrent 10

حد التزامن

Serverless فقط: حدّ التنفيذات المتزامنة. اضبط على 'false' للمعالجة التسلسلية — ضروري لترتيب Webhook.

المصادقة
// @token my-secret

مصادقة نقطة النهاية

احمِ أي نقطة نهاية بسر مشترك. العملاء يصادقون عبر Bearer أو Basic أو ترويسة X-Token أو معامل استعلام.

الوقت الفعلي
// @websocket true

دعم WebSocket

فعّل الاتصالات ثنائية الاتجاه الفورية. يتطلب وضع Worker. معالجات ws.message وws.open وws.close تُحقن تلقائياً.

الذكاء الاصطناعي
// @ai true

مساعدات الذكاء الاصطناعي

تحقن generateText وstreamText وgenerateObject من Vercel AI SDK. بلا imports، بلا إعداد مفاتيح API. نموذج مهيأ مسبقاً.

الذكاء الاصطناعي
// @ai-model anthropic/claude-sonnet-4.5

اختيار نموذج الذكاء الاصطناعي

Override the default AI model per script. Default: google/gemini-2.5-flash-lite. Supports 300+ models from 15+ providers.

السحابة
// @aws true

تكامل AWS

فعّل AWS SDK داخل سكريبتك بتعليق واحد. وصّل إلى S3 وDynamoDB وLambda وأي خدمة AWS أخرى مباشرة.

home / kit / exec / accordion
مرجع

مرجع التعليقات السحرية الكامل.

كل تعليق، كل قيمة، كل افتراضي. كل شيء في مكان واحد.

@modeالتنفيذ

يضبط وضع التنفيذ للسكريبت. 'worker' ينشئ VM مستمراً؛ 'serverless' (الافتراضي) ينشئ VM جديداً لكل طلب.

الصيغة

// @mode worker // @mode serverless
home / kit / exec / use-cases
حالات الاستخدام

من Webhook إلى WebSocket في دقائق.

ستة أنماط تغطي النطاق الكامل — من HTTP APIs الفورية إلى بروكسيات الذكاء الاصطناعي الفورية.

APIs الفورية

تخطَّ إعداد Express بالكامل. أنشئ ملفاً — يصبح نقطة نهاية HTTP حية. Worker لحركة المرور العالية، Serverless للعزل.

معالجات Webhook

Webhooks Stripe وGitHub وSlack مع عزل Serverless. استخدم @concurrent false للمعالجة التسلسلية والترتيب المتسق.

خوادم WebSocket

خوادم دردشة، لوحات مباشرة، بث SSE. وضع Worker يحافظ على اتصالات مستمرة مع حالة غرفة مشتركة.

بروكسي MITM للذكاء الاصطناعي

اعترض وتحكم في طلبات الذكاء الاصطناعي. أضف فحوصات أمان، عدّل الطلبات، احجب البيانات الحساسة، تتبع الاستخدام.

تحديد المعدل

تتبع عدد الطلبات لكل IP في الكائن المشترك عبر الطلبات. وضع Worker يجعل تحديد المعدل في الذاكرة أمراً تافهاً.

تركيب السكريبتات

كل سكريبت هو نقطة نهاية HTTP. استدعِ سكريبتات أخرى بـ fetch(). اركّب خدمات مصغّرة من دوال بسيطة.

home / kit / exec / endpoints
50+ نقطة نهاية

كل سطح API، في مكان واحد.

تنفيذ السكريبتات وإدارتها والتحقق منها والقوالب والتوجيه والمراقبة والتحكم بالتعليقات السحرية — كل ذلك في API واحد.

المراقبة وMagic API

8 نقاط نهاية

GET /api/v1/exec/monitor/stats

GET
/api/v1/exec/monitor/statsمقاييس الأداء
GET
/api/v1/exec/monitor/active-requestsالطلبات النشطة
POST
/api/v1/exec/monitor/script-performanceمقاييس لكل سكريبت
GET
/api/v1/exec/monitor/healthفحص الصحة
GET
/api/v1/exec/magic-comments/schemaالحصول على مخطط التعليقات السحرية
GET
/api/v1/exec/magic-comments/readقراءة تعليقات السكريبت السحرية
PUT
/api/v1/exec/magic-comments/updateتحديث التعليقات السحرية
POST
/api/v1/exec/magic-comments/bulk-updateتحديث جماعي للتعليقات السحرية

التنفيذ والسكريبتات

7 نقاط نهاية

GET/POST /:path

GET
/:pathتنفيذ سكريبت عبر مسار مستند إلى الملف
POST
/:pathتنفيذ سكريبت مع جسم الطلب
GET
/api/v1/exec/scripts/listسرد جميع السكريبتات
GET
/api/v1/exec/scripts/readقراءة محتوى السكريبت
POST
/api/v1/exec/scripts/writeإنشاء أو تحديث سكريبت
DELETE
/api/v1/exec/scripts/deleteحذف سكريبت
POST
/api/v1/exec/scripts/treeالحصول على شجرة المجلد

التحقق

6 نقاط نهاية

POST /api/v1/exec/validate/script

POST
/api/v1/exec/validate/scriptتحقق شامل من السكريبت
POST
/api/v1/exec/validate/typescriptفحص النوع في TypeScript
POST
/api/v1/exec/validate/syntaxالتحقق من البنية النحوية
POST
/api/v1/exec/validate/magic-commentsتحليل التعليقات السحرية والتحقق منها
POST
/api/v1/exec/validate/dependenciesتحليل التبعيات
POST
/api/v1/exec/validate/return-typeالتحقق من نوع المُعاد

القوالب والتوجيه

6 نقاط نهاية

GET /api/v1/exec/templates/list

GET
/api/v1/exec/templates/listسرد القوالب المتاحة
GET
/api/v1/exec/templates/previewمعاينة قالب
POST
/api/v1/exec/templates/generateإنشاء سكريبت من قالب
POST
/api/v1/exec/route/resolveتحليل عنوان URL إلى مسار السكريبت
POST
/api/v1/exec/route/discoverاكتشاف جميع المسارات
POST
/api/v1/exec/route/testاختبار مطابقة المسار
الرئيسية / Kit / exec / دعوة للعمل

كودك هو الـ API.

اكتب دالة TypeScript. أضف تعليقاً واحداً. إنها حية.

اقرأ التوثيق