Документація

Налаштування та розробка

Є два рівні кастомізації: пропатчити сирець наявного додатка або написати новий за зразком вбудованого й завантажити його.

Хот-патч сирцю

Кнопка з олівцем на будь-якій картці додатка відкриває його JavaScript-сирець для редагування. Збереження кладе знімок, що перезаписує оригінал — і для вбудованих, і для завантажених додатків — і зміна набирає чинності одразу, без перезапуску. Зручно для правки промпту, виправлення URL чи швидкої перевірки ідеї на живій системі.

Reset відкидає знімок і відновлює початковий сирець (лише вбудовані — завантажений додаток і так ваш).

Редагування сирцю додатка — збережений знімок перезаписує оригінал

Написання власного додатка

Додаток — це два файли:

  • <id>.json — маніфест: id, name, description, author, email, date, type та config_fields (key, label, тип поля, типове значення, опис), які веб-інтерфейс перетворює на форму;
  • <id>.js — сирець: звичайний JavaScript-файл (виконується вбудованим рушієм QuickJS, з мостом addon.get_config() до налаштованих полів), що експортує функції, які викликає його тип — напр. chat_completion() для LLM-провайдера, списки інструментів і виклики мосту для MCP-додатка.

Найшвидший старт — експорт наявного додатка: кнопка Export на його картці завантажує zip з маніфестом і сирцем разом. Візьміть вбудований додаток, найближчий до вашої мети (вони також лежать у crates/vterm-server/src/addon/builtins/), поміняйте id, name, type та експортовані функції, потім установіть результат через Upload Addon. Завантажені додатки можна видалити кнопкою з кошиком.

Експорт додатка — маніфест і JavaScript-сирець одним zip

Зберігання

Завантажені додатки й знімки сирців лежать у теці addons/ каталогу конфігурації як <id>.json + <id>.js і переживають перезапуски. Для вбудованого id враховується лише перезапис .js — вбудований додаток зберігає власний маніфест.