diff --git a/ops/ops/SECRETARY-AGENT.md b/ops/ops/SECRETARY-AGENT.md new file mode 100644 index 0000000..611394b --- /dev/null +++ b/ops/ops/SECRETARY-AGENT.md @@ -0,0 +1,94 @@ +# Секретарь: почему молчал, что починили, как добавили «мышление» + +## 1. Почему Секретарь не отвечал + +Три отдельные причины, все найдены проверкой (не догадками). + +### 1.1 Права резали владельца + +Ответ «Доступ к этой функции есть только у семьи» приходил **самому +владельцу**. Причина — новый гейт ролей: + +* гейт был в `matrix.Bot.dispatch`, но у секретаря **свой** `dispatch`; +* при передаче профильному боту (`peers[prefix].dispatch`) терялся + `last_sender` → бот видел «неизвестного» → отказ. + +**Исправлено:** гейт добавлен в секретаря; автор передаётся профильному боту; +внутренние вызовы без пользователя не блокируются. + +### 1.2 «Не нашёл» обрывал диалог + +Разбор намерений возвращал «Не нашёл «комедию»», и цепочка завершалась. +**Исправлено:** отрицательные ответы больше не считаются финальными. + +### 1.3 LLM был выключен + +`LLM_BASE_URL` и `LLM_API_KEY` в `/etc/hub-core/llm.env` были **пустыми**, +поэтому «умные» шаги молча не работали. +**Исправлено:** база `https://api.deepseek.com/v1`, ключ из `/root/.deepseek-key`. + +## 2. Приоритет команд + +Было: «включи фильм Дюна» → парсер видел «фильм» → выполнял `!фильмы`. +**Исправлено:** запуск фильма перехватывается **до** разбора команд. + +## 3. Больше команд (15 новых) + +| Команда | Что даёт | +|---|---| +| `!фильмы` | что есть в медиатеке | +| `!сериалы` | сериалы и число серий | +| `!очередь` | что качается и на сколько % | +| `!диск` | место на диске | +| `!бэкапы` | свежесть копий, включая VPS | +| `!сервисы` | состояние сервисов | +| `!свет` | какой свет включён | +| `!климат` | температура и влажность | +| `!фото`, `!книги`, `!музыка`, `!документы` | состояние сервисов | +| `!яндекс` | устройства Яндекса по типам | +| `!пожелания`, `!хочу <идея>` | очередь идей | +| `!заявки`, `!одобрить N`, `!отклонить N` | заявки агентов | +| `!агенты` | отчёт роя | + +## 4. Мышление: агент с инструментами + +Новый модуль `hub/agent_llm.py`. Модель получает системную инструкцию +и **сама решает**, что делать: + +``` +{"tool": "genre", "args": {"genre": "comedy"}} — вызвать инструмент +{"ask": "Уточните: комедию посвежее или классику?"} — переспросить +{"answer": "..."} — ответить самой +``` + +Инструменты: жанр, поиск по названию (с алиасами), запуск фильма, очередь, +диск, сервисы, свет, климат, книги, музыка, документы, Яндекс, заявки, +пожелания, поиск по документации. + +Диалог помнит 6 последних реплик на пользователя +(`/var/lib/hub-bots/dialog_memory.json`). + +### Проверка + +| Запрос | Ответ агента | +|---|---| +| «подскажи тупую американскую комедию» | предложил конкретные названия и уточнил | +| «найди фантастику» | уточнил: фильмы или сериалы | +| «что качается» | 2 фильма с процентами | +| «сколько места на диске» | **нашёл, что диск заполнен на 100%** | + +Последний пункт — важный: агент нашёл аварию, которую мы не замечали. + +## 5. Авария с диском (нашла себя сама) + +Диск был занят на **100%**. Что сделали: + +* чистка завершённых раздач — **18.6 ГБ**; +* docker prune, журналы, /tmp; +* итог: **81% занято, 21 ГБ свободно**. + +### Ошибка и её исправление + +Скрипт чистки удалил «Братство Кольца» **до импорта** в медиатеку. +Исправлено: теперь удаляется только то, чьё название уже есть в медиатеке +(`IMPORT_GUARD`), остальное остаётся. Фильм поставлен на повторную загрузку.