Посібник користувача ZIAForge

Перші кроки

ZIAForge об'єднує обговорення, планування, виконання та перевірку в одному завданні. Виберіть Code для проєкту Git або Work для документів, досліджень та інших результатів у звичайній папці.

Почніть із невеликого завдання в окремому проєкті. Якщо ви вибираєте нативний CLI, спершу встановіть його та увійдіть під власним обліковим записом у терміналі. Крім того, ви можете налаштувати з'єднання API. Підписка на CLI і платний API є окремими способами підключення; ZIAForge не виконує вхід за вас і не переносить кредити між ними.

1. Відкрийте «Налаштування» та перевірте робочу папку й мову. Розділ «Про програму» показує точні відомості про запущену збірку.
2. Для Code додайте репозиторій Git на бічній панелі. Для Work виберіть окрему папку під час створення завдання.
3. Збережіть пресет із CLI, моделлю, рівнем міркувань і рівнем доступу. Ви також можете вибрати «Власна» безпосередньо без збереженого пресету.
4. Створіть завдання, виберіть його маршрут, ролі та ручне або автоматичне просування. Перевірте вибір перед натисканням «Почати».

Пов'язані інструкції: Огляд проєкту · Сумісність із провайдерами.

Встановлення відповідного пакета для настільних систем

Виберіть пакет для вашої операційної системи та архітектури CPU: x64 або arm64. Конвеєр збірки може створювати формати DMG/ZIP для macOS, інсталятор NSIS/ZIP для Windows, а також DEB/RPM/AppImage/tar.gz/ZIP для Linux. Згенерований файл або крос-збірка не є доказом того, що інсталятор і нативний UI пройшли перевірку на вашому комп'ютері; зверніться до звіту про перевірку відповідного випуску.

Збірки для macOS на основі Electron 44 вимагають macOS 13 або новішої версії. Використовуйте пакет arm64 на Apple Silicon і пакет x64 для Intel. Повністю закрийте старішу програму перед заміною. Пакети попереднього перегляду можуть бути непідписаними та не нотаріально засвідченими; не плутайте артефакт розробки з підписаним публічним релізом.

Для Windows потрібна операційна система, підтримувана включеною версією Electron, і доступний Git у PATH. Виберіть відповідну архітектуру. Непідписана попередня версія не має сертифікації Authenticode. Портативний ZIP має містити повний каталог програми та файли середовища виконання, а не лише її виконуваний файл.

Для Linux потрібні сумісне графічне середовище, системні бібліотеки, необхідні для Electron, і Git. Для зашифрованих облікових даних керування надайте робочу Secret Service, таку як gnome-libsecret або KWallet; небезпечний бекенд basic_text не підтримується. Результати перевірки (smoke tests) у безголовному режимі або контейнері не засвідчують працездатність на кожному робочому столі чи дистрибутиві.

Встановіть DEB за допомогою apt install ./file.deb або встановіть RPM через менеджер пакетів вашого дистрибутива. Для AppImage потрібні права на виконання та відповідна підтримка FUSE; альтернативою є прапорець --appimage-extract-and-run, де він підтримується. Розпаковуйте архіви tar.gz і ZIP з усіма їхніми файлами середовища виконання. Розмежовуйте дані користувача та файли програми під час заміни пакета.

Щоб зібрати із сирцевого коду, використовуйте Node 24, Git та npm ci, включно зі звичайним інсталятором Electron. Для нативної перезбірки потрібні інструменти платформи: інструменти командного рядка Xcode на macOS; MSVC C++, Windows SDK і Python на Windows; компілятор, make, Python, pkg-config і необхідні інструменти пакування на Linux. Дотримуйтесь інструкцій у PLATFORM_BUILDS.md щодо точних команд і поточних обмежень платформи.

Версії випусків резервуються централізовано, а вихідні дані є незмінними. Перевірочна збірка CI не є опублікованим інсталятором. Архіви вихідного коду містять сирцеві файли, lock-файл, документацію та скрипти; залежності, облікові дані, профілі користувачів і приватні дослідження виключені. Ніколи не робіть висновків про валідацію для нативної ARM або Windows на основі успішної збірки для x64.

Пов'язані інструкції: Пакети для платформ, попередні вимоги та обмеження перевірки · Ідентифікація збірки та перевірки випусків.

Code: п'ять маршрутів

Auto оцінює обсяг: просте запитання може завершитися відповіддю, тоді як більше завдання потребує підготовки. «Виправити помилку» досліджує причину та готує виправлення. «Спершу специфікація» починає з технічного рішення; «Спершу вимоги» починає з вимог і критеріїв приймання.

Мультимодельний маршрут використовує окремі контексти для дослідження, проєктування, реалізації та перевірки. Назва маршруту не вимагає різних провайдерів: кожна роль використовує пресет або конфігурацію «Власна», яку ви виберете.

Worktree ізолює зміни Git завдання. «Гілка» працює у вибраній робочій копії. Перевірте проєкт, гілку та модель перед початком; опис завдання не надсилається додатково у звичайний чат.

Для ідеї з невирішеними продуктовими або технічними рішеннями використовуйте «Спершу вимоги» та закладайте основу в обговоренні. Auto класифікує запит; це не команда негайно реалізувати кожну коротку фразу. «Зберегти чернетку» зберігає запит без звернення до моделі; «Почати» зберігає та запускає керований процес один раз. Від однієї до чотирьох копій завдання мають незалежні ідентифікатори створення та налаштування ролей.

Пов'язані інструкції: Контракт робочого процесу Code · Профілі підказок Code.

Обговорення Forge

«Почати» відкриває центральне обговорення. Відповідайте природно, ставте зустрічні запитання, додавайте обмеження та обговорюйте технічні рішення. Розмова та запитання залишаються прив'язаними до завдання.

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

Щоб свідомо переглянути основу, виберіть «Вимоги», «Специфікація» або «Планування». Нова версія вимагає нового прийняття залежних рішень. Завершені кроки та їхні підтвердження зберігаються; замінені незавершені фази залишаються в історії.

Керовані сесії фаз відрізняються від вільного чату. Використовуйте обговорення Forge замість надсилання ручних підказок безпосередньо в сесію, що належить робочому процесу.

Пов'язані інструкції: Контракт обговорення Forge.

Документи та рішення

Відкрийте документ, перевірте його версію та внесіть зміни за потреби. Відправлення змін через обговорення створює нову версію; звіти та перевірені результати не переписуються ретроспективно.

Перед прийняттям запропонованого плану відредагуйте порядок, інструкції, критерії приймання та команди перевірки. Дозволяйте конкретні команди, які ви розумієте: вони виконуються в папці завдання. Мультимодельний маршрут пропонує один крок реалізації для всього завдання, з деталями в його документах та інструкціях.

«Схвалити» — це окреме свідоме рішення. Auto не обходить запитання або прийняття вимог, специфікацій і планів. Документ, змінений ззовні, не може повторно використовувати старе схвалення.

Файли підготовки з'являються як артефакти. Їхня версія, фаза створення та хеш прив'язують їх до результату. Документи Code зберігаються поза робочим деревом (worktree) і не потрапляють у коміт автоматично.

Перевірте як документ, так і відображене рішення перед прийняттям. Прийняття зв'язує поточний ID шлюзу, ревізію плану та збережені хеші документів. Запитуйте зміни, коли обсяг або підтвердження неправильні. Якщо рішення застаріло, перезавантажте збережений стан перед новим вибором; змінений файл не може бути прийнятий під ранішою версією.

Пов'язані інструкції: Шлюзи робочого процесу та версії документів.

Виконання та рецензування

Список завдань показує реальні кроки, поточну спробу, результати перевірки та рецензування. Те, що агент каже «виконано», не завершує крок: повинні існувати необхідні за планом підтвердження.

Ручний режим робить паузи між придатними кроками. Auto просуває перевірені кроки та дозволяє обмежену кількість повторних спроб. «Зупинити після» завжди створює точку перевірки. «Пауза» зупиняє активну роботу процесу; закриття панелі не зупиняє її.

Незалежний рецензент використовує окремий контекст із файлами та результатами перевірки. Кожне обов'язкове блокувальне зауваження має бути усунене; наявність кількох рецензентів не дозволяє зняти блокувальну помилку голосуванням.

У мультимодельному маршруті виправлення зауважень вимагає явного рішення. Виправлення не запускає мовчки інше рецензування: «Рецензувати знову» відкриває новий цикл. Коментарі до рецензії можуть запитувати перегляд координатором без повторення реалізації.

Завершені кроки не можна непомітно відредагувати. За TDD етап Red повинен дійсно зазнати невдачі з очікуваної причини, після чого Green має пройти успішно. Обмежена кількість спроб запобігає нескінченним повторам.

Збережіть незалежних рецензентів CLI/API у розділі «Налаштування → Команди рецензування», потім виберіть команду в Code або Work. Рецензенти працюють паралельно, після чого діє архітектор звіту команди. Ви також можете налаштувати незалежних рецензентів без збереженої команди. Архітектор звіту отримує лише анонімні структуровані звіти без файлів проєкту чи інструментів; для такої ізоляції наразі потрібні Claude Code або API.

Кожен крок реалізації потребує виконуваної перевірки, обов'язкового незалежного рецензування або обох. Фази підготовки натомість зберігають валідовані результати та квитанції артефактів; вони не вдають, що тести реалізації запускалися. Команда вважається успішною лише тоді, коли підтверджено її фактичний статус виходу та очищення запущених процесів. Перевірка Red для TDD повинна завершитися звичайною помилкою перед реалізацією та перевіркою Green; відсутність виконуваного файлу або таймаут не є дійсним результатом Red.

Стандартні запобіжники зупиняють роботу після трьох невдалих спроб на одному кроці або п'ятдесяти спроб загалом. Переривання зараховується як спроба, але саме по собі не вважається невдалою спробою. Ліміти та зафіксовані підтвердження зберігаються після перезапуску; «Повторити» не скидає їх. Ознайомтеся зі збереженою помилкою перед наданням дозволу на наступну спробу.

Пов'язані інструкції: Перевірка та рецензування.

Паралельні команди рецензування та архітектор звіту

Відкрийте «Налаштування → Команди рецензування» та збережіть команду. Додайте незалежних рецензентів із власними CLI або API, моделлю, рівнем міркувань і спеціалізацією, після чого виберіть архітектора звіту. Виберіть команду в конфігурації рецензування завдання. Пресет виконавця також може використовуватися рецензентом, а варіант «Власна» залишається доступним; незалежні ролі все одно мають окремі контексти.

Рецензенти працюють паралельно над одними й тими самими матеріалами завдання. Кожен обов'язковий звіт, помилка та вердикт фіксуються. Архітектор отримує анонімні пронумеровані звіти без імен рецензентів, відомостей про моделі чи провайдерів, початкового вмісту завдання, доступу до репозиторію або інструментів. Він порівнює звіти та повертає один структурований вердикт; він не проводить повторного аналізу вихідного коду.

Блокувальне зауваження або відхилення обов'язковим рецензентом не можуть бути скасовані більшістю голосів чи перевагою архітектора. Відсутні або некоректні звіти блокують схвалення. Ознайомтеся з окремими зауваженнями та загальним рішенням перед прийняттям або дозволом на внесення виправлень. Збережена команда фіксується та заморожується для поточного запуску; редагування її пресету не переписує збережені підтвердження.

Архітектор лише для звітів наразі використовує підтримувані конфігурації без інструментів для Claude або API. Codex та Antigravity залишаються доступними як рецензенти, але не допускаються до цієї ізольованої ролі архітектора, доки не з'явиться перевірений контракт без інструментів. Лише підказки «без інструментів» недостатньо.

Пов'язані інструкції: Типізована конфігурація команди · Агрегація рецензій.

Спеціалізації агентів і політика підказок

Модель є рушієм виконання; спеціалізація — це профіль інструкцій. Виберіть «Немає» для відсутності додаткової спеціалізації, «Стандартна» для типового посібника, Auto для відповідного вбудованого посібника або «Вручну» для вибраних посібників і власних обмежених інструкцій. Пресети можуть зберігати цей вибір.

Оригінальний каталог охоплює загальне програмування, архітектуру, безпеку, надійність, продуктивність, тестування та зручність інтерфейсу. Auto використовує доступний текст завдання/кроку для вибору посібника; це не викликає таємно іншу модель і не засвідчує експертність. Пропозиції планування можна перевірити та змінити перед прийняттям плану реалізації.

Спеціалізації рецензування допомагають спрямувати увагу, але ніколи не замінюють незалежних підтверджень, обмежень доступу або структурованого вердикту. Ставтеся до власних інструкцій як до частини обсягу завдання: не використовуйте їх для обходу прийняття документів, політики інструментів, автентифікації чи повідомлень про помилки від рецензентів.

Пов'язані інструкції: Оригінальний каталог підказок.

Work: від запитання до документа

Для Work не потрібен Git. Варіант «За замовчуванням» створює окрему папку завдання; варіант «Власна» вибирає наявну папку через системне діалогове вікно. «Зберегти чернетку» зберігає налаштування без інференсу; «Почати» запускає першу фазу.

Auto відповідає безпосередньо або пропонує відповідний план із реальними пунктами виконання. «Мозковий штурм» створює ideas.md перед тим, як ви виберете додаткові ідеї або оцінювання. «Дослідження» зберігає findings.md, джерела та обмеження. «Написання» переходить від задуму і, коли це корисно, outline.md до описового документа або draft.md; нові редакції зберігають попередні версії.

Вибирайте вхідні файли за допомогою нативного діалогового вікна вибору та посилайтеся на них через @. Застосунок копіює їх як незмінні вхідні дані завдання та перевіряє їхню ідентичність перед запуском. «За замовчуванням» створює папку завдання під керуванням програми; доступ до папки у варіанті «Власна» є збереженим дозволом власника. Збережена незапущена чернетка може змінити свою папку.

Створюйте від 1 до 4 копій із незалежними налаштуваннями виконавця. Завдання, які використовують спільні папки, не можуть виконувати запис одночасно. Ця координація поширюється на операції ZIAForge, а не на довільні зовнішні програми.

«Глибокий мозковий штурм» типово використовує трьох незалежних виконавців і підтримує до восьми. Виберіть їхній порядок і конфігурації, зокрема повторне використання пресету в окремих контекстах. Запитання виконавців зберігають своє походження; некоректно сформовані звіти отримують одну спробу виправлення формату. Частковий збій залишається видимим, а не подається як одностайний успіх.

Режим «Глибокий» об'єднує збережені звіти виконавців у brainstorm_report.md і завжди запитує рішення користувача. Невелике доопрацювання оновлює звіт через координатора; значна зміна запускає новий раунд зафіксованих виконавців. Артефакти зберігають свої версії.

Визначені ролі фіксуються під час створення завдання або явного збереження чернетки. Після першого виклику можна змінити лише автоматичне/ручне просування; використовуйте нове завдання для інших налаштувань ролей або моделей. Редагування глобального пресету не призводить до непомітних змін у наступних фазах.

Ручний режим робить паузи між придатними фазами, зокрема перед значним планом «Написання». Auto може продовжувати виконання безпосередньо за цим планом. Запитання, запропоновані плани виконання, напрямок «Мозкового штурму» та перегляд звітів у режимі «Глибокий» залишаються явними рішеннями навіть у Auto. Цитата сама по собі не доводить факт вебпошуку, а збережений бінарний файл сам по собі не підтверджує коректності його відображення.

Пов'язані інструкції: Режими та рішення Work.

Пресети, моделі та доступ

Пресет зберігає CLI/API, модель, рівень міркувань і дозволи. Нижній колонтитул чату містить сегменти пресету, CLI, моделі та параметрів. Варіант «Власна» працює без пресету; «Створити пресет» зберігає поточний вибір.

Каталог надходить із вибраного встановленого CLI або API, де це підтримується. «Оновити» актуалізує список без зміни вибору. Якщо автоматичне виявлення недоступне, введіть точний ID моделі; провайдер все одно має підтримувати його. Рівні міркування залежать від моделі та CLI. Значення за замовчуванням провайдера відрізняється від явного токена «none».

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

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

Дозволи різняться залежно від провайдера. «Лише читання» та «Запис у робочу область» доступні там, де їх підтримує адаптер. Antigravity використовує нативні налаштування CLI або явно вибраний повний доступ. Повний доступ не є пісочницею.

Спеціалізація додає настанови до підказки, а не іншу модель чи дозвіл. Пресети та ролі підтримують «Немає», «Стандартна», Auto і «Вручну». Auto вибирає профілі з тексту кроку без додаткового виклику моделі; «Вручну» приймає до чотирьох спеціалізацій і власні інструкції. Призначення, запропоновані планувальником, можна відредагувати перед прийняттям плану.

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

Пов'язані інструкції: Можливості провайдерів.

Чати, зупинка та черга

Відкриті вкладки, «Недавні» та чернетки належать до одного завдання. Закриття вкладки видаляє її з «Відкритих», але зберігає в «Недавніх» і не зупиняє процес її провайдера чи керований робочий процес. Шукайте в історії, відкривайте чат повторно або закривайте всі додаткові вкладки з меню історії.

«Зупинити» перериває поточний хід. Зачекайте на завершення зупинки перед наступним «Надіслати»: підтвердження переривання не означає завершення процесу. Тим часом ви можете набирати наступну чернетку.

У звичайному чаті «У чергу» зберігає подальший запит окремо від поточної чернетки. «Призупинити чергу» затримує подальше доставлення. «Зупинити» та «Вийти» призупиняють чергу. Після перезапуску спочатку натисніть «Відновити», а потім явно «Продовжити чергу».

«Невизначено» означає, що стан доставлення невідомий. Таке повідомлення не надсилається повторно автоматично: перевірте історію, скопіюйте текст за потреби та відхиліть елемент черги. Його повторне надсилання є новим свідомим запитом.

Керовані поетапні чати використовують власний робочий процес, а не звичайну чергу. «Стежити за етапом» показує поточну фазу; вибір іншої вкладки вручну зупиняє відстеження. Журнали CLI відображають діагностику окремо від відповіді.

Відповіді у форматі Markdown відображають заголовки, списки, таблиці, посилання та блоки коду. Картки інструментів і діагностика CLI залишаються відокремленими від відповіді. Повідомлені моделлю міркування та метрики токенів відображаються лише тоді, коли провайдер дійсно надає їх; не робіть висновків про приховані міркування або використання ресурсів на основі анімації.

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

Пов'язані інструкції: Надійна черга повідомлень.

Файли, Git і завершення

Розділ «Файли» показує папку завдання. Порівнюйте результати з вимогами, відкривайте документи та переглядайте відмінності (diffs). Збереження бінарного файлу не доводить його правильного відображення в цільовому застосунку.

Git надає статус, зміни та операції із зафіксованими результатами. Коміт, злиття та надсилання (push) за замовчуванням виконуються вручну; автоматичні операції є окремими опціями для повністю перевіреного плану.

Не змінюйте робочі файли між перевіркою та публікацією: схвалення прив'язане до точних байтів. Конфлікти, невдалі відправлення (push) і невідомі результати операцій блокують прогрес до прийняття явного рішення. Auto не дозволяє публікацію мовчки.

Work не створює гілок Git і не має фіналізації Git. Зберігайте необхідні документи з вибраної папки, включно з версіями та джерелами.

Редактор файлів забезпечує підсвічування синтаксису за розширенням, пошук і заміну, історію скасувань, перенесення рядків і чернетки для кожної вкладки. Збереження підтримує кодування UTF-8/UTF-16 і відхиляє конфлікти зовнішніх змін. Інші кодування та двійковий вміст потребують зовнішнього редактора. Незбережені чернетки блокують вихід із програми (Quit), доки власник не збереже або не відкине їх.

Повний синтаксис увімкнено для файлів розміром до 8 МіБ. Більші текстові файли відкриваються у вікнах по 256 КіБ; файли від 8 до 64 МіБ можна явно завантажити повністю без підсвічування синтаксису. Понад 64 МіБ використовуйте віконне редагування та обмежений пошук наступного збігу. Це обмежений режим для великих файлів, а не еквівалент Sublime Text для документів довільного розміру.

«Відкрити папку» використовує контекст поточного завдання або гілки/worktree, замість того щоб мовчки відкривати лише оригінальний репозиторій. Рядок файлу може показати батьківський каталог цього файлу. Шляхи перевіряються бекендом відповідно до зареєстрованих дозволів завдання. Бінарні файли не можна редагувати як звичайний текст; використовуйте призначений для них засіб перегляду та зберігайте оригінальні байти.

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

Пов'язані інструкції: Типізований контракт редактора · Політики Git.

З’єднання API

Розділ «З’єднання» додає явно вибрану кінцеву точку, сумісну з OpenAI. Введіть назву, базову URL, модель і за потреби ключ. Багато серверів вимагають базову URL із закінченням на /v1; зверніться до документації вашої кінцевої точки.

Потрібен протокол HTTPS, за винятком локального HTTP (loopback). Використовуйте звичайну кінцеву точку без облікових даних, вбудованих у URL. Ключі використовують підтримуване шифрування OS і не повертаються в UI. Зміна кінцевої точки вимагає повторного введення її ключа. Залишення поля ключа порожнім зберігає збережений ключ; пункт «Видалити збережений ключ» явно очищає його.

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

Зберігайте облікові дані в «З’єднаннях», а не в тексті завдання чи інструкціях пресету. Рецензенти з доступом лише для читання отримують лише дозволені їм файлові інструменти API; архітектор звіту не має інструментів. Непідтримувані виклики інструментів відхиляються, а не виконуються мовчки. Сервери різняться параметрами міркування, підтримкою інструментів і списками моделей; порівнюйте помилку з власним контрактом вашої кінцевої точки.

Пов'язані інструкції: З’єднання API.

Налаштування, мови та безпечне скидання

Загальні налаштування задають робочу область, мову інтерфейсу та параметри за замовчуванням. «З’єднання» керує кінцевими точками API. «Пресети» та «Команди рецензування» зберігають конфігурації ролей. «Віддалене керування» управляє локальними обліковими даними, областю дії сервера та правами власника; «Оновлення» керує джерелом/каналом релізів. «Про програму» показує точні відомості про запущену збірку.

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

Кнопка «Зберегти» застосовує відображену конфігурацію. Скидання бази даних або повернення до заводських налаштувань може призвести до видалення метаданих застосунку; обов'язково збережіть файли та перевірену резервну копію, перш ніж свідомо використовувати скидання. Ці операції виконуються локальним власником. Не використовуйте їх як простий спосіб діагностики збійного робочого процесу або пошкодженого запису.

Пов'язані інструкції: Інструкції з локалізації · Відновлення даних.

Запитати асистента довідки

Відкрийте розділ «Довідка», виберіть збережений підключений пресет на панелі асистента та запитайте про ZIAForge. Відповіді формуються на основі поточної канонічної англійської довідки та вибраної мови інтерфейсу. Кнопки посилань на розділи відкривають відповідні теми довідки, щоб ви могли зіставити пояснення з оригіналом.

Цей асистент веде окрему приватну бесіду обсягом до 100 збережених записів і 3 МіБ. Введіть запитання довжиною до 12,000 символів; кнопка «Надіслати» відправляє його, «Зупинити» скасовує активну генерацію відповіді зі збереженням вашого запитання, а «Очистити» видаляє цю бесіду довідки. Ненадіслана чернетка та вибір пресета зберігаються в разі закриття або повторного відкриття довідки в межах одного сеансу роботи, але чернетка не записується на диск. Асистент не надсилає команд застосунку, не змінює робочий процес і не підтверджує контрольні етапи. Його поради не є оперативною перевіркою завдання, облікового запису чи зовнішнього підключення.

Сеанси довідки з Claude Code та API дотримуються підтримуваного режиму без інструментів. Нативні сеанси довідки з Codex та Antigravity вимагають наявного нативного дозволу локального власника на керування комп'ютером. Якщо його вимкнено, застосунок пояснює цю вимогу замість вибору іншого провайдера. Тільки власник може ввімкнути його в локальних налаштуваннях керування; асистент не може увімкнути його самостійно.

Довідка з Codex використовує пісочницю лише для читання та відхиляє запити на схвалення інструментів. Antigravity використовує режим планування та свій нативний прапорець пісочниці. Ці нативні режими не є універсальною гарантією ізоляції на рівні операційної системи. Хеш вихідної довідки визначає джерело, використане для відповіді; згенероване пояснення все одно може містити помилки, тому перед виконанням дій ознайомтеся з пов'язаними розділами. Старі відповіді позначаються окремо, якщо версія їхньої вихідної довідки відрізняється від поточної.

Пов'язані інструкції: Канонічна довідка та підтримка перекладів · Асистент застосунку та дозволи.

Асистент і Telegram

Асистент використовує вибраний пресет і той самий API керування застосунком. Дозвіл на перевірку стану та дозвіл на виконання операцій є окремими. Перевіряйте команди та результати: пояснення асистента не є підтвердженням завершення дії.

Telegram вмикається лише локальним власником, за наявності чинного токена бота та числового ID власника. Керування призначено виключно для приватного чату цього власника. Неналаштований або неактивний бот не повинен отримувати повідомлення застосунку.

Не вставляйте токен бота у звичайний чат. Налаштування інтеграції не підтверджує наявність зв'язку з Telegram і не створює бота автоматично. Знімки екрана та відповіді можуть містити приватні дані робочої області.

Виберіть пресет асистента та надайте дозвіл на виконання операцій у застосунку окремо від дозволу на перегляд. Робота асистента з Codex та Antigravity вимагає нативних прав від власника; вони не підміняються автоматично сесією API без інструментів або Claude. Знімки екрана можуть відображатися в бесіді асистента, але поточні вхідні дані моделі не передбачають аналізу зображень. Не вважайте, що асистент візуально перевірив зображення лише тому, що відобразив його.

Асистент може перевіряти зведення, завдання, чати, стан робочих процесів, контекст процесів і вікна застосунку за допомогою типізованих інструментів. Він може змінювати дозволені звичайні налаштування та запускати авторизовані операції застосунку. Він не може надавати нативні права, розкривати збережені облікові дані, віддалено змінювати дозволи кореневої робочої області або схвалювати контрольний етап Forge просто тому, що це зручно.

Пов'язані інструкції: Контракт керування застосунком.

Керування власним приватним ботом у Telegram

Створіть або отримайте власного бота, відкрийте приватний чат із ним і введіть його токен та свій числовий ID користувача Telegram у локальних налаштуваннях керування. Вмикайте інтеграцію лише тоді, коли ви плануєте підключення застосунку. ID власника — це ідентифікатор користувача, а не ім'я користувача (username) чи ID бота. Приймаються повідомлення лише від цього користувача і виключно в цьому приватному чаті.

Використовуйте /start, /menu або /status для перегляду запущеної версії, кількості проєктів/завдань та їхніх статусів. Кнопки відкривають «Проєкти», «Завдання», «Знімок екрана», «Довідка» та «Мова». У списках відображається по вісім пунктів на сторінці з кнопками навігації «Назад», «Оновити», «Головна» та «Попередня»/«Наступна». Кнопки проєктів фільтрують список завдань. Картка завдання показує збережений прогрес робочого процесу, модель/пресет і запитання, що очікують на відповідь, якщо такі є.

Відкрийте «Чати» завдання, щоб переглянути відкриті/нещодавні бесіди та чати етапів робочого процесу. У кожному перегляді показано до шести останніх повідомлень користувача й асистента, скорочених для огляду до 200 символів кожне. Внутрішні міркування моделі не відображаються. Перегляд історії не запускає провайдера. Попередній перегляд працює лише для читання: звичайний текст і команда /ask TEXT адресуються асистенту застосунку і за жодних умов не надсилаються автоматично в чат завдання, яке ви переглядаєте.

Команда «Запустити / Продовжити» повторно зчитує поточний робочий процес у режимі Code або Work і запускає відповідний збережений робочий процес. Команда «Призупинити» надсилає запит на його зупинку. Жодна з них не приймає вимоги, специфікацію, план, результати перевірки чи запитання; рішення, що очікує на відповідь, блокує запуск. Приймайте рішення в застосунку або скористайтеся явно дозволеною типізованою командою з точним зазначенням поточного контрольного етапу та ревізії.

Використовуйте кнопку «Мова» або команду /language, щоб вибрати будь-яку з 56 мов інтерфейсу за її оригінальною назвою. Це налаштування зберігається лише для цього бота і власника. Пункт «Використовувати мову застосунку» скасовує цей вибір. Це не змінює ані мову застосунку, ані права доступу; наявні повідомлення повторно не надсилаються.

Навігація зазвичай оновлює те саме опубліковане повідомлення меню. Кнопки мають унікальні ідентифікатори, термін дії яких спливає через 15 хвилин і які можна використати лише один раз; оновлення картки робить її попередні кнопки недійсними. Кнопки, термін дії яких сплив, уже використані, прив'язані до інших повідомлень або створені попередніми процесами, не можуть виконати дію. Повідомлення, яке точно неможливо відредагувати, можна замінити новою карткою; у разі невідомої помилки мережі повторна спроба у вигляді нового повідомлення не виконується.

Під час активації модуль опитування відкидає накопичену чергу повідомлень і фіксує прийняття оновлення перед його надсиланням, щоб перервані команди автоматично не повторювалися після перезапуску. Це запобігає повторному відтворенню, але не гарантує виконання. Перевіряйте статус і контекст, перш ніж свідомо призначати нову задачу після помилки. Автоматичні сповіщення про зміну статусу завдань відсутні.

Явні команди залишаються доступними: /projects, /tasks, /task TASK_ID, /run TASK_ID, /pause TASK_ID, /screenshot та /ask TEXT. Команда /new {JSON} створює завдання через типізовану createTask; /command {JSON} надсилає явну команду з каталогу. Ознайомтеся з актуальним каталогом щодо структури аргументів. Застосовуються ті самі правила авторизації бекенда та дозволи на папки, що й у програмі.

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

Пов'язані інструкції: Приватний бот і команди.

Нативний дозвіл керування комп'ютером лише для власника

Нативний доступ до комп'ютера за замовчуванням вимкнено. Тільки власник може ввімкнути його локально в меню «Налаштування» → «Віддалене керування». Асистент і команди HTTP/MCP/Telegram не можуть увімкнути цей прапорець самостійно. Якщо в операції відмовлено, асистент має описати відповідне налаштування та надати власнику право прийняти рішення.

Якщо параметр явно ввімкнено, команда computer.run приймає виконуваний файл, масив аргументів і необов'язковий абсолютний робочий каталог. Вона не використовує інтерполяцію оболонки, має ліміт часу 30 секунд і обмежує виведення розміром 1 МіБ. Якщо передано відсутній або недійсний каталог, у запиті відмовляється; якщо cwd опущено, використовується каталог налаштувань самого застосунку, а не HOME. Дія Quit скасовує активні команди поточного власника та очікує на завершення їхніх процесів.

Обсяг дозволів на читання/дії в застосунку та нативний доступ є окремими рішеннями. Робоче дерево не обмежує доступ до файлової системи для провайдера без обмежень. Скасуйте нативний доступ після завершення завдання, якщо він більше не потрібен, і перевіряйте звіти виконання команд, замість того щоб приймати текст асистента за підтвердження.

Пов'язані інструкції: Контракт керування лише для власника.

Браузер і віддалені екземпляри

Локальний власник вмикає сервер і вибирає його адресу, порт і права доступу: read для перегляду або operate для виконання дій. Стандартна адреса 127.0.0.1 доступна лише на цьому комп'ютері. Адреса 0.0.0.0 приймає з'єднання на мережевих інтерфейсах; перевірте параметри мережевого доступу перед її ввімкненням.

У браузері відкривається той самий інтерфейс після входу за токеном. Не додавайте токени до публічних посилань чи знімків екрана. Протокол HTTP сам по собі не шифрує трафік; у ненадійній мережі використовуйте захищений канал.

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

Типізовані команди та події забезпечують керування застосунком. Дозвіл read не надає права на зміну завдань. Нативне керування комп'ютером є окремим вибором локального власника та за замовчуванням вимкнено.

Застосунок повинен залишатися запущеним для керування через браузер, Telegram і зовнішніх агентів. Кожен екземпляр має власний приватний профіль, стан завдань, токен і порт сервера. Не використовуйте один профіль одночасно для різних незалежних екземплярів. Події браузера та відповіді на команди діють лише в межах вибраного екземпляра; перемикання UI не переміщує файли та не копіює нативний сеанс входу.

Пов'язані інструкції: HTTP і керування екземплярами.

OpenClaw, Hermes та інші зовнішні агенти

Використовуйте автентифікований API керування застосунком або вбудований stdio-міст MCP. Увімкніть сервер локально, виберіть режим читання або виконання дій та налаштуйте кожен клієнт із зазначенням URL і токена цього екземпляра. Для роботи автономного моста MCP потрібен Node.js версії 22 або новішої; застосунок Electron не встановлює клієнт вашого агента. URL браузера не є кінцевою точкою потокового HTTP MCP: передайте його як ZIAFORGE_URL для stdio-моста.

Міст надає інструменти ziaforge_status, ziaforge_commands, ziaforge_command і ziaforge_screenshot. Почніть зі статусу та актуального каталогу команд, після чого прочитайте system.context для вибраного завдання. Типізовані команди проходять ті самі перевірки ревізії, контрольних етапів, папки завдання та очищення, що й локальний UI.

Актуальний каталог команд містить documentation.guide — канонічну англомовну довідку з її вихідним шляхом і sourceSha256. Внутрішній архітектор застосунку отримує ту саму документацію через свої інструменти. Це забезпечує агентам повний контекст продукту без оперування застарілими відомостями; документація в жодному разі не надає прав доступу і не замінює поточного рішення людини.

Агенти мають обговорювати вимоги, технічні рішення та планування на основі короткої ідеї користувача. Вони зобов'язані дотримуватися явних контрольних етапів людини, вибраних моделей, правил ручного або автоматичного режиму Auto і необхідного рев'ю. Вони не повинні самовільно створювати схвалення, повторювати невизначені команди під новим ID або публікувати зміни в Git без явного наміру власника.

Налаштовуйте кілька іменованих серверів MCP для кількох окремих інсталяцій. Перемикання екземплярів — це вибір маршрутизації, а не синхронізація. Приклади конфігурації для OpenClaw і Hermes наведені в AGENT_CONTROL.md; налаштування та сумісність окремих клієнтів необхідно перевіряти для встановленої версії клієнта.

Зовнішній кеш requestId лише усуває дублікати для обмеженого набору запитів під час роботи застосунку. Довготривалі операції використовують власні ідентифікатори: createRequestId для створення завдань, commandId для рішень у робочому процесі, clientMessageId для повідомлень і operationId для мутацій у Git. Зберігайте початковий ідентифікатор і корисне навантаження в разі непідтвердженої відповіді; зчитуйте збережений стан перед навмисним запуском нової роботи.

Пов'язані інструкції: Інструкції для клієнтів MCP.

Локальний CLI та обмеження автоматизації

Диспетчер ziaf керує тим самим запущеним застосунком і збереженим робочим процесом. З вихідного коду використовуйте npm run ziaf -- list, npm run ziaf -- status --task TASK_ID --json, npm run ziaf -- start --task TASK_ID або npm run ziaf -- pause --task TASK_ID. Успішне підтвердження команди Start не означає, що завдання виконано.

Параметр --until-success навмисно вмикає режим Auto для збереженого робочого процесу, однак запитання, рев'ю, контрольні етапи прийняття, ліміти та контрольні точки все одно діють. Сполучення Ctrl+C завершує роботу спостережного диспетчера, але не зупиняє робочий процес застосунку автоматично. Дивіться CLI.md щодо кодів виходу, локальної кінцевої точки та роботи з профілями.

Інтерфейс «Автоматизації» наразі зберігає лише параметри відображення та локальні лічильники запусків. Він не є сертифікованим планувальником регулярних завдань і не підтверджує фактичне виконання фонового кроку моделі. Для реального виконання використовуйте елементи керування збереженим робочим процесом, утиліту ziaf або автентифікований API і перевіряйте їхні квитанції. Не сприймайте демонстраційну панель як планувальник для автономної роботи.

Пов'язані інструкції: Команди диспетчера.

Версія та оновлення

Розділ «Про програму» показує точну версію, що наразі запущена. Загальнодоступні оновлення вимагають надійного репозиторію релізів GitHub і вибору стабільного або попереднього каналу. Перевірка, завантаження та встановлення мають окремі статуси; виникнення помилки не означає, що оновлення було встановлено.

Автоматичне встановлення призначене для підписаних релізів для macOS. Непідписані збірки для розробки не встановлюються автоматично цим механізмом. Для заміни вручну повністю закрийте поточний застосунок і скористайтеся перевіреним артефактом.

Автоматична перевірка виконується одразу після ввімкнення, а потім кожні шість годин.

Стабільний канал виключає попередні версії; канал preview також дозволяє версії для розробки. Успішна перевірка лише підтверджує наявність метаданих релізу. Для завантаження та встановлення потрібен пакет для відповідної платформи та налаштований канал релізів. Доставка пакетів DEB для Linux здійснюється через окремий інсталятор; не вважайте, що DEB автоматично оновлюється за допомогою механізму оновлення macOS.

Пов'язані інструкції: Готовність релізу.

Перезапуск і відновлення

На macOS використовуйте Quit / ⌘Q для повного завершення роботи. Закриття вікна може залишити застосунок у запущеному стані. Повністю закрийте стару версію перед заміною застосунку.

Після запуску виберіть те саме завдання. Історія та чернетки відновляться. Дія «Відновити» відновлює нативний/локальний контекст, але не надсилає чернетку, не знімає чергу з паузи та не дозволяє повторення непідтвердженої операції.

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

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

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

Пов'язані інструкції: Контракт відновлення.

Усунення несправностей

CLI не знайдено: перевірте його встановлення та версію у звичайному терміналі, після чого перезапустіть ZIAForge. Наявність виконуваного файлу не означає, що ви пройшли автентифікацію. Скористайтеся штатним механізмом авторизації провайдера.

Модель недоступна або сталася помилка авторизації: оновіть пошук доступних моделей, виберіть доступний ID та перевірте стан свого облікового запису й ліміти. Не повторюйте запит із невизначеним результатом без перегляду його історії.

Робочий процес зупинився: відкрийте поточний етап, запитання, квитанцію перевірки або журнали CLI. Усуньте конкретну причину: запитання без відповіді, команду, дозвіл на доступ до папки або вичерпаний ліміт спроб. Команда «Продовжити» не перетворить невдалу перевірку на успішну.

Папку видалено або замінено: відновіть доступ до початкової папки або створіть нове завдання. Застосунок не повинен продовжувати роботу з HOME. Якщо ви помітили інший робочий каталог (cwd), зупиніть сеанс і збережіть діагностичні дані.

Формуючи звіт, зазначте точну версію з меню «Про програму», маршрут, CLI/модель, очікувану та фактичну поведінку, додайте знімок екрана та безпечний фрагмент журналу. Видаліть секрети, персональні дані та шляхи, які не підлягають публікації.

Віддалена сторінка недоступна: переконайтеся, що власник увімкнув сервер, перевірте адресу прослуховування та порт, після чого пройдіть автентифікацію за допомогою правильного токена екземпляра. Помилка 401 вказує на проблему автентифікації; відхилена зміна може пояснюватися режимом лише для читання або обмеженням дій виключно для власника. Зміна токена завершує роботу підключених клієнтів браузера. Не використовуйте окремий порт налагодження DevTools як порт віддаленого керування застосунком.

Відхилено збереження в редакторі: збережіть чернетку, перевірте поточний файл на диску й вирішіть конфлікт зовнішніх змін. Не намагайтеся обійти порівняння через перезапис метаданих застосунку. Якщо повне завантаження великого файлу недоступне, використовуйте підтримуване редагування вікнами/пошук або зовнішній редактор.

Telegram недоступний: перевірте локально токен бота, числовий ідентифікатор власника, наявність приватного чату та загальний статус. Конфліктний вебхук або інший активний опитувач може блокувати отримання оновлень; ZIAForge не видаляє вебхуки автоматично та не перехоплює контроль в іншого опитувача. Команди, відхилені або перервані на невідомому етапі, автоматично не повторюються.

Пов'язані інструкції: Тестування та діагностика.

Повідомлення про проблеми та перевірка даних

Зафіксуйте точну версію збірки з розділу «Про програму», OS/архітектуру, режим завдання, вибраного провайдера/модель і послідовність кроків для відтворення проблеми. Опишіть очікуваний і фактичний результати. Додайте безпечний знімок екрана та відповідну збережену команду або квитанцію верифікації замість повного приватного профілю.

Журнали CLI, журнали подій, стенограми моделі, трасування браузера та знімки екрана можуть розкривати вихідний код, персональні шляхи або токени. Перевіряйте та маскуйте конфіденційні дані перед публікацією. Автоматичне маскування в журналі за принципом найкращих зусиль не гарантує безпеку знімка екрана або архіву для публічного показу.

Для контрибуторів команда qa:doctor зчитує середовище та параметри збірки; qa:inspect відкриває ізольований профіль із заглушками провайдерів. Фікстура підтверджує протестований шлях у застосунку без звернення до моделі. Робота з реальними моделями, з'єднання з Telegram, нативне робоче середовище Linux, перевірка цифрового підпису та зібраних пакетів є окремими видами підтверджень. Дивіться TESTING.md щодо команд відтворення та очищення.

Пов'язані інструкції: Команди збирання доказів.

Локальні дані та межі доступу

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

У системі Linux для збереження облікових даних API, керування, Telegram та екземплярів потрібна розблокована служба GNOME Secret Service або KWallet; за відсутності підтримуваного сховища секретів ZIAForge відмовляється зберігати ці секрети замість використання резервного механізму basic_text середовища Electron.

Локальне зберігання не означає, що запити залишаються на вашому комп'ютері: вибраний CLI/API надсилає їх своєму провайдеру. Робоча папка та контроль процесів не є повноцінною ізоляцією на рівні OS. Перевіряйте вибрані дозволи.

Розрізняйте типи доказів: фікстури тестують застосунок без звернення до моделі; робота з реальними нативними інструментами перевіряє справжній CLI та обліковий запис; перевірки зібраних пакетів сертифікують конкретний артефакт. Успішне проходження одного типу перевірок не гарантує результату для інших.

Рівень доступу застосунку, робоче дерево та інструкція лише для читання відрізняються від обмежень на рівні операційної системи. Політики рецензента/помічника в Antigravity виявляють зміни в зібраних даних робочої області, а не забезпечують режим «лише для читання» у файловій системі. Нативне керування комп'ютером запускає дозволені власником програми за межами стандартних інструментів застосунку; вимикайте його, коли потреба в ньому зникає.

Пов'язані інструкції: Походження та публікація.

Ознайомлення з відкритим проєктом та внесення змін

Спершу прочитайте AGENTS.md та CONTRIBUTING.md, а потім PROJECT_MAP.md для з'ясування актуальних меж вихідного коду. Поведінку визначають реалізовані типізовані контракти та поточні документи щодо робочих процесів і провайдерів. CONCEPT.md і частини ARCHITECTURE.md, присвячені роботі в терміналі, відображають історію задуму і не повинні сприйматися як заяви щодо поточної версії.

Вихідним джерелом англомовної довідки є файл docs/help/en.json. Не редагуйте вручну згенеровані файли USER_GUIDE.md або website/guide.html. Змініть канонічний розділ, оновіть відповідний контракт і запустіть команду node scripts/help/generate.cjs. Вбудована довідка застосунку зчитує те саме джерело. Зіставляйте нові матеріали з фактичною реалізацією, враховуючи обмеження, дозволи та непідтримувані сценарії.

Кожна з 56 мовних локалей інтерфейсу має окремий статус довідки у файлі docs/help/locales.json. У разі відсутності або неповноти довідки використовується англійська мова. Повні тексти машинного перекладу позначаються як такі й прив'язуються до хешу англійського джерела без претензії на перевірку людиною. Переклад, перевірений людиною, додатково фіксує рецензента. Кожен переклад зобов'язаний зберігати ідентифікатори розділів, дії, назви файлів і команд, технічні ліміти, використовувати правильний напрямок тексту та оновлюватися в разі змін в англійському джерелі.

Перед релізом виконайте команду node scripts/help/generate.cjs --check, щоб виявити застарілі згенеровані дані, некоректні шаблони локалей або недійсні посилання на локальні контракти. Перевірки перекладу UI та перевірки поведінки застосунку проводяться окремо. У документі HELP_MAINTENANCE.md описано порядок оновлення для контрибуторів та AI; документація не повинна заявляти про успішне проходження тесту, якщо він фактично не виконувався.

Пов'язані інструкції: Поточна карта проєкту · Підтримка документації · Інструкції для контрибуторів · Інструкції для агентів.