Руководство пользователя ZIAForge

Первые шаги

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

Начните с небольшой задачи в отдельном проекте. Если вы выбираете нативный CLI, сначала установите его и войдите под собственной учетной записью в терминале. Либо настройте подключение API. Подписка CLI и платный API являются отдельными способами подключения; ZIAForge не выполняет вход и не переносит баланс между ними.

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

Связанные инструкции: Обзор проекта · Совместимость провайдеров.

Установка подходящего пакета для настольных систем

Выберите пакет для вашей операционной системы и архитектуры CPU: x64 или arm64. Конвейер сборки может создавать форматы macOS DMG/ZIP, установщик Windows NSIS/ZIP и Linux DEB/RPM/AppImage/tar.gz/ZIP. Сгенерированный файл или кросс-сборка не являются доказательством того, что установщик и нативный 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 не поддерживается. Результаты дымового тестирования в headless-режиме или контейнере не подтверждают работоспособность для любого рабочего стола или дистрибутива.

Установите 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 оценивает масштаб: простой вопрос может завершиться ответом, тогда как более крупная задача требует подготовки. Маршрут «Исправить ошибку» исследует причину и подготавливает исправление. Маршрут «Сначала спецификация» начинается с технического решения; маршрут «Сначала требования» начинается с требований и критериев приемки.

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

Рабочее дерево Worktree изолирует изменения Git в задаче. Маршрут «Ветка» работает в выбранной рабочей копии. Проверьте проект, ветку и модель перед запуском; описание задачи не отправляется одновременно в обычный чат.

Для идеи с нерешенными продуктовыми или техническими вопросами используйте «Сначала требования» и сформируйте основу в ходе обсуждения. Auto классифицирует запрос; это не указание немедленно реализовывать каждую короткую фразу. Действие «Сохранить черновик» сохраняет запрос без обращения к модели; «Начать» сохраняет и единократно запускает управляемый процесс. От одной до четырех копий задачи имеют независимые идентификаторы создания и настройки ролей.

Связанные инструкции: Контракт рабочего процесса Code · Профили промптов Code.

Обсуждение Forge

Действие «Начать» открывает центральное обсуждение. Отвечайте естественным образом, задавайте встречные вопросы, добавляйте ограничения и обсуждайте технические решения. Беседа и вопросы остаются привязанными к задаче.

Отправка текста не означает принятие документа или санкционирование нового плана реализации. Уточнение в процессе выполнения сначала приостанавливает управляемый шаг и пересматривает затронутую область. Ответ на вопрос в рамках уже принятого шага позволяет продолжить этот шаг.

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

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

Связанные инструкции: Контракт обсуждения Forge.

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

Откройте документ, проверьте его версию и при необходимости внесите правки. Отправка правок через обсуждение создает новую версию; отчеты и проверенные результаты не переписываются задним числом.

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

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

Файлы подготовки отображаются как артефакты. Их версия, создавшая фаза и хеш привязывают их к результату. Документы Code хранятся вне рабочего дерева и не попадают в коммит автоматически.

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

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

Выполнение и рецензирование

В списке задач отображаются реальные шаги, текущая попытка, результаты проверки и рецензирования. Если агент говорит «готово», это не завершает шаг: обязательные подтверждения из плана должны существовать.

Ручной режим делает паузу между подходящими шагами. Auto продвигает проверенные шаги и допускает ограниченное число повторных попыток. Действие «Остановить после» всегда создает контрольную точку. Действие «Пауза» останавливает активную работу процесса; закрытие панели ее не останавливает.

Независимый рецензент использует отдельный контекст с файлами и результатами проверок. Каждое обязательное блокирующее замечание должно быть устранено; несколько рецензентов не могут отменить блокирующую ошибку голосованием.

В режиме «Мультимодель» исправление замечаний требует явного решения. Исправление не запускает молча еще одну проверку: действие «Проверить снова» открывает новый цикл. Комментарии рецензента могут запрашивать пересмотр координатором без повторной реализации.

Завершенные шаги нельзя незаметно отредактировать. При использовании TDD этап Red («Красный») должен действительно завершиться ошибкой по ожидаемой причине, после чего этап Green («Зеленый») должен пройти успешно. Ограниченное число попыток предотвращает бесконечные повторы.

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

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

Стандартные предохранители останавливают процесс после трех неудачных попыток на одном шаге или пятидесяти попыток в общей сложности. Прерывание расходует попытку, но само по себе не считается неудачной попыткой. Лимиты и сохраненные подтверждения сохраняются при перезапуске; действие «Повторить» не сбрасывает их. Ознакомьтесь с сохраненной ошибкой перед авторизацией новой попытки.

Связанные инструкции: Проверка и рецензирование.

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

Откройте «Настройки» → «Команды рецензирования» и сохраните команду. Добавьте независимых рецензентов с их собственным CLI или API, моделью, уровнем рассуждений и специализацией, затем выберите архитектора отчетов. Выберите команду в настройках рецензирования задачи. Пресет исполнителя также может использоваться рецензентом, а вариант Custom остается доступным; независимые роли по-прежнему имеют раздельные контексты.

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

Блокирующее замечание или отклонение обязательным рецензентом не могут быть сняты большинством голосов или предпочтением архитектора. Отсутствующие или некорректные отчеты препятствуют утверждению. Ознакомьтесь с отдельными замечаниями и сводным решением перед принятием или санкционированием исправлений. Сохраненная команда фиксируется и замораживается на время выполнения; редактирование ее пресета не перезаписывает уже сформированные подтверждения.

Архитектор, работающий только с отчетами, в настоящее время использует поддерживаемые конфигурации Claude или API без инструментов. Codex и Antigravity остаются доступными в качестве рецензентов, но отклоняются для этой изолированной роли архитектора до появления проверенного контракта без инструментов. Одного лишь промпта с указанием «без инструментов» недостаточно.

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

Специализации агентов и политика промптов

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

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

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

Связанные инструкции: Исходный каталог промптов.

Work: от вопроса к документу

Для Work не требуется Git. Вариант «По умолчанию» создает отдельную папку задачи; Custom выбирает существующую папку через системный диалог. Действие «Сохранить черновик» сохраняет настройки без инференса; «Начать» запускает первую фазу.

Режим Auto отвечает напрямую или предлагает подходящий план с реальными шагами выполнения To-do. Режим «Мозговой штурм» формирует ideas.md перед выбором дополнительных идей или оценки. Режим «Исследование» сохраняет findings.md, источники и ограничения. Режим «Написание» переходит от замысла и, при необходимости, от outline.md к описательному документу или draft.md; ревизии сохраняют предыдущие версии.

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

Создавайте копии 1–4 с независимыми настройками исполнителя. Задачи, использующие пересекающиеся папки, не могут выполнять запись параллельно. Эта координация распространяется на операции ZIAForge, а не на произвольные внешние программы.

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

Режим Deep объединяет сохраненные отчеты исполнителей в brainstorm_report.md и всегда запрашивает решение пользователя. Небольшое уточнение корректирует отчет через координатора; существенное изменение запускает новый раунд зафиксированных исполнителей. Артефакты сохраняют свои версии.

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

Ручной режим делает паузу между подходящими фазами, включая подробный план режима «Написание». Auto может продолжать выполнение через этот план. Вопросы, предложенные исполняемые планы, направление «Мозгового штурма» и проверка отчета Deep остаются явными решениями даже в Auto. Цитата сама по себе не доказывает факт поиска в браузере, а сохраненный бинарный файл сам по себе не доказывает корректность его отрисовки.

Связанные инструкции: Режимы и решения Work.

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

Пресет сохраняет CLI/API, модель, уровень рассуждений и права доступа. В нижней панели чата есть разделы пресета, CLI, модели и параметров. Пользовательский режим Custom работает без пресета; действие «Создать пресет» сохраняет текущий выбор.

Каталог формируется на основе выбранного установленного CLI или API, где это поддерживается. Действие «Обновить» обновляет список без изменения текущего выбора. Если автообнаружение недоступно, введите ID модели вручную; провайдер должен по-прежнему ее поддерживать. Уровни рассуждений зависят от модели и CLI. Значение по умолчанию провайдера отличается от явного токена none.

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

В режиме Forge метка роли имеет значение: для подготовки можно использовать отдельный планировщик Planner. В нижней панели изменяется отображаемая роль; рецензенты и вспомогательные роли выбираются в настройках рабочего процесса. Политика для уже проверенной реализации может быть заблокирована.

Права доступа различаются в зависимости от провайдера. Варианты «Только чтение» и «Запись в рабочую область» доступны там, где их поддерживает адаптер. Antigravity использует нативные параметры CLI или явно выбранный полный доступ. Полный доступ не является песочницей.

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

Введенный вручную ID модели или уровень рассуждений остаются вашим выбором, но провайдер может их отклонить. Редактирование глобального пресета не меняет задним числом запущенный чат или принятый план. Чтобы намеренно изменить неактивную беседу, используйте ее собственные элементы управления и дождитесь подтверждения. Отключенный параметр следует воспринимать как ограничение возможностей или жизненного цикла, а не обходить путем редактирования сохраненного JSON.

Связанные инструкции: Возможности провайдеров.

Чаты, остановка и очередь

Открытые вкладки, «Недавние» и черновики относятся к одной задаче. Закрытие вкладки удаляет ее из «Открытых», но сохраняет в «Недавних» и не останавливает процесс ее провайдера или управляемый рабочий процесс. Выполняйте поиск по истории, повторно открывайте чат или закрывайте все дополнительные вкладки из меню истории.

Действие «Остановить» прерывает текущий ход. Дождитесь завершения остановки перед следующей отправкой: подтверждение прерывания не означает завершение процесса. Тем временем вы можете набирать следующий черновик.

В обычном чате действие «В очередь» сохраняет последующий запрос отдельно от текущего черновика. Действие «Приостановить очередь» задерживает дальнейшую доставку. Действия «Остановить» и «Выйти» приостанавливают очередь. После перезапуска сначала выполните «Возобновить», затем явно выберите «Продолжить очередь».

Статус «Не определено» означает, что статус доставки неизвестен. Такое сообщение не отправляется повторно автоматически: просмотрите историю, при необходимости скопируйте текст и отклоните элемент в очереди. Повторная его отправка представляет собой новый осознанный запрос.

Чаты управляемых фаз используют собственный рабочий процесс, а не обычную очередь. Режим «Следовать за этапом» показывает текущую фазу; выбор другой вкладки вручную прекращает следование. Журналы CLI отображают диагностику отдельно от ответа.

В ответах Markdown отображаются заголовки, списки, таблицы, ссылки и блоки кода в тройных кавычках. Карточки инструментов и диагностика CLI остаются отделенными от ответа. Сообщаемые моделью рассуждения и метрики токенов отображаются только тогда, когда провайдер действительно их передает; не делайте выводов о скрытых рассуждениях или потреблении ресурсов на основе анимации.

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

Связанные инструкции: Надежная очередь сообщений.

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

Раздел «Файлы» отображает папку задачи. Сравнивайте результаты с требованиями, открывайте документы и просматривайте диффы. Сохранение бинарного файла не гарантирует его корректного отображения в целевом приложении.

Git предоставляет статус, изменения и операции с зарегистрированными результатами. Коммит, слияние и отправка по умолчанию выполняются вручную; автоматические операции выбираются отдельно для полностью проверенного плана.

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

Work не создает веток Git и не выполняет финализацию Git. Сохраняйте необходимые документы из выбранной папки, включая версии и источники.

Редактор файлов обеспечивает подсветку синтаксиса по расширению, поиск и замену, историю отмены, перенос строк и черновики для отдельных вкладок. При сохранении поддерживается кодировка UTF-8/UTF-16 и отклоняются конфликты внешних изменений. Для других кодировок и бинарного содержимого требуется внешний редактор. Несохраненные черновики блокируют выход из приложения до тех пор, пока владелец не сохранит или не удалит их.

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

Действие «Открыть папку» использует контекст текущей задачи или ветки/рабочего дерева, а не открывает молча только исходный репозиторий. Строка файла может отображать родительский каталог этого файла. Пути валидируются бэкендом на соответствие зарегистрированным разрешениям задачи. Бинарные файлы нельзя редактировать как обычный текст; используйте их целевое средство просмотра и сохраняйте исходные байты.

Удаление рабочего дерева — отдельное защищенное действие. Завершите прикрепленные структурированные сессии и терминалы перед его удалением, включая неактивные сессии. Проверьте сохраненный результат Git и состояние восстановления; удаление записи задачи не заменяет безопасное сохранение незафиксированной работы.

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

Подключения API

В разделе «Подключения» добавляется явно выбранная OpenAI-совместимая конечная точка. Укажите название, базовый URL, модель и при необходимости ключ. Для многих серверов требуется, чтобы базовый URL заканчивался на /v1; обратитесь к документации вашей конечной точки.

Требуется HTTPS, за исключением петлевого HTTP. Используйте прямую конечную точку без учетных данных, встроенных в 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 владельца — это идентификатор пользователя, а не имя пользователя или ID бота. Принимаются сообщения только от этого пользователя в этом же личном чате.

Используйте /start, /menu или /status для обзора работающей версии, количества проектов/задач и статусов задач. Кнопки открывают «Проекты», «Задачи», «Скриншот», «Справку» и «Язык». В списках отображается по восемь элементов на страницу с навигацией: «Назад», «Обновить», «Главная» и «Назад»/«Вперед». Кнопки проектов фильтруют список задач. На карточке задачи отображаются сохраненный прогресс воркфлоу, модель/пресет и ожидающие решения вопросы, если таковые имеются.

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

Команда Run / Continue повторно считывает текущий воркфлоу Code или Work и запускает подходящий сохраненный воркфлоу. Pause запрашивает его приостановку. Ни одна из них не принимает требования, спецификацию, план, результаты ревью или вопросы; наличие нерешенного вопроса блокирует запуск. Принимайте решения в приложении или используйте явно авторизованную типизированную команду с ее точным текущим гейтом и ревизией.

Используйте «Язык» или /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 отменяет активные команды текущего процесса и ожидает завершения их процессов.

Область чтения/управления приложением и нативный доступ являются раздельными решениями. Рабочее дерево не ограничивает доступ к файловой системе для провайдера без ограничений. Отзовите нативный доступ после завершения задачи, если он больше не требуется, и проверяйте квитанции команд, а не принимайте текст ответа ассистента на веру.

Связанные инструкции: Контракт управления только для владельца.

Браузер и удаленные инстансы

Локальный владелец включает сервер и выбирает его адрес, порт и область действия: чтение для инспекции или управление для выполнения действий. Стандартный адрес 127.0.0.1 доступен только на этом компьютере. 0.0.0.0 прослушивает сетевые интерфейсы; проверьте параметры сетевого доступа перед его включением.

Браузер открывает тот же интерфейс после входа по токену. Не публикуйте токены в открытых ссылках или на скриншотах. Один лишь HTTP не шифрует трафик; используйте защищенный канал при работе через ненадежную сеть.

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

Типизированные команды и события обеспечивают управление приложением. Область чтения не дает права на изменение задач. Нативное управление компьютером — это отдельное решение локального владельца, изначально оно отключено.

Приложение должно оставаться запущенным для управления через браузер, 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 и канал stable или preview. Проверка, загрузка и установка имеют отдельные статусы; ошибка не означает, что обновление было установлено.

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

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

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

Связанные инструкции: Готовность к релизу.

Перезапуск и восстановление

В macOS используйте «Выход» / ⌘Q для полного завершения работы. Закрытие окна может оставить приложение работающим. Полностью закройте старую версию перед заменой приложения.

После запуска выберите ту же задачу. История и черновики восстановятся. Возобновление возвращает нативный/локальный контекст, но не отправляет черновик, не снимает очередь с паузы и не разрешает повтор неизвестной операции.

Если отображается окно восстановления, не редактируйте JSON вручную. Проверьте затронутый тип документа, сохраните исходные файлы и выберите проверенную резервную копию. Восстановление более старой очереди помечает ее элементы как неопределенные.

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

Создавайте резервные копии файлов задач и профиля приложения при закрытых инстансах программы. Просто скопированная папка не является проверенной копией для восстановления. Если процедура восстановления предлагает выбрать проверенную резервную копию, сохраните также точные поврежденные файлы. Восстановление более старого воркфлоу или очереди не дает права повторно запускать неопределенный инференс или операции Git.

Связанные инструкции: Контракт восстановления.

Устранение неполадок

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

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

Воркфлоу остановлен: откройте текущую фазу, вопрос, квитанцию верификации или логи CLI. Устраните конкретную причину: неотвеченный вопрос, команду, права доступа к папке или исчерпание лимита попыток. Кнопка «Продолжить» не может превратить непройденную проверку в успешную.

Папка отсутствует или заменена: восстановите доступ к исходной папке или создайте новую задачу. Приложение не должно продолжать работу из HOME. Если обнаружена другая рабочая директория, остановите шаг и сохраните диагностические данные.

При составлении отчета укажите версию из раздела «О программе», маршрут, CLI/модель, ожидаемое и фактическое поведение, приложите скриншот и безопасный фрагмент лога. Удалите секреты, личные данные и пути, которые нельзя публиковать.

Удаленная страница недоступна: убедитесь, что владелец включил сервер, проверьте адрес и порт прослушивания, затем выполните аутентификацию с правильным токеном инстанса. Ошибка 401 указывает на проблему с аутентификацией; отклоненная операция изменения может быть вызвана режимом «только чтение» или настройкой, доступной только владельцу. Смена токена закрывает сессии текущих браузерных клиентов. Не открывайте отдельный порт инспекции DevTools в качестве удаленного управления приложением.

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

Telegram недоступен: проверьте токен бота, числовой ID владельца, личный чат и статус локально. Конфликтующий вебхук или фоновый опрос может блокировать получение сообщений; 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; документация не должна заявлять об успешном прохождении тестов, которые не запускались.

Связанные инструкции: Текущая карта проекта · Поддержка документации · Инструкции для контрибьюторов · Инструкции для агентов.