Document threshold, reboot, troubleshooting, token and client verification in README
This commit is contained in:
@@ -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
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user