عن المشروع

OpenCode SubAgent Magazine هي إضافة موجهة لواجهة OpenCode TUI، تهدف إلى توفير مراقبة لحظية للوكلاء الفرعيين وعرض جانبي مرئي. تعمل مثل مخزن ذخيرة يملأ ويطلق معلومات الوكلاء الفرعيين، مما يساعد المستخدم على تتبع حالة كل وكيل فرعي، واستهلاك الرموز، والتكاليف، والوقت المستغرق، والنموذج، والتقدم وغيرها من البيانات الأساسية بشكل مباشر. تشمل الوظائف الرئيسية للإضافة: - **عرض الحالة اللحظية**: عبر نقاط ملونة (أخضر مكتمل، أصفر قيد التشغيل مع حركة تنفس، أحمر خطأ) لإظهار حالة كل وكيل فرعي في لمحة. - **تتبع الرموز والتكاليف**: تجميع استهلاك الرموز والتكاليف لكل وكيل فرعي، وعرضها عالميًا في شريط العنوان. - **توسيع التفاصيل**: النقر على عنصر لتوسيع عرض نوع الوكيل، الحالة، الوقت المستغرق، الرموز، التكاليف، النموذج، التقدم وغيرها من التفاصيل، مع محاذاة القيم لليمين لسهولة القراءة. - **الدخول إلى الجلسة بنقرة واحدة**: بعد التوسيع، النقر على "← دخول الجلسة" للانتقال مباشرة إلى المحادثة الكاملة للوكيل الفرعي. - **عرض معرف الجلسة**: عرض معرف جلسة الوكيل الفرعي في التفاصيل الموسعة، والنقر عليه لإظهار المعرف الكامل في نافذة منبثقة ونسخه. - **وضع علامة اكتمال يدوي**: للعناصر العالقة، يمكن إنهاؤها يدويًا عبر زر "- وضع علامة اكتمال" في الجانب الأيمن من المنطقة الموسعة، أو استخدام `/subagent-clear-running` للتنظيف الجماعي. - **لوحة قابلة للطي**: النقر على شريط العنوان لطي/توسيع اللوحة، مع حفظ الحالة واستمرارها بعد إعادة التشغيل. - **التمرير للأعلى/الأسفل**: توفير زري "↑ للأعلى" و"↓ للأسفل" أسفل القائمة، مع تكيف الاتجاه مع الترتيب. - **ترتيب قابل للتكوين**: عبر `/subagent-order` لدعم الترتيب التنازلي (الأحدث أولاً) أو التصاعدي (الأقدم أولاً). - **تبديل وضع التمرير**: `/subagent-scroll` لاختيار "تمرير بعجلة الفأرة" أو "النقر على المزيد للتمرير"، لحل تعارض التمرير بين الشريط الجانبي والتمرير العام. - **تنظيف تلقائي TTL**: فترة احتفاظ بالبيانات قابلة للتكوين (3/7/14/30 يومًا أو بدون حد)، مع تجديد تلقائي عند كل زيارة وحذف تلقائي عند انتهاء الصلاحية. - **مسح العناصر يدويًا**: `/subagent-clear-entries` لمسح جميع السجلات في الجلسة الحالية، لمنع إعادة بناء العناصر التاريخية عبر الفحص. - **تكيف اللغة**: دعم `/subagent-lang` للتبديل بين الصينية والإنجليزية أثناء التشغيل، مع حفظ التفضيل. - **حدود قابلة للتبديل**: `/subagent-border` للتحكم في إظهار/إخفاء الحدود الخارجية للوحة (مخفية افتراضيًا)، وعند التفعيل تتوحد مع نمط لوحة إحصائيات التخزين المؤقت. - **أوامر الشرطة المائلة**: توفير `/subagent-lang`، `/subagent-max`، `/subagent-order`، `/subagent-scroll`، `/subagent-ttl`، `/subagent-clear-entries`، `/subagent-session`، `/subagent-version`، `/subagent-clear-running`، `/subagent-border` وغيرها من أوامر التكوين الديناميكي. فيما يتعلق بالتثبيت، تدعم الإضافة كلاً من opencode 1.x و2.x. بالنسبة للإصدار 2.x، يجب إضافة عنصر في مصفوفة `plugins` في ملف `~/.config/opencode/cli.json`؛ أما للإصدار 1.x، فيمكن التثبيت عبر لوحة الأوامر أو التكوين اليدوي لملف `tui.jsonc`. يجب عدم استخدام `opencode plugin add` للتثبيت، لأن هذا الأمر يكتب في تكوين إضافات الخادم مما يسبب أخطاء. يشرح دليل الاستخدام بالتفصيل استخدام أوامر الشرطة المائلة، وعمليات لوحة المفاتيح والفأرة (مثل النقر على شريط العنوان للطي، والنقر على عنصر للتوسيع، والتمرير بعجلة الفأرة)، ومعاني ألوان الحالة. عند التحديث، يجب مسح ذاكرة التخزين المؤقت للإضافة وإعادة تثبيتها، لأن OpenCode لديه مشكلة معروفة تسبب تثبيت إصدار الإضافة. الإضافة مستقلة تمامًا عن النموذج، وتدعم جميع نماذج الذكاء الاصطناعي المتوافقة مع OpenCode (مثل DeepSeek وClaude وGPT وغيرها)، ويتم الحصول على البيانات عبر واجهات OpenCode SDK القياسية. مرخصة بموجب MIT.