ScreenPilot

الأسئلة الشائعة وحل المشكلات

إجابات قصيرة عن أكثر أسئلة ScreenPilot شيوعاً، مع حلول لأكثر المشكلات تكراراً: الأذونات ونوافذ الموافقة والتجمّد واختفاء التكبير.

الإجابات القصيرة أولاً ثم الحلول. وإذا لم تجد سؤالك هنا، اطلب من تطبيق الذكاء الاصطناعي أن يشغّل ScreenPilot doctor: يفحص الجهاز ويقول ما الذي يجب إصلاحه.

الأساسيات#

هل أحتاج إلى مفتاح API أو حساب؟#

لا. تطبيق الذكاء الاصطناعي هو الذي يفكّر، و ScreenPilot يعطيه الشاشة والمسجّل ومحرّر الفيديو. لا يوجد حساب لـ ScreenPilot ولا مفتاح ولا تسجيل دخول.

ما التطبيقات التي تعمل معه؟#

يضيف المثبّت ScreenPilot إلى كل تطبيق من هذه القائمة يجده على جهازك:

  • Claude Desktop وClaude Code
  • Codex وOpenCode وGemini CLI وQwen Code وGitHub Copilot CLI وAmazon Q وGoose وWarp
  • Cursor وWindsurf وDevin Desktop وAntigravity وKiro وZed وLM Studio
  • VS Code وVS Code Insiders وVSCodium، مع إضافتي Cline وRoo Code

JetBrains AI Assistant ليس له ملف إعدادات، فاستخدم زر Import from Claude فيه بعد التثبيت. وأي تطبيق آخر يدعم خوادم MCP يعمل أيضاً. راجع صفحة التثبيت.

هل أستطيع تسجيل نافذة واحدة فقط؟#

أنت تسجّل شاشة، ويستطيع الفيديو أن يتبع نافذة واحدة. هناك ثلاث طرق للحصول على اللقطة التي تريدها:

  • تأطير النافذة. الكاميرا الافتراضية هي "window": تُظهر النافذة المستخدمة فقط وتخفي الشريط والتطبيقات الأخرى. هذا يحتاج أن يعرف سطح المكتب النافذة النشطة (KDE وX11 وWindows وmacOS). على GNOME وأسطح مكتب Wayland الأخرى يعود إلى عرض الشاشة.
  • ضبط النافذة على 16:9. اطلب fitWindow (في سطر الأوامر: screenpilot record --fit-window <class or title>). تُغيَّر النافذة إلى 16:9 أثناء التسجيل وتعود إلى حالتها بعده.
  • تسجيل شاشة واحدة فقط. مرّر اسم الشاشة (--screens HDMI-A-5) فلا تظهر الشاشات الأخرى أبداً.

هل يمكن أن يكون التعليق الصوتي بالعربية؟#

نعم. يستخدم ScreenPilot افتراضياً أصوات Edge بالإنجليزية والعربية ولغات كثيرة غيرها. للعربية المصرية استخدم ar-EG-SalmaNeural (أنثى) أو ar-EG-ShakirNeural (ذكر). ولعرض المزيد شغّل screenpilot voices --lang ar-EG، أو اطلب من تطبيق الذكاء الاصطناعي عرض الأصوات. وإن فضّلت أصواتاً مجانية تعمل على جهازك فيمكنك تثبيت VoiceTut (عربية مصرية وإنجليزية) أو NAMAA (عربية مصرية) بالأمر screenpilot voice-setup. راجع صفحة الأصوات. ويمكن لسطر واحد أن يغيّر الصوت، فيجمع الفيديو الواحد بين لغتين. والعناوين يمكن أن تكون ثنائية اللغة أيضاً: اكتب "English\nعربي" نصاً للعنوان.

كتابة العربية داخل تطبيق العرض تعمل على Windows وmacOS وX11. وعلى Wayland تمرّ عبر الحافظة وتحتاج wl-clipboard (الأمر wl-copy).

هل يعمل دون إنترنت؟#

في معظمه نعم. التسجيل والتحليل والتحرير والتصدير تعمل على جهازك. وثلاثة أشياء تحتاج الإنترنت:

  • التعليق الصوتي الافتراضي. أصوات Edge خدمة على الإنترنت. أما الأصوات المحلية فلا تحتاج الإنترنت بعد تثبيتها (والتثبيت نفسه ينزّل نحو 10 غيغابايت، راجع الأصوات). والفيديو الذي لا فيه أسطر تعليق لا يحتاج صوتاً. المقاطع التي أُنشئت تُحفظ مؤقتاً في مجلد .screenpilot-cache بجوار الـ storyboard أو الـ take.
  • أول تصدير. ينزّل مُصيّر الفيديو، نحو 100 ميغابايت، مرة واحدة.
  • الصفحات التي تطلب من المتصفح التجريبي فتحها، وأي خطوط Google يستخدمها الـ storyboard.

وتطبيق الذكاء الاصطناعي نفسه يحتاج الإنترنت غالباً. راجع الخصوصية لمعرفة ما يغادر جهازك.

أين تُحفظ ملفاتي؟#

تذهب التسجيلات والفيديوهات النهائية إلى مجلد ScreenPilot داخل مجلد Videos (وفي ماك Movies). كل تسجيل مجلد جلسة فيه الفيديو وevents.jsonl وstoryboard.json. وعند استخدام سطر الأوامر تذهب الجلسات إلى sessions/<timestamp> في المجلد الحالي، أو إلى المجلد المحدد في SCREENPILOT_OUTPUT. وخيار المثبّت --output <dir> يحدد هذا المجلد. أما الإعدادات وسجل التدقيق ففي ~/.config/screenpilot (وفي Windows: %APPDATA%\screenpilot).

الفحص والأذونات#

ماذا يفحص doctor؟#

اطلب من تطبيق الذكاء الاصطناعي "run the ScreenPilot doctor"، أو شغّل screenpilot doctor. يطبع قائمة فحوصات وملخصاً مثل "12 ok, 0 failed, 2 skipped". كل فحص فاشل يذكر طريقة إصلاحه. والفحص المتخطّى (skipped) اختياري أو لا ينطبق على سطح مكتبك.

  • Node بإصدار 22 أو أحدث، وffmpeg وffprobe.
  • نوع سطح المكتب والشاشات، وهل يستطيع التسجيل والتحكم بالماوس ولوحة المفاتيح والتحكم بالنوافذ وتسجيل المؤشر.
  • المتصفح التجريبي (Chrome أو Edge أو Brave)، والأصوات (أصوات Edge الافتراضية تحتاج الإنترنت، وللأصوات المحلية فحص خاص اسمه "local voice" بعد أن تثبّتها)، ومُصيّر الفيديو.
  • OBS إذا كنت تستخدم --recorder obs فقط. وGStreamer على Linux.
  • على ماك: Accessibility وScreen Recording وInput Monitoring وavfoundation.

أضف --input لاختبار التحكم بالماوس أيضاً. هذا الاختبار يحرّك المؤشر الحقيقي لحظة.

ما أذونات macOS؟#

يمنح macOS أذونات الخصوصية للتطبيق الذي يشغّل ScreenPilot (Claude أو Cursor أو VS Code أو Terminal)، لا لـ ScreenPilot نفسه. افتح System Settings ثم Privacy & Security وفعّل ذلك التطبيق في:

  • Screen & System Audio Recording (اسمه Screen Recording في macOS 14 وما قبله): مطلوب للتسجيل ولقطات الشاشة وقراءة عناوين النوافذ.
  • Accessibility: مطلوب عندما يستخدم الذكاء الاصطناعي تطبيقاتك بالماوس ولوحة المفاتيح.
  • Input Monitoring: اختياري. يسمح للتسجيلات بالتكبير على نقراتك أنت.

بعدها أغلق تطبيق الذكاء الاصطناعي وافتحه من جديد. وإذا نقص إذن يفتح ScreenPilot صفحة الإعدادات الصحيحة، ويذكر الخطأ اسم التطبيق الذي يجب السماح له.

لماذا يعرض سطح مكتبي نافذة موافقة؟#

على Wayland (KDE وGNOME وغيرهما) لا تستطيع التطبيقات التقاط الشاشة أو التحكم بالماوس دون موافقتك. في أول مرة تسجّل فيها أو تدع الذكاء الاصطناعي يستخدم سطح مكتبك، يطلب النظام مرة واحدة السماح بمشاركة الشاشة أو بالتحكم عن بعد. اسمح بذلك، وعلى KDE اختر كل الشاشات. يحفظ ScreenPilot الموافقة فتكون التشغيلات التالية صامتة. وإذا اخترت شاشة واحدة فقط فستغيب الشاشات الأخرى عن التسجيلات. وحذف state.json من مجلد الإعدادات يجعل ScreenPilot يطلب الموافقة من جديد.

على sway وHyprland يعمل التسجيل لكن الذكاء الاصطناعي لا يستطيع التحكم بسطح المكتب، لأنه لا توجد فيهما واجهة تحكم عن بعد.

صنع الفيديو#

لماذا يتجمّد الفيديو أثناء تشغيل سطر التعليق؟#

لا يسمح التصدير بتداخل سطرين من التعليق. عندما يكون السطر أطول من الوقت المتاح قبل القطع أو السطر التالي، يجمّد التصدير الفيديو حتى ينتهي السطر. وتذكر نتيجة التصدير هذه التوقفات باسم autoHolds. لتفاديها اجعل الأسطر أقصر: جملة واحدة وأقل من 12 كلمة تقريباً وفكرة واحدة. والتعليق الموضوع في منطقة مقطوعة يُحذف، فأبقِ الأسطر داخل الأجزاء التي تحتفظ بها من الفيديو.

ما الفرق بين draft وdelivery؟#

للتصدير ثلاث جودات. draft سريعة وأقل صقلاً: استخدمها أثناء تعديل التوقيت والتكبير والصياغة. وlooks هي الافتراضية، تصدير عادي. وdelivery للملف النهائي: استخدمها مرة واحدة في النهاية. التصدير بطيء، فالتكرار على draft يوفّر وقتاً كبيراً. من سطر الأوامر: screenpilot render storyboard.json -q draft، ثم -q delivery -o demo.mp4.

كيف أقصّ الوقت الميت؟#

شغّل analyze على التسجيل. يعرض الفترات الخاملة، أي التي لا يحدث فيها شيء. ثم أنشئ الـ storyboard مع تفعيل suggest (screenpilot init <session> --suggest) فيقصّ الوقت الخامل ويضع تكبيراً على النقرات عنك. في الـ storyboard الحقل segments هو الأجزاء التي تحتفظ بها. أعطِ الجزء speed بين 4 و8 لتسريع شاشة التحميل بدل قصّها. واحذف الأخطاء بالطريقة نفسها. راجع مرجع الـ Storyboard.

كيف أبقي الفيديو أقل من 90 ثانية تقريباً؟#

استهدف من 30 إلى 90 ثانية. اقصص الوقت الخامل والتحميل أو سرّعه، واجعل التعليق جملة قصيرة واحدة لكل خطوة، وكتابة العنوان من كلمتين إلى ست كلمات. وعندما يتحكم الوكيل بسطح المكتب، اجعل الـ take نفسه أقل من 90 ثانية تقريباً واستخدم waitFor بدل الانتظار الطويل. والفيديو الطويل أكثر من اللازم غالباً يعرض كل خطوة: اعرض المسار الرئيسي واترك الباقي. راجع نصائح الـ take.

كيف أضيف ميزة جديدة إلى عرض صنعته من قبل؟#

لا تعد تسجيل العرض. سجّل الميزة الجديدة فقط، وأعطها storyboard يمتد (extends) من storyboard العرض، ثم اجمعهما بملف sequence.json يقسم العرض عند الثانية المناسبة: [{demo, to: 42}, {feature}, {demo, from: 42}]. انظر إدخال مقطع ميزة في عرض موجود.

كيف أحصل على نسخة طولية أو مربعة؟#

صيّر بالخيار --formats، مثل screenpilot render storyboard.json --formats 16:9,9:16,1:1. تحصل على ملف لكل صيغة من التعديل نفسه. النسخة الطولية من تسجيل عرضي تقصّ الـ views التي تؤطر نافذة، فانظر إلى مسودة أولًا. انظر عدة صيغ.

حل المشكلات#

تطبيق الذكاء الاصطناعي لا يعرف ScreenPilot#

أغلق التطبيق تماماً وافتحه من جديد. في Claude Desktop على Windows انقر بزر الفأرة الأيمن على أيقونته بجوار الساعة واختر Quit. إذا لم يتغير شيء، شغّل مثبّت ScreenPilot مرة أخرى. فهو يعرض التطبيقات التي أضاف إليها ScreenPilot. وإذا قال "No AI tool found" فثبّت تطبيق الذكاء الاصطناعي وافتحه مرة واحدة ثم شغّل المثبّت من جديد. راجع التثبيت.

لا يوجد تكبير على نقراتي في التسجيل#

يأتي التكبير من تسجيل النقرات، والتسجيل يعتمد على سطح المكتب:

  • KDE على Wayland: التقاط النقرات يحتاج أن يكون مستخدمك في المجموعة input. هذه المجموعة تستطيع قراءة كل ما يُكتب وكل حركة الماوس، فأضف نفسك إليها على جهاز تثق به فقط.
  • macOS: اسمح بـ Input Monitoring لتطبيق الذكاء الاصطناعي.
  • GNOME وأسطح مكتب Wayland الأخرى: يخفي سطح المكتب المؤشر، فلا يوجد سجل نقرات لتسجيلاتك أنت. أما الـ takes التي ينفّذها الوكيل فتسجّل نقراتها بنفسها، ويستطيع الوكيل وضع التكبير يدوياً في الـ storyboard.

doctor يقول إن مُصيّر الفيديو غير جاهز#

ينزَّل المُصيّر مرة واحدة، نحو 100 ميغابايت، ويحتاج الإنترنت. أول تصدير ينزّله، فلا شيء عليك فعله سوى الانتظار. وإذا فشل التنزيل فتحقق من الاتصال وأعد التصدير.

توقف الوكيل عندما لمست الماوس#

هذا مقصود. تحريك المؤشر يوقف الوكيل لتتولّى أنت الأمر. اطلب منه أن يستدعي resume ليكمل من حيث المؤشر الآن، أو abort ليتوقف. ولمنعه من التفاعل مع الماوس على جهاز دون مراقبة، راجع التشغيل دون مراقبة.