التخصيص والتطوير

هناك مستويان للتخصيص: ترقيع مصدر إضافة قائمة، أو كتابة واحدة جديدة على نمط مدمجة ورفعها.

ترقيع المصدر الساخن

زر القلم على أي بطاقة إضافة يفتح مصدر JavaScript للتحرير. الحفظ يخزّن لقطة تستبدل الأصل — للإضافات المدمجة والمرفوعة على السواء — ويسري التغيير فورًا دون إعادة تشغيل. مفيد لتعديل prompt أو إصلاح URL أو تجربة فكرة على النظام الحي.

Reset يلغي اللقطة ويستعيد المصدر الأصلي (المدمجة فقط — المرفوعة ملكك أصلًا).

كتابة إضافتك

الإضافة ملفان:

• <id>.json — البيان: id وname وdescription وauthor وemail وdate وtype وconfig_fields (المفتاح، التسمية، نوع الحقل، القيمة الافتراضية، الوصف) التي تحوّلها واجهة الويب إلى نموذج؛
• <id>.js — المصدر: ملف JavaScript عادي (تشغّله محرّك QuickJS المدمج، مع جسر addon.get_config() إلى الحقول المُعدّة) يصدّر الدوال التي يستدعيها نوعه — مثل chat_completion() لمزوّد LLM، وقوائم الأدوات ونداءات الجسر لإضافة MCP.

أسرع بداية هي تصدير إضافة قائمة: زر Export على بطاقتها ينزّل zip يضم البيان والمصدر معًا. اختر المدمجة الأقرب لهدفك (توجد أيضًا في crates/vterm-server/src/addon/builtins/)، عدّل id وname وtype والدوال المصدَّرة، ثم ثبّت النتيجة بـUpload Addon. المرفوعة يمكن حذفها مجددًا بزر سلة المهملات.

التخزين

الإضافات المرفوعة ولقطات المصدر تعيش في مجلد addons/ من مجلد الإعداد بصيغة <id>.json + <id>.js فتنجو من إعادة التشغيل. بالنسبة لمعرّف مدمج يُحترم استبدال .js فقط — المدمجة تحتفظ ببيانها الخاص.