Document threshold, reboot, troubleshooting, token and client verification in README

This commit is contained in:
Andrew Emelyaneko
2026-10-31 20:26:54 +03:00
parent bdf7b9686d
commit ce6759e6c2
+48 -1
View File
@@ -110,6 +110,14 @@ sudo ufw allow from <ip-клиента-opencode> 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 <token>" 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 <path> serve`:
```xml
<string>--config</string>
<string>/Users/andrew/.config/ollama-plagin-swap/config.json</string>
<string>serve</string>
```
После правки выполните `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
```