Wiki · см. также: Частые вопросы · Windows и macOS · начните с kit:doctor
Скрипты движка объясняют причину, а не просто падают. Частые случаи:
| Симптом |
Причина и что делать |
| «git-guard: N незакоммиченных файлов» |
Массовая запись по грязному дереву не оставляет возможности отката. Закоммитьте работу (панель: Закоммитить) — либо, если понимаете риск, добавьте --allow-dirty. |
| Агент отказывается писать: нет git |
Пишущий запуск сначала коммитит контрольную точку. Нет репозитория — некуда откатываться. git init и первый коммит всей базы. |
| «уже идёт пишущий прогон» |
Один пишущий на проект. Сообщение называет pid и время старта владельца. Если процесс мёртв, блокировка снимается сама; если жив — подождите или остановите его. |
kb_lint: нет папки AuroraKnowledgeDB/ |
Вы запустили из кита, а не из корня проекта. |
Агент не видит AGENTS.md |
Откройте папку проекта как корень рабочей области, а не кит. |
/aurora-vault не находится в разговоре |
Скилл — копия в ~/.claude/skills: kit:skills --apply. |
| Симптом |
Причина и что делать |
| «нет токена — задайте CONFLUENCE_PERSONAL_TOKEN» |
Скрипты синхронизации ходят в Confluence и Jira напрямую; MCP вашего редактора не помогает. Скопируйте aurora.env.local.example в .env.aurora.local и заполните. Проверка: python3 .aurora/scripts/jira_export.py --limit 1. |
| Скилл синхронизации смотрит не в то пространство или JQL |
Значения живут в aurora.config.yaml, а не в скилле: поправьте конфиг или запустите aurora_setup.py ещё раз. |
| Таймауты, половины страниц нет |
Страницы, до которых обход не дошёл, остаются в состоянии; запустите синхронизацию снова. --prune отказывается удалять после выгрузки с ошибками. |
| Страницу перенесли в Confluence |
kit:remap-sources, затем kb:repair --gone-sources. |
sync:audit сообщает COLLISION |
Две страницы различаются только регистром; зеркало дописывает id страницы. Запустите kb:names. |
| Симптом |
Причина и что делать |
| «не ответил» / пустой ответ |
agent:ping проверяет цепочку; agent:probe отличает «нет связи» от «неверный ключ» и «нет такой модели» и перечисляет модели шлюза. |
| Три сбоя подряд, прогон останавливается |
Так задумано: виноват шлюз, а не карточки. Почините шлюз и запустите снова — остальное подхватится. |
| Очень медленно, по одному запросу |
agent:width измеряет, сколько параллельных запросов держит шлюз; задайте …_WIDTH. |
| Утверждение в тезисе «без опоры» |
Момус ничего не нашёл в источнике. Оно перечислено в ops:todo; agent:distill --recheck проверит ещё раз. |
| Симптом |
Причина и что делать |
| «папки верхнего уровня вне схемы» |
Перенесите содержимое в Workspaces/<задача>/, либо закройте папку в .gitignore, если это служебные данные, либо объявите её в aurora.config.yaml → paths.extra_structure_dirs. |
| Коммит не проходит на храповике |
Число ошибок линтера выросло выше базовой линии. Почините (kb:repair) — либо осознанно AURORA_SKIP_RATCHET=1. Он снимает только храповик; проверку сообщения коммита не снимает ничто. |
| Сотни битых ссылок после разбора |
Ссылки на карточки, которых пока нет: kb:repair --links, затем --stubs. |
| Источник помечен разобранным, а карточек нет |
kb:build --reopen --apply. |
| Один источник, одна карточка на 60 КБ текста |
Разбор оборвался рано: kb:build --thin. |
| Одна сущность живёт пятью карточками |
kb:twins, agent:twins. |
Доля knowledge низкая |
Либо задачи ещё в работе, либо связей не нашли. Трассировка (ops:trace-table) и trust_statuses в конфиге. |
| «источник пропал» на карточке |
Страницу перенесли или удалили: kb:repair --gone-sources. |
| Имя файла не проходит на Windows или macOS |
kb:names (предпросмотр, затем --apply). |
Кириллическая папка под .gitignore помечена как вне схемы |
Исправлено в 1.148.2; обновите движок (kit:update). |
| Симптом |
Причина и что делать |
| «движок отстаёт от кита» |
Версия → предпросмотр → --apply. Маршрут не стартует в проекте, чей движок старше кита панели. |
| После обновления страница показывает старый интерфейс |
Перезапустите панель (aurora_cockpit.py --restart); первый запуск новой версии пересобирает реестр команд и может занять минуту. |
| Порт занят |
--port 9000 или --restart, чтобы заменить работающую панель. |
macOS блокирует start-aurora.command |
Правая кнопка → Открыть. |
Если симптома здесь нет, на странице жизненного цикла есть список
где чаще всего рвётся, а в
INSTALL — таблица этапа установки.
Эта wiki собирается из папки wiki/ репозитория — правьте страницы там, изменения, сделанные здесь, будут перезаписаны. · Home