انتقل إلى المحتوى
الملف هو API
V8 Isolates
إعداد صفري
تعليقات سحرية
تثبيت تبعيات تلقائي
دعم WebSocket
TypeScript أصيل
300+ نموذج ذكاء اصطناعي
الملف هو API
V8 Isolates
إعداد صفري
تعليقات سحرية
تثبيت تبعيات تلقائي
دعم WebSocket
TypeScript أصيل
300+ نموذج ذكاء اصطناعي
الملف هو API
V8 Isolates
إعداد صفري
تعليقات سحرية
تثبيت تبعيات تلقائي
دعم WebSocket
TypeScript أصيل
300+ نموذج ذكاء اصطناعي
الملف هو API
V8 Isolates
إعداد صفري
تعليقات سحرية
تثبيت تبعيات تلقائي
دعم WebSocket
TypeScript أصيل
300+ نموذج ذكاء اصطناعي
ExecHoody Exec

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

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

exec / hello.ts

// @mode serverless

// @cors reflective

// @timeout 5000

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

# حي على:

https://abc123-def456-exec-1.node-us-1.containers.hoody.com/hello

نقطة نهاية HTTP فورية — بلا ضبط
أوضاع التنفيذ

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

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

وضع Worker

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

وضع Serverless

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

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

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

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

وضع التنفيذ

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

الشبكة
// @cors reflective

التحكم في CORS

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

الحدود
// @timeout 60000

مهلة الطلب

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

الحدود
// @concurrent false

حد التزامن

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

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

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

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

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

دعم 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

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

تجاوَز النموذج لكل سكربت. الافتراضي هو google/gemini-2.5-flash-lite، مع الوصول إلى أكثر من 300 نموذج من أكثر من 15 مزوّد استدلال عبر Hoody AI.

تسجيل
// @log-level full

تفصيل السجلات

اضبط مستوى التسجيل من none وminimal صعودًا إلى standard (الافتراضي) ثم full وdebug. بلا stack تسجيل خارجي تربطه.

مرجع

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

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

@modeالتنفيذ

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

الصيغة

// @mode worker // @mode serverless
حالات الاستخدام

من 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(). اركّب خدمات مصغّرة من دوال بسيطة.

50+ نقطة نهاية

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

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

67 endpoints موثّقةhttps://abc123-def456-exec-1.node-us-1.containers.hoody.com

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

1 endpoint
POST
/{path}نفِّذ أي سكربت عبر مساره المبني على الملف

إدارة السكربتات

6 endpoints
GET
/api/v1/exec/scripts/readاقرأ محتوى السكربت
POST
/api/v1/exec/scripts/writeأنشئ سكربتًا أو حدّثه
DELETE
/api/v1/exec/scripts/deleteاحذف سكربتًا
GET
/api/v1/exec/scripts/listاعرض جميع السكربتات
POST
/api/v1/exec/scripts/treeاحصل على شجرة المجلدات
POST
/api/v1/exec/scripts/moveانقل سكربتًا أو أعد تسميته

التحقق

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

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

6 endpoints
GET
/api/v1/exec/templates/listسرد القوالب المتاحة
GET
/api/v1/exec/templates/previewمعاينة قالب
POST
/api/v1/exec/templates/generateإنشاء سكريبت من قالب
POST
/api/v1/exec/templates/create-customتحليل عنوان URL إلى مسار السكريبت
PUT
/api/v1/exec/templates/update-custom/{name}اكتشاف جميع المسارات
DELETE
/api/v1/exec/templates/delete-custom/{name}اختبار مطابقة المسار

Magic Comments

4 endpoints
GET
/api/v1/exec/magic-comments/schemaاحصل على مخطط magic comments
GET
/api/v1/exec/magic-comments/readاقرأ magic comments الخاصة بسكربت
PUT
/api/v1/exec/magic-comments/updateحدّث magic comments
POST
/api/v1/exec/magic-comments/bulk-updateتحديث جماعي عبر عدة سكربتات

التبعيات والحزم

9 endpoints
GET
/api/v1/exec/dependencies/bundledاعرض التبعيات المُجمَّعة مسبقًا
POST
/api/v1/exec/dependencies/checkتحقق من الحزم الناقصة
POST
/api/v1/exec/dependencies/installثبِّت وحدات npm
GET
/api/v1/exec/package/readRead package.json
POST
/api/v1/exec/package/updateUpdate package.json
POST
/api/v1/exec/package/installثبِّت الحزم
POST
/api/v1/exec/package/compareقارِن الحزم
POST
/api/v1/exec/package/pinثبِّت الإصدارات
POST
/api/v1/exec/package/initInitialize package.json

التوجيه

3 endpoints
POST
/api/v1/exec/route/resolveحدِّد السكربت الذي يقابله الـ URL
POST
/api/v1/exec/route/discoverاكتشف جميع المسارات
POST
/api/v1/exec/route/testاختبر مطابقة المسارات

الـ Cache والحالة المشتركة

4 endpoints
POST
/api/v1/exec/cache/clearامسح cache التنفيذ
POST
/api/v1/exec/shared-state/getاقرأ الحالة المشتركة
POST
/api/v1/exec/shared-state/setاكتب الحالة المشتركة
POST
/api/v1/exec/shared-state/clearامسح الحالة المشتركة

السجلات

5 endpoints
GET
/api/v1/exec/logs/listاعرض السجلات
POST
/api/v1/exec/logs/readاقرأ سجلًا
GET
/api/v1/exec/logs/streamتابِع السجلات مباشرة عبر SSE
POST
/api/v1/exec/logs/searchابحث في السجلات
DELETE
/api/v1/exec/logs/clearامسح السجلات

المراقبة وMagic API

6 endpoints
GET
/api/v1/exec/monitor/statsمقاييس الأداء
GET
/api/v1/exec/monitor/active-requestsالطلبات النشطة
GET
/api/v1/exec/monitor/scriptsمقاييس لكل سكريبت
POST
/api/v1/exec/monitor/script-performanceفحص الصحة
GET
/api/v1/exec/monitor/metricsالحصول على مخطط التعليقات السحرية
GET
/api/v1/exec/healthقراءة تعليقات السكريبت السحرية

الجداول

4 endpoints
GET
/api/v1/exec/schedules/listاعرض الجداول
POST
/api/v1/exec/schedules/triggerشغِّل جدولًا
POST
/api/v1/exec/schedules/reloadأعِد تحميل الجداول
GET
/api/v1/exec/schedules/historyسجل تشغيل الجداول

إدارة الـ SDK

4 endpoints
POST
/api/v1/exec/sdk/importاستورد SDK
GET
/api/v1/exec/sdk/listاعرض الـ SDKs المستوردة
GET
/api/v1/exec/sdk/{id}احصل على تفاصيل الـ SDK
DELETE
/api/v1/exec/sdk/{id}احذف SDK مستوردًا

OpenAPI للمستخدم

6 endpoints
POST
/api/v1/exec/user-openapi/generateولِّد مواصفة OpenAPI
GET
/api/v1/exec/user-openapi/listاعرض سكربتات المستخدم
POST
/api/v1/exec/user-openapi/validateتحقق من مخطط المستخدم
GET
/api/v1/exec/user-openapi/schemaقدِّم ملف المخطط
GET
/api/v1/exec/user-openapi/specقدِّم المواصفة المولَّدة
POST
/api/v1/exec/user-openapi/mergeادمج مواصفات OpenAPI

الـ Instances والنظام

3 endpoints
GET
/api/v1/exec/listاعرض جميع معرّفات instances الخاصة بـ exec
POST
/api/v1/exec/system/restartأعِد تشغيل الخادم
GET
/api/v1/exec/system/restart-statusاحصل على حالة إعادة التشغيل

كودك هو الـ API.

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

اقرأ التوثيق