Розширення

Розширення може мати повноекранну сторінку, наприклад дошку задач. Відкрийте її через Сторінки розширень над списком сесій. Меню з’являється лише для увімкнених і схвалених сторінок. Вибір чату, перезавантаження, пауза, видалення чи зміна сервера закривають сторінку. Розширення не може відкрити її самостійно.

Власні дані розширення зберігаються на підключеному сервері й видаляються після видалення розширення. Дошка може відстежувати сесії різних проєктів і worktree, не створюючи файлів у вашому проєкті.

Через Налаштування → Розширення можна додати до OpenChamber панелі, зроблені іншими людьми. Розширення - це невелика сторінка на правій бічній панелі, поруч із вбудованими панелями. Воно може показувати дані з іншого сервісу, прикріпляти задачу до чату, а з вашого дозволу - запускати сесії, надсилати промпти чи читати файли.

Розширення працюють у веб-версії та десктопній версії OpenChamber. VS Code і мобільний застосунок їх поки не завантажують. Це не те саме, що плагіни OpenCode.

Встановити розширення

Розширення з бейджем Вбудоване постачаються з вибраним інстансом OpenChamber. Вони початково ввімкнені й отримують задекларовані дозволи без окремого діалогу. На картці доступні Вимкнути та Увімкнути; видалити чи оновити їх окремо від застосунку не можна. Вимкнення зберігає дані й підключені облікові записи та залишається чинним після оновлення апки.

Їхні облікові записи налаштовуються в Налаштування → Інтеграції → Вбудовані інтеграції. Для доступу до сервісу все одно може знадобитися API-токен або вхід в обліковий запис.

1. Відкрийте Налаштування → Розширення.
2. Вставте в поле Тека, ZIP або URL одне з такого і натисніть Додати:
   • повний шлях до теки на цьому комп’ютері
   • шлях до файлу .zip
   • https-посилання на git-репозиторій або zip-файл
   • SSH Git-адресу, наприклад [email protected]:owner/extension.git
3. Якщо розширення просить якісь дозволи, діалог покаже їх список. Натисніть Дозволити й увімкнути або Видалити, щоб прибрати розширення.

Також можна перетягнути .zip на поле або вибрати його кнопкою архіву поруч; архів завантажується на сервер OpenChamber, тож це працює і для віддаленого екземпляра. У десктопній версії кнопка теки відкриває системне вікно вибору, а перетягнута тека встановлюється за своїм шляхом.

Іконка розширення з’явиться на бічній панелі. Якщо її немає, дивіться Усунення несправностей.

Розширення з теки запускається прямо з неї, тож розробник може редагувати файли й перезавантажувати панель. Zip або URL спершу копіюється в теку даних OpenChamber; оригінальний файл не чіпається.

Приватні репозиторії та Git identities

SSH-встановлення підтримує [email protected]:owner/extension.git і ssh://[email protected]/owner/extension.git, з необов’язковим #branch-or-tag. У меню з відбитком пальця біля поля виберіть Global Identity або збережений Git-профіль. Вибір зберігається для перевірки й встановлення оновлень; зміна ключа в профілі застосовується під час наступної операції.

Global Identity використовує Git/SSH-налаштування та SSH-агент користувача, який запускає вибраний сервер OpenChamber. Для remote instance ключ має бути доступний на тому сервері. Ключ із паролем спочатку розблокуйте в SSH-агенті процесу сервера. HTTPS використовує HTTPS-авторизацію Git і не перемикається на SSH автоматично. Git-хост має резолвитися в публічні адреси; локальні SSH-аліаси та адреси приватних мереж не підтримуються.

Що може робити розширення

Показувати панель і бачити, який проєкт і сесія відкриті, можна без дозволу. Усе, що діє від вашого імені, потребує дозволу, і весь список ви бачите один раз, під час встановлення:

• Надсилати повідомлення у ваших сесіях: пише й надсилає моделі промпти, а це витрачає токени і може запускати інструменти.
• Доступ до проєктів і сесій: переглядати проєкти, worktree та стани сесій, створювати й відкривати сесії в доданих проєктах. Вміст розмов залишається приватним.
• Читати й записувати файли проєкту: будь-який файл у відкритому проєкті.
• Читати й записувати файли поза проєктом: лише розташування, перелічені в діалозі.
• Використовувати ваш Small Model: одноразова генерація тексту поза вашими сесіями, з моделлю з Налаштування → Сесії → Small Model. Коштує токенів.
• Підключатися до зовнішнього сервісу: з обліковим записом, який ви підключите в Налаштування → Інтеграції.
• Читати розмову сесії: лише коли ви запускаєте дію розширення на цій сесії.
• Запускати локальний сервіс: окрему програму з повними правами вашого користувача. Дозволяйте лише якщо довіряєте автору.

Коли новіша версія просить більше, ніж ви дозволили, картка показує Потребує схвалення і кнопку Переглянути дозволи. Поки ви не дозволите новий список, розширення вимкнене.

Де воно з’являється

Крім панелі на бічній панелі, розширення може додавати пункти в меню, якими ви вже користуєтеся: дії на повідомленні в чаті, меню сесії, меню + біля поля чату та слеш-команди на кшталт /task ABC-12, які прикріплюють щось, нічого не відкриваючи. Воно також може дати власним інструментам належну іконку, заголовок і розкладку виводу в чаті, як у вбудованих інструментів OpenChamber. Розширення саме вирішує, що з цього пропонує; усе це вимкнене, поки ви не дозволите розширення.

Деякі розширення показують живу картинку замість власної панелі: те, в чому агент працює на сервері, наприклад браузер або симулятор. Клацніть у картинку або натисніть клавішу, щоб узяти керування; у рядку стану з’явиться Ви керуєте, а браузерні дії агента відхилятимуться, доки ви не натиснете Повернути агенту. Копіювання та вставка працюють як завжди. Інший пристрій, підключений водночас, бачить, хто керує, і не може забрати керування. Таке розширення може додати власні елементи керування поруч із зображенням, наприклад адресний рядок над ним або колонку інструментів збоку.

Підключити обліковий запис

Розширення, яке працює з сервісом, отримує картку в Налаштування → Інтеграції в розділі Облікові записи розширень. Залежно від сервісу картка просить API-токен, ім’я користувача з токеном або client id для входу через сервіс. Натисніть Під’єднати; Від’єднати стирає збережений токен. Додаткові поля, які оголошує розширення, зберігаються самі, щойно ви їх залишаєте.

Токен лишається на сервері OpenChamber. Сторінка розширення його ніколи не бачить.

Оновити

Розширення, встановлені з git-URL, можуть оновлюватися самі. Відкриття Налаштування → Розширення перевіряє кожне з них не частіше ніж раз на годину; Перевірити оновлення перевіряє одразу. Картка з новішою версією показує Доступне оновлення і кнопку Оновити. Оновлення зберігає ваші дозволи, облікові записи й налаштування; якщо нова версія просить більше, діалог підтвердження з’явиться знову. Розширення з теки чи zip не оновлюються: замініть їх вручну.

Додайте #v1.2.0 або #stable до git-URL під час встановлення, щоб стежити за тегом або гілкою замість типової гілки.

Призупинити або видалити

На кожній картці є перемикач Увімкнено. У вимкненому стані розширення лишається встановленим, але його панель схована, а виклики заблоковані. Прибрати видаляє встановлене з zip чи URL розширення з теки даних OpenChamber; для розширення з теки воно лише забуває шлях, ваша тека лишається.

Зробити своє

Усе, що вміє розширення, і як його створити, описано в Створити розширення.