73 lines
4.8 KiB
Markdown
73 lines
4.8 KiB
Markdown
# Рабочий секретарь — v2 (напоминания + Nextcloud)
|
||
|
||
Обновлено 28.10.2026.
|
||
|
||
## Что нового против v1
|
||
|
||
1. **Напоминания.** «напомни через 2 часа про #3», «напомни завтра в 10»,
|
||
«напомни в пятницу в 9»; список — команда `напоминания`. Напоминание приходит
|
||
в комнату и само снимается, если задачу закрыли.
|
||
2. **Синхронизация в Nextcloud.** Задачи дублируются как VTODO в календарь-список
|
||
**«Работа»** аккаунта `roman` — отдельный аккаунт не заводили, как и просил
|
||
владелец: у него будут «Работа», «Дом» и прочие списки в одном месте.
|
||
Команда `синк` отправляет все открытые задачи сразу.
|
||
3. Промпт агента ужесточён: он трогает только те задачи, о которых идёт речь,
|
||
и не подмешивает посторонние (раньше обновлял #1 в каждом действии).
|
||
|
||
## Как устроена синхронизация
|
||
|
||
* CalDAV, Basic-auth по app-паролю Nextcloud (`/root/.nextcloud-app-pass`).
|
||
* URL: `…/remote.php/dav/calendars/roman/work/`, UID задачи — `work-<id>@buryans.ru`.
|
||
* Поля VTODO: SUMMARY (текст), CATEGORIES (тип), DUE (срок), STATUS,
|
||
X-BURYANS-ITEM (номер задачи в базе секретаря).
|
||
* Создание/правка/закрытие/удаление в Matrix → те же операции в Nextcloud.
|
||
|
||
## Проверено 28.10.2026
|
||
|
||
```
|
||
«синк» -> «Отправлено в Nextcloud (список «Работа»): 2 из 2»
|
||
REPORT по календарю: 2 задачи — «Выдать КП по Vinteo для Кабаков Максим»,
|
||
«Разобраться с проектом Ricoh…»
|
||
напоминание через 1 минуту -> пришло в комнату
|
||
```
|
||
|
||
## Ловушки
|
||
|
||
* **Переменные окружения.** `bot.env` читался в словарь, но не в `os.environ`,
|
||
поэтому `caldav` видел пустой пароль и молча возвращал 0. Теперь ключи
|
||
пробрасываются в окружение, а конфиг CalDAV читается при вызове, не при импорте.
|
||
* **`import caldav`** — модуль должен лежать в `/opt/work-hub` рядом с ботом,
|
||
иначе служба уходит в цикл перезапуска с `ModuleNotFoundError`.
|
||
|
||
## Файлы
|
||
|
||
`ops/work/stack/`: `bot.py`, `agent.py`, `store.py`, `matrix.py`, `parse.py`,
|
||
`caldav.py`. Служба `work-secretary.service`, сводки `work-digest.timer`
|
||
(08:00 и 18:30), хранилище `/opt/work-hub` (700).
|
||
|
||
## v3: встречи в календаре (28.10.2026)
|
||
|
||
Встречи разбираются **детерминированно, без модели**: слово-триггер
|
||
(«встреча», «созвон», «приезд», «демо в») + дата/время из фразы
|
||
(«в пятницу в 14:00», «завтра в 10»). Создаётся VEVENT в календаре
|
||
**«Работа»** того же аккаунта Nextcloud, длительность по умолчанию 1 час.
|
||
|
||
Почему без модели: на запрос «встреча в пятницу в 14:00…» агент дважды
|
||
отвечал «создал», не создав ничего, а затем стал переспрашивать — тянул
|
||
лишнее из истории переписки. Для структурированного запроса правило надёжнее.
|
||
|
||
Проверено: событие в календаре с `DTSTART:20261030T140000`, ответ бота:
|
||
«Встреча #5: 30.10 в 14:00 — …».
|
||
|
||
Задачи (VTODO) остаются на агенте, встречи (VEVENT) — на правилах.
|
||
|
||
### Ловушки
|
||
|
||
* Агент пишет «создал», не выполнив действие: его ответ надо логировать.
|
||
Теперь сырой JSON пишется в `/var/log/work-agent.jsonl` — по нему видно,
|
||
что именно вернула модель.
|
||
* Дата из модели может прийти в разных форматах; для встреч добавлен разбор
|
||
по нескольким шаблонам, а при неудаче задача всё равно создаётся
|
||
(без календаря) и бот честно об этом сообщает.
|
||
|