الموارد#
يعرض الخادم مرجع المنصة كموارد MCP. يقرأها المساعد من غير استدعاء أداة. النص إنجليزي، بلغة الصفحة core.telegram.org/bots/serverless، حتى يمكن مطابقته بها.
| URI | المحتوى |
|---|---|
tgcloud://docs/project-structure | تخطيط tgcloud/ وhandlers وendpoints وlib وschema.js. استيراد وحدات المشروع مسار نسبي مع .js. استضافة ملفات Mini App |
tgcloud://docs/cli | مرجع CLI: الأوامر و--dry-run / --safe / --yes / --local وupgrade وwebhook |
tgcloud://docs/sdk-db | sdk/db: أنواع الأعمدة (text وinteger وreal وnumeric وblob وboolean وjson) والأوضاع، ومنشئ الاستعلام، وSQL الخام، ومن غير مفاتيح أجنبية، والحذف عبر .deprecated |
tgcloud://docs/sdk-api | sdk/api: واجهة Bot API كاملة وBotApiError وInputFile |
tgcloud://docs/sdk-fetch | sdk/fetch: عميل HTTP ومساعدات الجسم وحد 32 ميغابايت |
tgcloud://docs/limits | الحدود المنشورة والحصص التي لم تُنشر |
داخل مشروع مُولَّد اقرأ أولًا AGENTS.md وdocs/tgcloud-sdk.md. هما يطابقان واجهة CLI التي أنشأت المشروع. الموارد احتياط حين لا تكون داخل مشروع.
المصدر في المستودع: resources/docs/*.md. يتحقق npm run docs:check من تسجيل كل ملف، ومن تطابق نسختي المهارة، ومن وجود صفحات ru وzh وar وde وfr لكل صفحة إنجليزية.
حدود المنصة#
يجمع tgcloud://docs/limits الحدود المنشورة: 50 ميغابايت لكل رفع عبر Bot API (10 ميغابايت للصور)، و20 ميغابايت لكل تنزيل عبر getFile، و32 ميغابايت لجسم استجابة fetch. مخرجات console يعرضها tgcloud run ومن غير سقف حجم منشور.
حصص وقت التشغيل — الذاكرة والمعالج ومهلة الـ handler والـ endpoint ومعدل الاستدعاء وحجم القاعدة — غير منشورة. لا تفترض أرقامًا. يطبع run_handler زمن تنفيذ التشغيل: قِس مسارك به، واجعل الـ handler قصيرًا، وانقل العمل الثقيل خارج مسار التحديث عبر fetch. وللحصول على الأرقام اسأل في @BotFather ← البوت ← Serverless أو القنوات الرسمية للمنصة.
ويسرد المورد نفسه القدرات التي لا توفرها بيئة التشغيل: معاملات قاعدة البيانات والدفعات الذرية، ونقاط HTTP الواردة المخصصة (الويب هوك تملكه المنصة)، ومخزن الأسرار ومتغيرات البيئة، والمهام المجدولة — مع البديل المدعوم لكل منها.