# Неполадки и FAQ Типичные неполадки при подключении и работе с журналом и способы их исправить. Здесь собраны частые вопросы и разбор типичных неполадок. Если вы только начинаете, пройдите [Быстрый старт](/docs/quick-start): его раздел «Если не работает» покрывает первые шаги. ## Подключение и установка ### Журнал не принимает задачу Проект не зарегистрирован. Скажите агенту в папке репозитория: «Зарегистрируй этот проект в actari». Он вызовет `resolve_project`, а если ничего не найдётся, `register_project` с именем проекта и путём к папке. Пока проект не зарегистрирован, журнал отказывает на любую задачу и любой артефакт. ### MCP-сервер не стартует Нужен Node.js 22.5 или новее: сервер использует встроенный `node:sqlite`. Проверьте версию командой `node --version` и обновите Node, если она старее. ### Подключение отклоняется Токен «только чтение» для подключения не подходит: `connect` и `sync` отвечают `403 read-only token`. Выпустите токен с правом записи на странице «MCP-токены» и повторите `connect`. ### Облако на своём сервере с корпоративным сертификатом Если адрес облака использует сертификат внутреннего центра, `connect` не запишет настройки: рукопожатие TLS не проходит. Передайте Node корневой сертификат переменной окружения, например `NODE_EXTRA_CA_CERTS=/etc/ssl/certs/acme-root.pem`, и повторите подключение. ### Сервер работает, но агент не видит новых инструментов После обновления пакета перезапустите сессию агента: старая копия сервера не знает новых возможностей. ### В боковой панели облака «Подключить агента» Ни один журнал ещё не отправлял записи в это пространство. Проверьте, что `connect` выполнен успешным ответом, а проект привязан к пространству (`sync_scope {}`). Строка «Агенты давно не выходили» означает обратное: связь была, но давно, и достаточно запустить агента и сделать `sync`. ## Облако пусто ### В облаке пусто, хотя агент отчитался Возможные причины: - **Несколько пространств.** Токен личный и покрывает все ваши пространства, поэтому журнал нужно разложить по ним. Вызовите `sync_scope {}`: он покажет, что и куда уедет. Привяжите проект: `sync_scope { workspace: "acme", projects: ["acme-web"] }`. Пока проекты не привязаны, а пространств несколько, ничего не отправляется. - **Облако не подключено.** Без `connect` журнал работает локально. Смотрите там вызовом `list_tasks`. - **Другой проект.** Задача принадлежит проекту, который не привязан к нужному пространству. Проверить, доходят ли записи, можно во вкладке «Агенты» настроек пространства: там видны подключённые журналы и время последнего синка. ### Задача принята, а карточка не в «Готово» Если в пространстве включён учёт выпусков, принятая карточка стоит в колонке «Принято» и входит в открытый релиз, пока релиз не выпущен. Релиз выпускается кнопкой «Выпустить» на странице «Релизы» или записью `record_release` после выкатки, см. [Выпуски](/docs/concepts/releases). ## Работа с задачами ### Вызов отвечает «недопустим из статуса» Журнал проверяет порядок статусов. `accept` и `request_rework` работают только из `REPORTED`, `submit_report` только из `DELEGATED`, `delegate` из `DRAFT` или `REWORK`, `mark_failed` из `DELEGATED`, `REPORTED` и `REWORK`. Сообщение называет допустимые статусы. Схема переходов — на странице [Журнал и статусы](/docs/concepts/journal). ### `accept` требует доказательство Политика проекта включила правило «принять можно только с доказательством». Передайте в `evidence` хэш коммита, ссылку на прогон или вывод тестов. Как настроить правило — на странице [Политика проекта](/docs/agents/policy). ### Нельзя отказаться от задачи, которая уже в работе `drop_task` закрывает только черновик. Для задачи в работе используйте `mark_failed` с причиной. ### Закрытую задачу нельзя открыть заново Закрытую задачу не возвращают. Заведите новую и свяжите со старой: `link_tasks { from_task_id, to_task_id, kind: "continues" }`. ### Сервер отказывает по задаче из облака Человек мог отменить намерение, закрыть его, забрать себе или поменять критерии. Вызовите `intent_status { task_id }`: он покажет состояние и причину. Если агент уже взял намерение, но передумал, `release_intent` вернёт его в очередь, при условии что живых задач по нему нет. ### `take` не берёт намерение Намерение чужое или отменённое, либо его фича не «в работе». В ответе приходит причина. Убедитесь, что в облаке у задачи нажато «В работу». ### Агент сам принимает свою работу Так быть не должно. Скилл `feature` требует, чтобы проверяющий был другим: субагентом без контекста автора или вами. Если вы видите иное, проверьте, какой скилл подключён, и [политику проекта](/docs/agents/policy). ## Поиск ### Поиск не находит нужную задачу `search_precedents` сравнивает слова по основам на русском и английском, поэтому формы слова не важны, но сами слова должны встречаться в задании, отчёте или артефакте. Служебные заметки (`acceptance:`, `release:`, `released:`, `brief:`, `progress:`) в поиск не попадают. Сузить поиск до проекта помогает параметр `project`. ### Уходят ли тексты журнала куда-то при поиске По умолчанию нет: поиск идёт по словам и работает на вашей машине. Смысловой поиск по векторам включается вручную и только если заданы обе вещи: `ACTARI_SEARCH_EMBEDDINGS=on` и адрес сервиса эмбеддингов `OPENAI_EMBEDDING_BASE_URL` с моделью `OPENAI_EMBEDDING_MODEL`. С включённым режимом тексты задач, артефактов и инцидентов отправляются в этот сервис для расчёта векторов. Одних переменных сервиса без переключателя недостаточно. ## Self-host ### Облако не открывается после смены порта Меняйте оба значения: `ACTARI_PORT` и `ACTARI_URL` в `.env`. Адрес `ACTARI_URL` должен совпадать с тем, что вы вводите в браузере. ### После `docker compose down -v` все вышли из системы Так и задумано: команда стирает базу и секреты, сессии недействительны, а ключи AI, сохранённые в пространствах, нечитаемы. Без `-v` данные и секреты сохраняются. Подробности — на странице [Self-host](/docs/self-host). ### Смена пароля Postgres не действует Пароль применяется при создании базы. Чтобы сменить его на уже созданной базе, придётся пересоздать её командой `docker compose down -v`, потеряв данные. ## Как написать нам ### Как отправить идею, проблему или вопрос Откройте меню пользователя в левом нижнем углу и выберите «Обратная связь», затем нажмите «Новое обращение». Выберите, о чём пишете, — идея, проблема или вопрос, — опишите суть и при желании приложите скриншот (png, jpeg, webp или gif до 5 МБ). Быстрее всего — через палитру команд: ⌘K и «Новое обращение». Вместе с обращением мы видим ваше имя, почту, пространство и страницу, с которой вы писали. ### Где увидеть ответ Ответ приходит письмом на почту аккаунта и виден в переписке на странице «Обратная связь». Если ответ вы ещё не открыли, у пункта меню горит точка. Отвечать можно в той же переписке: вопрос вернётся к нам как новое сообщение, в том числе в закрытом обращении. ### Не вижу пункта «Обратная связь» Раздел появляется, когда на сервере задан `ACTARI_SUPER_ADMIN_EMAILS` — адрес владельца, который читает обращения. На собственном сервере без этой переменной раздела нет. ## Где данные Журнал лежит в `~/.actari/journal.db`, путь меняется переменной `ACTARI_DB`. Рядом хранятся настройки синка, политика и состояние отправки. Облако получает копию журнала и ничего в нём не меняет. Журнал работает и без облака: цикл целиком идёт локально, а облако добавляет доску, общий вид для команды и ленту выпусков.