# PaperWM.spoon على macOS: التثبيت والإعداد الأساسي

Last updated: 2026-11-12

PaperWM.spoon إضافة مجانية لمدير نوافذ تقسيمي قابل للتمرير، تعمل داخل Hammerspoon على macOS. للإعداد، ثبّت Hammerspoon، ثم انسخ مستودع PaperWM.spoon إلى مجلد Spoons الخاص بـ Hammerspoon، وحمّل الإضافة وشغّلها من init.lua، وامنح الأذونات التي يطلبها macOS. تتبع الأوامر أدناه README المشروع، جرى التحقق منه في 2026-11-12.

## أبرز الحقائق

- PaperWM.spoon إضافة (Spoon) لـ Hammerspoon، وليس تطبيق Mac مستقلًا.
- يوفر README أمر نسخ وأمثلة إعداد بلغة Lua.
- يطلب README تغيير خيارين في Mission Control: تعطيل إعادة ترتيب المساحات تلقائيًا، وتفعيل توجد للشاشات مساحات منفصلة.
- تناسبك هذه الإضافة إن أردت إعدادًا قابلًا للضبط بلغة Lua؛ أما من يفضّل ألا يصون إعدادات Hammerspoon فقد يختار أداة أخرى.

## ثبّت Hammerspoon أولًا

احصل على Hammerspoon من [موقعه الرسمي](https://www.hammerspoon.org/)، جرى التحقق منه في 2026-11-12. افتحه مرة واحدة واتبع مطالبات أذونات macOS. يشغّل Hammerspoon سكربتات أتمتة، فراجع ما تثبّته والشيفرة التي تختار تحميلها. يصف README الخاص بمشروع PaperWM.spoon الإضافة وإعدادها. ولم نختبر هذه الخطوات على كل إصدار من macOS.

يعطي [README الرسمي لـ PaperWM.spoon](https://github.com/mogenson/PaperWM.spoon)، جرى التحقق منه في 2026-11-12، أمر التثبيت التالي:

```bash
git clone https://github.com/mogenson/PaperWM.spoon ~/.hammerspoon/Spoons/PaperWM.spoon
```

شغّل الأمر في Terminal. فهو ينسخ المستودع إلى مجلد Spoons الذي يستخدمه Hammerspoon. وإن كنت تستخدم مجلد إعدادات مخصصًا لـ Hammerspoon، فعدّل الوجهة لتطابقه.

## اضبط خيارات Mission Control

يوجهك README إلى تفضيلات النظام ← سطح المكتب وشريط الأيقونات وقسم Mission Control. في macOS الحالي، افتح إعدادات النظام ← سطح المكتب وشريط الأيقونات، ثم مرّر إلى Mission Control. عطّل **إعادة ترتيب المساحات تلقائيًا بناءً على آخر استخدام**، وفعّل **توجد للشاشات مساحات منفصلة**. قد يختلف النص الدقيق وموضعه بحسب إصدار macOS. يعرض README هذه الخيارات كجزء من الإعداد.

هذه خيارات على مستوى النظام تؤثر في طريقة تعامل macOS مع المساحات. قرر هل تناسب إعدادك قبل تغييرها. وإن كنت تستخدم عدة شاشات، فتحقق من أن سلوك المساحات فيها يطابق ما تريده.

## حمّل الإضافة وشغّلها

افتح ملف إعدادات Hammerspoon في `~/.hammerspoon/init.lua`، وأضف أسطر Lua التالية:

```lua
PaperWM = hs.loadSpoon("PaperWM")
PaperWM:bindHotkeys(PaperWM.default_hotkeys)
PaperWM:start()
```

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

لإيقاف PaperWM.spoon، استدعِ `PaperWM:stop()` من وحدة التحكم في Hammerspoon أو من ملف الإعدادات. وإذا أبلغ بدء التشغيل عن غياب الإضافة، فتحقق من أن مجلد النسخ اسمه `PaperWM.spoon` وأنه داخل مجلد Spoons الذي يستخدمه Hammerspoon. افحص وحدة تحكم Hammerspoon بحثًا عن أخطاء Lua قبل تغيير عدة إعدادات معًا.

## تحقق من الاختصارات وغيّر أمرًا واحدًا

يوثّق [README الخاص بـ PaperWM.spoon](https://github.com/mogenson/PaperWM.spoon)، جرى التحقق منه في 2026-11-12، الافتراضيات: التركيز بـ Option–Command مع الأسهم، والتبديل بـ Option–Command–Shift مع الأسهم، وتدوير العرض بـ Option–Command–R. ويعرض أيضًا اختصارات للعائمة والمساحات وتغيير حجم النوافذ. إن تعارض اختصار مع تطبيق آخر، فعدّل جدول Lua، ثم أعد تحميل الإعداد، وافحص وحدة تحكم Hammerspoon إن توقفت الإضافة عن الاستجابة.

يمكن لإعدادات الإضافة نفسها أن تصفي التطبيقات وتعدّل نسب النوافذ. ويعرض README الخاص بها `window_filter` و`window_ratios` كنقاط ضبط. غيّر فقط إعدادًا تستطيع تحديده في الوثائق، ثم اختبر نافذة تطبيق عادية وتطبيقًا تريد استبعاده. ويشير القائمون على المشروع أيضًا إلى أن macOS يحدّ من تحريك النوافذ خارج الشاشة بالكامل، لذا قد تبقى النوافذ المقسّمة عند الحواف مرئية جزئيًا.

هذه سلسلة أدوات قائمة على Lua. تناسب من يرتاح لقراءة ملف إعدادات ويريد مرونة Hammerspoon. أما من يفضّل تطبيقًا مستقلًا ونافذة إعدادات، فقد يجد هذا الإعداد مرهقًا في الصيانة. README الخاص بـ PaperWM.spoon هو المرجع في تعليمات الإعداد؛ تحقق من المستودع قبل اتباعها، لأن المشاريع مفتوحة المصدر قد تتغير.

يقول README الخاص بـ PaperWM.spoon إنه "مستوحى من PaperWM"، ويربط بـ [مشروع PaperWM](https://github.com/paperwm/PaperWM)، جرى التحقق منه في 2026-11-12. للمشروعين تطبيقان وتعليمات إعداد منفصلة.

نحن من يصنع SlidePane، وهو تطبيق macOS لمن يريد ضبط تخطيطات النوافذ دون صيانة سكربتات Lua. قد يناسبك إن كنت تفضّل إعدادات التطبيق وعناصر التحكم المدمجة للاختصارات؛ بينما يكون PaperWM.spoon أنسب إن أردت نموذج البرمجة في Hammerspoon. راجع [ثبّت SlidePane وابدأ التجربة المجانية](/ar/guides/installation) لإعداد التطبيق.

## صفحات ذات صلة

يقارن [مقال Niri على Mac](/ar/blog/niri-on-mac) سير عمل آخر بالتمرير. ويشرح [الاختصارات وتخطيطات لوحة المفاتيح](/ar/guides/shortcuts) كيفية مراجعة اختصارات التطبيقات.
