# Поисковый индекс ## Зачем Поиск подстрокой не находил книги по автору или серии, а «огонь» не попадал в «Обсидиановый огонь» при неверном регистре. Теперь есть полнотекстовый индекс с ранжированием. ## Что внутри SQLite FTS5, `/var/lib/hub-search/index.db`: | Источник | Что индексируется | |---|---| | Calibre (CT111) | название, авторы, серия, путь | | Paperless | название и текст документа (первые 3000 символов) | | Mealie | название и описание рецепта | Токенизатор `unicode61 remove_diacritics` — нормально работает с русским. ## Как искать - `!найди herbert` → 3 книги Дюны, отсортированы по релевантности - `!найди огонь` → «Обсидиановый огонь» - API: `GET /search?q=огне*` Ответ содержит блок **«🔎 Точное совпадение»** — ранжированный, и ниже поиск по сервисам (фильмы, продукты, документы). ## Обновление Таймер `hub-search-index` — ежедневно 06:20. Ручной запуск: ```bash /opt/music-tools/venv/bin/python /opt/hub-core/search_index.py ``` ## Состояние на 21.10.2026 ``` индекс: 13 (книги 13, документы 0, рецепты 0) ``` Документов и рецептов пока нет — базы пустые. ## Ловушки 1. **`pct exec … python3 -c` с длинным кодом ломается на кавычках.** Надёжнее: `pct push` скрипта в контейнер и запуск файла. 2. **У таблицы `books` в Calibre нет колонок `series` и `comments`** — серия берётся через `books_series_link`. 3. **FTS не переводит языки**: «нейромант» не найдёт «Neuromancer». Нужен либо перевод в индексе, либо поиск на языке оригинала. ## Обновление 22.10 В индекс добавлена **документация репозитория** (`ops/**/*.md`): 373 записи + 13 книг. Раньше полнотекстовый поиск находил только книги. Найдено и исправлено: `c.commit()` стоял **до** вставки markdown-строк, поэтому они молча терялись при закрытии соединения. ## Изменения 22.10 - **Индексируется документация** `ops/**/*.md` — 373 записи (всего 386 с книгами). - Исправлен порядок: `commit()` теперь после вставки markdown-строк. - Ссылка на поиск добавлена на страницу «Моё». - Хранение архивов конфигов: **14 → 7 дней** (архив вырос до 244 МБ).