استكشاف الأخطاء وإصلاحها
لمعظم المشكلات حل سريع. إن لم تجد مشكلتك هنا، فراسل الدعم مع نظام التشغيل وإصدار PATerminal (الإعدادات ← التحديثات) وما جرّبته.
كُتب لـ PATerminal v1.8.3
التثبيت والفتح
- Windows: «قام Windows بحماية الكمبيوتر الخاص بك»
- انقر مزيد من المعلومات ثم تشغيل على أي حال. يحذّر SmartScreen من التطبيقات الجديدة؛ وإن أردت التأكد فقارن قيمة SHA-256 في دليل التثبيت على Windows.
- macOS يسأل قبل الفتح
- اختر فتح. التطبيق موقَّع بمعرّف Developer ID وموثَّق من Apple.
يعرض Git خطأً
عندما يمنع شيء ما على جهازك git من العمل، يعرض PATerminal لا يمكن تشغيل Git على هذا الكمبيوتر مع الإصلاح. الحالات الشائعة:
| السبب | الإصلاح |
|---|---|
| macOS: لم يُقبل ترخيص Xcode (غالبًا بعد تحديث Xcode مباشرة) | sudo xcodebuild -license accept |
| macOS: أدوات Command Line Tools مفقودة أو معطوبة | xcode-select --install |
| Git غير مثبّت | ثبّته (على Windows: winget install Git.Git)؛ وسيكتشفه PATerminal تلقائيًا. |
| «Dubious ownership» على محرك أقراص آخر أو مجلد مشترك على الشبكة | git config --global --add safe.directory <path> — للمجلدات التي تثق بها فقط. |
| Windows: المسار طويل جدًا | git config --global core.longpaths true |
لا تُحمَّل طلبات السحب أو الـ issues
تأكد من أن gh مثبّت ومسجَّل الدخول (gh auth status)، وأن للمستودع مستودعًا بعيدًا على GitHub. اضغط إعادة المحاولة بعد الإصلاح.
تبقى الجلسة على «قيد التشغيل»
- هناك ما زال يطبع مخرجات فيها — خادم تطوير أو مراقِب ملفات أو مؤشر دوّار. هذه مخرجات حقيقية، فالحالة صحيحة.
- بدأ Codex 0.154.0 أو أحدث قبل أن يحفظ PATerminal الإعداد
tui.whimsy = false: أعد تشغيل جلسة Codex تلك. وقد يتجاوزه إعداد صريح على مستوى المشروع أو سطر الأوامر. راجع ملاحظة لمستخدمي Codex.
لا تظهر إشعارات
- تحقق من أن الإعدادات ← الإشعارات مفعّل.
- اسمح بالإشعارات لـ PATerminal في إعدادات نظام التشغيل، وتحقق من وضع التركيز / عدم الإزعاج.
- لا تُرسل الإشعارات إلا للجلسات التي لا تنظر إليها.
لا تُستأنف محادثة
- ربما خرج الوكيل قبل حفظ المحادثة. افتحها من السجل بدلًا من ذلك.
- يتطلب نقل Claude Code إلى مجلد غير ذي صلة الإصدار v2.1.223 من Claude Code أو أحدث.
- لا يُعاد تطبيق الخيارات التي مرّرتها في سطر الأوامر الأصلي فقط.
فشل التحديث
إذا تعذّر تثبيت التحديث الموقَّع، فلن يُعاد تشغيل PATerminal ولن يتغير شيء. حاول لاحقًا، أو نزّل أحدث مثبّت من صفحة التنزيل وثبّته فوق الإصدار الحالي — تُحفظ جلساتك وإعداداتك.
أين تُحفظ بياناتي؟
تُخزَّن الجلسات والمجموعات والملاحظات والعبارات والإعدادات كملفات محلية على جهازك؛ وتبقى محادثات الوكلاء في مجلدات الوكلاء الخاصة (مثل ~/.claude و~/.codex). لا يُزامَن شيء مع أي خادم، ولا يحتوي PATerminal على أي قياس عن بُعد.
ما زلت عالقًا؟
راجع الأسئلة الشائعة، أو راسلنا بالبريد مع نظام التشغيل وإصدار PATerminal وما جرّبته. نردّ على كل رسالة.