Атомарная цель. Создать подробную инструкцию запуска, остановки, health-проверки, диагностики и отката.
Что мы делаем и зачем
Runbook превращает разовую демонстрацию в воспроизводимую систему. В него попадают только команды, которые реально проверялись в предыдущих экспериментах. Секреты заменяются placeholders, а интерактивные действия явно отделяются от автоматических.
Что должно быть готово
- Известны рабочие порты и команды.
- Fault matrix завершена.
- Есть фактические логи запуска.
Где выполнять
Только README.md проекта local-agent-gateway. Документация Open-LLM-VTuber не меняется.
Scope
| Разрешено | Только действия, прямо указанные в prompt и командах этого эксперимента. |
|---|---|
| Запрещено | Секреты, изменение main/upstream, расширение scope и скрытое исправление новых ошибок. |
| Результат | Артефакты и критерии на третьей странице эксперимента. |
Откройте Codex из папки, указанной на предыдущей странице. Для независимого аудита обязательно создайте новую сессию. Скопируйте следующий prompt целиком, не вырезая ограничения.
PROMPT ДЛЯ CODEX - КОПИРОВАТЬ ЦЕЛИКОМ
Работай как инженер в режиме контролируемого агента.
Перед любым изменением покажи карту релевантной части репозитория, одну атомарную цель, файлы чтения и изменения, риски и команды проверки.
Сначала покажи план. Не меняй файлы до моего явного подтверждения.
Не используй sudo, force push, git reset --hard, git clean -fd и опасные команды удаления.
Не переключай и не изменяй main.
Не читай и не печатай .env, токены, SSH-ключи, cookies и keychain.
Не трогай файлы за пределами указанного scope.
Не скрывай ошибки и не подменяй тест словесным утверждением.
После изменения покажи краткий diff, реальный минимальный тест и git status --short.
Если нужен больший scope, остановись и запроси новый атомарный шаг.
Текущая задача: дополнить только README.md local-agent-gateway проверенным Windows PowerShell runbook.
Включи prerequisites, структуру окон, порядок Ollama -> gateway -> Open-LLM-VTuber, health checks, smoke tests, штатную остановку Ctrl+C, проверку освобождения портов, таблицу симптом/класс/проверка/исправление, rollback local conf.yaml и правила обращения с token. Не вставляй реальные secrets, абсолютный пользовательский путь и непроверенные команды.
Сначала покажи оглавление и источники каждой команды. После подтверждения измени README, покажи diff, выполни команды, которые можно безопасно повторить, и полный pytest.Команды PowerShell
Команды ниже нужны либо для ручного выполнения, либо для сверки предложения Codex. Строки после комментария «после подтверждения» не запускаются заранее.
КОМАНДЫ - КОПИРОВАТЬ ПО ПОРЯДКУ
# Старт
ollama serve
uv run uvicorn app.main:app --host 127.0.0.1 --port 8642
uv run run_server.py --verbose
# Проверки
Invoke-RestMethod http://127.0.0.1:8642/health
Get-NetTCPConnection -LocalPort 11434,8642,12393 -State Listen
# Остановка каждого foreground-процесса: Ctrl+CКак действовать при запросе разрешения
Прочитайте команду и рабочую папку; сразу сверьте их со scope этого эксперимента.
Для одной безопасной команды выберите разовое Yes, proceed.
Если команда читает секреты, пишет за пределами scope или меняет main - нажмите Esc и объясните ограничение.
Что должно получиться
- Новый пользователь понимает, какое окно для какой команды.
- Каждый health check имеет ожидаемый результат.
- Rollback не удаляет данные и не меняет upstream history.
Типовые ошибки и действия
- README содержит непроверенную команду: пометить как NOT VERIFIED или удалить.
- Вставлен реальный token: немедленно заменить placeholder и проверить Git diff.
- Команды зависят от текущей папки: добавить Set-Location перед ними.
Артефакты и доказательства
Критерий завершения
ГОТОВАЯ ЗАПИСЬ В ОТЧЁТ
Эксперимент 14: Операционный runbook | Статус: PASS / FAIL / NOT PROVEN
Доказательство: <минимальный обезличенный вывод> | Не доказано: <ограничение>
Source tree: unchanged / <известный diff> | Следующий шаг: Подготовить намеренную поставку в собственный fork.