// tier: helix-primary · order 2

HelixCode betalicense: MIT

GoGinPostgreSQLRedisSSHModel Context Protocolllama.cppOllama

Source

HelixCode — layered architecture API layer Core services Data layer REST API WebSocket MCP multi-transport Auth & Sessions JWT Worker Pool SSH · health monitor Task + Checkpointing rollback / resume Project & Workflow LLM Providers llama.cpp · Ollama · OpenAI PostgreSQL 15+ 11-table schema Redis 7 optional cache
// architecture

منصة تطوير AI الموزعة التي تقسم العمل، تحفظه، ولا تفقد مكانك أبداً.

HelixCode هي منصة تطوير موزعة من فئة المؤسسات مبنية على Go وتقوم بتقسيم مهام التطوير إلى مهام ذكية موزعة عبر شبكة من العمال المدارة بواسطة SSH، مع نقاط تحقق تلقائية واسترجاع لضمان عدم فقدان أي عمل. تجمع المنصة بين تكامل مزودي LLM المتعددين، ومسارات عمل دورة التطوير الكاملة، والتسليم عبر المنصات المختلفة خلف واجهات REST وCLI وTUI وMCP.

HelixCode هي منصة تطوير موزعة لـ AI مكتوبة بلغة Go. تقسم العمل إلى مهام ذكية عبر شبكات العمال المبنية على SSH، وتحفظ التقدم عبر نقاط تحقق واسترجاع تلقائية، وتدمج عدة مزودي LLM، وتدفع دورة التطوير الكاملة عبر واجهات REST وCLI وTUI وMCP.

HelixCode هي منصة تطوير موزعة من فئة المؤسسات لـ AI (dev.helix.code، ترخيص MIT) مبنية حول وعد بسيط يجعل شعارها حرفياً: قسم العمل، احفظه، ولا تفقد مكانك أبداً. صممت لتحقيق تقسيم ذكي للمهام، وحفظ تلقائي للعمل، ومسارات تطوير عبر المنصات، وهي مكتوبة بلغة Go لتحقيق التوازي وقابلية النقل عبر ملف تنفيذي واحد الذي تتطلبه الحوسبة الموزعة — مع نقاط تحقق تلقائية واسترجاع ومراقبة في الوقت الفعلي كأولويات أساسية بدلاً من إضافات اختيارية.

تعتمد بنيتها على طبقة API مكونة من REST وWebSocket وMCP فوق مجموعة من الخدمات الأساسية المركزة — مصادقة JWT وإدارة الجلسات، وإدارة تجمعات العمال المبنية على SSH مع مراقبة الحالة الصحية، وإدارة المهام مع نقاط التحقق والتعامل مع التبعيات، وإدارة المشاريع ومسارات العمل، وطبقة موحدة لمزودي LLM — وكل ذلك مخزن على PostgreSQL، مع توفر Redis كطبقة تنسيق وتخزين مؤقت اختيارية. يقوم العمال الموزعون بالتثبيت التلقائي عبر الشبكة، لذا فإن توسيع الأسطول يتطلب فقط توجيه الخادم إلى جهاز بدلاً من تجهيزه يدوياً، وتغطي واجهات العملاء المتعددة CLI وواجهة المستخدم الطرفية وREST وإطارات العمل المحمولة، مما يجعل المنصة نفسها قابلة للوصول من خلال نص برمجي أو طرفية أو تطبيق.

تدفع HelixCode دورة التطوير الكاملة من البداية إلى النهاية: مسارات التخطيط والبناء والاختبار وإعادة الهيكلة تُنفذ تلقائياً مع وعي بالتبعيات وتتبع سياق الجلسات المتعددة، بحيث يحافظ الجهد طويل الأمد على استمراريته عبر الانقطاعات وحدود الأجهزة. تدمج المنصة عدة مزودي LLM — مثل llama.cpp وOllama وOpenAI — خلف واجهة واحدة، ثم تضيف اختياراً ذكياً للنماذج يعتمد على الأجهزة للكشف عن وحدة المعالجة المركزية المتاحة وGPU والذاكرة ومطابقتها مع النموذج المناسب للجهاز، وتدعم استراتيجيات التفكير المتقدمة مثل سلسلة الأفكار وشجرة الأفكار للمشكلات التي تتطلب أكثر من محاولة واحدة. يُنفذ Model Context Protocol عبر عدة وسائل نقل لتبادل الأدوات والسياقات الموحدة، وتُبقي الإشعارات متعددة القنوات (Slack وDiscord والبريد الإلكتروني وTelegram) الفرق على اطلاع دائم بتقدم العمل الموزع. تستهدف المنصة أنظمة Linux وmacOS وWindows وAurora OS وSymphonyOS.

المحتوى

عادةً ما تفقد عمليات التطوير الموزعة والمعتمدة على AI سياقها وتقدمها عند تقسيم المهام بين أجهزة مختلفة أو عند انقطاعها. تم بناء HelixCode لجعل تقسيم المهام ذكياً والحفاظ على العمل تلقائياً — بحيث يمكن تقسيم جهد تطوير كبير وتوزيعه عبر شبكة من العاملين، وتحديد نقاط تحقق، واستئنافه أو التراجع عنه دون فقدان الحالة.

إنها تجعل تطوير AI الموزع *متيناً* — وهي القدرة التي لم تكن عملية عند محاولة فرق التطوير تجميع هذه الأجزاء يدوياً. ثلاثة عناصر كانت تعيش في ثلاثة أدوات منفصلة أصبحت الآن منصة واحدة: الحوسبة الموزعة (شبكات العاملين SSH مع التثبيت التلقائي ومراقبة الصحة)، ومساعدة تطوير AI (نماذج اللغة الكبيرة متعددة المزودين مع الاستدلال واستدعاء الأدوات)، وأتمتة سير العمل طوال دورة الحياة الكاملة. النسيج الرابط هنا هو نقاط التحقق المدعومة بقاعدة بيانات: إذ يتم تخزين حالة المهام ونقاط التحقق والتبعيات في PostgreSQL، مما يسمح باستئناف مهمة تمتد عبر عدة أجهزة وعدة جلسات أو التراجع عنها بالضبط من حيث توقفت. وهكذا تتحول الانقطاعات وتقسيم العمل من مصدر لفقدان التقدم إلى حدث روتيني يمكن استرداده.

  • الحفاظ على العمل كعنصر أساسي: نقاط التحقق التلقائية والتراجع المطبقة على مهام التطوير *الموزعة*، بحيث يبقى التقدم محفوظاً حتى عند الانقطاع أو فشل الجهاز بدلاً من أن يتبخر معه.
  • اختيار النموذج المدرك للأجهزة: فحص وحدة المعالجة المركزية GPU والذاكرة المكتشفة ومطابقة كل مهمة بنموذج يمكن للجهاز تشغيله بكفاءة — دون الحاجة لضبط يدوي لكل عامل.
  • منصة واحدة، خمسة مداخل أمامية: REST وWebSocket وCLI وواجهة المستخدم النصية، وMCP، حيث تُعرض MCP نفسها عبر عدة بروتوكولات نقل لتمكين الأدوات والوكلاء من التكامل بأي طريقة يتصلون بها.
  • تغطية متعددة المنصات تمتد إلى ما هو أبعد من الثلاثية المعتادة لأجهزة سطح المكتب لتشمل نظامي Aurora OS وSymphonyOS، مما يوسع أسطول العاملين ليشمل منصات تتجاهلها معظم الأدوات.

  • عدم فقدان العمل عبر المهام الموزعة والقابلة للانقطاع. عندما تُقسم مهمة بين عدة أجهزة، فإن أي عطل أو انقطاع يترك عادةً ما كان قيد التنفيذ عالقاً. قمنا بنمذجة المهمة نفسها كناقل لنقاط التحقق والتبعيات، مخزنة في PostgreSQL، بحيث يمكن للنظام التراجع إلى آخر حالة سليمة أو استئنافها — متانة موجودة في طبقة البيانات بدلاً من الحالة الهشة في الذاكرة.
  • إدارة أسطول عاملين غير متجانس. شبكة من أجهزة Linux وmacOS وWindows وAurora وSymphonyOS تمثل هدفاً متحركاً من حيث التوافر والإعداد. نتعامل معها من خلال خدمة مخصصة لتجمع العاملين تقوم بالتسجيل القائم على SSH، والتثبيت التلقائي على العقد الجديدة، ومراقبة الصحة المستمرة، بحيث يبقى الأسطول معروفاً وقابلاً للتحكم مع دخول وخروج الأجهزة.
  • التنوع في المزودين والأجهزة. تختلف قدرات منصات LLM والأجهزة التي تشغلها بشكل كبير. أخفينا هذا التنوع خلف واجهة موحدة لمزودي LLM، وربطناها بكشف الأجهزة (وحدة المعالجة المركزية GPU والذاكرة) الذي يقود اختيار النموذج الذكي، بحيث يصل النموذج المناسب إلى الجهاز المناسب دون حاجة المتصل للتفكير في أي منهما.

المحتوى

  • Go (الوحدة الداخلية 1.26+) — تم اختياره لأن التوازي القائم على الغوروتينات وإخراج ثنائي واحد هو بالضبط ما يحتاجه نظام العامل الموزع: التوازي الاقتصادي للتنسيق وثنائي مستقل يُثبّت تلقائياً على أي عقدة. يحمل جميع الخدمات الأساسية وثنائيات CLI/الخادم.
  • Gin (إطار عمل HTTP) — تم اختياره لبناء طبقة REST سريعة وبسيطة ذات عبء منخفض؛ يخدم سطح /api/v1 (المصادقة، العمال، المهام، المشاريع) الذي يتواصل معه كل عميل.
  • PostgreSQL 15+ (عبر pgx/v5) — تم اختياره كنظام سجل دائم لأنه يتطلب الاستمرارية المعاملاتية لإنجاز نقاط التحقق والتراجع؛ يضم مخطط الحوسبة الموزعة المكون من 11 جدولاً (المستخدمون، العمال، المهام، المشاريع، الجلسات، مقدمو النماذج اللغوية الكبيرة، الإشعارات) الذي يجعل حفظ العمل ممكناً.
  • Redis 7+ (اختياري، go-redis/v9) — تم اختياره كطبقة تخزين وتنسيق اختيارية تُسرع المسارات الساخنة دون أن تصبح تبعية إلزامية، بحيث يمكن للنشر البسيط أن يعمل على بوستجريس وحده.
  • SSH — تم اختياره كناقل للتحكم في العمال تحديداً لأنه موجود بالفعل في كل مكان وآمن أصلاً؛ يدير تسجيل العمال، التثبيت التلقائي، وتنفيذ الأوامر عن بُعد عبر كامل المجموعة دون الحاجة لنشر وكيل مخصص مسبقاً.
  • Model Context Protocol (MCP) — تم اختياره لتبادل الأدوات والسياقات الموحدة بحيث تتكامل الأدوات والوكلاء الخارجيون عبر بروتوكول مفتوح واحد؛ يُطبق بدعم متعدد للناقلات ليلبي احتياجات العملاء أينما اتصلوا.
  • مقدمو LLM (llama.cpp، Ollama، OpenAI) — تم اختيارهم لتغطية الاستدلال المحلي والمستضاف خلف واجهة موحدة، بحيث يمكن التوجيه الذكي للمهام نحو نموذج محلي أو مستضاف دون أن يعلم المتصل بالفرق.

  • الحالة: تجريبية. يُعلن ملف README عن حالة "مكتملة بالكامل / جميع المراحل الخمس"؛ هذه الاكتمال مدعاة من المشروع وليس مؤكداً بشكل مستقل، لذا تُعامل الصفحة الحالة كتجريبية.
  • جميع التفاصيل أعلاه مستمدة من ملف README بالمستودع؛ العبارات التسويقية (الشعاريات) هي تحريرية وليست مقاييس مصدرية.

طبقة الأولوية: Helix-أساسية.