عن المشروع

pixelpets هو رفيق لسطح المكتب مبني باستخدام Electron لنظام Windows 10/11، مع نسخة بيتا لنظام macOS 12+ (مكتملة برمجياً وموقعة بشكل مؤقت، ولكن وفقاً لملف README لم يتم تشغيلها بعد على أجهزة Apple حقيقية). نظام Linux غير مدعوم صراحةً: حيث أن الطبقة العلوية (overlay) وخطافات الإدخال العالمية مخصصة لنظامي Windows/macOS فقط. يمكنك تثبيت برنامج تثبيت Windows مسبق البناء أو التشغيل من المصدر باستخدام git و Node 20 أو أحدث، وأمر `npm install` / `npm start`؛ كما يتوفر عرض تجريبي عبر المتصفح يشغل نفس برنامج الرندرة دون الحاجة لتثبيت أي شيء. البناءات غير موقعة، لذا سيقوم Windows SmartScreen و macOS Gatekeeper بإظهار تحذير عند التشغيل الأول، ويقوم التثبيت بتسجيل نفسه للبدء عند تسجيل الدخول (`npm run autostart:off` لتعطيل ذلك). ماذا يفعل يعيش الحيوان الأليف في طبقة شفافة تسمح بالنقر من خلالها فوق كل النوافذ الأخرى؛ ويكون الحيوان الأليف نفسه فقط هو القابل للنقر. يتفاعل مع المداعبة، والسحب، والكتابة، والتمرير، وحركة المؤشر، مع استجابات محكومة بنموذج مزاج داخلي يتراوح من الهدوء إلى النشاط المفرط (zoomies). يؤدي سحبه إلى تمديده وتصبح نقطة الإفلات موطنه الجديد على الخط السفلي. يؤدي النقر بزر الماوس الأيمن إلى تبديل الألوان (coats)؛ والنقر السريع ينتج عيوناً سعيدة وقلوباً وزقزقة؛ ووضع المؤشر على رأسه أو جسده يعطي ردود فعل متميزة للمداعبة. تؤدي الكتابة في أي مكان إلى تحفيز عجن القوائم الأمامية (الكتابة السريعة تسبب ارتفاع حرارته)، والتمرير يجعله يضرب ورقة شجر أو يتسلق حبل صوف في الألوان التي تتضمن فن الرسم. يوفر أيقونة في شريط المهام للإعدادات، وبدء الاستراحة، واختيار الألوان، ومنطقة اللعب، وتبديل الصوت/الصيد/المزاج، والخروج. المرئيات والصوت يتضمن التطبيق 14 لوناً للقطط بالإضافة إلى كلب Lab أسود، يتم إعادة تلوينها جميعاً وقت الرسم من سبريت (sprite) واحد مشفر بالأدوار. يتم دمج الرسوم المتحركة، بما في ذلك الأطراف، في نفس السبريت، لذا تحصل كل الألوان وكلا الفصيلتين على كل وضعية بألوانهما الخاصة دون ملفات صور إضافية. يمكن للمستخدمين تصميم الألوان واستيرادها وتصديرها. لا توجد ملفات صوتية على الإطلاق: يتم توليد المواء، والنباح، والخرخرة، واللهاث، وحلقة موسيقى lo-fi ارتجالية مباشرة باستخدام Web Audio. ميزات الإنتاجية بالإضافة إلى سلوكيات الحيوان الأليف، يوفر التطبيق مؤقتات للاستراحة وتقنية Pomodoro، وتذكيرات متكررة، وملاحظة مثبتة، وتنبيهات البريد غير المقروء عبر IMAP، وتنبيهات التقويم. تقوم ميزة Focus Guard بقراءة حالة "مشغول" من حدث تقويم مباشر، أو ساعات الهدوء، أو وضع العمل، فتقوم بإيقاف الحيوان الأليف والاحتفاظ بالرسائل بدلاً من مقاطعة مشاركة الشاشة؛ ويتم تلخيص الرسائل المحتجزة في سطر واحد بمجرد تفرغك. يتم حفظ الإعدادات في ملف `settings.json` في مجلد بيانات التطبيق الخاص بالمستخدم، ويتم ترحيل التثبيتات التي سبقت إعادة تسمية المشروع. تعمل المؤقتات والتذكيرات فقط أثناء تشغيل التطبيق وتستخدم الساعة المحلية. التكامل مع وكلاء الذكاء الاصطناعي (AI agent) يمكن لـ pixelpets التفاعل مع حالة عمل وكيل البرمجة: فيفكر واضعاً مخلبه على ذقنه بينما يفكر الوكيل، وينقر بالتزامن مع مؤشر التحميل أثناء عمله، ويرتعد عند حدوث أخطاء، ويقفز ويموء عندما ينتهي الوكيل. يمكن لأي أداة إرسال إشارة إليه عن طريق تشغيل `agent-hook.js` بحالة مثل thinking أو editing أو error أو done أو idle، والتي تكتب ملف حالة صغيراً يراقبه الحيوان الأليف. تتوفر تكوينات جاهزة لـ Claude Code و Codex CLI و Cursor و Antigravity و Kiro، والمساعد آمن للربط (hook-safe): حيث يقوم بتفريغ stdin والرد بـ `{"continue": true}` حتى لا يعيق الوكيل أو يغير عمله. الخصوصية بسبب تفاعله مع الكتابة والتمرير، يستمع التطبيق إلى أحداث الإدخال العالمية. يذكر ملف README أن الإدخال يُستخدم فقط لتحفيز الرسوم المتحركة في اللحظة الحالية، على جهازك: لا يتم تسجيل ضربات المفاتيح أو تخزينها أو نقلها أبداً. لا يوجد تتبع (telemetry) ولا تحديث تلقائي، ولا توجد اتصالات بالشبكة على الإطلاق إلا إذا قمت بتكوين تنبيهات البريد أو التقويم الاختيارية، والتي تتحدث فقط مع الخوادم التي تحددها من عمليات عامل (worker processes) معزولة. يتم تخزين كلمات مرور تطبيقات IMAP مشفرة أثناء السكون باستخدام `safeStorage` الخاص بـ Electron بدلاً من `settings.json`. التطوير والتوثيق تغطي الوثائق الميزات، والألوان المخصصة، والبنية التحتية، ودليل التطوير، وحزمة إطارات للرسم اليدوي واستيراد الوضعيات، وربط الوكلاء، وأداة طرفية صغيرة لجهاز iPad. يقوم `npm test` بتشغيل المجموعة بدون Electron أو GPU، ويقوم `npm run lint` بمطابقة ما يشغله CI إلى جانب فحص التشغيل، ويقوم `npm run poses:cat` بتوليد أوراق اتصال لكل نشاط عبر كل لون لضمان الجودة المرئية، ويقوم `npm run demo:all` بإعادة توليد وسائط README. نظرًا لأن الطبقة العلوية مجمعة بواسطة GPU، لا يمكن للقطات الشاشة العادية التقاطها، لذا تعتمد المراجعة المرئية على أوراق الاتصال تلك. المشروع مرخص بموجب MIT؛ وتوصف الفنون والكود والصوت بأنها أصلية، ويستشهد باثنين من الحيوانات الأليفة لسطح المكتب مفتوحة المصدر كمصدر إلهام مع التأكيد على عدم استخدام أي أصول أو سبريتات أو صوتيات أو علامات تجارية تابعة لجهات خارجية. المساهمات مرحب بها، مع وجود دليل للمساهمة، وسياسة خاصة للإبلاغ عن الثغرات الأمنية، ومناقشات للألوان المخصصة وإعدادات سطح المكتب، وقائمة مراجعة بيتا تستهدف مالكي Mac كأكثر مساهمة مفيدة حالياً.