عن المشروع

يحوّل هذا المشروع قلم هانوانغ PV60 (Ai Pointer) الصوتي من مبدّل شرائح عرض تقديمي إلى جهاز إدخال. الشركة المصنعة الفعلية للجهاز هي شنتشن شوانغهو للتقنية (dosmono)، وهانوانغ مجرد علامة تجارية بتصنيع خارجي. الوظائف الرئيسية: الضغط القصير على مفتاح أعلى/أسفل لتقليب الصفحات أو التمرير؛ الضغط الطويل على المفتاح العلوي للإدخال (Enter)، والضغط الطويل على المفتاح السفلي للمسح (Backspace)؛ ضغطة واحدة على مفتاح الصوت لتشغيل الميكروفون وتفعيل مفتاح الإدخال الصوتي الساخن في أسلوب الإدخال (Alt الأيمن)، وضغطة أخرى للإنهاء؛ الضغط المستمر على مفتاح الصوت للدخول في وضع الفأرة الجوية (التحكم بالمؤشر عبر الجيروسكوب)؛ عرض نسبة البطارية وحالة الاتصال وطريقة الاعتراض في شريط النظام. العتاد عبارة عن جهاز USB مركّب (VID_0611 / PID_3001)، يشمل ميكروفون USB Audio، ولوحة مفاتيح HID، وفأرة HID، وقناة إرسال/استقبال من 33 بايت على صفحة الشركة المصنعة 0xFF00، وجميع المفاتيح والإعدادات تمر عبر صفحة الشركة المصنعة. توثّق الوثائق ترميز أزرار المفاتيح وتنسيق حزمة البطارية (ميلي فولت بترتيب صغير النهاية، وصيغة النسبة المئوية الرسمية)، وتوضح أن القلم لا يبلّغ عن البطارية إلا مرة كل 10 ثوانٍ في حالة الاستيقاظ. يعتمد التنفيذ على برنامج تشغيل تصفية لوحة المفاتيح Interception لاعتراض مفاتيح القلم بشكل نظيف، ويحذّر ملف README صراحةً من أن هذا البرنامج قد تعتبره أنظمة مكافحة الغش في الألعاب عبر الإنترنت (ACE وVanguard وVAC/EAC/BattlEye وغيرها) مشبوهاً، ويُنصح بإلغاء تثبيت البرنامج وإعادة التشغيل قبل اللعب؛ وبعد إلغاء التثبيت يتراجع البرنامج إلى وضع مخفّض يعتمد على خطاف لوحة مفاتيح منخفض المستوى، وتبقى الوظائف قابلة للاستخدام لكن الضغط الطويل قد يسرّب أحرفاً. يسجّل README أيضاً عدة استنتاجات من الاختبار الفعلي: سلوك الضغط الطويل محجوز بواسطة ماكرو البرنامج الثابت ولا يمكن لخطافات وضع المستخدم اعتراضه بشكل نظيف؛ مكتبة الشركة المصنعة (kwma_x64.dll) تُفسد كومة الذاكرة (heap) للعملية، لذا يجب عزلها في عملية فرعية مستقلة مع إضافة مراقبة وإعادة تشغيل؛ تُبلّغ SDK بنجاح كاذب عند التعامل مع قلم في وضع السكون، لذا يجب إعادة إرسال الأوامر والتحقق من النشاط عبر طلبات القراءة فقط؛ بعض أساليب الإدخال تتجاهل أحداث SendInput التي تحمل علامة الحقن، لذا يجب إرسال المفاتيح على مستوى برنامج التشغيل، ويتطلب تحويل المفتاح الافتراضي إلى رمز المسح استخدام MAPVK_VK_TO_VSC_EX؛ لا يمكن تعديل ماكرو البرنامج الثابت عبر الإعدادات، وكتابة الإعدادات متطايرة. يتضمن المستودع البرنامج الرئيسي، وعملية فرعية مضيفة للصوت، وعدة أدوات للتحقيق العكسي (التقاط الحزم، والمقارنة A/B، وتعداد الأوامر، واختبار الضغط للتحقق من النشاط، وغيرها)، ووثائق التصميم. يتطلب البناء .NET 8 SDK، ويمكن نشره كملف واحد مكتفٍ ذاتياً. المكونات الخارجية (مكتبة الشركة المصنعة وInterception) لا تُوزَّع مع المستودع ويجب تجهيزها بنفسك؛ عند غياب مكتبة الشركة المصنعة تتعطل وظيفة الصوت وتبقى بقية الوظائف طبيعية. المسارات حالياً مثبّتة بشكل صلب على D:\pen-hack\، وتصبح الإعدادات سارية فوراً بعد الحفظ. الرخصة هي GNU GPL v3، وتغطي الكود الخاص فقط.