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
|
sudo systemctl restart ollama
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Генерация токена
|
||||||
|
|
||||||
|
Токен не выдаётся внешним сервисом: придумайте одинаковый секрет и впишите его и в серверный `config.json`, и в клиентский `clients.json`. Например:
|
||||||
|
|
||||||
|
```sh
|
||||||
|
openssl rand -hex 32
|
||||||
|
```
|
||||||
|
|
||||||
## Порог swap
|
## Порог swap
|
||||||
|
|
||||||
По умолчанию агент сравнивает общий объём **используемого** 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
|
```sh
|
||||||
@@ -140,10 +157,40 @@ curl -sS -X POST \
|
|||||||
http://10.8.0.62:8731/restart
|
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
|
```sh
|
||||||
/usr/bin/python3 -m py_compile src/*.py tests/*.py
|
/usr/bin/python3 -m py_compile src/*.py tests/*.py
|
||||||
/opt/homebrew/bin/pytest -q
|
/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