troubleshooting
الأخطاء الشائعة
رموز الأخطاء التي يصدرها سطح المكتب وعامل السحابة، مع معناها وكيفية حلّها.
سبكترا يُظهر كل خطأ برمز ثابت. الرموز قابلة للبحث عبر السجلات وتذاكر الدعم وتشخيصات محرّر السكريبت.
أخطاء سطح المكتب
| الرمز | المعنى | الحل |
|---|---|---|
| E_GPU_INIT | فشل اختيار محوّل wgpu | أعد التشغيل؛ إن استمرّ، تحقّق أن تعريف GPU يدعم Vulkan/Metal/DX12. |
| E_BROKER_AUTH | الوسيط رفض مفتاح API | أعد إدخال البيانات؛ تحقّق أن المفتاح للقراءة-والكتابة إن كنت تتداول. |
| E_SCRIPT_BUDGET | تجاوز سكريبت ميزانية المعالج/الذاكرة | انظر حدود العزل؛ بسّط الحلقة أو اطلب ميزانية موسّعة. |
| E_DATA_GAP | تغذية البيانات التاريخية بها فجوة عند النطاق المطلوب | إطار زمني مختلف عادةً يعمل؛ أبلغ عن الفجوة إن كانت قابلة لإعادة الإنتاج. |
| E_WORKSPACE_CORRUPT | فشل تحليل JSON لمساحة العمل المحفوظة | Profile ← Workspaces ← Reset (يحذف فقط تلك المساحة؛ كل شيء آخر يبقى). |
أخطاء عامل السحابة
تظهر في استجابات webhook وProfile ← Webhooks ← Activity.
| الرمز | HTTP | المعنى |
|---|---|---|
| signature_invalid | 401 | عدم تطابق HMAC. تحقّق أن بايتات الجسم التي وقّعتها تطابق ما أرسلته. |
| timestamp_out_of_range | 401 | انحراف ساعة المرسل > ٥ دقائق. افحص NTP. |
| ip_not_allowed | 403 | قائمة IP تستثنيك. أضف IP المصدر. |
| cap_breached | 403 | سقف الخسارة اليومي مخروق. انتظر ٠٠:٠٠ التالية بمنطقة الوسيط، أو أعد التعيين يدوياً. |
| secret_paused | 403 | إيقاف إداري أو تلقائي. افحص Activity للسبب. |
| idempotent_replay | 200 | نفس client_id رُئي خلال ٢٤ ساعة. يُرجع النتيجة الأصلية. |
| replay_attack | 409 | نفس (timestamp, body) رُئي مؤخراً. خلل بالمرسل أو هجوم. |
| rate_limited | 429 | > ١ طلب/ث/سرّ. تراجع. |
| broker_rejected | 502 | الوسيط أرجع غير 2xx. الجسم يشمل سبب الوسيط. |
أخطاء محرّر السكريبت
مُجمِّع VM البايت كود يُصدر أخطاء بسطر + عمود. الأكثر شيوعاً:
type_mismatch— العاملان ليسا متوافقي الأنواع. افحص الأنواع المستنتجة عبرEditor ← Inspect(Cmd+I).unbound_identifier— خطأ كتابة أو نسيانlet.arity_error— عدد وسائط خاطئ لدالّة مدمجة.series_index_negative—series[N]يتطلّبN >= 0.
الإبلاغ
إن أُعيد إنتاج خطأ بخطوات، أرسل إلى [email protected] متضمّناً رمز الخطأ ونسخة البناء (Help ← About ← Copy diagnostic)، وصادر مساحة العمل إن كان ذا صلة.