diff --git a/README.md b/README.md index 21ae1de..6c96fb5 100644 --- a/README.md +++ b/README.md @@ -110,6 +110,14 @@ sudo ufw allow from to any port 8731 proto tcp sudo systemctl restart ollama ``` +## Генерация токена + +Токен не выдаётся внешним сервисом: придумайте одинаковый секрет и впишите его и в серверный `config.json`, и в клиентский `clients.json`. Например: + +```sh +openssl rand -hex 32 +``` + ## Порог swap По умолчанию агент сравнивает общий объём **используемого** swap с конкретным размером: @@ -123,6 +131,15 @@ sudo systemctl restart ollama } ``` + +## Поведение агента + +- Каждые `poll_interval_seconds` (по умолчанию 60) снимает метрики swap и состояние `/api/ps`. +- При превышении порога пытается перезапустить сервис, если Ollama не занят; если занят, откладывает restart до `restart_force_after_seconds`. +- После перезапуска ждёт `/api/tags` не более `restart_health_timeout_seconds`. +- Действует cooldown и лимит restart-ов в час для защиты от штормов. +- Логи и state хранятся в `~/.local/state/ollama-plagin-swap/`. + ## Проверка агента на сервере ```sh @@ -140,10 +157,40 @@ curl -sS -X POST \ http://10.8.0.62:8731/restart ``` +## Перезагрузка сервера + +После reboot Mac mini агент запустится автоматически при входе пользователя, потому что записан +в `~/Library/LaunchAgents` с `RunAtLoad=true`. Если автоматического входа нет, agent не стартует +до логина. Проверьте после перезагрузки: + +```sh +launchctl list | grep com.ollama.swap-agent +curl -sS -H "Authorization: Bearer " http://127.0.0.1:8731/health +``` + +## Проверка клиентского плагина OpenCode + +OpenCode автоматически подключает глобальный plugin из +`~/.config/opencode/plugins/ollama-swap.js`. После запуска OpenCode проверьте логи/уведомления: +при `server.connected` клиент получит статус с удалённого агента и запустит периодический опрос. + +## Неполадки LaunchAgent + +Если лог показывает `unrecognized arguments: --config ...`, plist вызывает +`serve --config ...`. Переведите аргументы в порядок `--config serve`: + +```xml +--config +/Users/andrew/.config/ollama-plagin-swap/config.json +serve +``` + +После правки выполните `launchctl unload ... && launchctl load -w ...`. + ## Локальные проверки перед установкой ```sh /usr/bin/python3 -m py_compile src/*.py tests/*.py /opt/homebrew/bin/pytest -q -node --check .opencode/plugins/ollama-swap.js +node --check examples/opencode/ollama-swap.js ```