هذه الصفحة مترجمة من الإنجليزية لغرض التيسير. الأصل الإنجليزي هو النسخة الأدق، وإذا اختلفت النسختان فالأصل الإنجليزي هو الذي يسري.

دليل مستخدم Myna Recorder

كل ما يقوم به Recorder. الصياغة الدقيقة لكل أمر موجودة داخل التطبيق، بجانب المحرر.

آخر تحديث: 15 سبتمبر 2026.

البدء

Myna Recorder — “Recorder” في هذا الدليل، Recorder.exe على القرص — هو مسجّل ماكرو لنظام Windows 10 و11، بإصدار 64 بت. يسجّل لوحة مفاتيحك وماوسك، ويتيح لك تحرير النتيجة كبرنامج نصي مقروء، ثم تشغيلها في أي تطبيق. حمّله من هنا.

التفعيل

  1. أنشئ حسابًا وأكّد بريدك الإلكتروني.
  2. في Recorder، سجّل الدخول من أعلى اليمين ببريدك الإلكتروني وكلمة المرور. سيعرض الشريط عندئذٍ خطتك ورصيدك من الذكاء الاصطناعي.

يبقى Recorder مسجَّل الدخول ويستمر في العمل حتى مع انقطاع الاتصال. تسجيل الخروج يحرِّر مقعد الترخيص على هذا الجهاز لصالح جهاز آخر.

ماكروك الأول

اضغط بدء التسجيل (F2)، ونفّذ المهمة يدويًا، ثم اضغط إيقاف التسجيل (F3)، ثم بدء التشغيل (F4) لإعادة تشغيله، وإيقاف التشغيل (F6) لإنهاء التشغيل مبكرًا. جدول الاختصارات الكامل تحت التشغيل.

حيثما يذكر هذا الدليل مفتاحًا، فهو المفتاح الافتراضي. تُغيَّر المفاتيح من الإعدادات > المفاتيح السريعة.

يرسل الماكرو إدخالًا حقيقيًا إلى أي نافذة تكون في المقدمة. تعرّف على مفتاح إيقاف التشغيل قبل البدء؛ فهو يعمل حتى عندما لا تكون نافذة Recorder هي النافذة النشطة.

النافذة

ستة تبويبات. أربعة منها تحرّر المشروع نفسه؛ أما الوكيل فينفّذ مهمة نيابةً عنك، والنقر التلقائي ينقر نيابةً عنك.

التبويبالغرض منه
Recorderقائمة الخطوات: صف واحد لكل إجراء، مع العلامات والأقسام وتجميع سلاسل حركة الماوس. الأفضل لإعادة الترتيب والحذف وتعديل التوقيت.
البرنامج النصيالماكرو نفسه كنص. الأفضل للحلقات والشروط والتعديلات الدقيقة. انقر نقرًا مزدوجًا فوق أمر لفتح نموذج إعداداته. أسفل المحرر، يضيف شرح عمودًا بكلمات مبسّطة بجانب الكود، ويعرض الإكمال التلقائي أسماءً أثناء الكتابة، ويسرد فحص الصياغة المشكلات أثناء الكتابة.
النقر التلقائينقر تلقائي: نقرة واحدة أو مفتاح واحد أو سلسلة نقاط، تتكرر مرارًا بمعدّل تحدده أنت — راجع النقر التلقائي.
الوكيلقل ما تريد إنجازه، ويقوم الذكاء الاصطناعي بتنفيذه على الماوس ولوحة المفاتيح الفعليَّين، خطوة بخطوة — راجع الوكيل.
المراقبةصفوف مراقبة تعمل جنبًا إلى جنب مع التشغيل أو بمفردها — راجع المراقبة.
الصورقصاصات الشاشة المسمّاة التي يستخدمها هذا الماكرو. التقطها وأعد التقاطها وأعد تسميتها من هنا. القصاصات مشتركة بين كل وحدات الماكرو على هذا الجهاز.

يعرض جنبًا إلى جنب قائمة الخطوات والبرنامج النصي في آن واحد. يفتح زر المتغيرات لوحة تعرض كل متغير مباشرةً أثناء التشغيل.

الملفات

  • .recproj — مشروع: الماكرو وقصاصاته وإعداداته في ملف واحد. هذا ما تحفظه عادةً.
  • .recscript — برنامج نصي وحده، كنص.

يُحفظ الماكرو الحالي تلقائيًا، بما في ذلك نص علامة تبويب البرنامج النصي غير المُطبَّق.

التسجيل

يبدأ بدء التسجيل ويُنهي إيقاف التسجيل (F2 وF3 افتراضيًا). التسجيل عام: يلتقط ما تفعله في أي تطبيق، بالتوقيت الأصلي نفسه.

تحدد الإعدادات > التسجيل ما يُسجَّل: لوحة المفاتيح، نقرات الماوس، حركة الماوس، عجلة الماوس. من دون حركة الماوس يكون الماكرو أقصر بكثير وينقر مباشرةً إلى كل هدف؛ سجّل الحركة فقط للرسم أو التحويم.

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

استخدام كل الشاشات يوسّع الالتقاط ليشمل كل شاشة عرض. اتركه متوقفًا مع شاشة واحدة.

التشغيل

الإجراءالمفتاح الافتراضي
ابدأ التسجيلF2
إيقاف التسجيلF3
بدء التشغيلF4
إيقاف التشغيل مؤقتًا / استئنافهF5
إيقاف التشغيلF6
بدء النقر التلقائيF7
إيقاف النقر التلقائيF8

المفاتيح السبعة جميعها عامة، والمفتاح الذي يحجزه Recorder يُستهلك: لا تراه التطبيقات الأخرى أبدًا. غيّرها أو عطّلها من الإعدادات > المفاتيح السريعة.

إيقاف التشغيل هو الطريقة العامة الوحيدة لمقاطعة ماكرو قيد التشغيل. أبقه مرتبطًا بمفتاح؛ فخيار الإخفاء أثناء التشغيل والوكيل يرفضان البدء من دونه.

السرعة والتكرار

يعمل التشغيل من 0.25× إلى 10×. تُغيّر السرعة مدة الانتظارات المسجَّلة فقط، لا استدعاءات sleep() التي كتبتها، ولا يمكنها جعل التطبيق يستجيب أسرع. إذا تعطّل الماكرو عند 4× لكنه يعمل عند 1×، استبدل التوقيت بـwait_for().

يشغّل التكرار الماكرو عددًا محددًا من المرات؛ 0 يعني “حتى الإيقاف”. للتكرار ضمن تشغيل واحد، استخدم كتل الحلقات.

عمليات الاختبار

يشغّل اختبار في علامة تبويب المسجّل الصفوف المحددة فقط. تُترجم اختبار التحديد في علامة تبويب البرنامج النصي النص المحدد وتشغّله، بما في ذلك التعديلات غير المُطبَّقة. لا يُمسّ الماكرو أبدًا.

  • يعمل الاختبار مرة واحدة بسرعة 1×، أيًا كانت قيم التكرار والسرعة.
  • تُوسَّع الحلقة المحددة جزئيًا لتشمل الكتلة كاملة؛ ويمثّل عنوان القسم المحدد كل ما بداخله.
  • يعمل عدّ تنازلي أولًا (الإعدادات > التسجيل > الانتظار قبل بدء الاختبار، من 0–30 ثانية، والافتراضي 3). يلغيه الإيقاف.

الإخفاء أثناء التشغيل

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

تحرير الماكرو

الأقسام

القسم عنوان فصل في قائمة الخطوات. استخدم قسمًا واحدًا لكل مرحلة فعلية من المهمة.

with section("Log in"):
    click_crop("Username")
    type_text("user")

with section("Export"):
    click_crop("Export")

لا تتداخل الأقسام أبدًا وتبدأ من الهامش الأيسر. يمكن أن تقع الحلقات والشروط داخل قسم، بمسافة بادئة مقدارها أربع مسافات لكل مستوى.

العلامات والانتقالات

label="name" على أي أمر يجعل منه هدف انتقال؛ وlabel("name") في سطر مستقل خطوة لا تفعل شيئًا يمكن الانتقال إليها؛ وgoto("name") تنتقل إليها.

with section("Retry"):
    click_crop("Refresh", label="again")
    wait_for("Done", timeout_ms=20000, on_fail="again")
    label("done")

كل goto("x") وon_no="x" وon_fail="x" وسهم wait_any -> "x" يحتاج إلى خطوة تحمل label="x"، وإلا توقف التشغيل بخطأ. يجب أن تكون العلامات فريدة.

الدوال: راجع مرجع البرنامج النصي.

الصور والقصاصات

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

التقط واحدة من علامة تبويب الصور، سمِّها، ثم استخدم الاسم:

wait_for("Save dialog", timeout_ms=10000, abort=True)
click_crop("Save button")
الوسيطةماذا تفعل
"crop"الاسم بين علامتي اقتباس، أو شرط من عدة أسماء: "A" or "B"، "A" and "B"، مع أقواس للتجميع. يعمل في wait_for وclick_crop وفي كتل if_image/while_image الأربع؛ وتنقر click_crop فوق أول اسم مكتوب. راجع الشروط.
confidenceمدى قرب التطابق المطلوب، 0–1. الافتراضي 0.8. اخفضها لزر يغيّر درجة لونه عند التحويم؛ وارفعها إذا تطابق الشيء الخطأ.
timeout_msالمدة التي يستمر خلالها البحث. الافتراضي 5000.
abortالافتراضي False: عدم العثور على الصورة يُعدّ إخفاقًا لا خطأ، ويستمر التشغيل. أما abort=True فيوقفه بدلًا من ذلك.
on_failعلامة يُنتقَل إليها إذا لم تظهر الصورة أبدًا.
region(x, y, w, h): يبحث فقط داخل هذا المستطيل. استخدمه عندما يظهر العنصر نفسه مرتين. يمكن أن يكون كل رقم متغيرًا أو مجموع قيم.
match"color" (الافتراضي، وهو الأدق) أو "shape"، أي المخطط الخارجي فقط، وهو ما يصمد أمام تغيير السمة. لا يزال الشكل القديم grayscale=True يعني match="shape".
x_offset / y_offsetفي click_crop: يزيح النقرة عن مركز التطابق.
pre_click_msفي click_crop: مدة بقاء المؤشر فوق التطابق قبل الضغط. الافتراضي 200. راجع الماوس.
intoخزّن التطابق كمتغير، أو اكتب r = wait_for("crop"). راجع نتيجة التطابق.

التقط بإحكام. يجب أن تحتوي القصاصة على الجزء المميز فقط دون سواه؛ فالخلفية داخلها تُفشل التطابق عند تغيّر الخلفية.

قراءة النص من الشاشة

تقرأ read_text منطقة من الشاشة إلى متغير. نظّف النتيجة باستخدام الدوال المساعدة، واستخدمها في الشروط أو العمليات الحسابية أو كـ${name} داخل أي وسيطة نصية.

total = read_text(region=(820, 400, 180, 40), single_line=True)
message_box("The order total was ${total}")

مرّر region دائمًا. تؤدي قراءة سطح المكتب كاملًا إلى تصغيره حتى يصبح نص الواجهة العادي غير مقروء.

ثلاثة محركات قراءة

engine=ما هو
"builtin"المحرك الافتراضي. يعمل على جهازك، مجانًا، وينتقل داخل البرنامج المُصدَّر.
"tesseract"محلي ومجاني أيضًا. يقرأ بعض الشاشات بشكل أفضل وبعضها بشكل أسوأ من المحرك المدمج. وهو وحده يقبل page_mode=، الذي يتحكم في كيفية تقسيم الصورة إلى أسطر. جرّبه عندما تكون القراءة قريبة من الصواب لكنها خاطئة.
"ai"نموذج نسخ نصي على الخادم. يستهلك من الرصيد ويمنع التصدير؛ راجع الرصيد. استخدمه عندما يخطئ كلا المحركين المحليين في قراءة شيء مهم.

يُختار المحرك لكل خطوة على حدة. تقوم engine="ai" بالنسخ؛ أما للاستدلال على الشاشة، فاستخدم ask_ai.

تنظيف ما ورد

total = read_text(region=(820, 400, 180, 40)).to_number()
if total < 1000:
    notify("Total looks low: ${total}")

الدوال المساعدة مذكورة تحت تنظيف ما تقرؤه. تخزّن المنطقة الفارغة "" ويستمر التشغيل. تدمج single_line=True النتيجة في سطر واحد.

سؤال الذكاء الاصطناعي

يطرح ask_ai سؤالًا عن جزء من الشاشة على نموذج رؤية ويخزّن الإجابة: “كم صفًا لونه أحمر؟”، “هل يوجد مربع حوار خطأ؟”.

n = ask_ai("how many error icons are visible", role="count", region=(0, 0, 800, 600))
if n:
    click(n.1.x, n.1.y)

كل استدعاء يستهلك من الرصيد ويمنع التصدير؛ راجع الرصيد. يقتصر التشغيل الواحد على 60 استدعاءً للذكاء الاصطناعي.

ثلاثة أدوار

role=الإجابة
"count"الافتراضي. رقم، ومكان كل عنصر: n هو العدد، وn.1.x / n.1.y الموضع الأول، وn.2.x الثاني. يمكن أن يكون الفهرس متغيرًا: click(n.${i}.x, n.${i}.y). لا يوجد دور نعم/لا: if n: يعني “هل هو موجود”، وif not n: “هل هو مفقود”.
"explain"جملة، لاستخدامها في log() أو notify().
"read"نسخ للنص، باستخدام النموذج الذي اخترته — بخلاف read_text(engine="ai")، الذي يستخدم نموذج نسخ ثابتًا.

اختيار نموذج

يأخذ model= اسمًا قصيرًا. القائمة الحيّة، المسعَّرة لمنطقة الخطوة التي تقرؤها، موجودة في نموذج الإعدادات (انقر مرتين على استدعاء ask_ai في علامة التبويب «البرنامج النصي»). الإعداد المستحسن هو النموذج الافتراضي بمستوى استدلاله الافتراضي: اترك model= وreasoning= خارج الاستدعاء ويختارهما الخادم، وهو حاليًا glm. الجدول موجود لحالة وجود سبب للاختلاف؛ فالنموذج الأغلى ليس الأدق في كل سؤال، وقد تبيّن أن gemma، الأرخص، هو الأدق على قصاصة صغيرة.

الاسمالنموذجمستويات reasoning=temperature=
gemmaGoogle Gemma 3 12B—0–2
glmGLM 5.3 Flash (الافتراضي)—0–2
qwen-vlQwen3-VL 30B—0–2
gemini-liteGemini 3.1 Flash Lite—0–2
geminiGemini 3.7 Flashمنخفض، متوسط، مرتفع—
haikuClaude Haiku 4.5—0–1
sonnetClaude Sonnet 5منخفض، متوسط، مرتفع، مرتفع جدًا، أقصى (الافتراضي مرتفع)—
gemini-proGemini 3.1 Proمنخفض، متوسط، مرتفع0–2
kimiKimi K3منخفض، مرتفع، أقصى (يستدل دائمًا؛ الافتراضي أقصى)—
opusClaude Opus 5منخفض، متوسط، مرتفع، مرتفع جدًا، أقصى (الافتراضي مرتفع)—

أعطِه دائمًا region=. يستطيع النموذج عدّ الأشياء عبر سطح مكتب كامل ثم يعجز عن تحديد مواضعها؛ والماكرو الذي يريد النقر يحتاج إلى صورة صغيرة. ينطبق الأمر نفسه على read_text وعلى صفوف المراقبة بالذكاء الاصطناعي.

مرجع البرنامج النصي

يشبه البرنامج النصي لغة Python ويقتصر على جزء صغير منها: المتغيرات، والعمليات الحسابية، وشرط if/else، وحلقتا while وrepeat، واستدعاءات الأوامر، ودوال def، ومسافة بادئة بأربع مسافات، وتعليقات #. الكتل يمكن أن تتداخل؛ الأقسام وحدها يجب أن تبقى عند الهامش الأيسر. لا توجد قوائم، ولا ضمّ نصوص بـ+، ولا استيراد.

المرجع الكامل — كل أمر، وكل وسيط يقبله، وأسماء المفاتيح، ومثال عملي لكل منها — موجود داخل التطبيق، بجانب المحرر الذي تكتب فيه البرامج النصية. في علامة التبويب «البرنامج النصي»، افتح قائمة الأوامر وانقر بزر الفأرة الأيمن على أي أمر لعرض صفحته في الدليل؛ اختر أمرًا واضغط «إدراج» لوضع استدعاء صالح عند المؤشر. انقر مرتين على استدعاء لفتح نموذج إعداداته، الذي يسرد كل خيار يقبله ذلك الأمر.

يمكن إعطاء الوسائط المسمّاة بترتيبها دون أسمائها: press("a", 0.5) هي نفسها press("a", hold=0.5). يقبل كل أمر أيضًا label="name".

المراقبة

صف المراقبة مراقبٌ دائم. يرصد الشاشة أثناء تشغيل الماكرو، أو بمفرده بعد الضغط على بدء المراقبة، بحثًا عن الشيء الذي قد يحدث: مربع حوار عطل، أو شريط انتهاء صلاحية الجلسة، أو تحذير نفاد المخزون. يراقب wait_for فقط حيث تضعه، أما صف المراقبة فيراقب طوال الوقت.

ما الذي يراقبه الصف

تختار شريحة «المراقبة بـ» أحد الاثنين: صورة يُبحث عنها، أو سؤال يُطرح.

النوعماذا تفعل
صورةقصاصة مسمّاة، تُطابَق كما يطابق wait_for. مجانية، وبقدر ما تشاء من المرات.
سؤال الذكاء الاصطناعيسؤال يُطرح على نموذج رؤية: “هل يوجد مربع حوار خطأ؟” الإجابة عدد؛ 0 يعني أنه لم يُعثر على شيء. يستهلك من الرصيد؛ راجع الرصيد.

متى ينطلق

الإعدادالمعنى
يظهرتظهر الصورة، أو ينتقل العدد من 0 إلى أي رقم آخر.
يختفيكانت موجودة والآن لم تعد كذلك. يجب أن يرى الصف الشيء أولًا، لذا لا ينطلق أبدًا على شيء لم تفتحه بعد.
تحليللصفوف الذكاء الاصطناعي فقط. لا حافة تحوّل: يصف النموذج ما يراه ويُرسل الصف تلك الجملة عند كل فحص.

بقية الصف

العمودماذا تفعل
البحث فيأي جزء من الشاشة يُبحث فيه أو يُسأل عنه. الفراغ يعني كل الشاشة. أعطِ صف الذكاء الاصطناعي منطقة صغيرة؛ راجع سؤال الذكاء الاصطناعي.
المطابقة علىصفوف الصور: اللون أكثر صرامة، والشكل يطابق حسب المخطط الخارجي وحده وينجو من تغيير السمة. يحمل زر الترس بجانبها فترة الهدوء. تستخدم صفوف الذكاء الاصطناعي هذه الخانة للنموذج، والاستدلال، ودرجة الحرارة، والمنطقة، وفترة الهدوء.
الفحص كلعدد المرات التي يفحص فيها هذا الصف، بالثواني. لا يمكن لصف الذكاء الاصطناعي أن ينزل عن ثانية واحدة، وقيمته الافتراضية ستون.
البدء بعدالتأخير بعد بدء المراقبة قبل أن يبدأ هذا الصف، لإتاحة الوقت لتحميل التطبيق. يُعاد ضبطه في كل مرة تبدأ فيها المراقبة.
الرسالةما تقوله الرسالة التنبيهية. يُستبدَل ${name}. وإن تُرك فارغًا، يرسل صف التحليل الجملة من النموذج نفسه.

ما الذي يفعله عند انطلاقه

نافذة منبثقة، وTelegram، وDiscord، ولقطة شاشة مرفقة. تختار الشارات على الصف وسائل الإرسال؛ وتوفّر الإعدادات بيانات الاعتماد. إيقاف الماكرو يوقف الماكرو ويوقف المراقبة. صف التحليل ينطلق عند كل فحص، لذا لا يمكنه إيقاف الماكرو.

تحمل إعدادات الصف أيضًا فترة هدوء بين الرسائل، منفصلة عن عدد مرات الفحص. يمكن أيضًا لـالإعدادات > الإشعارات إرسال صورة للشاشة على مؤقّت أثناء تفعيل المراقبة.

التصدير

يحمل زر التصدير كل صف مراقبة مفعَّل وله صورة، مع قصاصته وإعداداته. يبدأ البرنامج المُصدَّر تشغيلها مع كل تشغيل ويوقفها عند انتهائه، تمامًا كما يفعل زر تشغيل هنا. تُرفض الصفوف التي تسأل الذكاء الاصطناعي عند التصدير، مع ذكرها بالاسم؛ فأوقفها أولًا. أما وصول تنبيهاتها عبر Telegram أو Discord فيعتمد على سؤال بيانات الاعتماد عند التصدير.

النقر التلقائي

تنقر علامة التبويب «النقر التلقائي»، أو تضغط مفتاحًا، مرارًا وتكرارًا حتى توقفها: عند المؤشر، أو عند نقطة ثابتة، أو عبر تسلسل من النقاط تسجّلها بالنقر عليها. إنها ليست ماكرو — لا شيء يدخل في المشروع — لكن كل ما في علامة التبويب يُحفظ للمرة القادمة.

ثلاثة أوضاع

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

الإعدادات

الإعدادالمعنى
الانتظار بينالوقت بين النقرات، بالمللي ثانية، بالإضافة إلى تذبذب اختياري: زمن إضافي يصل إلى هذا الحد، يُختار من جديد مع كل نقرة، فلا يكون الإيقاع دقيقًا أبدًا. تُظهر الشارة الخضراء بجانبه حصيلة الإعدادات بالنقرات في الثانية، محتسبةً مدة الضغط والتذبذب.
مدة الضغطمدة بقاء الزر أو المفتاح مضغوطًا في كل نقرة، بتذبذب خاص بها.
التوقف بعدحتى الإيقاف، أو عدد من النقرات (أو الدورات، في حالة التسلسل)، أو مدة زمنية.
التشتتإلى أي مدى يمكن أن تقع كل نقرة عن نقطتها، في أي اتجاه، حتى لا يصيب تشغيل طويل بكسلًا واحدًا مرارًا. 0 يعني الدقة التامة. اجعلها أصغر من الهدف.
التجوّل داخل مربعاختر مربعًا، ثم حدد أين تبدأ داخله؛ تبتعد كل نقرة عن سابقتها بمسافة لا تتجاوز حدًّا معينًا، ولا تخرج أبدًا من المربع.
المفتاح السريعيبدأ F7 ويوقف F8، من أي برنامج. غيّرهما من الإعدادات > المفاتيح السريعة.

تسجيل تسلسل

في تسلسل من النقاط، اضغط تسجيل النقاط وانقر بزر الفأرة الأيسر على كل موضع بالترتيب، في البرنامج نفسه. تضيف كل نقرة صفًا وأنت تشاهد. النقرة التي تضغط «إيقاف» — وأي نقرة أخرى على نافذة Recorder — لا تُحتسب. يكون لكل صف بعد ذلك انتظاره وزره ونوع نقرته الخاصة، ويحرّك اختيار نقطة واحدة على شاشة مجمّدة.

طرق إيقافه

  • زر إيقاف، أو مفتاح إيقاف النقر التلقائي، أو مفتاح إيقاف التشغيل، أو Esc ما دامت نافذة Recorder في المقدمة.
  • وضع الضغط المستمر: ينقر فقط أثناء الضغط باستمرار على مفتاح البدء، ويظل المفتاح يصل إلى البرنامج الذي تحت المؤشر.
  • الإيقاف عند لمس المؤشر أعلى الشاشة: ادفع الماوس نحو الحافة العلوية فيتوقف، في كل وضع — طريقة خروج لا تحتاج إلى لوحة مفاتيح.
  • الإيقاف إذا حُرّك الماوس يدويًا: بمجرد أن يكون المؤشر في موضع لم يضعه النقر التلقائي فيه.

ينتظر زر البدء لحظة أولًا ليتمكن الماوس من مغادرة النافذة؛ أما المفتاح السريع فيبدأ فورًا.

ما تتضمنه كل خطة

النقر التلقائي نفسه متاح في كل خطة: نقرة واحدة أو مفتاح واحد بمعدل دقيق، عند المؤشر أو عند نقطة ثابتة، مع العدد والحد الزمني وكل طرق إيقافه. تضيف خطتا Basic وPro ميزة الشبيهة بالبشر (ينتقل المؤشر إلى كل نقرة وتتفاوت مدة الضغط)، والتذبذبَين، والتشتت، وتسلسلات النقاط، ومربع التجوّل. في خطة Free تظهر هذه الضوابط باهتة مع قفل بجانبها، وما تضبطه تحت خطة يُحفظ لحين شمولها مجددًا.

الحركة الشبيهة بالبشر موجودة لجعل التشغيل يتصرف كيدٍ على الماوس في التطبيقات العادية. لا يفعل Recorder شيئًا لإخفاء نفسه عن أي برنامج.

التصدير كبرنامج

ملف > تصدير كبرنامج… يكتب ملف .exe واحدًا يحتوي على الماكرو وقصاصاته وقارئ النص الذي ضُبط عليه. لا يحتاج إلى مثبّت، ولا إلى بيئة تشغيل، ولا إلى نسخة من Recorder.

  • يعرض مربع حوار التصدير نافذة تحكم: «تشغيل» و«إيقاف مؤقت» و«إيقاف» مع مفاتيحها، و«التكرار» و«السرعة»، وسطر حالة. من دونها يعمل البرنامج فور فتحه، ولا يظهر شيئًا، ويُغلق عند انتهاء الماكرو — وهذا مناسب لشيء يبدؤه برنامج جدولة، وغير مناسب لأول محاولة. فعّل النافذة لأي شيء ستبدؤه بيدك: عندئذٍ تظهر أي مشكلة في رسالة بدلًا من أن تمر دون أن يلاحظها أحد.
  • تنتقل مفاتيح التشغيل والإيقاف المؤقت والإيقاف كما كانت معيَّنة في الإعدادات > المفاتيح السريعة عند التصدير، وكذلك صفوف المراقبة المفعّلة وإعداد تكرار المفاتيح.
  • وحدات الماكرو التي تستخدم الذكاء الاصطناعي (ask_ai، أو read_text مع engine="ai") تُرفض عند التصدير، مع ذكر الخطوات بأسمائها. أما القارئان المحليان فينتقلان داخل الملف.
  • إذا كان الماكرو أو أحد صفوف المراقبة يرسل إلى Telegram أو Discord وكان أحدهما مُعدًّا، يسألك Recorder عمّا إذا كنت تريد تضمين بيانات الاعتماد هذه؛ ويستطيع أي شخص يملك الملف قراءتها. ومن دونها لا ترسل خطوات الإشعار والتنبيهات شيئًا. يحتاج Telegram وDiscord إلى خطة Basic أو Pro: وفي خطة Free لا يُطرح السؤال ولا تنتقل التفاصيل أبدًا.

إيقاف برنامج مُصدَّر

مفتاح إيقاف التشغيل كما كان معيَّنًا عند التصدير، وهو F6 ما لم تغيّره. ومفتاح إيقاف عطّلته يعود إلى F6، لأن الماكرو الذي لا يمكن إيقافه لن يعمل.

إذا كان تطبيق آخر يستحوذ على هذا المفتاح، يجرّبه البرنامج مع Ctrl+Shift، ثم Ctrl+Alt، ويخبرك بأيّهما قبل الخطوة الأولى. وإذا تعذّر تسجيل أيٍّ منها، لا يعمل الماكرو إطلاقًا ويذكر السبب.

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

مساعد الذكاء الاصطناعي

صِف الماكرو الذي تريده ويكتب المساعد البرنامج النصي. لا يصل شيء إلى محررك حتى توافق عليه: اقرأ الرد، ثم اضغط «استخدام» أو «استبدال». يفحص المُجمِّع كل رد؛ فإذا لم يُجمَّع، يقوم المساعد بمحاولة إصلاح تلقائية واحدة، تستهلك رصيدًا.

وضعان. يكتب البناء الماكرو. ويسأل التخطيط عن المهمة ولا يكتب شيئًا حتى تضغط كتابة الماكرو؛ ابدأ منه لأي شيء يتجاوز بضع خطوات. يرسل Ctrl+Enter؛ ويبدأ جديد محادثة جديدة ويحذف النسخة المحفوظة من المحادثة.

النموذج والاستدلال: اترك كليهما على افتراضي. متوسط والأعلى نموذجان مختلفان لا نموذجان أفضل، والمزيد من الاستدلال يكلّف أكثر في كل دورة ونادرًا ما يغيّر البرنامج النصي. استخدام الاسترداد يجعل الماكرو يجد طريقه بنفسه بعد نقرة أخطأت هدفها بدلًا من التوقف؛ وإضافة توقفات قصيرة بعد النقرات يوقف العمل لحظة بعد كل نقرة كي لا تسبق الخطوة التالية الشاشة. وعادةً تُترك الميزتان مفعّلتين.

الحصول على إجابة جيدة

  • التقط قصاصاتك أولًا. يُخبَر المساعد بأسماء القصاصات الموجودة. ومن دونها، لا يستطيع سوى كتابة الإحداثيات.
  • صِف شكل الشاشة، لا الهدف فقط. فـ«انقر تحديث الكل، وانتظر حتى يقول شريط الحالة تم» أفضل من «حدّث جدول البيانات».
  • نقِّح ضمن المحادثة. فـ«انتظر ظهور مربع حوار الحفظ بدلًا من النوم» متابعة طبيعية.

الرصيد

يُستهلك الرصيد في كل ما يصل إلى الخادم: دورات المساعد (بما فيها محاولة الإصلاح)، وخطوات ask_ai، وصفوف المراقبة بالذكاء الاصطناعي، وread_text مع engine="ai"، وكل خطوة من تشغيل الوكيل. أما التسجيل والتشغيل ومراسي الصور والقارئان المحليان والتصدير فلا يستهلك أيٌّ منها رصيدًا أبدًا. يظهر رصيدك بجانب حالة تسجيل الدخول، وفي لوحة المساعد، وفي صفحة حسابك؛ وتكتب كل خطوة ذكاء اصطناعي تكلفتها في سجل التشغيل. الخطط وباقات الرصيد في صفحة الأسعار.

كل خطوة ذكاء اصطناعي في الماكرو (ask_ai، أو read_text مع engine="ai"، أو صف مراقبة بالذكاء الاصطناعي) تستهلك رصيدًا، وتحتاج إلى حساب مسجَّل الدخول، وتمنع التصدير. فالبرنامج المُصدَّر لا يملك حسابًا يُخصم منه.

الوكيل

علامة التبويب «الوكيل» هي العرض الثالث. اكتب هدفًا وينفّذه الذكاء الاصطناعي على سطح مكتبك، خطوة تلو الأخرى، متحققًا من الشاشة بعد كل خطوة. هذا computer use على سطح مكتبك أنت، بالماوس ولوحة المفاتيح الحقيقيين. وهو في أفضل حالاته مع المهام القصيرة الواضحة على شاشة واحدة — افتح صفحة، واملأ نموذجًا، وانقر عبر بضع شاشات؛ أما العمل الطويل أو غير المعتاد فمن الأفضل تسجيله كماكرو. راقبه في المرات القليلة الأولى.

كل خطوة استدعاء واحد للذكاء الاصطناعي، يُحتسب بالرصيد نفسه المستخدَم في ask_ai — بما في ذلك خطوات تشغيل لا يصل إلى غايته. يرى الوكيل الشاشة فقط؛ والنص الموجود على تلك الشاشة ليس تعليمات له أبدًا.

وهو ليس المساعد. فالمساعد يكتب ماكرو تحتفظ به وتعيد تشغيله؛ أما الوكيل فينفّذ المهمة الآن ولا يترك شيئًا وراءه.

تشغيل مهمة

  1. اكتب الهدف: افتح مجلد التنزيلات ورتّبه حسب التاريخ. يحفظه حفظ في قائمة المحفوظة؛ ويزيل حذف واحدًا منها.
  2. اضغط بدء أو Ctrl+Enter. يسأل Recorder مرة واحدة لكل تشغيل، هل تسمح للوكيل بتولي الأمر؟، مكررًا الهدف وما يُسمح له باستخدامه. ولن يبدأ دون اختصار إيقاف التشغيل؛ راجع التشغيل.
  3. راقب الخط الزمني. تُظهر كل خطوة ما رآه الوكيل، وحكمه على الخطوة السابقة (نعم، أو لا، أو غير واضح)، وما يفعله الآن، وما كلّفه. ويحتفظ التذييل بإجمالي التشغيل ورصيدك المتبقي.
  4. اضغط إيقاف، أو اختصار الإيقاف الخاص بك، في أي وقت.

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

عندما تكون المهمة سؤالًا (أخبرني بالخطة التي عليها الحساب) تعود الإجابة في صورة تقرير: مربع رسالة، أو أيًّا مما فعّلته الإعدادات > الإشعارات من سطح المكتب أو Telegram أو Discord.

الخيارات

النموذجافتراضي أو متوسط أو الأعلى. الأعلى هو الإعداد الموصى به، وهو الذي يبدأ به أي ملف شخصي جديد.
مُحسِّن الرصيديرسل لقطة شاشة أصغر في كل خطوة، بتكلفة أقل بنحو الخُمس لكل تشغيل. أوقفه إذا كان الوكيل يفوّت نصًا صغيرًا.
تعلّمه كماكروغير متاح في هذا الإصدار؛ والمربع باهت. لا يترك الوكيل أي ماكرو وراءه.

ما الذي يُسمح له به

يذكر السطر تحت المربعات ما يُسمح للوكيل باستخدامه: الماوس، ولوحة المفاتيح، والتوقيت، والفتح، والرسائل افتراضيًا. يفتح الأذونات الإعدادات > الوكيل، حيث يكون كل واحد منها مربع اختيار تحت يُسمح له بـ:

الإذنالافتراضي
تحريك الماوس والنقر بهمفعَّل
الكتابة على لوحة المفاتيحمفعَّل
الانتظارمفعَّل
فتح الملفات والمجلدات وصفحات الويبمفعَّل
الإبلاغ عمّا وجدهمفعَّل
تشغيل الأوامرمعطّل — اتركه معطّلًا. فهو لم يُختبر بما يكفي بعد.
إعادة تشغيل الكمبيوتر أو إيقاف تشغيلهمعطَّل

اترك الخيارين الأخيرين معطّلين. فسطر أوامر بصلاحياتك يستطيع فعل أي شيء تستطيعه أنت، ولا يستطيع الوكيل التمييز بين أمر آمن وأمر مدمِّر.

يحدد يتوقف عندما الحدود: خطوات التشغيل، وإخفاقات الخطوة الواحدة، والرصيد لكل تشغيل (0 يعني بلا حد). ويحدد الوتيرة مدة انتظار الوكيل استقرار الشاشة، وبين الخطوات، وبين الإجراءات داخل الخطوة الواحدة. ارفع الأخيرة لتطبيق لا يواكب النقر ثم الكتابة.

الإعدادات

انقر الإعدادات في شريط القوائم. سبع علامات تبويب: المفاتيح السريعة، والتسجيل، ولوحة المفاتيح، والنافذة، والإشعارات، والسجل، والوكيل. يطبّق «موافق»، ويتجاهل «إلغاء»، وتعيد استعادة الإعدادات الافتراضية كل شيء إلى أصله باستثناء بيانات اعتماد Telegram وDiscord.

المفاتيح السريعة

المفاتيح السريعة العامة السبعة افتراضية، لا ثابتة. ويمكن إعادة تعيين كل واحد منها أو تعطيله هنا، وهذه العلامة هي المكان الوحيد الذي يُظهر الإعدادات الحالية. انقر الحقل واضغط التركيبة؛ ويمسحها Esc. لا يمكن لإجراءين مشاركة مفتاح واحد، ويحذّر Recorder إذا كان تطبيق آخر قد استحوذ على أحدها. الإعدادات الافتراضية تحت التشغيل.

التسجيل ولوحة المفاتيح

تضم التسجيل مفاتيح تبديل الالتقاط والعد التنازلي للاختبار. وتتحكم لوحة المفاتيح فيما إذا كان مفتاح مضغوط باستمرار يتكرر كما تفعل لوحة المفاتيح الحقيقية: معطّل افتراضيًا، مع التأخير والمعدل وتذبذب اختياري، ومطابقة هذا الكمبيوتر لنسخ إعدادات Windows لديك. وينتقل هذا الإعداد مع البرنامج المُصدَّر.

النافذة

الإخفاء أثناء التشغيل، واستخدام كل الشاشات، والسمة الداكنة، وحجم النص من 85% إلى 140%. وينطبق الأخيران فورًا.

الإشعارات

معطّلة افتراضيًا. وبعد تفعيلها، يستطيع Recorder إخبارك عند انتهاء تسجيل، وعند انتهاء تشغيل، وعند إيقاف تشغيل، عبر إشعار سطح المكتب، أو Discord، أو Telegram، أو أي مزيج منها. إشعارات سطح المكتب متاحة في كل خطة؛ أما Telegram وDiscord فيحتاجان إلى خطة Basic أو Pro. وفي خطة Free يكون المربعان باهتين مع ذكر السبب تحتهما، ويُحفظ أي رمز أو رابط ويب هوك تدخله لحين تغطية خطتك له. تستخدم المراقبة القنوات نفسها، بمفاتيح لكل صف. ويحدد جودة الصورة حجم لقطات الشاشة المرفقة، من منخفضة جدًا إلى بلا فقدان.

Discord

حقل واحد: عنوان رابط ويب هوك.

  1. أنشئ ويب هوك في Discord. افتح إعدادات السيرفر > عمليات الدمج > الويب هوك، واختر ويب هوك جديد، وحدد القناة، وسمِّه، واضغط نسخ رابط الويب هوك. تحتاج إلى إذن إدارة الويب هوك.
  2. الصقه في Recorder. الإعدادات > الإشعارات، فعّل Discord، والصق الرابط.
  3. أرسل اختبارًا. يجب أن تظهر رسالة في القناة خلال ثوانٍ.

رابط الويب هوك كلمة مرور. فأي شخص يملكه يستطيع النشر في تلك القناة. وإذا تسرّب، فاحذف الويب هوك في Discord وأنشئ آخر جديدًا؛ وتصدير برنامج يستخدمه يسألك أولًا.

Telegram

تحتاج إلى رمز بوت من BotFather ومعرِّف المحادثة الرقمي. ويُدخَل كلاهما في الإعدادات > الإشعارات.

لقطة الشاشة الموقوتة

ينشر خيار إرسال صورة للشاشة أثناء المراقبة لقطة شاشة إلى Telegram وDiscord كل N ثانية، للمنطقة التي تختارها أو للشاشة كاملة. ويعمل فقط أثناء تفعيل بدء المراقبة، ولا يستخدم بالون سطح المكتب أبدًا.

ما الذي يُرسَل

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

تذهب الرسائل مباشرةً من جهازك إلى Discord أو Telegram، ولا تمر أبدًا عبر خوادمنا.

سجل التشخيص

تُظهر عرض > السجل ما يفعله التشغيل، وتختار الإعدادات > السجل ما يُسجَّل. فعّل كل خطوة أولًا عندما يسيء الماكرو التصرف. وتسجّل محتوى النص الأحرف المقروءة من شاشتك كنص عادي؛ عطّلها مجددًا بعد أن تجد المشكلة.

ترخيصك

جهاز واحد في كل مرة

للانتقال إلى جهاز آخر، سجّل الخروج من القديم، ثم سجّل الدخول على الجديد. وإذا لم يعد الجهاز القديم متاحًا، فسجّل الدخول على الجديد على أي حال: فبعد ألا يتصل الجهاز القديم لمدة 30 يومًا، يأخذ الجديد مكانه.

العمل دون اتصال

لا يوقف انقطاع الاتصال التشغيل؛ ويعرض الشريط “تم تسجيل الدخول (العمل دون اتصال)” ويستمر Recorder في العمل. ولا يتوقف إلا بعد أن يظل دون اتصال لفترة طويلة.

الميزات التي لا تغطيها خطتك

ست أشياء مشمولة حسب الخطة: ميزات الذكاء الاصطناعي، وقراءة النص من الشاشة، ومراقبة الشاشة، والتصدير كبرنامج، وتنبيهات Telegram وDiscord، والخيارات الإضافية للنقر التلقائي (النقرات الشبيهة بالبشر، والتذبذب، والتشتت، وتسلسلات النقاط، ومربع التجوال). يتحول عنصر التحكم الذي لا تغطيه خطتك إلى اللون الأحمر، والنقر عليه يوضح السبب؛ ويبهت مربعا الإشعار وعناصر تحكم النقر التلقائي الإضافية بقفل والسبب بجانبهما.

تسري التغييرات خلال نحو نصف ساعة. ويعرض مربع حوار الحساب خطتك ورصيدك.

استكشاف الأخطاء وإصلاحها

العرضالسبب المعتاد والحل
تقع النقرات في المكان الخطأ الإحداثيات المسجَّلة مطلقة (راجع التسجيل) وقد تحركت النافذة أو تغيّرت الدقة. استبدل click(x, y) بـ click_crop("name").
يعمل عند التنفيذ خطوة بخطوة، ويفشل بالسرعة الكاملة يحتاج التطبيق إلى لحظة. تستقر النقرات على الهدف بالفعل لمدة pre_click_ms=200؛ جرّب 400–600 على النقرة الفاشلة، أو الأفضل من ذلك، استخدم wait_for للعنصر الذي أنت على وشك استخدامه.
تنتهي مهلة wait_for مع أن الصورة مرئية تتضمن القصاصة خلفية تغيّرت، أو عنصر التحكم مصمَّم بمظهر مختلف. أعد الالتقاط بإحكام أكبر، أو اخفض confidence، أو جرّب match="shape". يُظهر موضوع سجل «عمليات بحث الصور» الدرجات.
يعيد read_text كلامًا غير مفهوم لا يوجد region، أو أنها كبيرة جدًا. ضيّقها لتقتصر على النص فقط، وجرّب engine="tesseract" إذا كان القارئ المدمج لا يزال يواجه صعوبة.
لا تجيب خطوة ask_ai أو صف مراقبة بالذكاء الاصطناعي بشيء تحتاج إلى حساب مسجَّل الدخول برصيد، وإلى region= صغيرة بما يكفي كي يكون الشيء مقروءًا.
لا يبدأ الوكيل لا يوجد اختصار إيقاف التشغيل معيَّن (يقول مربع الحوار يحتاج الوكيل إلى مفتاح إيقاف). عيّن واحدًا في الإعدادات > المفاتيح السريعة. كما يحتاج إلى حساب مسجَّل الدخول برصيد.
ينتهي الوكيل بحالة توقّف أو تعثّر وصل إلى حد (خطوة فشلت ثلاث مرات، أو أربعون خطوة، أو حد الرصيد) أو استسلم النموذج؛ ويذكر السطر الأخير أيّهما. قسِّم الهدف إلى مهام أصغر، أو أوقف مُحسِّن الرصيد، أو ارفع الحدود في الإعدادات > الوكيل.
تظل لوحة المفاتيح عالقة بعد التشغيل وجود key_down دون key_up المقابل له. اضغط المفتاح المُعدِّل وحرّره يدويًا، ثم أصلح الماكرو.
يتوقف التشغيل بخطأ علامة غير معروفة يسمّي goto أو on_no أو on_fail أو سهم wait_any شيئًا لا تحمل أي خطوة علامته ولا يُسمَّى به أي قسم. تحقق من الإملاء؛ فأسماء العلامات والأقسام حساسة لحالة الأحرف.
مفتاح الاختصار لا يفعل شيئًا أُعيد تعيينه، أو عُطِّل، أو سجّله تطبيق آخر أولًا؛ فـWindows لا يشارك مفتاحًا عامًا. تحقق من الإعدادات > المفاتيح السريعة.
لا يتوقف برنامج مُصدَّر بالضغط على F6 يستحوذ شيء آخر على مفتاح الإيقاف لديك، فجهّزه البرنامج مع Ctrl+Shift أو Ctrl+Alt وذكر ذلك قبل أن يبدأ. تنتقل المفاتيح كما كانت معيَّنة في الإعدادات > المفاتيح السريعة وقت التصدير؛ أعد التصدير بعد إعادة التعيين.
لا يحدث شيء عند بدء التشغيل يعمل التطبيق الهدف بصلاحيات المسؤول ولا يعمل Recorder كذلك. شغّل Recorder بصلاحيات المسؤول أيضًا.
زر أحمر اللون خطتك لا تتضمن هذه الميزة. انقره؛ وتذكر الرسالة أيّها. راجع ترخيصك.
لا يفعل برنامج مُصدَّر شيئًا مرئيًا صُدِّر دون نافذة التحكم، فيعمل فور فتحه ويُغلق عند انتهاء الماكرو. صدّره مجددًا مع تفعيل إظهار نافذة تحكم: عندئذٍ تظهر «تشغيل» و«إيقاف مؤقت» و«إيقاف» على الشاشة، وتظهر أي مشكلة في رسالة.

لا يزال الأمر معلَّقًا؟

راسل support@mynarecorder.com. فذكر ما كنت تتوقعه وما حدث بدلًا منه، مع السجل إن كان لديك واحد، يمنحك إجابة حقيقية في رد واحد.