عن المشروع

StarNet هو تطبيق مكتبي محلي أولاً يتيح لك إنشاء وكلاء ذكاء اصطناعي، وتنظيمهم في محطة فضائية بفن البكسل، ومشاهدتهم وهم يؤدون عملاً حقيقياً باستخدام نماذج وأدوات حقيقية. المحطة ليست زينة فحسب؛ بل هي إسقاط حي لحالة وقت التشغيل، حيث تمثل الغرف فرقاً محدودة النطاق حسب القدرات، وتعد الممرات مسارات تسليم مأذونة، أما الأشياء الموضوعة فهي منح قدرات حقيقية. تشمل القدرات الأساسية: - إنشاء عدة وكلاء بفئات وشخصيات وتجهيزات مميزة، يعمل كل منهم بشكل متزامن في مساحة عمل خاصة وبصلاحيات محدودة. - إحضار مفاتيح API الخاصة بك (OpenRouter وAnthropic وOpenAI وGoogle) وتخزينها بأمان في سلسلة مفاتيح نظام التشغيل؛ ولا تحتوي الواجهة الأمامية على أي أسرار. - ربط الوكلاء بمنصات المراسلة مثل Telegram وDiscord وSlack وSignal أو Matrix للتفاعل عن بُعد. - استخدام النماذج المحلية عبر Ollama دون أي مفتاح API أو تكلفة. - جدولة المهام باستخدام cron، وتشغيل وصفات متعددة الخطوات، ومنح مهارات قابلة لإعادة الاستخدام. - طرح أسئلة توضيحية عبر Task Briefs بدلاً من التخمين. - تسليم العمل المنجز كملفات حقيقية في مجلد OUTBOX. - إرفاق خوادم Model Context Protocol (MCP) وموصلات لصق المفتاح/OAuth لتوسيع قدرات الوكلاء. - إملاء صوتي بضغطة للتحدث وخرج صوتي موحد للمحطة. - سجلات دائمة على القرص للإنفاق والميزانيات وسجل المهام والجداول. تفصل البنية بين الاهتمامات: - frontend/: عالم المحطة المبني بـ JavaScript خالصة، وواجهة مستخدم سطح المكتب. - sidecar/: وقت تشغيل وكيل Node.js محلي يتولى المزودين والأدوات والاستمرارية والميزانيات والموافقة. - shared/: عقود الأحداث والمخططات العابرة للحدود. - src-tauri/: غلاف سطح مكتب Rust/Tauri ووقت تشغيل مدمج. - test/ وqa/: اختبارات الوحدة والعقد والتكامل وبوابات الإصدار، بالإضافة إلى إيصالات QA الحية. يدعم قطار الإصدار العام Windows 10/11 (64 بت) وmacOS (Apple Silicon وIntel). حزم Linux هي قطع بناء داخلية وليست هدفاً عاماً مدعوماً. تُنشر إصدارات سطح المكتب على صفحة إصدارات GitHub. للتشغيل من المصدر، تحتاج إلى Node.js 18+ (الإصدار Node.js 22 يطابق CI) وGit، واختيارياً متطلبات Rust وTauri لغلاف سطح المكتب. يمكن تشغيل sidecar مباشرة باستخدام node sidecar/index.js، ثم فتح http://localhost:8787 في المتصفح. وللتطوير، استخدم npm run desktop:dev وnpm run desktop:build. تُجرى الاختبارات عبر سكربتات npm: npm run test:fast (بوابة دمج مطلوبة)، وnpm run test:http (مجموعة اختبارات HTTP/E2E الحية لـ sidecar)، وnpm test (تحقق كامل)، وnpm run security:secrets (فحص أسرار لكامل السجل). ويتم التحقق من جاهزية الإصدار باستخدام npm run qa:ready. المساهمات مرحب بها؛ راجع CONTRIBUTING.md ومدونة قواعد السلوك. يجب الإبلاغ عن الثغرات الأمنية بشكل خاص وفق SECURITY.md. المشروع مفتوح المصدر بموجب ترخيص MIT. يغطي الترخيص الكود فقط؛ أما اسم StarNet وشعاره وأعمال المحطة الفنية وهوية العلامة التجارية فمملوكة لـ Andrew Sims وغير مرخصة مع الكود. يجب أن تستخدم عمليات fork اسمها وشعارها وأعمالها الفنية الخاصة، ولا يجوز لها تقديم نفسها على أنها StarNet أو أنها معتمدة من المشروع.