Spectra
تصفّح التوثيق

troubleshooting

إعادة تعيين المساحات وتسجيل الخروج

استرداد بنقرة واحدة إذا تعطّل التطبيق عند إضافة علامة تبويب جديدة أو ظهرت أخطاء تخطيط مستمرة لا تختفي بعد إعادة التشغيل.


إذا تعطّل تطبيق سطح المكتب عند الضغط على زر "+" لإضافة علامة تبويب، أو لم يعد يرسم الرسم البياني بعد إعادة التشغيل، أو ظهرت أخطاء تخطيط تستمر حتى بعد إعادة التثبيت، فالسبب الأكثر احتمالاً هو حقل تالف في ملف ذاكرة التخزين المؤقت لمساحة العمل لا نستطيع اكتشافه عند التحميل. الاسترداد بنقرة واحدة.

الزر

الحساب ▼ → إعادة تعيين المساحات وتسجيل الخروج

موجود في القائمة المنسدلة للحساب في أعلى اليمين، فوق إدخال تسجيل الخروج العادي مباشرة.

ماذا يفعل

  1. يحذف ملف ذاكرة التخزين المؤقت المحلية لمساحة العمل (%LOCALAPPDATA%\Spectra\app_state.json على ويندوز؛ والمكافئ على ماك / لينكس تحت مجلد التهيئة).
  2. يعيد تعيين كل لوحة رسم بياني في الذاكرة إلى تخطيط التداول الافتراضي.
  3. يسجّل خروجك حتى تعيد جلسة تسجيل الدخول التالية بناء مساحة عملك من السحابة بشكل نظيف.

مساحات العمل المحفوظة والرسوم البيانية والتنبيهات وسجل التداول مخزّنة على الخادم وستعود عند تسجيل الدخول مرة أخرى. الزر هذا لا يحذف سوى ذاكرة التخزين المؤقت المحلية والتخطيط الحالي في الذاكرة.

متى تستخدمه

استخدمه إذا رأيت أيًا من هذه الأعراض التي تستمر بعد إعادة التشغيل العادية:

  • التطبيق يتعطّل عند الضغط على "+" لإضافة علامة تبويب.
  • لوحة الرسم البياني تظهر فارغة أو بآثار GPU مشوّهة في كل إطار.
  • عملية التطبيق تخرج بصمت (دون نافذة خطأ ودون رسالة في وحدة التحكم) بعد التشغيل بقليل.
  • ترى الرسالة "Quarantined raw payload to workspaces/broken-..." في سجل الأعطال (%LOCALAPPDATA%\Spectra\panic.log).

ماذا لو لم ينفع

إذا استمر التعطّل بعد تسجيل الخروج والدخول:

  1. أعد تشغيل ويندوز. إعادة التشغيل تمسح حالة برنامج تشغيل GPU العالقة التي قد تبقى أحيانًا بعد إنهاء العملية.
  2. حدّث برنامج تشغيل GPU. نشرت كل من NVIDIA و AMD إصلاحات لإنهاء العمليات لـ D3D12 / Vulkan في برامج تشغيل 2025–2026.
  3. افحص برنامج مكافحة الفيروسات / حماية النقطة الطرفية. بعض برامج الأمان تعيد كتابة ذاكرة العمليات وقد تعطّل التطبيقات أثناء wgpu::Queue::submit.
  4. أرسل لنا سجل الأعطال. إذا كان %LOCALAPPDATA%\Spectra\panic.log يحتوي على إدخالات، أرفقه في بريد دعم إلى [email protected] إلى جانب الملف في %LOCALAPPDATA%\Spectra\workspaces\broken-*.json إن وجد. هذا الملف هو حمولة JSON الدقيقة التي أطلقت الاسترداد ويتيح لنا إعادة إنتاج الخطأ بالكامل.

لماذا يلزم هذا

يرسم تطبيق سطح المكتب الرسوم البيانية عبر wgpu الذي يتواصل مباشرة مع برنامج تشغيل GPU. حقول قليلة في JSON المحفوظ لمساحة العمل، إذا تلفت بسبب كتابة جزئية أو عدم توافق مخطط مستقبلي، يمكن أن تشكّل حالة Rust المحمّلة بطريقة تجعل عمليات GPU اللاحقة تعطّل العملية. التعطّل يتجاوز آلية الذعر في Rust تمامًا، لذا لا يوجد خطأ داخل التطبيق يظهر.

بدلًا من محاولة اكتشاف كل أنماط التلف الممكنة عند التحميل (هدف متحرك)، Spectra:

  1. يحجز أي حمولة تفشل في إلغاء التسلسل بشكل نظيف، ويكتبها إلى %LOCALAPPDATA%\Spectra\workspaces\broken-<ts>.json للاسترداد الجنائي قبل العودة إلى الإعدادات الافتراضية.
  2. يكشف هذا الإعادة بنقرة واحدة كمنفذ هروب للمستخدم في الحالة الأصعب حيث ينجح تحليل JSON ولكن محتواه يسبّب التعطّل لاحقًا.

كلا الآليتين معًا تضمنان أن الحفظ السيئ لا يحبسك خارج التطبيق بشكل دائم.