دعم Coflow
يطوّر Coflow ويدعمه مطوّر واحد. أسرع طريقة للحصول على المساعدة: رسالة بريد إلكتروني فيها المعلومات أدناه.
التواصل
البريد الإلكتروني
candidathector@gmail.com — الموضوع «Coflow support»؛ والزر أعلاه يملأ أيضًا نموذجًا للإبلاغ عن خطأ
يقرأ الرسائل ويرد عليها المطوّر الذي كتب الكود.
ما الذي يجب إرفاقه في بلاغ الخطأ
بهذه المعلومات يمكن إعادة إنتاج معظم المشكلات وإصلاحها دون مراسلات متكررة.
- إصدار VS Code: Help › About (على macOS: Code › About Visual Studio Code).
- إصدار Coflow: في عرض الإضافات، بجانب الاسم.
- سجل Coflow: افتح لوحة Output (
Ctrl+Shift+U) واختر Coflow من قائمتها، أو شغّل الأمر Coflow: Show Log. انسخ الأسطر المحيطة بالخطأ. - نظام التشغيل وإصدار Python (
python --versionفي المفسّر الذي يستخدمه Coflow). - ما الذي فعلته وما الذي توقعته. لقطة شاشة للخريطة تساعد. وإن أمكن، مشروع أو ملف صغير يُظهر المشكلة.
من فضلك لا ترسل كودًا لا يحق لك مشاركته. مثال صغير مختلَق يُظهر المشكلة مفيد بالقدر نفسه.
حل المشكلات
«لم يُعثر على مفسّر Python»، أو تقول الخريطة إن التحليل فشل
يحتاج Coflow إلى Python 3.10 أو أحدث. يستخدم المفسّر المختار في إضافة Python، وإلا python3. اختر واحدًا عبر Python: Select Interpreter، أو ضع المسار الكامل في الإعداد coflow.pythonPath (مثل /usr/bin/python3 أو C:\Python312\python.exe). رسالة الخطأ فيها زرّا Select Interpreter وSet Python Path، وShow Log يبيّن أي مفسّر جُرِّب.
Coflow معطّل، أو لا تُفتح الخريطة (الوضع المقيّد)
يشغّل Coflow مفسّر Python الخاص بك، ويشغّل Record a Run… الكود الخاص بك، لذا لا يعمل إلا في مجلد موثوق. شغّل Workspaces: Manage Workspace Trust وامنح المجلد الثقة، ثم افتح الخريطة من جديد. مساحات العمل الافتراضية (ملفات ليست على القرص) غير مدعومة.
الخريطة فارغة
يرسم Coflow خرائط لمشاريع Python. افتح المجلد الذي يحتوي الكود (لا ملفًا منفردًا)، وتأكد أن coflow.exclude لا يستبعده. البيئات الافتراضية وnode_modules ومجلدات البناء والذاكرات المؤقتة مستبعدة دائمًا.
مشروع كبير بطيء، أو يتوقف التحليل
يتوقف التحليل بعد دقيقتين. استبعد المجلدات التي لا تحتاجها عبر coflow.exclude (مثل legacy/** أو الكود المولَّد)، وأوقف coflow.analyzeOnSave لتحدّث الخريطة عند الطلب فقط (Coflow: Refresh Map). المستويات العريضة تُعرض بحجم مقروء: حرّك العرض، أو استخدم Search map للانتقال.
رابط كنت أتوقعه مفقود، أو مرسوم بخط متقطع
الاستدعاءات عبر getattr أو حقن الاعتماديات أو قواميس المعالجات لا يمكن إثباتها دائمًا بقراءة الكود؛ لذلك تظهر متقطعة أو لا تظهر. سجّل تنفيذًا لترى بالضبط ما حدث.
شيء ما مخفي على الخريطة
افتح View Options (⋯ على الخريطة): كل خيار يذكر عدد ما يخفيه، والخريطة تعرض «N hidden here». ويعيد Reset View Options القيم الافتراضية.
مساعدة إضافية
- الأسئلة الشائعة (الخصوصية، اللغات، الترخيص) مُجاب عنها في صفحة Coflow.
- ما يفعله Coflow بالكود الخاص بك: بيان الخصوصية.
- سجل التغييرات