Що може додати розширення.
Розширення може щось додати майже в кожну частину OpenChamber, а частина його роботи взагалі не потребує вікна. Обери номер, щоб побачити, що там буває, як це робить одне з наших розширень і яка частина SDK за це відповідає.
Обери номер, щоб побачити, що там буває.
1 Сторінка на весь екран Рядок у розділі Сторінки відкриває розширення на весь екран замість чату.
2 Позначки в рядках бічної панелі Маленька іконка на сесіях і робочих деревах, які назве розширення, а його текст видно в підказці.
3 Панель на рейці Іконка на правій рейці відкриває сторінку розширення поруч із чатом.
4 Живий екран Панель розширення показує картинку того, у чому працює агент, наприклад симулятор телефона, і клік по картинці забирає керування в агента.
5 Розділ у Work Status Розділ у панелі поруч із чатом, до чотирьох кнопок у заголовку.
6 Інструменти в чаті Виклики інструментів розширення отримують його іконку й назву, а результат показується як картка, список, таблиця, JSON, Markdown чи код.
7 Блоки у відповідях агента Агенти можуть вставляти компоненти розширення у відповідь, а малює їх його сторінка.
8 ID, що стають посиланнями ID задачі на кшталт UPL-31 у повідомленні або посилання на трекер розширення стають клікабельними.
9 Сповіщення Коротке повідомлення в правому нижньому куті вікна, поверх усього.
10 Git-хост поруч із GitHub Проєкт, чий remote лежить на Git-хості розширення, отримує його merge requests та issues на дошці Issues і PR, у термінах самого хосту.
11 Трекер поруч із Linear Задачі з трекера розширення отримують власну вкладку на дошці Issues і PR, поруч із Linear.
-
Рядок у розділі Сторінки відкриває розширення на весь екран замість чату. Acme Tasks малює там дошку задач.
ВикористовуєЧитати в документаціїcontributes.page -
Маленька іконка на сесіях і робочих деревах, які назве розширення, а його текст видно в підказці. Acme CI ставить червоний хрестик на кожну сесію гілки, де впали перевірки.
ВикористовуєЧитати в документаціїcontributes.markshost.setMark() -
Іконка на правій рейці відкриває сторінку розширення поруч із чатом. Крапка на іконці каже, що щось чекає, а підказка показує кількість.
ВикористовуєЧитати в документаціїcontributes.panelhost.setBadge() -
Панель розширення показує картинку того, у чому працює агент, наприклад симулятор телефона, і клік по картинці забирає керування в агента. Розширення може пристикувати поруч із картинкою власні кнопки.
ВикористовуєЧитати довідку SDKservice.surfacepanel.dock -
Розділ у панелі поруч із чатом, до чотирьох кнопок у заголовку. OpenChamber може сам намалювати рядки з відповідей сервісу розширення, тоді розділу не потрібна сторінка.
ВикористовуєЧитати в документаціїcontributes.statusSectionhost.setStatusControls() -
Виклики інструментів розширення отримують його іконку й назву, а результат показується як картка, список, таблиця, JSON, Markdown чи код. Для цього вистачить кількох рядків у маніфесті, без коду.
ВикористовуєЧитати в документаціїcontributes.tools -
Агенти можуть вставляти компоненти розширення у відповідь, а малює їх його сторінка. Кнопка в блоці відповідає агенту.
ВикористовуєЧитати в документаціїcontributes.blockshost.answerBlock() -
ID задачі на кшталт UPL-31 у повідомленні або посилання на трекер розширення стають клікабельними. Клік відкриває задачу в розширенні або прикріплює її до повідомлення.
ВикористовуєЧитати в документаціїcontributes.links -
Коротке повідомлення в правому нижньому куті вікна, поверх усього. На ньому може бути кнопка Копіювати для помилки чи посилання, і воно може висіти, доки користувач його не закриє.
ВикористовуєЧитати в документаціїhost.toast() -
Проєкт, чий remote лежить на Git-хості розширення, отримує його merge requests та issues на дошці Issues і PR, у термінах самого хосту. Їх там переглядають і зливають, а з будь-якого можна почати робоче дерево чи сесію.
ВикористовуєЧитати в документаціїprovides: ["source-control"]contributes.sourceControl -
Задачі з трекера розширення отримують власну вкладку на дошці Issues і PR, поруч із Linear. Ці самі задачі з'являються в меню +, у New Worktree і серед пов'язаних елементів сесії.
ВикористовуєЧитати в документаціїprovides: ["tracker"]contributes.tracker
Сторінка на весь екран
Рядок у розділі Сторінки відкриває розширення на весь екран замість чату. Acme Tasks малює там дошку задач.
contributes.pageОбери номер, щоб побачити, що там буває.
1 Пункт у меню + Пункт розширення в меню + поля вводу відкриває його вибір у вікні.
2 Прикріплені елементи Елемент, який прикріплює розширення, лягає на поле вводу чипом, там само, де з'являються елементи з GitHub і Linear.
3 Слеш-команди /task UPL-31 прикріплює задачу, нічого не відкриваючи.
4 Рядки в меню @ Сервіс розширення відповідає на те, що користувач пише після @.
5 Палітра команд Дії над сесією й слеш-команди з'являються в ⌘P, коли користувач шукає їх або назву розширення.
6 Логотипи провайдерів Коли OpenCode-плагін розширення додає провайдера моделей, вибір моделі й Налаштування показують його з власним логотипом.
-
Пункт розширення в меню + поля вводу відкриває його вибір у вікні. Те, що вибрав користувач, лягає на повідомлення чипом.
ВикористовуєЧитати в документаціїcontributes.attach -
Елемент, який прикріплює розширення, лягає на поле вводу чипом, там само, де з'являються елементи з GitHub і Linear. Модель читає текст, що йде разом із ним, а клік по чипу відкриває елемент у розширенні.
ВикористовуєЧитати в документаціїhost.attach() -
/task UPL-31 прикріплює задачу, нічого не відкриваючи. Розширення знаходить задачу й повертає її чипом.
ВикористовуєЧитати в документаціїcontributes.commandshost.onResolve() -
Сервіс розширення відповідає на те, що користувач пише після @. Вибраний рядок іде агенту текстом, а користувач бачить чип.
ВикористовуєЧитати в документаціїcontributes.mentions -
Дії над сесією й слеш-команди з'являються в ⌘P, коли користувач шукає їх або назву розширення.
ВикористовуєЧитати в документаціїcontributes.actionscontributes.commands -
Коли OpenCode-плагін розширення додає провайдера моделей, вибір моделі й Налаштування показують його з власним логотипом.
ВикористовуєЧитати в документаціїcontributes.providerLogos
Пункт у меню +
Пункт розширення в меню + поля вводу відкриває його вибір у вікні. Те, що вибрав користувач, лягає на повідомлення чипом.
contributes.attachОбери номер, щоб побачити, що там буває.
1 Git-хост Розширення додає Git-хост поруч із GitHub, GitLab і Gitea.
2 Трекер Розширення додає трекер поруч із Linear.
3 Канал сповіщень Сервіс розширення отримує кожне сповіщення, яке отримав би телефон, і надсилає його в чат чи на власний сервер.
4 Картка облікового запису Картка в Облікових записах розширень, де користувач підключає сервіс токеном або входом.
5 Провайдер використання Картка на сторінці Використання поруч із вбудованими провайдерами, яку можна показати і в Work Status.
6 Браузер агента Сервіс розширення може відповідати на дії агента в браузері, тож агенти працюють у браузері без відкритої десктопної апки.
-
Розширення додає Git-хост поруч із GitHub, GitLab і Gitea. Проєкт на цьому хості отримує дошку Issues і PR, бейджі пул-реквестів і робочі дерева з пул-реквестів.
ВикористовуєЧитати в документаціїprovides: ["source-control"]contributes.sourceControl -
Розширення додає трекер поруч із Linear. Задачі з цього трекера з'являються у виборі, в меню +, у New Worktree і серед пов'язаних елементів сесії.
ВикористовуєЧитати в документаціїprovides: ["tracker"]contributes.tracker -
Сервіс розширення отримує кожне сповіщення, яке отримав би телефон, і надсилає його в чат чи на власний сервер. Токен лишається в OpenChamber.
ВикористовуєЧитати в документаціїprovides: ["notifications"]contributes.notifications -
Картка в Облікових записах розширень, де користувач підключає сервіс токеном або входом. Розширення звертається до сервісу через OpenChamber і токена не бачить.
ВикористовуєЧитати в документаціїcontributes.integrationhost.request() -
Картка на сторінці Використання поруч із вбудованими провайдерами, яку можна показати і в Work Status. Числа читає розширення, а малює їх OpenChamber.
ВикористовуєЧитати в документаціїprovides: ["quota"]contributes.quota -
Сервіс розширення може відповідати на дії агента в браузері, тож агенти працюють у браузері без відкритої десктопної апки. Користувач вибирає цей сервіс як провайдера браузера.
ВикористовуєЧитати в документаціїprovides: ["browser"]
Git-хост
Розширення додає Git-хост поруч із GitHub, GitLab і Gitea. Проєкт на цьому хості отримує дошку Issues і PR, бейджі пул-реквестів і робочі дерева з пул-реквестів.
provides: ["source-control"]contributes.sourceControlОбери номер, щоб побачити, що там буває.
1 Блоки у відповідях агента Блоки, які розширення додає у відповіді агента, показуються на телефоні на ширину відповіді, автору нічого додаткового робити не треба.
2 ID, що стають посиланнями ID задач на кшталт UPL-31 у повідомленнях чату стають посиланнями і на телефоні, автору нічого додаткового робити не треба.
3 Інструменти в чаті Виклики інструментів розширення показуються на телефоні з іконкою, назвою й виглядом виводу від розширення, автору нічого додаткового робити не треба.
4 Прикріплені елементи Елемент, який прикріпило розширення, лежить на полі вводу телефона чипом, як і на десктопі.
5 Сповіщення Тост від розширення показується на телефоні банером угорі екрана, разом із кнопкою "Копіювати".
6 Вкладка у воркспейсі З panel.mobile: true панель розширення стає вкладкою воркспейсу телефона на весь екран, після вбудованих вкладок.
7 Живий екран Розширення з panel.mobile: true і живою картинкою показує картинку у своїй вкладці воркспейсу, з пристикованими кнопками автора.
8 Розділ у "Стан роботи" Розділ Work Status від розширення показується у вкладці "Стан роботи" воркспейсу, автору нічого додаткового робити не треба.
9 Поповери як нижній шит Поповер, який розширення відкриває з якоря, показується на телефоні нижнім шитом із назвою розширення, автору нічого додаткового робити не треба.
10 Сторінка на весь екран Сторінка з page: { entry, mobile: true } з'являється в меню "Більше" списку сесій на телефоні й відкривається на весь екран зі стрілкою назад.
11 Позначки на рядках сесій Позначки, які розширення ставить на сесії та робочі дерева, видно в списку сесій на телефоні, автору нічого додаткового робити не треба.
12 Дії в меню довгого тапу по сесії Дії над сесією з mode: "background" стоять після "Архівувати" в меню, яке відкриває довгий тап по рядку сесії.
13 Рядки розширень у шиті + З panel.mobile: true пункт розширення для прикріплення з'являється в шиті + поля вводу, під пікерами.
14 Трекер у шиті + Трекер, який додає розширення, з'являється в шиті + поля вводу поруч із GitHub і Linear, автору нічого додаткового робити не треба.
15 Слеш-команди Слеш-команди розширення працюють у полі вводу телефона, автору нічого додаткового робити не треба.
16 Рядки в меню @ Рядки, які сервіс розширення додає в меню @, показуються і на телефоні, автору нічого додаткового робити не треба.
17 Дії над повідомленням Дії над повідомленням з mode: "background" з'являються в шиті "Більше дій" повідомлення на телефоні.
18 Дії над виділеним текстом Дії над виділенням з mode: "background" з'являються кнопками в шиті для виділеного тексту на телефоні.
19 Редактор файлів Редактор розширення для типу файлів займає всю вкладку "Файли" на телефоні, автору нічого додаткового робити не треба.
20 Дії на довгий тап у Files Дії над файлом з mode: "background" стоять після "Копіювати шлях" у меню, яке відкриває довгий тап по рядку у "Файли".
21 Дії над виділеними рядками диффу Дії над диффом з mode: "background" з'являються кнопками з підписами під полем коментаря до виділених рядків на телефоні.
22 Логотипи провайдерів Логотип провайдера, який постачає розширення, видно у виборі моделі на телефоні, автору нічого додаткового робити не треба.
23 Налаштування → Розширення У налаштуваннях телефона є сторінка "Розширення", щоб додавати, схвалювати, вимикати й видаляти розширення.
24 Картки облікових записів Картки трекера, каналу сповіщень і облікового запису від розширення є в Налаштування → Інтеграції на телефоні.
25 Картка використання Провайдер використання від розширення отримує картку на сторінці Налаштування → Використання телефона з іконкою розширення, автору нічого додаткового робити не треба.
26 Браузер агента Налаштування → Інструменти OpenChamber на телефоні дає вибрати сервіс розширення як браузер агента.
-
Блоки, які розширення додає у відповіді агента, показуються на телефоні на ширину відповіді, автору нічого додаткового робити не треба. Тап по кнопці в блоці відповідає агенту.
ВикористовуєЧитати в документаціїcontributes.blocks -
ID задач на кшталт UPL-31 у повідомленнях чату стають посиланнями і на телефоні, автору нічого додаткового робити не треба. Тап відкриває вкладку розширення у воркспейсі, якщо в розширення є panel.mobile: true, інакше посилання працює як завжди.
ВикористовуєЧитати в документаціїcontributes.links -
Виклики інструментів розширення показуються на телефоні з іконкою, назвою й виглядом виводу від розширення, автору нічого додаткового робити не треба.
ВикористовуєЧитати в документаціїcontributes.tools -
Елемент, який прикріпило розширення, лежить на полі вводу телефона чипом, як і на десктопі. З panel.mobile: true тап відкриває його у вкладці розширення, а без цього тост каже, що розширення не відкривається на телефоні.
ВикористовуєЧитати в документаціїhost.attach()panel.mobile: true -
Тост від розширення показується на телефоні банером угорі екрана, разом із кнопкою "Копіювати". Автору нічого додаткового робити не треба.
ВикористовуєЧитати в документаціїhost.toast() -
З panel.mobile: true панель розширення стає вкладкою воркспейсу телефона на весь екран, після вбудованих вкладок. Лічильник бейджа стоїть на іконці вкладки, а Налаштування → Загальні впорядковує й ховає її разом з іншими.
ВикористовуєЧитати в документаціїpanel.mobile: truehost.setBadge() -
Розширення з panel.mobile: true і живою картинкою показує картинку у своїй вкладці воркспейсу, з пристикованими кнопками автора. Статус каже "Торкніться, щоб узяти керування", а "Повернути агенту" віддає керування назад.
ВикористовуєЧитати довідку SDKpanel.mobile: trueservice.surface -
Розділ Work Status від розширення показується у вкладці "Стан роботи" воркспейсу, автору нічого додаткового робити не треба. Кнопки стають 36 px під палець, а вибір розділів позначає його як "Розширення".
ВикористовуєЧитати в документаціїcontributes.statusSection -
Поповер, який розширення відкриває з якоря, показується на телефоні нижнім шитом із назвою розширення, автору нічого додаткового робити не треба. Шит такої висоти, яку попросило розширення, і закривається хрестиком, тапом поза ним або кнопкою Назад.
ВикористовуєЧитати довідку SDKmountPopoverAnchor() -
Сторінка з page: { entry, mobile: true } з'являється в меню "Більше" списку сесій на телефоні й відкривається на весь екран зі стрілкою назад. Сторінка page: true бере HTML панелі, тож слідує за panel.mobile.
ВикористовуєЧитати в документаціїpage: { entry, mobile: true } -
Позначки, які розширення ставить на сесії та робочі дерева, видно в списку сесій на телефоні, автору нічого додаткового робити не треба. Тап відкриває вкладку розширення у воркспейсі, якщо в розширення є panel.mobile: true, а інакше показує текст позначки й відкриває її посилання, якщо воно є.
ВикористовуєЧитати в документаціїcontributes.marks -
Дії над сесією з mode: "background" стоять після "Архівувати" в меню, яке відкриває довгий тап по рядку сесії. Дія, що відкриває панель, з'являється там лише з panel.mobile: true.
ВикористовуєЧитати в документаціїwhere: "session"mode: "background" -
З panel.mobile: true пункт розширення для прикріплення з'являється в шиті + поля вводу, під пікерами. Діалог відкривається на весь екран, а панель відкривається вкладкою розширення у воркспейсі.
ВикористовуєЧитати в документаціїcontributes.attachpanel.mobile: true -
Трекер, який додає розширення, з'являється в шиті + поля вводу поруч із GitHub і Linear, автору нічого додаткового робити не треба.
ВикористовуєЧитати в документаціїprovides: ["tracker"] -
Слеш-команди розширення працюють у полі вводу телефона, автору нічого додаткового робити не треба. Команді, що відкриває панель, потрібен panel.mobile: true.
ВикористовуєЧитати в документаціїcontributes.commands -
Рядки, які сервіс розширення додає в меню @, показуються і на телефоні, автору нічого додаткового робити не треба.
ВикористовуєЧитати в документаціїcontributes.mentions -
Дії над повідомленням з mode: "background" з'являються в шиті "Більше дій" повідомлення на телефоні. Дія, що відкриває панель, з'являється там лише з panel.mobile: true.
ВикористовуєЧитати в документаціїwhere: "message"mode: "background" -
Дії над виділенням з mode: "background" з'являються кнопками в шиті для виділеного тексту на телефоні. Дія, що відкриває панель, з'являється там лише з panel.mobile: true.
ВикористовуєЧитати в документаціїwhere: "selection"mode: "background" -
Редактор розширення для типу файлів займає всю вкладку "Файли" на телефоні, автору нічого додаткового робити не треба. Файл тримає й зберігає OpenChamber, як і на десктопі.
ВикористовуєЧитати в документаціїcontributes.fileEditors -
Дії над файлом з mode: "background" стоять після "Копіювати шлях" у меню, яке відкриває довгий тап по рядку у "Файли". Дія, що відкриває панель, з'являється там лише з panel.mobile: true.
ВикористовуєЧитати в документаціїwhere: "file"mode: "background" -
Дії над диффом з mode: "background" з'являються кнопками з підписами під полем коментаря до виділених рядків на телефоні. Дія, що відкриває панель, з'являється там лише з panel.mobile: true.
ВикористовуєЧитати в документаціїwhere: "diff"mode: "background" -
Логотип провайдера, який постачає розширення, видно у виборі моделі на телефоні, автору нічого додаткового робити не треба.
ВикористовуєЧитати в документаціїcontributes.providerLogos -
У налаштуваннях телефона є сторінка "Розширення", щоб додавати, схвалювати, вимикати й видаляти розширення. Дозволи відкриваються в нижньому шиті, автору для цього нічого робити не треба.
Читати в документації -
Картки трекера, каналу сповіщень і облікового запису від розширення є в Налаштування → Інтеграції на телефоні. Там обліковий запис підключається токеном.
ВикористовуєЧитати в документаціїcontributes.integration -
Провайдер використання від розширення отримує картку на сторінці Налаштування → Використання телефона з іконкою розширення, автору нічого додаткового робити не треба.
ВикористовуєЧитати в документаціїprovides: ["quota"] -
Налаштування → Інструменти OpenChamber на телефоні дає вибрати сервіс розширення як браузер агента.
ВикористовуєЧитати в документаціїprovides: ["browser"]
Блоки у відповідях агента
Блоки, які розширення додає у відповіді агента, показуються на телефоні на ширину відповіді, автору нічого додаткового робити не треба. Тап по кнопці в блоці відповідає агенту.
contributes.blocksРобота без відкритого вікна
Локальний сервіс працює поруч з OpenChamber і не зупиняється, коли ніхто не дивиться.
service.keepRunningservice.schedule contributes.sessionEvents contributes.sessionControl contributes.instructionscontributes.skills contributes.opencodePlugin contributes.waits host.generate() host.readFile()contributes.filesystem host.storage host.onRunningShells() provides: ["opencode"] Почати
Розширення складається з теки з маніфестом і вебсторінки. Сторінка "Зробити розширення" пояснює обидва й показує, як ставити розширення з теки, поки ти над ним працюєш. На сторінці Приклад є готове розширення, яке можна скопіювати.