ابنِ تطبيقات Mac أصلية

حتى الآن استخدمت OpenCode لبناء تطبيقات ويب ونشرها، وتحرير ملفات وفيديوهات، وتشغيل نماذج ذكاء اصطناعي، وأتمتة متصفحك. يمكنك أيضًا استخدام OpenCode لبناء تطبيقات macOS أصلية باستخدام Swift وXcode. ستبدأ بتطبيق موجود مفتوح المصدر أنشأه المطوّر مفتوح المصدر Fayaz Ahmed، تبنيه من المصدر وتشغّله وتجري تغييرًا، لتكوّن حسًا بكيفية عمل عملية تطوير التطبيقات. بعد أن تمر بالدورة، يمكنك اختياريًا بدء تطبيق جديد خاص بك من الصفر. يعلّم skill منصة OpenCode الأنماط الأصلية التي تحتاجها على الطريق.

التطبيق هو OpenCode Stats من Fayaz Ahmed، تطبيق شريط قوائم أصلي لـ macOS يعرض إحصاءات استخدامك لـ OpenCode: التكلفة، والجلسات، والـ tokens، والأدوات، والتفصيل حسب المشروع، كلها تُقرأ من قاعدة بيانات OpenCode المحلية. الأمر مناسب: ستستخدم OpenCode لبناء تطبيق عن OpenCode.

المتطلبات

هذا التمرين لـ macOS فقط. بناء تطبيق Mac أصلي يحتاج إلى Mac وأدوات المطوّر من Apple.

هناك شيئان منفصلان يخلط الناس بينهما غالبًا:

• Command Line Tools تمنحك git وclang ومترجم Swift. سيثبّتها OpenCode لك من جلستك بـ xcode-select --install.
• Xcode الكامل هو التطبيق الكبير من Mac App Store الذي يتضمن xcodebuild وmacOS SDK. تحتاجه لبناء .app فعلي. Command Line Tools وحدها لا تكفي لهذا المشروع.

يستهدف OpenCode Stats macOS 15.6+ ويُبنى بـ Xcode 26 أو أحدث (مستقر، بلا حاجة لـ beta). سيتحقق الوكيل مما لديك بـ xcodebuild -version ويمشيك عبر تثبيت Xcode إن كان مفقودًا.

الـ skill

ستثبّت macos-app-skills، مجموعة من agent skills لبناء تطبيقات macOS أصلية بـ SwiftUI وAppKit:

npx skills add fayazara/macos-app-skills -g -y

العلامة -g تثبّت الـ skill عالميًا (لكل مشاريعك) و-y تتخطى المطالبات التفاعلية، فيُثبَّت دفعة واحدة. يجمع skills للبناء من سطر الأوامر (build)، وأنماط macOS الأصلية لمطوّري الويب (macos-patterns)، ونوافذ الإعدادات، وتحديثات Sparkle التلقائية، وتراكبات النوتش، ومسارات الإصدار. هذه تشفّر الأنماط المكتسبة بشق الأنفس التي تخطئها وكلاء الذكاء الاصطناعي عادة، لذا يبني OpenCode التطبيق ويحرّره بشكل صحيح بدل التخمين.

تُحمَّل الـ skills عند بدء التشغيل، لذا أغلق OpenCode Desktop وأعد فتحه بعد التثبيت.

كيف يعمل البناء

تطبيق Mac أصلي ليس مشروع ويب: لا خادم تطوير ولا npm run dev. «تشغيله» يعني تجميع .app فعلي وإطلاقه. OpenCode Stats مشروع Xcode، لذا يستخدم الوكيل build skill لتجميعه بـ xcodebuild من جلستك، ثم يفتح النتيجة.

أشياء يجدر معرفتها قبل أن تبدأ، حتى تكون المخرجات مفهومة:

• xcodebuild أداة بناء سطر أوامر الخاصة بـ Xcode. يوجّهها الوكيل إلى OpenCode Stats.xcodeproj وscheme «OpenCode Stats». البناء الأول أبطأ من اللاحقة، لأن على Xcode حل تبعيات المشروع قبل أن يتمكن من التجميع.
• توقيع الشيفرة طريقة macOS لوسم تطبيق بهوية مطوّر. يشحن المشروع بإعدادات توقيع المؤلف، التي لن تطابق جهازك، لذا يبدّل الوكيل إعداداتك أو يعطّل التوقيع لبناء محلي. يعرف build skill كيف يتعامل مع هذا، لذا فشل البناء هنا متوقع وقابل للإصلاح، لا طريق مسدود.
• هو تطبيق شريط قوائم. لا نافذة عند الإطلاق. ستجد أيقونته في شريط القوائم أعلى الشاشة وتنقرها لفتح النافذة المنبثقة.

يقرأ التطبيق استخدامك الحقيقي من قاعدة بيانات OpenCode المحلية (~/.local/share/opencode/opencode.db)، لذا الأرقام التي تراها أرقامك. إن لم تشغّل OpenCode على هذا الجهاز قط، ستكون الإحصاءات فارغة حتى تفعل.

ما الذي ستفعله

• أعد أدوات المطوّر من Apple بتثبيت Xcode وCommand Line Tools، مع تحقق الوكيل مما لديك بالفعل.
• ثبّت macos-app-skills skill، ثم أعد تشغيل OpenCode Desktop حتى يُحمَّل.
• انسخ OpenCode Stats repository من GitHub إلى جهازك.
• ابنِ التطبيق من المصدر بـ xcodebuild.
• شغّل التطبيق واعثر على أيقونته في شريط قوائمك.
• أجرِ تغييرًا صغيرًا، مثل تعديل تسمية شريط القوائم أو النافذة المنبثقة، ثم أعد البناء لرؤيته.
• اختياريًا افتح pull request لمشاركة تغييرك مع الـ repository الأصلي.

شارك عملك

بعد أن يعمل تغييرك، يمكنك تقديمه للمشروع. سيساعدك الوكيل على عمل fork للـ repository، ودفع تغييرك إلى branch، وفتح pull request ضد fayazara/opencode-stats باستخدام gh CLI من تمرين استخدم Git وGitHub. سواء دمج المشرف أم لا، فإن PR مدروس مساهمة حقيقية مفتوحة المصدر. هذه الخطوة اختيارية، تخطَّها إن فضّلت إبقاء تغييرك محليًا.

ابنِ تطبيقك الخاص

بناء تطبيق شخص آخر يعلّمك الدورة: أعد الأدوات، ابنِ، شغّل، غيّر، كرّر. بعد أن تستوعب ذلك، يمكنك توجيه OpenCode إلى تطبيق جديد تمامًا خاص بك. لا يجب أن يكون تطبيق شريط قوائم، يمكن أن يكون أي نوع من تطبيقات macOS: تطبيق نوافذ عادي، تطبيق قائم على المستندات، أداة مدفوعة بالإعدادات، أي شيء تريد صنعه. صف التطبيق الذي تفكر فيه ودع OpenCode يبني هيكله من الصفر.

يمكنك أيضًا استكشاف بقية مشاريع Fayaz مفتوحة المصدر، مثل Kaze (تحويل الكلام إلى نص محليًا) أو Screendrop (لقطات الشاشة والتسجيل)، وبناء أي منها بالطريقة نفسها.