К содержимому

Диагностика

Базовая диагностика ai_stp и безопасное восстановление после ошибок.

Диагностика

Повседневное восстановление для агента:

ai-stp task intents --json

Следуйте continuation argv. Не выгружайте полный реестр как прелюдию.

Expert здоровье, если пользователь спросил, что сломано:

ai-stp doctor --json

Она показывает состояние CLI, окружения, локального реестра, устройства, хранилища секретов и доступных возможностей. doctor завершается с кодом 0 даже если установка ещё не готова; состояние — в теле ответа.

Expert ориентация и полный реестр:

ai-stp capabilities --json
ai-stp help --agent --json

Если help --agent расходится с флагом на этой странице, прав CLI. Неограниченный dump всё равно продолжает на task intents.

PATH / команда не найдена

Проверьте установку:

uv tool list
uv tool install ai-stp-cli
ai-stp version --json

Исполняемый файл — ai-stp. Пакет PyPI — ai-stp-cli. Если пакет есть, а команды нет, каталог uv tools не находится в PATH. Добавьте его и снова запустите ai-stp version --json.

Нет аккаунта

Аккаунт не нужен для локального режима и анонимного чтения публичного каталога. Авторизация нужна для приватных объектов, синхронизации, публикации, устройств, привязанных к облачной сессии, и grants.

ai-stp auth status --json
ai-stp registry search --kind setup --query frontend --json
ai-stp device init --json
ai-stp passport developer init --json

auth status сообщает local-only, authenticated, expired или revoked. Не запускайте auth login, чтобы «починить» локальный compose.

Офлайн-кэш

Локальный режим должен продолжать работать после первичной настройки. Публичный каталог может быть доступен из кэша, если объект уже был подтверждён платформой.

ai-stp registry show --kind component --id <stable_id> --json
ai-stp registry fetch --kind component --id <stable_id> --version 1.0 --json
ai-stp registry acquire --id <setup_id> --version 1.0 --offline --json

Смотрите checked_at (или эквивалентное поле свежести в конверте). Попадание в кэш — не новая verified-публикация. --offline у acquire использует только проверенные кэшированные паспорта и артефакты; если их нет, команда отказывается.

Устаревший digest плана

Если вы внутри задачи install, продолжайте её. Движок перепланирует. Не набирайте install plan, чтобы форсировать новый digest.

Expert: apply именованного leaf повторяет план и отказывается, если digest больше не совпадает. Это защита, а не ошибка. Не проталкивайте старый digest.

ai-stp task continue --json

Если expert-операция уже есть, а байты под ней изменились, отмените её, пока apply не начался:

ai-stp install cancel --operation <id> --json

Частичное применение

Не удаляйте target и резервные копии вручную.

ai-stp install status --json
ai-stp install recover --operation <id> --json
ai-stp target status --project <id> --harness <id> --json

install recover сообщает, что оставила остановленная операция и что можно сделать. Сама команда ничего не восстанавливает.

install recover / resume

Если apply прервался после того, как provider уже начал работу, завершите проверку результата, не применяя изменения снова:

ai-stp install resume --operation <id> --provider <exe> --json

resume ничего не применяет. Он спрашивает provider, что реально оказалось на диске. Затем:

ai-stp target status --project <id> --harness <id> --json
ai-stp target backups --project <id> --harness <id> --json

Подробности команд: Установка, Target.

Харнесс undefined

Автоматическая установка не считается безопасной, когда харнесс — undefined.

ai-stp toolchain harnesses --json
ai-stp toolchain harness-capabilities --json
ai-stp doctor --json

Выберите любой из семи выпускаемых харнессов или импортируйте и просматривайте локально без apply:

ai-stp setup import inspect --root <dir> --harness <id> --json

См. Харнессы.

Нет хранилища секретов

Ключ устройства живёт в системном хранилище секретов, если есть доверенный backend, иначе — в файле только для владельца. doctor называет уровень. Файловый уровень — поддерживаемая конфигурация (SSH, контейнеры), а не скрытый сбой.

ai-stp doctor --json
ai-stp device show --json

Смотрите проверку credential_store и поля идентичности устройства. Если device init ещё не запускали, это needs_user_action, а не отсутствие хранилища:

ai-stp device init --json

device reset разрушителен и требует --confirm. Это не повтор doctor.

experimental без согласия

Непроверенные объекты не участвуют в автоматической установке без явного согласия. Нет настройки «включать все непроверенные навсегда».

ai-stp consent list --json
ai-stp consent allow --scope publisher --target <publisher_id> --json
ai-stp consent allow --scope object_major --target <stable_id>@<major> --json
ai-stp registry search --kind component --query scanner --include-experimental --json

--include-experimental меняет только этот поиск. Для установки по-прежнему нужна долговременная запись. Отзыв: ai-stp consent revoke. См. Доверие и безопасность.

Связанные страницы