docs: add OpenChamber feature docs and translations (#1400)
* docs: add OpenChamber feature docs and translations Add 30 new docs pages covering OpenChamber-specific workflows and setup: OpenCode server, providers/models/agents, MCP, skills, commands & snippets, usage, projects, context, notes/todos/plans, scheduled tasks, project actions, preview, worktrees, multi-run, git & GitHub, magic prompts, git identities, mobile/PWA, security, notifications, voice, project icons, remote instances, desktop browser, updates, and three troubleshooting pages. Rebuild sidebar into eight task-oriented sections and translate every new page into all six supported locales (uk, zh-cn, es, pt-br, ko, pl). * docs: surface new sections on homepage and cross-link tunnels Add an Explore block to the docs homepage (all seven locales) linking to the new section anchors, and cross-link the Tunnels page to Security and PWA & Mobile.
This commit is contained in:
Bohdan Triapitsyn
committed by
GitHub
GitHub
parent
bf6043a472
commit
967704a9b9
@@ -0,0 +1,39 @@
|
||||
---
|
||||
title: Команди та сніпети
|
||||
description: Створюйте багаторазові слеш-команди та текстові сніпети для чату.
|
||||
---
|
||||
|
||||
# Команди та сніпети
|
||||
|
||||
І команди, і сніпети рятують вас від повторного набирання того самого. Команди — це цілі промпти, які ви запускаєте через `/`; сніпети — це фрагменти тексту, які ви вставляєте в повідомлення через `#`.
|
||||
|
||||
## Команди
|
||||
|
||||
Команда — це збережений промпт, який ви запускаєте слешем, як-от `/review`. Керуйте ними в **Settings → Commands**.
|
||||
|
||||
1. Відкрийте **Settings → Commands** і створіть команду.
|
||||
2. Дайте їй назву, опис і текст промпту, який вона має надсилати.
|
||||
3. За бажанням закріпіть її за конкретним агентом чи моделлю.
|
||||
4. Виберіть персональну область або область проєкту.
|
||||
|
||||
У чаті введіть `/` як **перший** символ повідомлення, щоб викликати команди, потім оберіть одну. Ваш текст може використовувати заповнювачі:
|
||||
|
||||
- `$ARGUMENTS` — те, що ви вводите після команди
|
||||
- `@filename` — вставляє вміст файлу
|
||||
- `` !`command` `` — вставляє вивід shell-команди
|
||||
|
||||
Вбудовані команди `init` та `review` можна скинути, але не можна видалити.
|
||||
|
||||
## Сніпети
|
||||
|
||||
Сніпет — це багаторазовий текст, на який ви посилаєтеся вбудовано через хештег, як-от `#signoff`. Керуйте ними в **Settings → Snippets**.
|
||||
|
||||
1. Відкрийте **Settings → Snippets** і створіть сніпет.
|
||||
2. Дайте йому назву й текст, який він позначає. Додайте псевдоніми, якщо хочете більше одного тригера.
|
||||
3. Виберіть персональну область або область проєкту.
|
||||
|
||||
У чаті введіть `#` і виберіть сніпет. OpenChamber підставить повний текст перед надсиланням.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Навички](/uk/skills/) — завантажуйте більші набори інструкцій за потреби
|
||||
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: Контекст
|
||||
description: Дивіться, скільки пам'яті моделі використовує сесія.
|
||||
---
|
||||
|
||||
# Контекст
|
||||
|
||||
Кожна модель може утримувати лише певний обсяг розмови водночас — свій контекст. OpenChamber показує, наскільки той заповнений, щоб ви могли зрозуміти, коли сесія наближається до ліміту й відповідь може почати втрачати старіші деталі.
|
||||
|
||||
## Швидкий індикатор
|
||||
|
||||
Поки ви спілкуєтеся, невеликий датчик показує відсоток використаного контексту. Він змінює колір у міру заповнення:
|
||||
|
||||
- зелений — багато місця
|
||||
- жовтий — заповнюється (близько трьох чвертей)
|
||||
- червоний — майже повний
|
||||
|
||||
Наведіть на нього (або торкніться на мобільному), щоб побачити точну кількість токенів.
|
||||
|
||||
## Повна панель контексту
|
||||
|
||||
Відкрийте вкладку **Context** у правій бічній панелі для повнішої картини поточної сесії:
|
||||
|
||||
- використовувана модель і коли почалася сесія
|
||||
- загальна кількість токенів відносно ліміту моделі
|
||||
- підсумки повідомлень і вартості
|
||||
- розподіл токенів останньої відповіді
|
||||
- приблизний розподіл того, що займає контекст (ваші повідомлення, агента, вивід інструментів)
|
||||
|
||||
Розподіл — це оцінка, а не точний підрахунок; використовуйте його, щоб виявити, що заповнює вікно, а не для виставлення рахунків.
|
||||
|
||||
## Що робити, коли він повний
|
||||
|
||||
Починайте свіжу сесію для нового завдання, а не дозволяйте одній сесії розростатися безкінечно. Коротший контекст швидший і тримає модель зосередженою.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Проєкти](/uk/projects/) — сесії згруповані за проєктами
|
||||
@@ -0,0 +1,22 @@
|
||||
---
|
||||
title: Десктопний браузер
|
||||
description: Переглядайте будь-яку сторінку всередині десктопного застосунку, з інспекцією та перехопленням консолі.
|
||||
---
|
||||
|
||||
# Десктопний браузер
|
||||
|
||||
Десктопний застосунок має вбудований браузер, тож ви можете відкрити будь-яку сторінку просто поруч із чатом, вказувати на елементи, щоб запитати про них, і перехоплювати консоль сторінки. Відкрийте його з кнопки глобуса в заголовку застосунку.
|
||||
|
||||
> Десктопний браузер — це функція **лише для десктопа**. У вебі панель [перегляду](/uk/preview/) пропонує ті самі інструменти інспекції та консолі для вашого локального dev-сервера.
|
||||
|
||||
## Інспекція та анотування
|
||||
|
||||
Увімкніть **inspect** і клікніть будь-який елемент на сторінці. OpenChamber перехоплює нотатку про нього — що це, його стилі, де він розташований, і знімок екрана — і прикріплює її до вашого повідомлення в чаті. Це найшвидший спосіб сказати агентові «ось цей елемент, прямо тут».
|
||||
|
||||
## Перехоплення консолі
|
||||
|
||||
Браузер збирає вивід консолі сторінки — помилки, попередження та логи — щоб ви могли фільтрувати й читати його, не відкриваючи інструменти розробника.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Перегляд і dev-сервери](/uk/preview/) — ті самі інструменти для вашого локального dev-сервера
|
||||
@@ -0,0 +1,30 @@
|
||||
---
|
||||
title: Git-ідентичності
|
||||
description: Комітьте від правильного імені та email для кожного репозиторію.
|
||||
---
|
||||
|
||||
# Git-ідентичності
|
||||
|
||||
Git-ідентичність — це ім'я та email, якими підписані ваші коміти. Якщо ви працюєте і з особистими, і з робочими репозиторіями, ви можете зберегти ідентичності й застосовувати правильну для кожного репозиторію, замість покладатися на єдине глобальне налаштування. Керуйте ними в **Settings → Git**.
|
||||
|
||||
## Додавання ідентичності
|
||||
|
||||
1. Відкрийте **Settings → Git** і виберіть **New**.
|
||||
2. Уведіть **name** та **email**, із якими комітити.
|
||||
3. Виберіть, як вона автентифікується з віддаленим репозиторієм:
|
||||
- **SSH** — спрямуйте її на SSH-ключ
|
||||
- **token** — використовуйте збережені облікові дані для хоста
|
||||
4. За бажанням дайте їй колір та іконку, щоб її було легко впізнати.
|
||||
|
||||
Глобальна ідентичність вашої системи теж показується, лише для читання.
|
||||
|
||||
## Застосування ідентичності до репозиторію
|
||||
|
||||
Застосування ідентичності записує її в **локальний** git-конфіг цього репозиторію — це впливає лише на цей репозиторій, не на ваше глобальне налаштування. SSH-ідентичності також задають SSH-команду для використання вашого ключа; token-ідентичності налаштовують збереження облікових даних для хоста.
|
||||
|
||||
Ви можете імпортувати ідентичності, які OpenChamber виявляє з ваших наявних git-облікових даних, і зберегти їх як token-ідентичності.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Робочі процеси Git і GitHub](/uk/git/) — комітьте з використанням заданої ідентичності
|
||||
- [GitHub Issues та PR](/uk/github/) — підключіть акаунт GitHub для PR
|
||||
@@ -0,0 +1,41 @@
|
||||
---
|
||||
title: Робочі процеси Git і GitHub
|
||||
description: Додавайте до staging, комітьте та керуйте гілками, не залишаючи OpenChamber.
|
||||
---
|
||||
|
||||
# Робочі процеси Git і GitHub
|
||||
|
||||
OpenChamber має вбудований вигляд git, тож ви можете переглядати зміни, комітити та керувати гілками, не перемикаючись на термінал. Відкрийте його на вкладці **Git** у правій бічній панелі.
|
||||
|
||||
## Перегляд і коміт
|
||||
|
||||
Вигляд git розділяє ваші зміни на **staged** та **unstaged**:
|
||||
|
||||
- клікніть **+** біля файлу, щоб додати його до staging, або **−**, щоб прибрати
|
||||
- додайте до staging або приберіть усе в групі за раз
|
||||
- клікніть файл, щоб побачити його diff
|
||||
|
||||
Потім напишіть повідомлення коміту й закомітьте. Ви можете доручити OpenChamber **згенерувати повідомлення коміту** з ваших staged-змін — він використовує модель поточної сесії, тож вам потрібна відкрита сесія.
|
||||
|
||||
## Гілки та історія
|
||||
|
||||
Вигляд git також охоплює щоденну рутину git:
|
||||
|
||||
- створення, перемикання, перейменування та видалення гілок
|
||||
- push, pull і fetch
|
||||
- перегляд історії та diff для кожного коміту
|
||||
- stash і відновлення змін
|
||||
|
||||
## Pull request'и
|
||||
|
||||
Підключіть GitHub (див. [GitHub Issues та PR](/uk/github/)), і вкладка **PR** дасть змогу відкрити pull request, оновити його, позначити готовим чи злити — і згенерувати його заголовок та опис так само, як повідомлення комітів.
|
||||
|
||||
## Внесення конфліктів
|
||||
|
||||
Якщо злиття, rebase чи integrate натрапляє на конфлікт, OpenChamber показує, що застрягло, і дає змогу розв'язати його — зокрема передати агентові.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [GitHub Issues та PR](/uk/github/) — підключіть GitHub і починайте роботу з issue
|
||||
- [Сесії worktree](/uk/worktrees/) — ізолюйте гілку у власній теці
|
||||
- [Git-ідентичності](/uk/git-identities/) — комітьте від правильної особи для кожного репозиторію
|
||||
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: GitHub Issues та PR
|
||||
description: Підключіть GitHub і починайте сесії з issue та pull request'ів.
|
||||
---
|
||||
|
||||
# GitHub Issues та PR
|
||||
|
||||
Підключіть свій акаунт GitHub, і OpenChamber зможе підтягувати issue та pull request'и, починати сесію прямо з одного з них і відкривати чи оновлювати PR за вас.
|
||||
|
||||
## Підключення GitHub
|
||||
|
||||
1. Відкрийте **Settings → Git**.
|
||||
2. Під GitHub виберіть **Connect**. OpenChamber покаже посилання й короткий код.
|
||||
3. Відкрийте посилання, уведіть код і підтвердьте.
|
||||
|
||||
Коли підключення виконано, ваш акаунт показується в розділі GitHub. Ви можете підключити більше одного акаунта й перемикатися між ними або відключитися будь-коли.
|
||||
|
||||
## Початок роботи з issue чи PR
|
||||
|
||||
Коли ви створюєте [сесію worktree](/uk/worktrees/) з підключеним GitHub, ви можете обрати **Start from GitHub issue/PR**:
|
||||
|
||||
- виберіть **issue**, і OpenChamber назве гілку на його честь і відкриє сесію з issue та його коментарями як першим повідомленням
|
||||
- виберіть **pull request**, і він викачає гілку PR; ви можете включити diff PR, щоб агент мав повну зміну
|
||||
|
||||
Це закидає вас прямо в сесію з уже завантаженим контекстом.
|
||||
|
||||
## Відкриття pull request'ів і керування ними
|
||||
|
||||
З вкладки **PR** у [вигляді git](/uk/git/) ви можете створити pull request, оновити його, позначити чернетку готовою чи злити її. OpenChamber може згенерувати заголовок та опис PR з ваших змін.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Робочі процеси Git і GitHub](/uk/git/) — комітьте та керуйте гілками
|
||||
- [Сесії worktree](/uk/worktrees/) — де починаються сесії з issue та PR
|
||||
@@ -20,6 +20,13 @@ OpenChamber — це візуальний робочий простір навк
|
||||
- [Тунелі](/uk/tunnels/)
|
||||
- [Усунення несправностей](/uk/troubleshooting/)
|
||||
|
||||
## Дослідіть
|
||||
|
||||
- [Проєкти](/uk/projects/) та [Сесії worktree](/uk/worktrees/) — організуйте та ізолюйте свою роботу
|
||||
- [Провайдери, моделі та агенти](/uk/providers/) — підключіть OpenCode та оберіть модель
|
||||
- [Робочі процеси Git і GitHub](/uk/git/) — комітьте, переглядайте та відкривайте PR
|
||||
- [Безпека](/uk/security/) та [Тунелі](/uk/tunnels/) — захистіть свій інстанс і отримайте до нього доступ
|
||||
|
||||
## Для чого OpenChamber
|
||||
|
||||
OpenChamber створений для тих частин AI-кодингу, яким потрібен командний центр: розгалуження сесій, перегляд діфів, керування терміналами, спостереження за прогресом інструментів, запуск дій проєкту та збереження всієї картини перед очима, поки агент працює.
|
||||
|
||||
@@ -0,0 +1,26 @@
|
||||
---
|
||||
title: Magic Prompts
|
||||
description: Налаштовуйте вбудовані промпти, що стоять за автоматизованими процесами OpenChamber.
|
||||
---
|
||||
|
||||
# Magic Prompts
|
||||
|
||||
OpenChamber використовує вбудовані промпти за лаштунками щоразу, коли робить щось автоматично, — пише повідомлення коміту, складає PR, переглядає issue, розв'язує конфлікт, підсумовує сесію. Magic Prompts — це місце, де ви читаєте й переписуєте ці промпти. Відкрийте їх у **Settings → Magic Prompts**.
|
||||
|
||||
Ця сторінка не потрібна для звичайного користування. Звертайтеся до неї, коли хочете, щоб процес поводився інакше, — скажімо, повідомлення комітів у певному стилі.
|
||||
|
||||
## Редагування промпту
|
||||
|
||||
1. Відкрийте **Settings → Magic Prompts**.
|
||||
2. Виберіть промпт із груп у бічній панелі — Git, GitHub, Planning та Session.
|
||||
3. Відредагуйте текст і збережіть.
|
||||
|
||||
Деякі промпти мають видиму частину (повідомлення, яке ви побачите) та частину з інструкціями (приховані вказівки для агента). Промпти можуть містити `{{placeholders}}`, які OpenChamber заповнює, як-от diff чи заголовок issue, — лишайте їх на місці.
|
||||
|
||||
## Скидання
|
||||
|
||||
Передумали? Кожен промпт має **reset to default**, а ще є **reset all**, якщо хочете почати спочатку всюди.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Робочі процеси Git і GitHub](/uk/git/) — багато з цих промптів живлять git-процеси
|
||||
@@ -0,0 +1,30 @@
|
||||
---
|
||||
title: MCP-сервери
|
||||
description: Додавайте MCP-сервери, щоб дати агентам додаткові інструменти.
|
||||
---
|
||||
|
||||
# MCP-сервери
|
||||
|
||||
MCP-сервер дає вашим агентам додаткові інструменти — як-от пошук у базі даних, виклик API чи читання сервісу, яким ви користуєтеся. Додавайте їх у **Settings → MCP**.
|
||||
|
||||
## Додавання сервера
|
||||
|
||||
1. Відкрийте **Settings → MCP**.
|
||||
2. Додайте сервер і виберіть його тип:
|
||||
- **local** — OpenChamber запускає команду на вашій машині. Ви вказуєте йому команду для запуску і, за потреби, змінні середовища.
|
||||
- **remote** — OpenChamber підключається до URL, який хостить хтось інший. Ви вказуєте йому URL і будь-які потрібні заголовки (наприклад, токен автентифікації).
|
||||
3. Збережіть. Сервер увімкнений за замовчуванням; ви можете вимкнути його, не видаляючи.
|
||||
|
||||
## Де він застосовується
|
||||
|
||||
Виберіть область при додаванні сервера:
|
||||
|
||||
- **personal** — доступний у кожному проєкті
|
||||
- **project** — доступний лише в поточному проєкті й зберігається разом з іншими налаштуваннями проєкту
|
||||
|
||||
Імена серверів використовують малі літери, цифри, дефіси та підкреслення.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Провайдери, моделі та агенти](/uk/providers/) — спершу підключіть модель
|
||||
- [Навички](/uk/skills/) — ще один спосіб розширити можливості агентів
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: PWA та мобільний доступ
|
||||
description: Установіть OpenChamber як застосунок і користуйтеся ним із телефона.
|
||||
---
|
||||
|
||||
# PWA та мобільний доступ
|
||||
|
||||
Вебзастосунок OpenChamber встановлюється як застосунок для телефона (PWA), тож ви можете тримати його на головному екрані й користуватися ним на весь екран. Поєднайте його з [тунелем](/uk/tunnels/), і ви зможете перевіряти сесію звідусіль.
|
||||
|
||||
## Установлення
|
||||
|
||||
OpenChamber використовує вбудоване встановлення вашого браузера, тож окремого завантаження немає:
|
||||
|
||||
- **десктопний браузер** — скористайтеся опцією **Install** в адресному рядку
|
||||
- **iPhone/iPad (Safari)** — Поділитися → **Додати на початковий екран**
|
||||
- **Android (Chrome)** — меню → **Встановити застосунок** / **Додати на головний екран**
|
||||
|
||||
Після встановлення він відкривається у власному вікні без елементів браузера.
|
||||
|
||||
## Доступ із телефона
|
||||
|
||||
Щоб відкрити OpenChamber на телефоні, коли сервер працює на вашому комп'ютері, запустіть [тунель](/uk/tunnels/) і відкрийте посилання (або відскануйте QR-код) на телефоні. Використовуйте надійний [пароль UI](/uk/security/) щоразу, коли це робите.
|
||||
|
||||
## Мобільні налаштування
|
||||
|
||||
Під **Settings → OpenChamber** кілька опцій налаштовують мобільний і встановлений досвід — встановлену назву застосунку, орієнтацію екрана та поведінку екранної клавіатури.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Тунелі](/uk/tunnels/) — дістаньтеся до свого інстансу з іншої мережі
|
||||
- [Безпека](/uk/security/) — захистіть UI перед тим, як відкривати доступ
|
||||
@@ -0,0 +1,32 @@
|
||||
---
|
||||
title: Multi-run
|
||||
description: Запускайте той самий промпт у кількох моделях чи сесіях одночасно.
|
||||
---
|
||||
|
||||
# Multi-run
|
||||
|
||||
Multi-run запускає кілька сесій з однієї форми — зручно, щоб спробувати те саме завдання з різними моделями й порівняти результати. Відкрийте його з кнопки вгорі бічної панелі сесій.
|
||||
|
||||
## Запуск multi-run
|
||||
|
||||
1. Відкрийте лаунчер multi-run.
|
||||
2. Виберіть проєкт і назвіть групу запусків.
|
||||
3. Напишіть промпт і виберіть моделі, із якими його запустити (до п'яти на групу).
|
||||
4. Виберіть, чи **ізолювати запуски**.
|
||||
5. Запустіть.
|
||||
|
||||
Кожна модель отримує власну сесію, і всі вони починаються з вашого промпту.
|
||||
|
||||
## Ізольовані запуски
|
||||
|
||||
Увімкніть **isolate runs**, щоб дати кожному запуску власний [worktree](/uk/worktrees/) і гілку, щоб вони ніколи не торкалися тих самих файлів. Для цього потрібен git-репозиторій — для тек, які ним не є, це вимикається автоматично. Виберіть гілку, від якої починаються запуски.
|
||||
|
||||
З вимкненою ізоляцією кожен запуск — це звичайна сесія в теці проєкту.
|
||||
|
||||
## Порівняння результатів
|
||||
|
||||
Кожен запуск — це звичайна сесія, яку ви можете відкрити, прочитати й зберегти чи відкинути. Якщо ви запустили їх, щоб порівняти підходи, переглядайте їх поруч і несіть найкращий далі.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Сесії worktree](/uk/worktrees/) — як ізоляція працює під капотом
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: Нотатки, завдання та плани проєкту
|
||||
description: Зберігайте нотатки, список завдань і збережені плани для кожного проєкту.
|
||||
---
|
||||
|
||||
# Нотатки, завдання та плани проєкту
|
||||
|
||||
Кожен проєкт має власний робочий простір для нотаток, списку завдань і збережених планів. Вони належать проєкту, а не якійсь окремій сесії, тож зберігаються, коли ви переходите між сесіями. Знайдіть їх на вкладці **Context** у правій бічній панелі (окрема вкладка на мобільному).
|
||||
|
||||
## Нотатки
|
||||
|
||||
Поле для довільних нотаток про все, що ви хочете запам'ятати про проєкт. Воно зберігається саме в міру набирання.
|
||||
|
||||
## Завдання
|
||||
|
||||
Простий чеклист. Додавайте пункти, відмічайте виконані, переставляйте їх перетягуванням і очищайте завершені.
|
||||
|
||||
Кожне завдання має меню **send**, щоб ви могли передати його агентові:
|
||||
|
||||
- надіслати в поточну сесію
|
||||
- почати з ним нову сесію
|
||||
- почати з ним нову [сесію worktree](/uk/worktrees/) (лише коли проєкт є git-репозиторієм)
|
||||
|
||||
## Плани
|
||||
|
||||
Місце, щоб тримати довші плани як збережені файли. Ви можете:
|
||||
|
||||
- імпортувати план із файлу Markdown чи тексту
|
||||
- відкрити план, щоб прочитати його в бічній панелі
|
||||
- видаляти плани, які вам більше не потрібні
|
||||
|
||||
Ви маєте повернутися на вкладку Context зі збереженою нотаткою, відміченим завданням або переліченим планом — так ви розумієте, що все спрацювало.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Сесії worktree](/uk/worktrees/) — запускайте завдання у власній гілці
|
||||
- [Проєкти](/uk/projects/) — це належить активному проєкту
|
||||
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: Сповіщення
|
||||
description: Дізнавайтеся, коли сесія потребує вас або завершується.
|
||||
---
|
||||
|
||||
# Сповіщення
|
||||
|
||||
Сповіщення повідомляють, коли щось потребує вашої уваги, щоб вам не доводилося стежити за екраном, — сесія завершилася, натрапила на помилку, поставила питання чи потребує дозволу щось зробити. Налаштуйте їх у **Settings → OpenChamber → Notifications**.
|
||||
|
||||
## Увімкнення
|
||||
|
||||
1. Відкрийте **Settings → OpenChamber → Notifications**.
|
||||
2. Дозвольте сповіщення, коли ваш браузер чи система про це запитає.
|
||||
3. Виберіть, про що ви хочете дізнаватися:
|
||||
- сесія **завершується**
|
||||
- сесія натрапляє на **помилку**
|
||||
- сесія **ставить питання**
|
||||
- сесія потребує **дозволу**
|
||||
- **підзавдання** завершуються
|
||||
|
||||
## Як вони до вас доходять
|
||||
|
||||
- на **десктопі** ви отримуєте нативні системні сповіщення
|
||||
- у **браузері чи встановленому застосунку** ви отримуєте веб-push-сповіщення, тож вони приходять навіть коли вкладка у фоні
|
||||
|
||||
Сесії, налаштовані на автоприйняття, не докучатимуть вам сповіщеннями про дозволи.
|
||||
|
||||
## Налаштування формулювань
|
||||
|
||||
Кожен вид сповіщення має шаблон заголовка й повідомлення, який ви можете редагувати, використовуючи поля на кшталт імені агента та моделі. Також є обмеження на те, скільки з останнього повідомлення включається, щоб сповіщення лишалися короткими.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Голосовий режим](/uk/voice/) — натомість слухайте відповіді, зачитані вголос
|
||||
@@ -0,0 +1,54 @@
|
||||
---
|
||||
title: OpenCode Server
|
||||
description: Підключіть OpenChamber до локального або віддаленого сервера OpenCode.
|
||||
---
|
||||
|
||||
# OpenCode Server
|
||||
|
||||
OpenChamber працює поверх сервера OpenCode. За замовчуванням він сам запускає такий сервер, тож вам нічого робити не доводиться. Ця сторінка потрібна лише тоді, коли ви хочете спрямувати OpenChamber на сервер, який ви вже запускаєте, або керувати тим, що він запускає.
|
||||
|
||||
## Як OpenChamber знаходить сервер
|
||||
|
||||
Коли OpenChamber стартує, він шукає сервер у такому порядку:
|
||||
|
||||
1. повторно використовує сервер, який уже запустив
|
||||
2. підключається до зовнішнього, якщо ви це налаштували (див. нижче)
|
||||
3. автоматично виявляє сервер на стандартному порту (`4096`)
|
||||
4. інакше — запускає й керує власним
|
||||
|
||||
Якщо нічого не налаштовано, крок 4 відбувається автоматично, і все працює.
|
||||
|
||||
## Підключення до сервера, який ви вже запускаєте
|
||||
|
||||
Задайте це перед запуском OpenChamber:
|
||||
|
||||
```bash
|
||||
OPENCODE_HOST=http://localhost:4096 OPENCODE_SKIP_START=true openchamber
|
||||
```
|
||||
|
||||
- `OPENCODE_HOST` — повна адреса вашого сервера OpenCode, разом із портом (значення на кшталт `http://localhost:4096`). У кінці не повинно бути шляху.
|
||||
- `OPENCODE_SKIP_START=true` — каже OpenChamber не запускати власний сервер.
|
||||
|
||||
Якщо вам потрібно лише змінити порт, задайте `OPENCODE_PORT` замість `OPENCODE_HOST`.
|
||||
|
||||
Якщо в `OPENCODE_HOST` бракує порту або є шлях, OpenChamber ігнорує його й повертається до запуску власного сервера. Слідкуйте за журналами запуску на предмет попередження `[config]`, якщо очікуване підключення не відбулося.
|
||||
|
||||
## Керування сервером із CLI
|
||||
|
||||
```bash
|
||||
openchamber status
|
||||
openchamber logs
|
||||
openchamber restart
|
||||
openchamber stop
|
||||
```
|
||||
|
||||
`openchamber` сам по собі запускає сервер у фоні. Додайте `--foreground`, щоб лишити його прив'язаним до вашого терміналу.
|
||||
|
||||
## «OpenCode перезапускається»
|
||||
|
||||
Поки сервер запускається або перезапускається, OpenChamber показує стан «OpenCode перезапускається» і призупиняє запити, доки той не буде готовий. Це нормально одразу після запуску чи перезапуску. Якщо стан так і не зникає, див. [Підключення до OpenCode](/uk/troubleshooting/opencode-connection/).
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Провайдери, моделі та агенти](/uk/providers/) — налаштуйте, із чим спілкується сервер
|
||||
- [Підключення до OpenCode](/uk/troubleshooting/opencode-connection/) — якщо не вдається підключитися
|
||||
@@ -0,0 +1,32 @@
|
||||
---
|
||||
title: Перегляд і dev-сервери
|
||||
description: Відкрийте запущений dev-сервер усередині OpenChamber.
|
||||
---
|
||||
|
||||
# Перегляд і dev-сервери
|
||||
|
||||
Коли ви запускаєте dev-сервер, OpenChamber може відкрити його просто всередині застосунку замість окремої вкладки браузера — щоб ви могли бачити свій сайт поруч із чатом, перехоплювати його консоль і вказувати на елементи, щоб запитати про них.
|
||||
|
||||
## Відкриття перегляду
|
||||
|
||||
OpenChamber слідкує за виводом терміналу на предмет локальної адреси (рядок `Local:`, який друкують інструменти на кшталт Vite, Next.js чи Astro). Коли він її помічає:
|
||||
|
||||
- у терміналі з'являється кнопка **Open preview**
|
||||
- [дія проєкту](/uk/project-actions/) з увімкненим автовідкриттям відкриває її за вас
|
||||
- локальне посилання в повідомленні чату теж може її відкрити
|
||||
|
||||
Сайт завантажується в бічній панелі. Переглянути можна лише локальні адреси (на вашій власній машині).
|
||||
|
||||
## Консоль та інспекція
|
||||
|
||||
У панелі перегляду ви можете:
|
||||
|
||||
- спостерігати за **консоллю** сторінки — помилки, попередження та логи, відфільтровані як вам зручно
|
||||
- увімкнути **inspect**, клікнути будь-який елемент і надіслати нотатку про нього — селектор, стилі, позицію та знімок екрана — прямо в чат
|
||||
|
||||
Це найшвидший спосіб сказати агентові «ось ця кнопка, тут», не описуючи її.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Дії проєкту](/uk/project-actions/) — автоматично відкривайте сервер при запуску
|
||||
- [Десктопний браузер](/uk/desktop-browser/) — ті самі інструменти для будь-якої сторінки на десктопі
|
||||
@@ -0,0 +1,28 @@
|
||||
---
|
||||
title: Дії проєкту
|
||||
description: Зберігайте команди, які часто запускаєте, і запускайте їх одним кліком.
|
||||
---
|
||||
|
||||
# Дії проєкту
|
||||
|
||||
Дія проєкту — це shell-команда, яку ви зберігаєте один раз і запускаєте кліком: ваш dev-сервер, збірка, прогін тестів. Кожен проєкт має власний список. Налаштуйте їх у **Settings → Projects → Project Actions**.
|
||||
|
||||
## Додавання дії
|
||||
|
||||
1. Відкрийте **Settings → Projects** і знайдіть розділ **Project Actions**.
|
||||
2. Додайте дію, дайте їй назву, виберіть іконку й уведіть команду для запуску.
|
||||
3. Збережіть.
|
||||
|
||||
Ви можете обмежити дію певними операційними системами, якщо команда має сенс лише на одній.
|
||||
|
||||
## Запуск дії
|
||||
|
||||
Дії живуть у меню в заголовку застосунку. Клікніть одну, і OpenChamber запустить її в терміналі у вашій теці проєкту, перемкнувши вас на вигляд терміналу, щоб ви могли спостерігати за виводом. Зупиніть її з того самого меню.
|
||||
|
||||
## Автовідкриття dev-сервера
|
||||
|
||||
Увімкніть **auto-open URL** для дії, що запускає сервер. OpenChamber слідкує за виводом на предмет локальної адреси й пропонує відкрити її — див. [Перегляд і dev-сервери](/uk/preview/). На десктопі ви також можете спрямувати її через SSH-перенаправлення порту.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Перегляд і dev-сервери](/uk/preview/) — відкрийте запущений dev-сервер усередині OpenChamber
|
||||
@@ -0,0 +1,20 @@
|
||||
---
|
||||
title: Іконки проєктів
|
||||
description: Дайте кожному проєкту впізнавану іконку.
|
||||
---
|
||||
|
||||
# Іконки проєктів
|
||||
|
||||
Іконка проєкту допомагає легко відрізняти ваші проєкти з першого погляду. OpenChamber намагається знайти її за вас, а ви завжди можете задати власну. Керуйте нею в **Settings → Projects**.
|
||||
|
||||
## Автоматичне виявлення
|
||||
|
||||
Коли ви додаєте проєкт, OpenChamber шукає файл `favicon` усередині нього й використовує його як іконку проєкту. Якщо ваш репозиторій уже постачається з favicon, іконка зазвичай просто з'являється — нічого робити не треба.
|
||||
|
||||
## Задати власну
|
||||
|
||||
Відкрийте **Settings → Projects** і завантажте зображення (PNG, JPEG чи SVG, до 5 МБ). Власне зображення має пріоритет над автоматично виявленим. Ви також можете натомість вибрати колір або прибрати зображення, щоб повернутися до виявлення.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Проєкти](/uk/projects/) — називайте, додавайте кольори та організовуйте свої проєкти
|
||||
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: Проєкти
|
||||
description: Організуйте роботу в проєкти та перемикайтеся між ними.
|
||||
---
|
||||
|
||||
# Проєкти
|
||||
|
||||
Проєкт — це тека на вашому комп'ютері, яку відстежує OpenChamber, зазвичай одна кодова база. Перемикання проєктів змінює теку, у якій працює агент, разом із сесіями та налаштуваннями цього проєкту.
|
||||
|
||||
## Додавання проєкту
|
||||
|
||||
Додати проєкт можна з кількох місць:
|
||||
|
||||
- пункт **Add project** у палітрі команд
|
||||
- кнопка **+** угорі бічної панелі сесій
|
||||
- оглядач тек, коли ви обираєте каталог
|
||||
|
||||
Вкажіть йому теку, і OpenChamber запам'ятає її. Назва походить від теки; ви можете змінити її пізніше.
|
||||
|
||||
## Перемикання проєктів
|
||||
|
||||
Виберіть проєкт на бічній панелі, щоб зробити його активним. Усе — сесії, git, нотатки — слідує за відкритим проєктом.
|
||||
|
||||
## Зробіть проєкт упізнаваним
|
||||
|
||||
Відкрийте **Settings → Projects**, щоб дати проєкту власну назву, колір чи іконку. OpenChamber намагається знайти іконку автоматично — див. [Іконки проєктів](/uk/project-icons/).
|
||||
|
||||
> У VS Code OpenChamber завжди використовує відкриту теку як єдиний проєкт, тож додавати чи перемикати нічого не потрібно. Сторінка налаштувань Projects там прихована.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Нотатки, завдання та плани проєкту](/uk/notes-todos-plans/) — тримайте робочі нотатки для кожного проєкту
|
||||
- [Дії проєкту](/uk/project-actions/) — зберігайте команди, які часто запускаєте
|
||||
- [Контекст](/uk/context/) — дивіться, скільки пам'яті моделі використовує сесія
|
||||
@@ -0,0 +1,49 @@
|
||||
---
|
||||
title: Провайдери, моделі та агенти
|
||||
description: Підключайте AI-провайдерів, обирайте моделі та налаштовуйте агентів.
|
||||
---
|
||||
|
||||
# Провайдери, моделі та агенти
|
||||
|
||||
Перш ніж OpenChamber зможе щось робити, до нього треба підключити щонайменше одного AI-провайдера. Ця сторінка охоплює підключення провайдера, вибір моделі та налаштування агентів.
|
||||
|
||||
## Підключення провайдера
|
||||
|
||||
1. Відкрийте **Settings → Providers**.
|
||||
2. Відкрийте меню **Add provider** й оберіть провайдера, який ще не підключений.
|
||||
3. Увійдіть одним із двох способів, залежно від провайдера:
|
||||
- **API key** — вставте свій ключ і збережіть.
|
||||
- **Sign-in (device flow)** — OpenChamber показує посилання й короткий код. Відкрийте посилання, введіть код і підтвердьте. OpenChamber завершить підключення самостійно.
|
||||
|
||||
Коли провайдер показано як підключений, його моделі стають доступними в чаті.
|
||||
|
||||
Щоб відключити, відкрийте провайдера й виберіть видалення його входу.
|
||||
|
||||
## Вибір моделі
|
||||
|
||||
Модель ви обираєте там, де працюєте:
|
||||
|
||||
- у чаті використовуйте перемикач моделей у рядку повідомлення, щоб задати провайдера й модель для цієї сесії
|
||||
- для кожного агента задайте модель за замовчуванням (нижче)
|
||||
|
||||
## Налаштування агентів
|
||||
|
||||
Агент — це іменоване налаштування: модель, характер та те, що йому дозволено робити.
|
||||
|
||||
1. Відкрийте **Settings → Agents**.
|
||||
2. Оберіть агента або створіть нового.
|
||||
3. Відредагуйте будь-що з:
|
||||
- **description** — для чого призначений агент
|
||||
- **model** — його модель за замовчуванням
|
||||
- **temperature** — наскільки креативними є його відповіді
|
||||
- **prompt** — постійні інструкції, яких він завжди дотримується
|
||||
- **tool rules** — якими інструментами він може користуватися
|
||||
|
||||
## Де зберігаються ваші входи
|
||||
|
||||
Входи провайдерів зберігає OpenCode, а не OpenChamber, тож вони спільні з CLI OpenCode. Якщо ви задаєте одного провайдера в кількох місцях, перемагає найбільш специфічне налаштування: налаштування для проєкту має пріоритет над вашим персональним.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [MCP Servers](/uk/mcp/) — додайте агентам додаткові інструменти
|
||||
- [Використання та квоти](/uk/usage/) — відстежуйте, скільки ви витратили
|
||||
@@ -0,0 +1,30 @@
|
||||
---
|
||||
title: Віддалені інстанси
|
||||
description: Підключайте десктопний застосунок до OpenChamber на іншій машині через SSH.
|
||||
---
|
||||
|
||||
# Віддалені інстанси
|
||||
|
||||
Десктопний застосунок може підключатися до OpenChamber, запущеного на іншій машині, через SSH — робочий сервер, хмарну машину, домашню лабораторію — і виводити її UI на ваш екран так, ніби він локальний. Налаштуйте це в **Settings → Remote Instances**.
|
||||
|
||||
> Віддалені інстанси — це функція **лише для десктопа**. У вебі чи у VS Code підключайтеся до віддаленого сервера за допомогою змінних середовища з [OpenCode Server](/uk/opencode-server/).
|
||||
|
||||
## Додавання віддаленого інстансу
|
||||
|
||||
1. Відкрийте **Settings → Remote Instances** і додайте один.
|
||||
2. Задайте йому SSH-команду, яку ви зазвичай використовуєте, щоб дістатися машини, плюс псевдонім.
|
||||
3. Виберіть, як OpenChamber запускається там:
|
||||
- **managed** — OpenChamber установлює й запускає себе на віддаленій машині
|
||||
- **external** — підключитися до того, що вже запущений
|
||||
4. Підключіться.
|
||||
|
||||
OpenChamber проходить через кроки — перевірку з'єднання, налаштування віддаленої машини, запуск сервера й перенаправлення порту — і показує, на якому етапі він на кожній стадії. Коли він досягає **ready**, віддалений UI завантажується локально.
|
||||
|
||||
## Облікові дані
|
||||
|
||||
Ви вирішуєте, чи зберігати SSH- та UI-паролі, чи вводити їх щоразу. Якщо з'єднання обривається, OpenChamber повідомляє, який крок збоїв, щоб ви могли виправити — див. [Віддалений доступ](/uk/troubleshooting/remote-access/).
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [OpenCode Server](/uk/opencode-server/) — підключайтеся до віддаленого сервера у вебі чи VS Code
|
||||
- [Віддалений доступ](/uk/troubleshooting/remote-access/) — коли з'єднання не завершується
|
||||
@@ -0,0 +1,33 @@
|
||||
---
|
||||
title: Заплановані завдання
|
||||
description: Запускайте промпт автоматично за розкладом.
|
||||
---
|
||||
|
||||
# Заплановані завдання
|
||||
|
||||
Заплановане завдання запускає промпт за вас за розкладом — наприклад, щоденне «підсумуй вчорашні зміни» чи щотижневе прибирання. Коли воно спрацьовує, OpenChamber починає нову сесію й надсилає промпт самостійно. Відкрийте планувальник із кнопки вгорі бічної панелі сесій.
|
||||
|
||||
## Створення завдання
|
||||
|
||||
1. Відкрийте діалог запланованих завдань із бічної панелі сесій.
|
||||
2. Додайте завдання й дайте йому назву.
|
||||
3. Виберіть, коли воно запускається:
|
||||
- **daily** — в один або кілька моментів щодня
|
||||
- **weekly** — у вибрані дні тижня та час
|
||||
- **once** — одна дата й час
|
||||
4. Задайте, що воно робить: промпт для надсилання, а також провайдера, модель і агента для використання. Промпт може бути слеш-командою, як-от `/review`.
|
||||
5. Збережіть і переконайтеся, що завдання ввімкнене.
|
||||
|
||||
Ви можете запустити будь-яке завдання негайно через **run now**, щоб перевірити, що воно робить те, що ви очікуєте.
|
||||
|
||||
## Як виглядає успіх
|
||||
|
||||
Після запуску завдання показує, коли воно востаннє виконувалося, чи воно успішне, і посилання на сесію, яку воно створило. Якщо запуск збоїть, помилка теж показується там.
|
||||
|
||||
## Майте на увазі
|
||||
|
||||
Завдання спрацьовують лише поки запущений сервер OpenChamber. Якщо ви його закриєте, заплановані запуски призупиняються, доки він не повернеться.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Команди та сніпети](/uk/commands-snippets/) — повторно використовуйте слеш-команду як промпт
|
||||
@@ -0,0 +1,37 @@
|
||||
---
|
||||
title: Безпека
|
||||
description: Захистіть UI паролем і ключами доступу перед тим, як відкривати його.
|
||||
---
|
||||
|
||||
# Безпека
|
||||
|
||||
OpenChamber дає доступ до вашої машини та вашого коду, тож заблокуйте його, перш ніж до нього зможе дістатися хтось, окрім вас. Ця сторінка охоплює пароль UI, ключі доступу (passkeys) і те, що треба знати перед тим, як відкривати OpenChamber у мережі.
|
||||
|
||||
## Установлення пароля UI
|
||||
|
||||
Запустіть OpenChamber із паролем, і браузерний UI запитуватиме його:
|
||||
|
||||
```bash
|
||||
openchamber --ui-password be-creative-here
|
||||
```
|
||||
|
||||
Ви також можете задати його через змінну середовища `OPENCHAMBER_UI_PASSWORD` замість того, щоб писати його в командному рядку. Після входу OpenChamber на деякий час запам'ятовує пристрій, тож вас не питатимуть щоразу.
|
||||
|
||||
Завжди задавайте пароль, якщо інстанс доступний комусь іще — особливо через [тунель](/uk/tunnels/) чи публічний інтернет.
|
||||
|
||||
## Ключі доступу (passkeys)
|
||||
|
||||
Щойно задано пароль, ви можете додати ключі доступу (Face ID, Touch ID, апаратний ключ безпеки) для швидшого входу. Додайте їх у **Settings → OpenChamber → Passkeys**.
|
||||
|
||||
Ключі доступу прив'язані до поточного пароля. Якщо ви зміните чи приберете пароль, збережені ключі доступу очищаються, і вам доведеться додати їх знову.
|
||||
|
||||
## Перш ніж відкривати доступ
|
||||
|
||||
- За замовчуванням OpenChamber слухає лише вашу власну машину (`127.0.0.1`). Щоб слухати ширше, потрібна свідома зміна, і спершу вам слід задати пароль.
|
||||
- Надавайте перевагу [тунелю](/uk/tunnels/) чи приватній мережі (як-от VPN) перед відкриттям порту в інтернет.
|
||||
- Якщо ви ставите OpenChamber за власним HTTPS-сервером, див. [Зворотний проксі](/uk/reverse-proxy/).
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Тунелі](/uk/tunnels/) — рекомендований спосіб дістатися до інстансу віддалено
|
||||
- [Зворотний проксі](/uk/reverse-proxy/) — запускайте OpenChamber за власним сервером
|
||||
@@ -0,0 +1,27 @@
|
||||
---
|
||||
title: Каталог навичок
|
||||
description: Переглядайте та встановлюйте готові навички.
|
||||
---
|
||||
|
||||
# Каталог навичок
|
||||
|
||||
Каталог навичок дає змогу встановлювати навички, які опублікували інші люди, замість писати власні. Відкрийте його в **Settings → Skills → Catalog**.
|
||||
|
||||
Про написання власних навичок див. [Навички](/uk/skills/).
|
||||
|
||||
## Встановлення навички
|
||||
|
||||
1. Відкрийте каталог.
|
||||
2. Перегляньте вбудовані джерела — репозиторій навичок Anthropic та спільнотний реєстр ClawdHub — або скористайтеся пошуком.
|
||||
3. Оберіть навичку й установіть її.
|
||||
4. Виберіть, куди встановити: для всього, що ви робите, чи лише для поточного проєкту.
|
||||
|
||||
Якщо навичка з такою назвою вже існує, OpenChamber запитає, що робити, — пропустити її, перезаписати чи вирішувати для кожної навички окремо.
|
||||
|
||||
## Додавання власного джерела
|
||||
|
||||
Ви можете додати будь-який Git-репозиторій як джерело, використовуючи його ім'я `owner/repo` або повний Git-URL. Приватним репозиторіям потрібен налаштований доступ на вашій машині (SSH-ключ або збережені облікові дані); якщо джерело не може автентифікуватися, каталог повідомляє про це, а не мовчки збоїть.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Навички](/uk/skills/) — створюйте та керуйте встановленими навичками
|
||||
@@ -0,0 +1,30 @@
|
||||
---
|
||||
title: Навички
|
||||
description: Створюйте багаторазові інструкції, які агенти завантажують за потреби.
|
||||
---
|
||||
|
||||
# Навички
|
||||
|
||||
Навичка — це багаторазовий набір інструкцій, який агент може підтягнути, коли він доречний, — наприклад, «як ми пишемо повідомлення комітів» або «наші конвенції API». Керуйте ними в **Settings → Skills**.
|
||||
|
||||
Щоб установити готові навички замість писати власні, див. [Каталог навичок](/uk/skills-catalog/).
|
||||
|
||||
## Створення навички
|
||||
|
||||
1. Відкрийте **Settings → Skills**.
|
||||
2. Створіть навичку й дайте їй назву та короткий опис. За описом агент вирішує, коли навичка застосовна, тож робіть його конкретним.
|
||||
3. Напишіть інструкції. Додайте допоміжні файли, якщо навичка їх потребує.
|
||||
4. Виберіть, де вона зберігається:
|
||||
- **personal** — доступна в кожному проєкті
|
||||
- **project** — доступна лише в поточному проєкті
|
||||
|
||||
## Використання навички в чаті
|
||||
|
||||
Введіть `/` посередині повідомлення, щоб викликати перемикач навичок, потім оберіть одну. Агент завантажить інструкції цієї навички для відповіді.
|
||||
|
||||
`/` на самому початку повідомлення натомість відкриває [команди](/uk/commands-snippets/).
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Каталог навичок](/uk/skills-catalog/) — установлюйте навички, які опублікували інші
|
||||
- [Команди та сніпети](/uk/commands-snippets/) — інші способи повторно використовувати текст у чаті
|
||||
@@ -0,0 +1,34 @@
|
||||
---
|
||||
title: Підключення до OpenCode
|
||||
description: Виправте проблему, коли OpenChamber не підключається до свого сервера OpenCode.
|
||||
---
|
||||
|
||||
# Підключення до OpenCode
|
||||
|
||||
Якщо OpenChamber завантажується, але ніяк не виходить за межі стану «OpenCode перезапускається», або чат не відповідає, сервер, із яким він спілкується, недоступний. Пройдіться по цьому.
|
||||
|
||||
## Він застряг на «OpenCode перезапускається»
|
||||
|
||||
- дайте йому хвилину одразу після запуску — цей стан нормальний, поки сервер стартує
|
||||
- перевірте, чи сервер живий, командою `openchamber status`
|
||||
- перезапустіть його командою `openchamber restart`
|
||||
- перегляньте деталі запуску командою `openchamber logs`
|
||||
|
||||
## Ви підключаєтеся до власного сервера
|
||||
|
||||
Якщо ви налаштували OpenChamber на використання наявного сервера, ще раз перевірте налаштування з [OpenCode Server](/uk/opencode-server/):
|
||||
|
||||
- `OPENCODE_HOST` має містити порт, без шляху — наприклад, `http://localhost:4096`
|
||||
- задайте `OPENCODE_SKIP_START=true`, щоб OpenChamber не запускав ще й свій
|
||||
- якщо адреса недійсна, OpenChamber ігнорує її й натомість запускає власний сервер — шукайте попередження `[config]` у журналах
|
||||
|
||||
## Усе ще не працює
|
||||
|
||||
- переконайтеся, що версія Node.js — `20` або новіша
|
||||
- перевстановіть найновіший CLI
|
||||
- відкрийте `http://localhost:3000` напряму, перш ніж тестувати будь-який тунель чи віддалене посилання
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [OpenCode Server](/uk/opencode-server/) — як OpenChamber знаходить сервер і керує ним
|
||||
- [Усунення несправностей](/uk/troubleshooting/) — інші поширені проблеми
|
||||
@@ -0,0 +1,38 @@
|
||||
---
|
||||
title: Віддалений доступ
|
||||
description: Виправляйте тунелі, віддалені інстанси та доступ до OpenChamber з іншого пристрою.
|
||||
---
|
||||
|
||||
# Віддалений доступ
|
||||
|
||||
Коли ви не можете дістатися OpenChamber із телефона чи іншої машини, виправлення залежить від того, як ви підключаєтеся.
|
||||
|
||||
## Спершу перевірте базове
|
||||
|
||||
- відкрийте `http://localhost:3000` спочатку на тому самому комп'ютері — якщо це не вдається, то проблема не у віддаленому доступі; див. [Підключення до OpenCode](/uk/troubleshooting/opencode-connection/)
|
||||
- переконайтеся, що сервер запущений, командою `openchamber status`
|
||||
|
||||
## Посилання тунелю не працює
|
||||
|
||||
- виконайте `openchamber tunnel status --all`
|
||||
- перезапустіть тунель з того самого інстансу й порту
|
||||
- перегенеруйте посилання для підключення, якщо попереднє вже було використане
|
||||
|
||||
Повне налаштування див. у [Тунелях](/uk/tunnels/).
|
||||
|
||||
## Віддалений інстанс не підключається (десктоп)
|
||||
|
||||
Коли [віддалений інстанс](/uk/remote-instances/) застрягає, OpenChamber називає крок, який збоїв:
|
||||
|
||||
- **auth** — ваш SSH- чи UI-пароль було відхилено; уведіть його повторно
|
||||
- **install / start** — OpenChamber не зміг налаштувати чи запустити сервер на віддаленій машині; перевірте вимоги тієї машини
|
||||
- **forwarding** — з'єднання встановлено, але порт не доходить до вас; спробуйте інший локальний порт
|
||||
|
||||
## За власним сервером
|
||||
|
||||
Якщо ви поставили OpenChamber за зворотним проксі, і він завантажується дивно чи не підключається, див. [Зворотний проксі](/uk/reverse-proxy/).
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Тунелі](/uk/tunnels/) · [Віддалені інстанси](/uk/remote-instances/) · [Зворотний проксі](/uk/reverse-proxy/)
|
||||
- [Безпека](/uk/security/) — захистіть UI перед тим, як відкривати доступ
|
||||
@@ -0,0 +1,35 @@
|
||||
---
|
||||
title: Worktree та Git
|
||||
description: Виправляйте поширені проблеми з worktree та git.
|
||||
---
|
||||
|
||||
# Worktree та Git
|
||||
|
||||
Проблеми, що виникають із [сесіями worktree](/uk/worktrees/) та [виглядом git](/uk/git/), і як їх усунути.
|
||||
|
||||
## Worktree потребує уваги
|
||||
|
||||
OpenChamber позначає worktree, коли щось не так:
|
||||
|
||||
- **folder missing** — теку worktree видалено чи переміщено поза OpenChamber; приберіть сесію й створіть свіжий worktree
|
||||
- **detached or unborn branch** — worktree не на звичайній гілці; викачайте його на одну
|
||||
- **merge, rebase, or cherry-pick in progress** — операцію лишили наполовину завершеною; завершіть або скасуйте її з вигляду git
|
||||
|
||||
## Не вдається створити worktree
|
||||
|
||||
- **branch already exists** — виберіть іншу назву гілки або скористайтеся опцією наявної гілки
|
||||
- **name already in use** — виберіть іншу назву worktree
|
||||
|
||||
## Генерація коміту чи PR збоїть
|
||||
|
||||
Генерація повідомлення коміту чи опису PR відбувається у вашій активній сесії, тож вам потрібна відкрита сесія з вибраною робочою моделлю. Відкрийте чи виберіть сесію й спробуйте знову.
|
||||
|
||||
## Проблеми зі шляхами SSH чи Windows
|
||||
|
||||
- переконайтеся, що SSH-ключ, який використовує репозиторій, — це той, що заданий у вашій [git-ідентичності](/uk/git-identities/)
|
||||
- у Windows git використовує шляхи в стилі Unix (як-от `/c/Users/...`) — OpenChamber це обробляє, але власні шляхи до SSH-ключів мають дотримуватися тієї самої форми
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Сесії worktree](/uk/worktrees/) — як worktree створюються та видаляються
|
||||
- [Git-ідентичності](/uk/git-identities/) — задайте правильний ключ та ідентичність для кожного репозиторію
|
||||
@@ -80,4 +80,6 @@ openchamber tunnel stop --port 3000
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Безпека](/uk/security/) — захистіть інтерфейс перед відкриттям доступу
|
||||
- [PWA та мобільний доступ](/uk/mobile/) — відкривайте OpenChamber з телефона
|
||||
- [Усунення несправностей](/uk/troubleshooting/) — якщо посилання тунелю не працює
|
||||
|
||||
@@ -0,0 +1,31 @@
|
||||
---
|
||||
title: Оновлення
|
||||
description: Тримайте OpenChamber оновленим на десктопі, у вебі та VS Code.
|
||||
---
|
||||
|
||||
# Оновлення
|
||||
|
||||
Те, як ви оновлюєте OpenChamber, залежить від того, як ви його встановили. У будь-якому разі ви можете перевірити свою поточну версію в **Settings → OpenChamber → About**.
|
||||
|
||||
## Десктопний застосунок
|
||||
|
||||
Десктопний застосунок перевіряє наявність оновлень у релізах GitHub. Коли воно доступне, OpenChamber повідомляє вам, завантажує його, коли ви оберете, і встановлює при наступному перезапуску. Ви завжди керуєте процесом — нічого не встановлюється без вашого схвалення.
|
||||
|
||||
## Веб / CLI
|
||||
|
||||
Якщо ви встановили CLI, оновіть його з **About** кнопками перевірки та оновлення або з терміналу:
|
||||
|
||||
```bash
|
||||
openchamber update
|
||||
```
|
||||
|
||||
OpenChamber визначає, як його було встановлено (npm, pnpm, yarn чи bun), і запускає правильне оновлення за вас.
|
||||
|
||||
## Сервер OpenCode
|
||||
|
||||
OpenChamber та OpenCode оновлюються окремо. Коли доступна нова версія OpenCode, OpenChamber пропонує оновити її й перезапускає сервер після цього. Див. [OpenCode Server](/uk/opencode-server/) про те, як цим сервером керують.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Встановлення](/uk/install/) — як кожен застосунок встановлюється спочатку
|
||||
- [OpenCode Server](/uk/opencode-server/) — оновлення базового сервера
|
||||
@@ -0,0 +1,28 @@
|
||||
---
|
||||
title: Використання та квоти
|
||||
description: Відстежуйте, скільки з плану вашого провайдера ви вже використали.
|
||||
---
|
||||
|
||||
# Використання та квоти
|
||||
|
||||
Сторінка «Використання» показує, скільки з плану кожного провайдера ви витратили, щоб ви бачили, наскільки близько до ліміту перебуваєте. Відкрийте її в **Settings → Usage**.
|
||||
|
||||
## Що ви бачите
|
||||
|
||||
Для кожного підключеного провайдера OpenChamber показує:
|
||||
|
||||
- скільки з поточного вікна ви використали, у вигляді смужки
|
||||
- розподіл за моделями
|
||||
- індикатор темпу, щоб ви могли зрозуміти, чи встигнете вичерпати ліміт
|
||||
|
||||
Ви можете обрати, які провайдери відображаються, і той самий підсумок доступний із випадного меню в заголовку застосунку.
|
||||
|
||||
## Підтримувані провайдери
|
||||
|
||||
Використання працює для провайдерів, які публікують квоту, зокрема Claude, Codex, GitHub Copilot, Google, OpenRouter, Kimi, NanoGPT, z.ai, Zhipu, MiniMax, Ollama Cloud та Wafer.
|
||||
|
||||
Провайдер показує використання лише після того, як ви до нього увійшли на сторінці [Провайдери](/uk/providers/). Кільком провайдерам потрібен додатковий крок — наприклад, Ollama Cloud читає файл сесії, який ви налаштовуєте окремо. Якщо провайдер не показує даних, зазвичай це означає, що бракує цих додаткових облікових даних.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Провайдери, моделі та агенти](/uk/providers/) — увійдіть, перш ніж з'явиться використання
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: Голосовий режим
|
||||
description: Говоріть з OpenChamber і слухайте відповіді, зачитані вголос.
|
||||
---
|
||||
|
||||
# Голосовий режим
|
||||
|
||||
Голосовий режим дає змогу диктувати повідомлення й слухати відповіді, зачитані вам уголос. Увімкніть його в **Settings → OpenChamber → Voice**.
|
||||
|
||||
## Зачитування відповідей уголос (текст-у-мовлення)
|
||||
|
||||
Виберіть, як озвучуються відповіді:
|
||||
|
||||
- **browser** — вбудовані голоси вашого браузера, без налаштування
|
||||
- **OpenAI** — голоси OpenAI; вставте свій API-ключ і виберіть голос
|
||||
- **OpenAI-compatible** — будь-який сервіс, що говорить у форматі OpenAI; уведіть його URL і, якщо потрібно, API-ключ
|
||||
- **macOS say** — вбудована команда `say`, на Mac'ах, де вона є
|
||||
|
||||
Коли ввімкнено, ви отримуєте кнопку відтворення на повідомленнях, щоб почути їх зачитаними вголос.
|
||||
|
||||
## Диктування повідомлень (мовлення-у-текст)
|
||||
|
||||
Виберіть, як транскрибується ваше мовлення:
|
||||
|
||||
- **browser** — вбудоване розпізнавання вашого браузера, без налаштування
|
||||
- **server** — OpenAI-сумісний сервіс транскрипції; уведіть його URL і, за потреби, API-ключ
|
||||
- **on-device** — модель мовлення, що працює у вашому браузері й завантажується при першому використанні
|
||||
|
||||
## Зауваження для телефонів
|
||||
|
||||
Для зачитування відповідей уголос на телефоні опції OpenAI чи OpenAI-compatible найнадійніші — мобільні браузери обмежують вбудовані голоси.
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Сповіщення](/uk/notifications/) — отримуйте пінг замість того, щоб слухати
|
||||
- [Провайдери, моделі та агенти](/uk/providers/) — де ваш ключ OpenAI, можливо, вже зберігається
|
||||
@@ -0,0 +1,36 @@
|
||||
---
|
||||
title: Сесії worktree
|
||||
description: Дайте сесії власну гілку й теку, щоб робота лишалася ізольованою.
|
||||
---
|
||||
|
||||
# Сесії worktree
|
||||
|
||||
Сесія worktree працює у власній викачаній копії вашого репозиторію, у власній гілці (git worktree). Це не дає паралельним сесіям заважати файлам одна одної — одна може робити рефакторинг, поки інша виправляє баг, без перемикань туди-сюди.
|
||||
|
||||
## Створення
|
||||
|
||||
1. Відкрийте діалог нового worktree з кнопки вгорі бічної панелі сесій.
|
||||
2. Виберіть відправну точку:
|
||||
- **new branch** — назвіть гілку й виберіть, від якої гілки почати
|
||||
- **existing branch** — викачайте гілку, яка у вас уже є
|
||||
3. Підтвердьте теку worktree (OpenChamber пропонує одну з назви гілки).
|
||||
4. Створіть його.
|
||||
|
||||
OpenChamber створює гілку, налаштовує теку й запускає в ній сесію. Ви також можете запустити її прямо із [завдання](/uk/notes-todos-plans/) або [issue чи PR у GitHub](/uk/github/).
|
||||
|
||||
## Повернення роботи
|
||||
|
||||
Коли робота готова, скористайтеся **Integrate** у вигляді Git, щоб перенести коміти worktree на іншу гілку (як-от `main`). Якщо зміна конфліктує, ви можете передати конфлікт агентові на розв'язання.
|
||||
|
||||
## Прибирання
|
||||
|
||||
Видалення чи архівування сесії може прибрати worktree. Ви обираєте, чи також видалити гілку — локальну й віддалену, якщо така є. Нічого не видаляється без вашого запиту.
|
||||
|
||||
## Якщо щось виглядає не так
|
||||
|
||||
Worktree може потребувати уваги, якщо його тека зникла, його гілка в стані detached або злиття чи rebase наполовину завершені. OpenChamber позначає це, щоб ви могли виправити — див. [Worktree та Git](/uk/troubleshooting/worktrees-git/).
|
||||
|
||||
## Пов'язане
|
||||
|
||||
- [Multi-run](/uk/multi-run/) — запускайте багато сесій worktree одночасно
|
||||
- [Робочі процеси Git і GitHub](/uk/git/) — комітьте та інтегруйте зсередини OpenChamber
|
||||
Reference in New Issue
Block a user